Record etichetta - Bulk

Articolo
12/21/2023

Definisce un'etichetta che può essere caricata e scaricata in un file bulk.

Le etichette consentono di organizzare campagne, gruppi di annunci, annunci e parole chiave in gruppi in base a ciò che è importante per te. È quindi possibile filtrare ed eseguire report sulle etichette per ottenere i dati più significativi per l'utente.

È possibile scaricare tutti i record label nell'account includendo il valore DownloadEntity di Labels nella richiesta del 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 etichetta.

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Label,,-22,,,,ClientIdGoesHere,,,Label Description,Label Name,#FFFFFF

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

    // Map properties in the Bulk file to the 
    // Label object of the Campaign Management service.
    Label = new Label
    {
        // 'Color' column header in the Bulk file
        ColorCode = "#FFFFFF",
        // 'Description' column header in the Bulk file
        Description = "Label Description",
        // 'Id' column header in the Bulk file
        Id = labelIdKey,
        // 'Label' column header in the Bulk file
        Name = "Label Name " + DateTime.UtcNow
    },

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

uploadEntities.Add(bulkLabel);

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

Colore
Client Id
Descrizione
Id
Etichetta
Ora modifica
Stato

Colore

Colore dell'etichetta come codice esadecimale.

Il valore esadecimale deve avere il prefisso '#'. Ad esempio, è possibile usare il valore di #FFFFFF per un'etichetta bianca.

Il colore può essere visualizzato nell'applicazione Web Microsoft Advertising. L'applicazione può visualizzare il colore o utilizzare il valore esadecimale per classificare un set di etichette.

Aggiungere: Opzionale. Se non si specifica alcun colore, il valore verrà assegnato in modo casuale per ogni etichetta.
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. È possibile aggiornare il codice colore, ma non rimuoverlo.
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

Descrizione

Descrizione dell'etichetta.

La descrizione dell'etichetta può avere una lunghezza compresa tra 1 e 200 caratteri.

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

Id

Identificatore generato dal sistema dell'etichetta.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per l'etichetta nel campo Id padre dei tipi di record dipendenti, ad esempio Etichetta campagna. Questa operazione è consigliata se si aggiungono nuove etichette e nuovi record dipendenti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio

Etichetta

Nome dell'etichetta.

Il nome dell'etichetta con distinzione tra maiuscole e minuscole può avere una lunghezza compresa tra 1 e 80 caratteri e deve essere univoco in tutte le etichette dell'account.

Aggiungere: Obbligatorio
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
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

Stato

Stato dell'etichetta.

I valori possibili sono Attivo 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.

Condividi tramite