Condividi tramite

Record parola chiave negativo campagna - Bulk

  • Articolo

Definisce una parola chiave negativa assegnata a una campagna che può essere caricata e scaricata in un file bulk.

Nello schema bulk ognuna delle parole chiave negative associate a una campagna è rappresentata singolarmente dalla propria riga. Ad esempio, se una campagna ha due parole chiave negative, sono rappresentate da due record di parole chiave negative campagna nel file bulk con Stato impostato su Attivo.

Nota

La parola chiave Campaign Negative può essere aggiunta ed eliminata, ma non può essere aggiornata.

È possibile scaricare tutti i record delle parole chiave negative della campagna nell'account includendo il valore DownloadEntity di CampaignNegativeKeywords 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.

Nell'esempio csv bulk seguente viene aggiunta una nuova parola chiave negativa della campagna se viene specificato un valore di ID padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Campaign Negative Keyword,Active,,-112,,,ClientIdGoesHere,,shoes,Exact,

Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignNegativeKeyword , 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 BulkCampaignNegativeKeyword
var bulkCampaignNegativeKeyword = new BulkCampaignNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    CampaignId = campaignIdKey,
    // 'Campaign' column header in the Bulk file
    CampaignName = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // NegativeKeyword object of the Campaign Management service.
    NegativeKeyword = new NegativeKeyword
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Match Type' column header in the Bulk file
        MatchType = MatchType.Exact,
        // 'Text' column header in the Bulk file
        Text = "shoes"
    },
                
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkCampaignNegativeKeyword);

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 Keyword , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Campagna

Nome della campagna che contiene la parola chiave negative.

Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Sola lettura e Obbligatorio

Nota

Per l'aggiunta e l'eliminazione, è 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: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Sola lettura

Id

Identificatore generato dal sistema della parola chiave negativa.

Aggiungere: Sola lettura
Aggiornamento: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Sola lettura e Obbligatorio

Parola chiave

Testo della parola chiave negativa.

Il testo può contenere un massimo di 100 caratteri.

Aggiungere: Obbligatorio
Aggiornamento: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Sola lettura

Tipo di corrispondenza

Tipo di corrispondenza per confrontare la parola chiave negativa e il termine di ricerca dell'utente.

I valori di tipo di corrispondenza supportati per una parola chiave negativa sono Phrase e Exact.

Aggiungere: Obbligatorio
Aggiornamento: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
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: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Sola lettura

Parent Id

Identificatore generato dal sistema della campagna che contiene la parola chiave negativa.

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. Questa operazione è consigliata se si aggiungono nuove parole chiave negative a una nuova campagna nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Sola lettura

Nota

Per l'aggiunta e l'eliminazione, è necessario specificare il campo Id padre o Campagna .

Stato

Rappresenta lo stato di associazione tra la campagna e la parola chiave negative.

Se la parola chiave negative è associata alla campagna, il valore di questo campo è Attivo.

I valori possibili sono Attivo o Eliminato.

Aggiungere: Opzionale. Il valore predefinito è Attivo.
Aggiornamento: Non applicabile. Una parola chiave negativa può essere aggiunta ed eliminata, ma non può essere aggiornata.
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato. Per eliminare una parola chiave negativa specifica, è necessario caricare lo stato, l'ID e l'ID padre. Per eliminare tutte le parole chiave negative per la campagna, è sufficiente caricare lo stato e l'ID padre in un singolo record. Facoltativamente, è quindi possibile aggiungere nuovi record di parole chiave negative per sostituire il set eliminato.