Record di associazione gruppo di destinatari di prodotti negativi della campagna - Bulk
Definisce un'associazione di destinatari di prodotti negativi della campagna che può essere caricata e scaricata in un file bulk.
Nota
Gli elenchi di remarketing dinamici erano in precedenza noti come destinatari di prodotti in Microsoft Advertising. Nell'interfaccia utente di Microsoft Advertising verrà visualizzato "Elenco di remarketing dinamico", ma per evitare modifiche di rilievo, gli oggetti oggetti API sono ancora denominati "destinatari del prodotto".
Gli obiettivi del gruppo di destinatari non possono essere impostati sia a livello di campagna che di gruppo di annunci. Se imposti criteri di gruppo di destinatari a livello di campagna a livello di campagna, non puoi impostare criteri di gruppo di destinatari a livello di gruppo di annunci disponibili. Le esclusioni del pubblico possono essere impostate sia a livello di campagna che di gruppo di annunci. Microsoft Advertising applica un'unione di esclusioni a livello di campagna e gruppo di annunci.
Consiglio
Per una panoramica e altre informazioni sui gruppi di destinatari, vedere la guida tecnica sulle API audience .
È possibile scaricare tutti i record di Campaign Negative Product Audience Association nell'account includendo il valore DownloadEntity di CampaignNegativeProductAudienceAssociations 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 associazione di destinatari del prodotto Campaign Negative se viene specificato un valore di ID padre valido.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign Negative Product Audience Association,Paused,,-1111,,,ClientIdGoesHere,,,,ProductAudienceIdHere,My Product Audience
Se si usano gli SDK di Bing Ads per .NET, Java o Python, è possibile risparmiare tempo usando BulkServiceManager per caricare e scaricare l'oggetto BulkCampaignNegativeProductAudienceAssociation , 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 BulkCampaignNegativeProductAudienceAssociation
var bulkCampaignNegativeProductAudienceAssociation = new BulkCampaignNegativeProductAudienceAssociation
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// NegativeCampaignCriterion object of the Campaign Management service.
NegativeCampaignCriterion = new NegativeCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = productAudienceIdKey,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = CampaignCriterionStatus.Paused
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Audience' column header in the Bulk file
AudienceName = null,
};
uploadEntities.Add(bulkCampaignNegativeProductAudienceAssociation);
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 Campaign Negative Product Audience Association , i campi dell'attributo seguenti sono disponibili nello schema bulk del file.
Gruppo di destinatari
Nome del gruppo di destinatari del prodotto.
Questo campo bulk viene mappato al campo Audience del record Product Audience .
Aggiungere: Sola lettura e Obbligatorio per alcuni casi d'uso. È necessario specificare il campo Gruppo di destinatari o ID gruppo di destinatari . Se si aggiungono nuove associazioni di destinatari di prodotti negativi della campagna con nuovi gruppi di destinatari di prodotti nello stesso file bulk e se non si imposta il campo ID gruppo di destinatari , questo campo Destinatari deve essere impostato come chiave logica sullo stesso valore del campo Destinatari del record Gruppo di destinatari del prodotto . Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura
ID gruppo di destinatari
Identificatore microsoft advertising del gruppo di destinatari del prodotto associato alla campagna.
Questo campo bulk esegue il mapping al campo ID del record Gruppo di destinatari di prodotti .
Aggiungere: Sola lettura e Obbligatorio per alcuni casi d'uso. È necessario specificare il campo Gruppo di destinatari o ID gruppo di destinatari . Se si imposta il campo ID gruppo di destinatari , è necessario specificare un identificatore di gruppo di destinatari del prodotto esistente o un identificatore negativo uguale al campo Id del record gruppo di destinatari prodotto padre. Se il campo ID gruppo di destinatari non è impostato, è necessario impostare il campo Gruppo di destinatari come chiave logica sullo stesso valore del campo Destinatari del record Gruppo di destinatari del prodotto . Una di queste opzioni è consigliata se si aggiungono nuove associazioni di destinatari di prodotti negativi della campagna con nuovi gruppi di destinatari di prodotti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Aggiornamento: Sola lettura
Elimina: Sola lettura
Campagna
Nome della campagna associata al gruppo di destinatari del prodotto.
Aggiungere: Sola lettura e Obbligatorio
Aggiornamento: Sola lettura e Obbligatorio
Elimina: Sola lettura e Obbligatorio
Nota
Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Campagna .
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
Id
Identificatore generato dal sistema per l'associazione tra una campagna e il gruppo di destinatari del prodotto.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura e Obbligatorio
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
Aggiornamento: Sola lettura
Elimina: Sola lettura
Parent Id
Identificatore generato dal sistema della campagna associata al gruppo di destinatari del prodotto.
Questo campo bulk viene mappato al campo Id del record Campagna .
Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore campagna esistente o un identificatore negativo uguale al campo Id del record campagna padre. Questa opzione è consigliata se si associano gruppi di destinatari di prodotti a una nuova campagna 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
Nota
Per aggiungere, aggiornare ed eliminare, è necessario specificare il campo Id padre o Campagna .
Stato
Stato dell'associazione.
I valori possibili sono Attivo o Eliminato.
Aggiungere: Opzionale. Il valore di stato predefinito è Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per