Record di parole chiave negative condivise - Bulk

Articolo
12/21/2023

Definisce una parola chiave negativa condivisa in un elenco di parole chiave negative che può essere scaricata e caricata in un file bulk.

È possibile scaricare tutti i record di parole chiave negative condivise nell'account includendo il valore DownloadEntity di SharedNegativeKeywords 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 a un elenco di parole chiave negative, dato un ID elenco di parole chiave negative valido (ID padre).

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Keyword,Match Type,Name
Format Version,,,,,,,,,,6.0
Shared Negative Keyword,Active,,-19,,,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 BulkSharedNegativeKeyword , 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 BulkSharedNegativeKeyword
var bulkSharedNegativeKeyword = new BulkSharedNegativeKeyword
{
    // '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"
    },

    // 'Parent Id' column header in the Bulk file
    NegativeKeywordListId = negativeKeywordListIdKey,

    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkSharedNegativeKeyword);

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

Client Id
Id
Parola chiave
Tipo di corrispondenza
Ora modifica
Parent Id
Stato

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 dell'elenco di parole chiave negative che contiene la parola chiave negativa.

Questo campo bulk esegue il mapping al campo ID del record Elenco parole chiave negative .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore dell'elenco di parole chiave negative esistente oppure specificare un identificatore negativo uguale al campo Id del record padre Elenco parole chiave negative . È consigliabile aggiungere nuove parole chiave negative a un nuovo elenco di parole chiave negative 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

Stato

Rappresenta lo stato di associazione tra l'elenco di parole chiave negative e la parola chiave negative.

Se la parola chiave negative è associata all'elenco di parole chiave negative, 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.

Condividi tramite