Record di associazione del gruppo di destinatari di prodotti del gruppo di annunci - Bulk
Definisce un'associazione di destinatari di prodotti del gruppo di annunci 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 Ad Group Product Audience Association nell'account includendo il valore DownloadEntity di AdGroupProductAudienceAssociations 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 aggiungerebbe una nuova associazione di destinatari di prodotti del gruppo di annunci se viene fornito un valore 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,,
Ad Group Product Audience Association,Paused,,-1111,,,ClientIdGoesHere,,10,,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 BulkAdGroupProductAudienceAssociation , 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 BulkAdGroupProductAudienceAssociation
var bulkAdGroupProductAudienceAssociation = new BulkAdGroupProductAudienceAssociation
{
// 'Ad Group' column header in the Bulk file
AdGroupName = null,
// Map properties in the Bulk file to the
// BiddableAdGroupCriterion object of the Campaign Management service.
BiddableAdGroupCriterion = new BiddableAdGroupCriterion
{
// 'Parent Id' column header in the Bulk file
AdGroupId = adGroupIdKey,
Criterion = new AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = productAudienceIdKey,
},
// 'Bid Adjustment' column header in the Bulk file
CriterionBid = new BidMultiplier
{
Multiplier = 10
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = AdGroupCriterionStatus.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(bulkAdGroupProductAudienceAssociation);
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 Associazione gruppi di destinatari di prodotti del gruppo di annunci, i campi dell'attributo seguenti sono disponibili nello schema del file bulk.
- Gruppo di annunci
- Gruppo di destinatari
- ID gruppo di destinatari
- Rettifica dell'offerta
- Campagna
- Client Id
- Id
- Ora modifica
- Parent Id
- Stato
Gruppo di annunci
Nome del gruppo di annunci associato 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 Gruppo di annunci .
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 stai aggiungendo nuove associazioni di destinatari di prodotti del gruppo di annunci con nuovi gruppi di destinatari di prodotti nello stesso file bulk e se non imposti il campo Id gruppo di destinatari , questo campo Destinatari deve essere impostato come chiave logica sullo stesso valore del campo Pubblico 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 di Microsoft Advertising del gruppo di destinatari del prodotto associato al gruppo di annunci.
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 del gruppo di annunci 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
Rettifica dell'offerta
Percentuale di aumento/riduzione dell'importo dell'offerta per il gruppo di destinatari del prodotto.
I valori supportati sono negativi da novanta (-90,00) a novantacento positivi (900,00).
Importante
Se non specificato, il valore di rettifica dell'offerta predefinito è 0. Il valore predefinito è soggetto a modifiche.
Importante
Microsoft Advertising non applica alcun aumento delle offerte fino a quando il pubblico del prodotto associato non ha almeno 1.000 utenti. Se qualcuno si qualifica per far parte di più gruppi di destinatari di prodotti E i destinatari del prodotto sono associati allo stesso gruppo di annunci con diversi aggiustamenti delle offerte, verrà applicata la rettifica dell'offerta più alta. Per altre informazioni sul remarketing nella ricerca a pagamento, vedere Raggiungere il pubblico.
Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.
Elimina: Sola lettura
Campagna
Nome della campagna che contiene il gruppo di annunci.
Aggiungere: Sola lettura
Aggiornamento: Sola lettura
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
Id
Identificatore generato dal sistema per l'associazione tra un gruppo di annunci e il gruppo di destinatari di prodotti.
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 del gruppo di annunci associato al gruppo di destinatari del prodotto.
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 associano gruppi di destinatari di prodotti a un nuovo gruppo di annunci 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 Gruppo di annunci .
Stato
Stato dell'associazione.
I valori possibili sono Attivo, Sospeso o Eliminato.
Aggiungere: Opzionale. Il valore di stato predefinito è Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.