Condividi tramite

Record elenco clienti - Bulk

  • Articolo

Definisce un elenco di clienti che può essere scaricato e caricato in un file bulk.

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

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

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

Tipo di azione

Determina se aggiungere, rimuovere o sostituire i record dell'elemento elenco clienti inclusi nello stesso file di caricamento bulk.

Se il tipo di azione è "Aggiungi", il servizio tenterà di aggiungere i record dell'elemento elenco clienti inclusi nello stesso file di caricamento bulk.

Se il tipo di azione è impostato su "Rimuovi", il servizio tenterà di rimuovere i record dell'elemento elenco clienti inclusi nello stesso file di caricamento bulk.

Se il tipo di azione è impostato su "Sostituisci", tutti i dati di corrispondenza cliente precedenti per questo elenco verranno rimossi e il servizio tenterà di aggiungere i record degli elementi elenco clienti inclusi nello stesso file di caricamento bulk.

Aggiungere: Opzionale. Per impostazione predefinita, il tipo di azione "Aggiungi" viene usato per i nuovi elenchi di clienti. Indipendentemente dal fatto che si imposti un valore, questo campo viene ignorato per i nuovi elenchi di clienti.
Aggiornamento: Obbligatorio se si includono anche record di elementi elenco clienti per un gruppo di destinatari esistente nello stesso file di caricamento bulk e in caso contrario questo campo è facoltativo.
Elimina: Sola lettura

Gruppo di destinatari

Nome dell'elenco dei clienti.

Il nome può contenere un massimo di 128 caratteri.

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

Dimensioni della rete del gruppo di destinatari

Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete Audience. In questo modo si ha un'idea del numero di utenti di rete audience che è possibile definire come target.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura

Dimensioni della ricerca del gruppo di destinatari

Numero totale di persone che sono membri attivi di questo gruppo di destinatari nella rete di ricerca. In questo modo si ha un'idea del numero di utenti di ricerca di destinazione.

Il pubblico deve avere almeno 300 persone prima che Microsoft Advertising lo usi per le ottimizzazioni.

Questa proprietà sarà vuota per un massimo di 24 ore durante la compilazione del gruppo di destinatari, ad esempio se si aggiunge o si aggiorna la durata, la regola o l'identificatore di tag dell'elenco dei clienti.

Questa proprietà sarà vuota se il tag UET associato all'elenco dei clienti ha lo stato Non verificato o Inattivo, perché l'elenco dei clienti non può ricevere le informazioni sui clienti dal sito Web necessario per compilare l'elenco.

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

Descrizione

Descrizione dell'elenco dei clienti. Usare una descrizione per ricordare il gruppo di destinatari di questo elenco di clienti.

La descrizione può contenere un massimo di 1.024 caratteri.

Aggiungere: Opzionale
Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Se si imposta questo campo sulla stringa delete_value , l'impostazione precedente viene rimossa.
Elimina: Sola lettura

Id

Identificatore generato dal sistema dell'elenco dei clienti.

Aggiungere: Opzionale. È necessario lasciare vuoto questo campo o specificare un identificatore negativo. È quindi possibile fare riferimento a un identificatore negativo impostato per l'elenco clienti nel campo ID padre dei tipi di record dipendenti, ad esempio l'elemento elenco clienti. Questa operazione è necessaria se si aggiungono un nuovo elenco di clienti e nuovi elementi dell'elenco dei clienti 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

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

Durata appartenenza

Quando si crea un elenco di clienti, è possibile specificare per quanto tempo gli utenti rimangono in tale segmento.

La durata minima è 1 giorno. Nota: Se un utente non ha alcuna attività per 180 giorni, viene rimosso da tutti i segmenti.

Se la durata dell'appartenenza è "-1", non c'è scadenza.

Se la durata dell'appartenenza è Null, viene usata la durata predefinita (30 giorni).

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

Parent Id

Identificatore microsoft advertising del cliente che contiene l'elenco dei clienti.

Aggiungere: Opzionale
Aggiornamento: Sola lettura. Non è possibile modificare l'ID padre.
Elimina: Sola lettura

Ambito

L'ambito definisce gli account che possono usare questo elenco di clienti. Per un elenco di clienti, l'unico ambito supportato è Customer e l'elenco dei clienti può essere associato a qualsiasi campagna e gruppo di annunci in tutti gli account del cliente.

Aggiungere: Obbligatorio
Aggiornamento: Sola lettura. Non è possibile modificare l'ambito.
Elimina: Sola lettura

Stato

Stato dell'elenco dei clienti.

I valori possibili sono Attivo o Eliminato.

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

Tipi di campagna supportati

Elenco delimitato da punto e virgola dei tipi di campagna che supportano l'elenco dei clienti.

I valori supportati sono Audience, DynamicSearchAds, Search e Shopping. In futuro potrebbero essere aggiunti nuovi tipi di campagna, quindi non è consigliabile assumere alcuna dipendenza da un set fisso di valori.

Aggiungere: Sola lettura
Aggiornamento: Sola lettura
Elimina: Sola lettura