Condividi tramite


Oggetto dati CombinedList - Campaign Management

Un elenco combinato è un gruppo di destinatari creato da una combinazione di più gruppi di destinatari esistenti.

È possibile combinare gruppi di destinatari personalizzati, elenchi di clienti, gruppi di destinatari di prodotti, gruppi di destinatari simili ed elenchi di remarketing. Non è possibile includere altri elenchi combinati o gruppi di destinatari sul mercato in un elenco combinato.

Puoi creare un massimo di 1.000 elenchi combinati per account pubblicitario e fino a 5.000 per cliente. Ogni elenco può includere fino a 100 regole di combinazione o set di condizioni logiche e ogni CombinazioneRule può contenere fino a 100 ID gruppo di destinatari.

Consiglio

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

Sintassi

<xs:complexType name="CombinedList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="CombinationRules" nillable="true" type="tns:ArrayOfCombinationRule" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elementi

L'oggetto CombinedList include gli elementi seguenti: CombinationRules.

Elemento Descrizione Tipo di dati
CombinationRules Condizioni logiche usate per determinare chi aggiungere all'elenco combinato.

Ogni elenco può includere fino a 100 regole di combinazione o set di condizioni logiche e ogni CombinazioneRule può contenere fino a 100 ID gruppo di destinatari.

Per informazioni dettagliate, vedere Le osservazioni di CombinationRule.

Aggiungere: Obbligatorio
Aggiornamento: Obbligatorio. Se si vuole mantenere una delle regole precedenti, è necessario impostarle di nuovo in modo esplicito durante l'aggiornamento.
Matrice CombinationRule

L'oggetto CombinedList include elementi ereditati.

Elementi ereditati

Elementi ereditati dal gruppo di destinatari

L'oggetto CombinedList deriva dall'oggetto Audience ed eredita gli elementi seguenti: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Le descrizioni seguenti sono specifiche di CombinedList 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 Questo elemento non è supportato per i gruppi di destinatari di elenchi combinati.

Aggiungere: Non supportato
Aggiornamento: Non supportato
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 Questo elemento non è supportato per i gruppi di destinatari di elenchi combinati.

Aggiungere: Non supportato
Aggiornamento: Non supportato
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 24 ore durante la compilazione del gruppo di destinatari, ad esempio se si aggiunge o si aggiorna la durata combinata dell'appartenenza all'elenco, la regola o l'identificatore di tag.

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

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
Digitare Tipo di gruppo di destinatari. Questo valore è CombinedList quando si recupera un gruppo di destinatari dell'elenco combinato. 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