Oggetto dati CustomerList - Campaign Management
Definisce un oggetto dati CustomerList.
Importante
Prima di creare i dati dell'elenco dei clienti tramite l'API Campaign Management, è 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.
Sintassi
<xs:complexType name="CustomerList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:complexContent mixed="false">
<xs:extension base="tns:Audience">
<xs:sequence />
</xs:extension>
</xs:complexContent>
</xs:complexType>
Elementi
L'oggetto CustomerList include elementi ereditati.
Elementi ereditati
Elementi ereditati dal gruppo di destinatari
L'oggetto CustomerList deriva dall'oggetto Audience e eredita gli elementi seguenti: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Le descrizioni seguenti sono specifiche di CustomerList e potrebbero non essere applicabili ad altri oggetti che ereditano gli stessi elementi dall'oggetto Audience .
| Elemento | Descrizione | Tipo di dati |
|---|---|---|
| AudienceNetworkSize | 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 |
long |
| CustomerShare | Determina l'elenco di clienti e account che condividono il gruppo di destinatari. I dettagli includono i conteggi delle associazioni dei gruppi di destinatari. I tag UET condivisi e i gruppi di destinatari sono disponibili solo per i clienti pilota. Per una panoramica della condivisione di gruppi di destinatari e tag UET in una gerarchia di clienti, vedere la guida tecnica Condividi gruppi di destinatari e tag UET . Aggiungere: Opzionale Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. Impostare questo elemento su Null o vuoto per conservare le condivisioni account cliente esistenti. Per rimuovere tutte le condivisioni account cliente, impostare l'elemento CustomerAccountShares dell'oggetto CustomerShare su Null o vuoto. Per rimuovere un subset di condivisioni account cliente, specificare le condivisioni account cliente che si desidera mantenere nell'elemento CustomerAccountShares dell'oggetto CustomerShare . |
CustomerShare |
| Descrizione | Descrizione del gruppo di destinatari. Usare una descrizione per ricordare il gruppo di destinatari di destinazione. 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. |
Stringa |
| ForwardCompatibilityMap | Elenco di stringhe di chiave e valore per la compatibilità con l'inoltro per evitare modifiche che altrimenti causano un'interruzione quando vengono aggiunti nuovi elementi nella versione corrente dell'API. Le modifiche di compatibilità forward verranno annotate qui nelle versioni future. Attualmente non sono presenti modifiche di compatibilità per l'oggetto Audience . |
Matrice KeyValuePairOfstringstring |
| Id | Identificatore microsoft advertising del gruppo di destinatari. Aggiungere: Sola lettura Aggiornamento: Obbligatorio e di sola lettura |
long |
| MembershipDuration | Quando si crea un gruppo di destinatari, è possibile specificare quanto tempo fa Microsoft Advertising deve cercare le azioni che corrispondono alla definizione del gruppo di destinatari. La durata minima è 1 giorno e la durata massima consentita è di 390 giorni. È anche possibile impostare la durata su -1 per nessuna scadenza. Aggiungere: Opzionale. Se non specificato, la durata dell'appartenenza verrà impostata su 30 per impostazione predefinita. Aggiornamento: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata. |
int |
| Nome | Nome del gruppo di destinatari. 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. |
Stringa |
| Parentid | Identificatore microsoft advertising dell'account o del cliente. Se l'ambito è impostato su Account, questo è l'ID account e in caso contrario è l'ID cliente. Aggiungere: Obbligatorio Aggiornamento: Sola lettura. Non è possibile modificare l'ID padre. |
long |
| Ambito | L'ambito definisce gli account che possono usare questo gruppo di destinatari. Se l'ambito è impostato su Account, il pubblico può essere associato solo alle campagne e ai gruppi di annunci in un unico account, ad esempio tramite ParentId. Se l'ambito è impostato su Cliente, il pubblico può essere associato a campagne e gruppi di annunci in tutti gli account del cliente. Aggiungere: Obbligatorio Aggiornamento: Opzionale. È possibile modificare l'ambito da Account a Customer, ma non è possibile modificare l'ambito da Cliente a Account. |
EntityScope |
| SearchSize | 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à nil o vuota per un massimo di 48 ore durante la compilazione del gruppo di destinatari, ad esempio se si aggiunge o si aggiorna la durata dell'appartenenza all'elenco clienti. Aggiungere: Sola lettura Aggiornamento: Sola lettura |
long |
| SupportedCampaignTypes | Elenco dei tipi di campagna che supportano questo gruppo di destinatari. 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 |
matrice di stringhe |
| Tipo | Tipo di gruppo di destinatari. Questo valore è CustomerList quando si recupera un gruppo di destinatari dell'elenco dei clienti. Per altre informazioni sui tipi di gruppo di destinatari, vedere Le osservazioni sugli oggetti dati del gruppo di destinatari. Aggiungere: Sola lettura Aggiornamento: Sola lettura |
AudienceType |
Requisiti
Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13