Condividi tramite

Record di parole chiave negative del gruppo di annunci - Bulk

  • Articolo

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

Nello schema bulk ogni parola chiave negativa associata a un gruppo di annunci viene rappresentata singolarmente dalla propria riga. Ad esempio, se un gruppo di annunci ha due parole chiave negative, sono rappresentate da due record di parole chiave negative del gruppo di annunci nel file bulk con Stato impostato su Attivo.

Nota

La parola chiave negative del gruppo di annunci può essere aggiunta ed eliminata, ma non può essere aggiornata.

È possibile scaricare tutti i record delle parole chiave negative del gruppo ad nell'account includendo il valore DownloadEntity di AdGroupNegativeKeywords 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 aggiunge una nuova parola chiave negativa del gruppo di annunci se viene specificato un valore id padre valido.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Ad Group Negative Keyword,Active,,-1111,,,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 BulkAdGroupNegativeKeyword , 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 BulkAdGroupNegativeKeyword
var bulkAdGroupNegativeKeyword = new BulkAdGroupNegativeKeyword
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // '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",

    // 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(bulkAdGroupNegativeKeyword);

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 parole chiave negative del gruppo di annunci, i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Gruppo di annunci

Nome del gruppo di annunci 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 Gruppo di annunci .

Campagna

Nome della campagna che contiene il gruppo di annunci e la 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

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 del gruppo di annunci che contiene la parola chiave negativa.

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. È consigliabile aggiungere nuove parole chiave negative a un nuovo gruppo di annunci 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 Gruppo di annunci .

Stato

Rappresenta lo stato di associazione tra il gruppo di annunci e la parola chiave negative.

Se la parola chiave negative è associata al gruppo di annunci, 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 il gruppo di annunci, è 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.