Oggetto dati CustomerList - Campaign Management

Articolo
11/14/2024

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.

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

{
  "AudienceNetworkSize": "LongValueHere",
  "CustomerShare": {
    "CustomerAccountShares": [
      {
        "AccountId": "LongValueHere",
        "Associations": [
          {
            "AssociationCount": "LongValueHere",
            "UsageType": "ValueHere"
          }
        ],
        "CustomerId": "LongValueHere"
      }
    ],
    "OwnerCustomerId": "LongValueHere"
  },
  "Description": "ValueHere",
  "ForwardCompatibilityMap": [
    {
      "key": "ValueHere",
      "value": "ValueHere"
    }
  ],
  "Id": "LongValueHere",
  "MembershipDuration": IntValueHere,
  "Name": "ValueHere",
  "ParentId": "LongValueHere",
  "Scope": "ValueHere",
  "SearchSize": "LongValueHere",
  "SupportedCampaignTypes": [
    "ValueHere"
  ],
  "Type": "CustomerList"
}

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 Aggiornare: 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 Aggiornare: 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 Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	corda
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 Aggiornare: 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. Aggiornare: 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 Aggiornare: Opzionale. Se non è impostato alcun valore per l'aggiornamento, questa impostazione non viene modificata.	corda
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 Aggiornare: 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 Aggiornare: 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 Aggiornare: 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 Aggiornare: 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 Aggiornare: Sola lettura	AudienceType

Requisiti

Servizio: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Usato da

ApplyCustomerListItems

Condividi tramite