Record elemento elenco clienti - Bulk

  • Articolo

Definisce un elemento elenco clienti che può essere caricato in un file bulk.

Nota

Il download in blocco degli elementi dell'elenco dei clienti non è supportato.

Importante

Prima di caricare i dati dell'elenco clienti tramite l'API bulk, è necessario creare un gruppo di destinatari dell'elenco dei clienti e accettare i termini e le condizioni nell'interfaccia utente di Microsoft Advertising. L'elenco iniziale dei clienti non deve contenere dati dei clienti, ma è necessario selezionare Accetto. Selezionando "Accetto" l'utente (1) accetta di essere in grado di divulgare legalmente i dettagli del pubblico, ovvero i dati personali, a Microsoft e (2) accettare le Condizioni di corrispondenza del cliente, il Contratto Microsoft Advertising e i criteri di Microsoft Advertising. Microsoft userà i dati caricati in base alle condizioni di corrispondenza del cliente.

Un elenco di clienti è un set di informazioni di contatto dei clienti compilate per abilitare la corrispondenza del cliente. Ogni elenco può includere più elementi Email.

È possibile aggiungere o aggiornare un record elenco clienti senza record di elementi elenco clienti nello stesso file di caricamento bulk; tuttavia, non è possibile caricare record di elementi elenco clienti senza il record elenco clienti padre associato.

Dopo 48 ore, controllare i campi Dimensioni gruppo di destinatari, ad esempio Dimensioni ricerca destinatari , per vedere quanti di questi clienti sono stati abbinati nella rete Bing. A quel punto, i tuoi annunci possono iniziare a essere visualizzati per questo nuovo pubblico.

Consiglio

Per una panoramica e altre informazioni sui gruppi di destinatari, vedere la guida tecnica sulle API audience .

È possibile scaricare tutti i record dell'elemento elenco clienti nell'account includendo il valore DownloadEntity di CustomerLists 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 aggiunto un nuovo elemento dell'elenco dei clienti.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Action Type,Sub Type,Text
Format Version,,,,,,6.0,,,,,,
Customer List,Active,-10,,ClientIdGoesHere,,,New customer list description,Customer,New Customer List,Add,,
Customer List Item,,,-10,ClientIdGoesHere,,,,,,,Email,HashedValue

Per un record elemento elenco clienti , i campi dell'attributo seguenti sono disponibili nello schema file bulk.

Gruppo di destinatari

Nome del gruppo di destinatari dell'elenco clienti padre.

Il nome può contenere un massimo di 128 caratteri.

Aggiungere: Obbligatorio. È necessario specificare il campo Id padre o Gruppo di destinatari .
Elimina: Obbligatorio. È necessario specificare il campo Id padre o Gruppo di destinatari .

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: Opzionale

Parent Id

Identificatore del gruppo di destinatari dell'elenco clienti padre.

È necessario specificare il campo Id padre o Gruppo di destinatari .

Aggiungere: Sola lettura e Obbligatorio. È necessario specificare un identificatore elenco clienti esistente o un identificatore negativo uguale al campo Id del record elenco clienti padre. Questa operazione è necessaria se si aggiungono nuovi elementi dell'elenco clienti a un nuovo elenco di clienti nello stesso file bulk. Per altre informazioni, vedere Chiavi di riferimento dello schema file bulk.
Elimina: Obbligatorio.

Sottotipo

Determina se il campo Testo rappresenta un valore di Email con hash.

Attualmente l'unico valore supportato è "Email".

Aggiungere: Obbligatorio
Elimina: Obbligatorio

Testo

Il Email con hash come testo.

Se il sottotipo è "Email", questo campo non può contenere testo normale. La stringa deve essere hash usando l'algoritmo SHA-256. Il Email con hash deve essere una stringa esadecimale di lunghezza 64. Ad esempio, è necessario caricare una stringa con hash, ad esempio "f25ad364d33972379a7a4f4df33db14205f5c40eb19cfdb2fc5aaf117e10101" anziché "test@contoso.com".

Aggiungere: Obbligatorio
Elimina: Obbligatorio