Condividi tramite

Record di destinazione annunci di Ricerca dinamica negativa campagna - Bulk

  • Articolo

Definisce una destinazione pubblicitaria di Ricerca dinamica negativa campagna che può essere caricata e scaricata in un file bulk.

Il record Campaign Negative 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 destinazione ad ricerca dinamica negativa campagna nell'account includendo il valore DownloadEntity di CampaignNegativeDynamicSearchAdTargets 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 negativa della campagna 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,,,,,,,,
Campaign Negative Dynamic Search Ad Target,Active,,-114,,,ClientIdGoesHere,,,Bulk Campaign Dynamic Search Ad Target,,,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 BulkCampaignNegativeDynamicSearchAdTarget , 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 BulkCampaignNegativeDynamicSearchAdTarget
var bulkCampaignNegativeDynamicSearchAdTarget = new BulkCampaignNegativeDynamicSearchAdTarget
{
    // Map properties in the Bulk file to the 
    // NegativeCampaignCriterion object of the Campaign Management service.
    NegativeCampaignCriterion = new NegativeCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new Webpage
        {
            Parameter = new WebpageParameter
            {
                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 Campaign Negative Dynamic Search Ad Target"
            }
        },
        // 'Id' column header in the Bulk file
        Id = null,
    },
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeDynamicSearchAdTarget);

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 Campaign Negative Dynamic Search Ad Target , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Campagna

Nome della campagna che contiene la destinazione dell'annuncio dinamico (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 Campagna .

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

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. È possibile avere un solo target di annunci dinamici per ogni campagna 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. È possibile avere un solo target di annunci dinamici per ogni campagna 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. È possibile avere un solo target di annunci dinamici per ogni campagna 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 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. È possibile avere un solo target di annunci dinamici per ogni campagna 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. È possibile avere un solo target di annunci dinamici per ogni campagna 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. È possibile avere un solo target di annunci dinamici per ogni campagna 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

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 imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa. 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 della campagna che contiene la destinazione dinamica dell'annuncio (criterio della pagina Web).

Questo campo bulk viene mappato al campo Id del record Campagna .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore campagna esistente o un identificatore negativo uguale al campo Id del record campagna padre. Questo è consigliato se si aggiungono nuovi obiettivi di annunci dinamici a una nuova campagna 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 Campagna .

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.