Record etichetta - Bulk
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
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.