Record di destinazione annunci ricerca dinamica gruppo di annunci - Bulk

  • Articolo

Definisce una destinazione pubblicitaria di Ricerca dinamica del gruppo di annunci che può essere caricata e scaricata in un file bulk.

Il record Ad Group Dynamic Search Ad Target può essere creato solo all'interno di campagne di ricerca con impostazioni di annunci di ricerca dinamica valide (inclusi i campi Domain Language, Dynamic Description Enabled, Page Feed IDs, Source e Website ). L'ID esperimento della campagna deve essere impostato e il tipo di gruppo di annunci deve essere impostato su "SearchDynamic".

È possibile scaricare tutti i record di Ad Group Dynamic Search Ad Target nell'account includendo il valore DownloadEntity di AdGroupDynamicSearchAdTargets nella richiesta di servizio DownloadCampaignsByAccountIds o DownloadCampaignsByCampaignIds . Inoltre, la richiesta di download deve includere l'ambito EntityData . Per altre informazioni sul servizio bulk, incluse le procedure consigliate, vedere Download e caricamento in blocco.

L'esempio csv bulk seguente aggiungerebbe una nuova destinazione pubblicitaria di ricerca dinamica del gruppo di annunci se viene fornito un valore id padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid,Name,Tracking Template,Custom Parameter,Dynamic Ad Target Condition 1,Dynamic Ad Target Condition 2,Dynamic Ad Target Condition 3,Dynamic Ad Target Value 1,Dynamic Ad Target Value 2,Dynamic Ad Target Value 3
Format Version,,,,,,,,,6.0,,,,,,,,
Ad Group Dynamic Search Ad Target,Paused,,-1113,,,ClientIdGoesHere,,0.5,Bulk Ad Group Dynamic Search Ad Target,,{_promoCode}=PROMO1; {_season}=summer,Url,Category,PageContent,contoso.com,US/CA/SFO,flowers

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupDynamicSearchAdTarget , anziché chiamare direttamente le operazioni del servizio e scrivere codice personalizzato per analizzare ogni campo nel file bulk.

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkAdGroupDynamicSearchAdTarget
var bulkAdGroupDynamicSearchAdTarget = new BulkAdGroupDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                // Set Conditions null if you want to target all webpages
                Conditions = new []
                {
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 1' column header in the Bulk file
                        Argument = "contoso.com",
                        // 'Dynamic Ad Target Condition 1' column header in the Bulk file
                        Operand = WebpageConditionOperand.Url
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 2' column header in the Bulk file
                        Argument = "US/CA/SFO",
                        // 'Dynamic Ad Target Condition 2' column header in the Bulk file
                        Operand = WebpageConditionOperand.Category
                    },
                    new WebpageCondition
                    {
                        // 'Dynamic Ad Target Value 3' column header in the Bulk file
                        Argument = "flowers",
                        // 'Dynamic Ad Target Condition 3' column header in the Bulk file
                        Operand = WebpageConditionOperand.PageContent
                    },
                },
                // 'Name' column header in the Bulk file
                CriterionName = "Bulk Ad Group Dynamic Search Ad Target"
            }
        },
        CriterionBid = new FixedBid
        {
            // 'Bid' column header in the Bulk file
            Amount = 0.50
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.Paused,
        // 'Tracking Template' column header in the Bulk file
        TrackingUrlTemplate = null,
        // 'Custom Parameter' column header in the Bulk file
        UrlCustomParameters = new CustomParameters
        {
            // Each custom parameter is delimited by a semicolon (;) in the Bulk file
            Parameters = new[] {
                new CustomParameter(){
                    Key = "promoCode",
                    Value = "PROMO1"
                },
                new CustomParameter(){
                    Key = "season",
                    Value = "summer"
                },
            }
        },
    },
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
};

uploadEntities.Add(bulkAdGroupDynamicSearchAdTarget);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

Per un record Di destinazione annunci ricerca dinamica gruppo di annunci , i campi di attributo seguenti sono disponibili nello schema del file bulk.

Gruppo di annunci

Nome del gruppo di annunci che contiene la destinazione dinamica dell'annuncio (criterio della pagina Web).

Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

Offerta

Importo da presentare all'asta.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura

Campagna

Nome della campagna che contiene il gruppo di annunci e la destinazione degli annunci dinamici (criterio della pagina Web).

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

ID Client

Usato per associare i record nel file di caricamento bulk ai record nel file dei risultati. Il valore di questo campo non viene utilizzato o archiviato dal server; viene semplicemente copiato dal record caricato nel record di risultati corrispondente. Può essere qualsiasi stringa valida fino a 100 di lunghezza.

Aggiungere: Opzionale
Aggiornamento: Opzionale
Elimina: Sola lettura

Parametro personalizzato

Raccolta personalizzata di parametri chiave e valore per il rilevamento url.

In un file bulk l'elenco dei parametri personalizzati viene formattato come segue.

  • Formattare ogni coppia di parametri personalizzata come Key=Value, ad esempio {_promoCode}=PROMO1.

  • Microsoft Advertising accetterà le prime 8 coppie chiave parametro e valore personalizzate incluse e, se si includono più di 8 parametri personalizzati, verrà restituito un errore.

  • Ogni coppia chiave/valore è delimitata da un punto e virgola e da uno spazio ("; "), ad esempio {_promoCode}=PROMO1; {_season}=summer.

  • Una chiave non può contenere un punto e virgola. Se un valore contiene un punto e virgola, deve essere preceduto da caratteri di escape come '\;'. Inoltre, se il valore contiene una barra rovesciata, deve anche essere preceduto da escape come '\'.

  • La chiave non può superare i 16 byte UTF-8 e il valore non può superare i 250 byte UTF-8. La chiave è obbligatoria e il valore è facoltativo. Le dimensioni massime della chiave non includono le parentesi graffe e il carattere di sottolineatura, ad esempio '{', '_' e '}'.

    Nota

    Con il servizio bulk la chiave deve essere formattata con parentesi graffe circostanti e un carattere di sottolineatura iniziale, ad esempio se la chiave è promoCode, deve essere formattata come {_promoCode}. Con il servizio Campaign Management non è possibile specificare le parentesi graffe e il carattere di sottolineatura circostanti.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Per rimuovere tutti i parametri personalizzati, impostare questo campo su delete_value. La parola chiave delete_value rimuove l'impostazione precedente. Per rimuovere un subset di parametri personalizzati, specificare i parametri personalizzati che si desidera mantenere e omettere eventuali parametri che non si desidera mantenere. Il nuovo set di parametri personalizzati sostituirà qualsiasi set di parametri personalizzato precedente.
Elimina: Sola lettura

Nota

Se non imposti nessuno dei campi della condizione, dell'operatore o del valore di destinazione degli annunci dinamici, hai come destinazione tutte le pagine Web.

Condizione di destinazione annunci dinamici 1

Primo di un massimo di 3 operandi di condizione della pagina Web. La condizione viene soddisfatta se la proprietà della pagina Web a cui fa riferimento questo campo contiene o è uguale al valore Dynamic Ad Target Value 1 .

I valori possibili includono Category, CustomLabel, PageContent, PageTitle e Url.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione o del valore di destinazione degli annunci dinamici, stai effettivamente indirizzando tutte le pagine Web. Puoi avere un solo target di annunci dinamici per ogni gruppo di annunci per tutte le pagine Web.
Aggiornamento: Non consentito. Non è possibile aggiornare i campi della condizione o del valore dinamico della destinazione dell'annuncio. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Condizione di destinazione annunci dinamici 2

Secondo di un massimo di 3 operandi di condizione della pagina Web. La condizione viene soddisfatta se la proprietà della pagina Web a cui fa riferimento questo campo contiene o è uguale al valore dynamic ad target value 2 .

I valori possibili includono Category, CustomLabel, PageContent, PageTitle e Url.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione o del valore di destinazione degli annunci dinamici, stai effettivamente indirizzando tutte le pagine Web. Puoi avere un solo target di annunci dinamici per ogni gruppo di annunci per tutte le pagine Web.
Aggiornamento: Non consentito. Non è possibile aggiornare i campi della condizione o del valore dinamico della destinazione dell'annuncio. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Condizione di destinazione annunci dinamici 3

Terzo di un massimo di 3 operandi di condizione della pagina Web. La condizione viene soddisfatta se la proprietà della pagina Web a cui fa riferimento questo campo contiene o è uguale al valore Dynamic Ad Target Value 1 .

I valori possibili includono Category, CustomLabel, PageContent, PageTitle e Url.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione o del valore di destinazione degli annunci dinamici, stai effettivamente indirizzando tutte le pagine Web. Puoi avere un solo target di annunci dinamici per ogni gruppo di annunci per tutte le pagine Web.
Aggiornamento: Non consentito. Non è possibile aggiornare i campi della condizione o del valore dinamico della destinazione dell'annuncio. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Operatore di destinazione annunci dinamici 1

Primo di un massimo di 3 operatori di condizione della pagina Web. La condizione viene soddisfatta se la proprietà della pagina Web a cui fa riferimento questo campo contiene o è uguale al valore Dynamic Ad Target Value 1 .

I valori possibili includono Contains e Equals.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione, dell'operatore o del valore di destinazione degli annunci dinamici, hai come destinazione tutte le pagine Web. Se imposti Dynamic Ad Target Condition 1 e non imposti Dynamic Ad Target Operator 1, useremo l'operatore predefinito per l'operando selezionato. Se si vuole creare URL uguale, è necessario passare l'operatore . Aggiornamento: Non consentito. Non è possibile aggiornare i campi operatore o valore di destinazione degli annunci dinamici. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Operatore di destinazione annunci dinamici 2

Secondo di un massimo di 3 operatori di condizione della pagina Web. La condizione viene soddisfatta se la proprietà della pagina Web a cui fa riferimento questo campo contiene o è uguale al valore dynamic ad target value 2 .

I valori possibili includono Contains e Equals.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione, dell'operatore o del valore di destinazione degli annunci dinamici, hai come destinazione tutte le pagine Web. Se imposti Dynamic Ad Target Condition21 e non imposti Dynamic Ad Target Operator 2, useremo l'operatore predefinito per l'operando selezionato. Se si vuole creare URL uguale, è necessario passare l'operatore . Aggiornamento: Non consentito. Non è possibile aggiornare i campi operatore o valore di destinazione degli annunci dinamici. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Operatore di destinazione annunci dinamici 3

Terzo di un massimo di 3 operatori di condizione della pagina Web. La condizione viene soddisfatta se la proprietà della pagina Web a cui fa riferimento questo campo contiene o è uguale al valore dynamic ad target value 3 .

I valori possibili includono Contains e Equals.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione, dell'operatore o del valore di destinazione degli annunci dinamici, hai come destinazione tutte le pagine Web. Se imposti Dynamic Ad Target Condition 3 e non imposti Dynamic Ad Target Operator 3, useremo l'operatore predefinito per l'operando selezionato. Se si vuole creare URL uguale, è necessario passare l'operatore . Aggiornamento: Non consentito. Non è possibile aggiornare i campi operatore o valore di destinazione degli annunci dinamici. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Valore di destinazione annuncio dinamico 1

Primo di un massimo di 3 argomenti di condizione o criterio della pagina Web.

È possibile impostare questa stringa sull'URL, la categoria, il titolo della pagina o il contenuto della pagina per il sito. Ad esempio, se il campo Condizione di destinazione annunci dinamici 1 è impostato su URL, è possibile impostare questo campo su contoso.com/flowers.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione o del valore di destinazione degli annunci dinamici, stai effettivamente indirizzando tutte le pagine Web. Puoi avere un solo target di annunci dinamici per ogni gruppo di annunci per tutte le pagine Web.
Aggiornamento: Non consentito. Non è possibile aggiornare i campi della condizione o del valore dinamico della destinazione dell'annuncio. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Valore di destinazione annuncio dinamico 2

Secondo di un massimo di 3 argomenti di condizione o criterio della pagina Web.

È possibile impostare questa stringa sull'URL, la categoria, il titolo della pagina o il contenuto della pagina per il sito. Ad esempio, se il campo Condizione di destinazione annunci dinamici 2 è impostato su URL, è possibile impostare questo campo su contoso.com/flowers.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione o del valore di destinazione degli annunci dinamici, stai effettivamente indirizzando tutte le pagine Web. Puoi avere un solo target di annunci dinamici per ogni gruppo di annunci per tutte le pagine Web.
Aggiornamento: Non consentito. Non è possibile aggiornare i campi della condizione o del valore dinamico della destinazione dell'annuncio. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Valore di destinazione annuncio dinamico 3

Terzo di un massimo di 3 argomenti di condizione o criterio della pagina Web.

È possibile impostare questa stringa sull'URL, la categoria, il titolo della pagina o il contenuto della pagina per il sito. Ad esempio, se il campo Condizione di destinazione annunci dinamici 3 è impostato su URL, è possibile impostare questo campo su contoso.com/flowers.

Aggiungere: Opzionale. Se non imposti nessuno dei campi della condizione o del valore di destinazione degli annunci dinamici, stai effettivamente indirizzando tutte le pagine Web. Puoi avere un solo target di annunci dinamici per ogni gruppo di annunci per tutte le pagine Web.
Aggiornamento: Non consentito. Non è possibile aggiornare i campi della condizione o del valore dinamico della destinazione dell'annuncio. Per aggiornare le condizioni della pagina Web è necessario eliminare la destinazione dinamica degli annunci e aggiungerne una nuova.
Elimina: Sola lettura

Id

Identificatore generato dal sistema della destinazione dinamica dell'annuncio (criterio della pagina Web).

Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Suffisso URL finale

Il suffisso URL finale può includere parametri di rilevamento che verranno aggiunti alla fine dell'URL della pagina di destinazione. È consigliabile inserire parametri di rilevamento richiesti dalla pagina di destinazione in un suffisso URL finale in modo che i clienti vengano sempre inviati alla pagina di destinazione. Per altri dettagli e regole di convalida, vedere Suffisso URL finale nelle guide tecniche.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

Ora modifica

Data e ora dell'ultimo aggiornamento dell'entità. Il valore è espresso nell'ora UTC (Coordinated Universal Time).

Nota

Il valore di data e ora riflette la data e l'ora nel server, non nel client. Per informazioni sul formato della data e dell'ora, vedere la voce dateTime in Tipi di dati XML primitivi.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

Nome

Nome del criterio che è possibile usare per identificare i criteri, ad esempio è possibile filtrare o ordinare in ordine alfabetico.

La lunghezza del nome del criterio deve essere compresa tra 1 e 2048, inclusi.

Aggiungere: Opzionale. Se non si specifica alcun nome, per impostazione predefinita il nome verrà impostato su un elenco concatenato di condizioni. Ogni condizione verrà delimitata dalla parola chiave e . Ad esempio, se le condizioni sono a) Url contiene flower , b) Url contiene libro e c) PageContent contiene seattle, quindi il nome del criterio predefinito sarà URL contiene fiore e URL contiene book e PageContent contiene seattle. Se tutti i campi condizione e valore sono vuoti, tutte le pagine Web sono destinate a tutte e il nome verrà impostato su Tutte le pagine Web.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si specifica la parola chiave delete_value , il nome del criterio verrà aggiornato al valore predefinito, ad esempio Tutte le pagine Web o un elenco concatenato di criteri.
Elimina: Sola lettura

Parent Id

Identificatore generato dal sistema del gruppo di annunci che contiene la destinazione dinamica degli annunci (criterio della pagina Web).

Questo campo bulk viene mappato al campo Id del record gruppo di annunci .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore del gruppo di annunci esistente o un identificatore negativo uguale al campo Id del record gruppo di annunci padre. Questo è consigliato se si aggiungono nuove destinazioni di annunci dinamici a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura

Nota

Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Gruppo di annunci .

Stato

Stato della destinazione dell'annuncio dinamico (criterio della pagina Web).

I valori possibili sono Attivo, Sospeso o Eliminato.

Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.

Modello di rilevamento

I modelli di rilevamento possono essere usati insieme all'URL della pagina di destinazione generato dinamicamente dal dominio specificato per la campagna Annunci di ricerca dinamica. Combinando il dominio con il modello di rilevamento, l'URL della pagina di destinazione viene assemblato in cui un utente viene indirizzato dopo aver fatto clic sull'annuncio.

Le regole di convalida seguenti si applicano ai modelli di rilevamento. Per altre informazioni sui modelli e i parametri supportati, vedere l'articolo della Guida di Microsoft Advertising Quali parametri di rilevamento o URL è possibile usare?

  • I modelli di rilevamento definiti per le entità di livello inferiore, ad esempio gli annunci, sostituiscono quelli impostati per entità di livello superiore, ad esempio la campagna. Per altre informazioni, vedere Limiti delle entità.

  • La lunghezza del modello di rilevamento è limitata a 2.048 caratteri. La stringa di protocollo HTTP o HTTPS viene conteggiata per il limite di 2.048 caratteri.

  • Il modello di rilevamento deve essere un URL ben formato che inizia con uno dei seguenti: http://, https://, {lpurl} o {unescapedlpurl}.

  • Microsoft Advertising non convalida l'esistenza di parametri personalizzati. Se si usano parametri personalizzati nel modello di rilevamento e non esistono, l'URL della pagina di destinazione includerà i segnaposto chiave e valore dei parametri personalizzati senza sostituzione. Ad esempio, se il modello di rilevamento è https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}e non vengono definiti {_season} o {_promocode} a livello di campagna, gruppo di annunci, criterio, parola chiave o annuncio, l'URL della pagina di destinazione sarà lo stesso.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura