Record etichetta gruppo di annunci - Bulk
Definisce un record di associazione tra un gruppo di annunci e un'etichetta che può essere caricata e scaricata in un file bulk. Per caricare o scaricare il gruppo di annunci o l'etichetta, usa il record Gruppo di annunci o Etichetta .
È possibile scaricare tutti i record dell'etichetta del gruppo di annunci nell'account includendo il valore DownloadEntity di AdGroupLabels 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 applica un'etichetta a un gruppo di annunci se vengono specificati valori id eID padre validi.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Name,Description,Label,Color
Format Version,,,,,,,,6.0,,,
Ad Group Label,,-22,-1111,,,ClientIdGoesHere,,,,,
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkAdGroupLabel , 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 BulkAdGroupLabel
var bulkAdGroupLabel = new BulkAdGroupLabel
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// LabelAssociation object of the Campaign Management service.
LabelAssociation = new LabelAssociation
{
// 'Parent Id' column header in the Bulk file
EntityId = adGroupIdKey,
// 'Id' column header in the Bulk file
LabelId = labelIdKey
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkAdGroupLabel);
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 etichetta gruppo di annunci, i campi di attributo seguenti sono disponibili nello schema file bulk.
Nota
I campi Gruppo di annunci e Campagna non vengono restituiti nel file di download.
Gruppo di annunci
Nome del gruppo di annunci in cui viene applicata o rimossa l'etichetta.
Aggiungere: Sola lettura
Elimina: Sola lettura
Nota
Per l'aggiunta e l'eliminazione, è necessario specificare l'ID padre o entrambi i campi Gruppo di annunci e Campagna .
Campagna
Nome della campagna che contiene il gruppo di annunci in cui viene applicata o rimossa questa etichetta.
Aggiungere: Sola lettura
Elimina: Sola lettura
Nota
Per l'aggiunta e l'eliminazione, è necessario specificare l'ID padre o entrambi i campi Gruppo di annunci e Campagna . Per il download in blocco, i campi Gruppo di annunci e Campagna non vengono restituiti.
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
Elimina: Sola lettura
Id
Identificatore dell'etichetta applicata o rimossa dal gruppo di annunci.
Questo campo bulk esegue il mapping al campo Id del record Etichetta .
Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore di etichetta esistente o un identificatore negativo uguale al campo Id del record etichetta padre. Questa opzione è consigliata se si applicano nuove etichette ai gruppi di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: Sola lettura e Obbligatorio
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
Elimina: Sola lettura
Parent Id
Identificatore del gruppo di annunci in cui viene applicata o rimossa l'etichetta.
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. Questa opzione è consigliata se si applicano etichette a un nuovo gruppo di annunci nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: Sola lettura e Obbligatorio
Nota
Per l'aggiunta e l'eliminazione, è necessario specificare l'ID padre o entrambi i campi Gruppo di annunci e Campagna . Per il download in blocco, i campi Gruppo di annunci e Campagna non vengono restituiti.
Stato
Rappresenta lo stato applicato tra il gruppo di annunci e l'etichetta.
I valori possibili sono Attivo ed Eliminato. Se l'etichetta viene applicata al gruppo di annunci, il valore di questo campo è Attivo.
Aggiungere: Sola lettura
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.