Condividi tramite


Record di associazione elenco clienti campagna - Bulk

Definisce un'associazione elenco clienti campagna che può essere caricata e scaricata in un file bulk.

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 dell'associazione elenco clienti campagna nell'account includendo il valore DownloadEntity di CampaignCustomerListAssociations 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 elenco clienti campagna se viene specificato 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,,
Campaign Customer List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,CustomerListIdHere,My Customer List

Per un record di associazione elenco clienti campagna , i campi dell'attributo seguenti sono disponibili nello schema del file bulk.

Gruppo di destinatari

Nome dell'elenco dei clienti.

Questo campo bulk viene mappato al campo Destinatari del record Elenco clienti .

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 dell'elenco clienti campagna con nuovi elenchi di clienti nello stesso file bulk e se non si imposta il campo ID gruppo di destinatari , il campo Gruppo di destinatari deve essere impostato come chiave logica sullo stesso valore del campo Gruppo di destinatari del record Elenco clienti . 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 dell'elenco dei clienti associato alla campagna.

Questo campo bulk esegue il mapping al campo ID del record Elenco clienti .

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 elenco clienti esistente o un identificatore negativo uguale al campo Id del record elenco clienti 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 Elenco clienti . Una di queste opzioni è consigliata se si aggiungono nuove associazioni elenco clienti campagna con nuovi elenchi di clienti 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 l'elenco dei clienti.

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.

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

Campagna

Nome della campagna associata all'elenco dei clienti.

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 l'elenco dei clienti.

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 all'elenco dei clienti.

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 elenchi di clienti 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, Sospeso o Eliminato.

Aggiungere: Opzionale. Il valore di stato predefinito è Attivo.
Aggiornamento: Opzionale
Elimina: Obbligatorio. Lo stato deve essere impostato su Eliminato.