Oggetto dati audience - Campaign Management

Articolo
08/03/2024

Definisce l'oggetto di base di un gruppo di destinatari.

Non provare a creare un'istanza di un gruppo di destinatari. È possibile creare uno o più degli oggetti seguenti che ne derivano.

Nota

Microsoft Advertising genererà automaticamente gruppi di destinatari simili per gli elenchi di remarketing per i partecipanti pilota, ad esempio GetCustomerPilotFeatures restituisce l'identificatore di funzionalità 317.

Sintassi

<xs:complexType name="Audience" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceNetworkSize" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="CustomerShare" nillable="true" type="tns:CustomerShare" />
    <xs:element minOccurs="0" name="Description" nillable="true" type="xs:string" />
    <xs:element xmlns:q123="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q123:ArrayOfKeyValuePairOfstringstring" />
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="MembershipDuration" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="ParentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="SearchSize" nillable="true" type="xs:long" />
    <xs:element xmlns:q124="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q124:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

Elementi

L'oggetto Audience include gli elementi seguenti: AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type.

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. Vedere altri dettagli nella documentazione per gli oggetti che ereditano questo elemento, ad esempio RemarketingList.	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. Questo elemento è supportato solo con remarketingList. I gruppi di destinatari di altri tipi non possono essere condivisi nella gerarchia dei clienti.	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.	string
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 questo oggetto.	Matrice KeyValuePairOfstringstring
Id	Identificatore microsoft advertising del gruppo di destinatari.	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 180 giorni.	int
Nome	Nome del gruppo di destinatari. Il nome può contenere un massimo di 128 caratteri.	string
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.	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.	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. Vedere altri dettagli nella documentazione per gli oggetti che ereditano questo elemento, ad esempio RemarketingList.	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.	matrice di stringhe
Tipo	Tipo di gruppo di destinatari. Per altre informazioni sui tipi di gruppo di destinatari, vedere la sezione Osservazioni.	AudienceType

Osservazioni

Per i linguaggi Java e .NET, non impostare l'elemento Type perché il valore è determinato dal fatto che si crea un'istanza di un gruppo di destinatari personalizzato o di un altro tipo di gruppo di destinatari. Se si genera il soap manualmente, usare l'attributo type del nodo Audience , come illustrato nell'esempio seguente.

<Audiences xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Audience i:type="CustomAudience">
    <Description i:nil="false">Custom Audience Description</Description>
    <ForwardCompatibilityMap xmlns:e43="http://schemas.datacontract.org/2004/07/System.Collections.Generic" i:nil="false">
      <e43:KeyValuePairOfstringstring>
        <e43:key i:nil="false"></e43:key>
        <e43:value i:nil="false"></e43:value>
      </e43:KeyValuePairOfstringstring>
    </ForwardCompatibilityMap>
    <Id i:nil="true" />
    <MembershipDuration i:nil="false">30</MembershipDuration>
    <Name i:nil="false">Custom Audience Name</Name>
    <ParentId i:nil="false">ParentIdHere</ParentId>
    <Scope>Customer</Scope>
  </Audience>
</Audiences>

Requisiti

Servizio: CampaignManagementService.svc v13
Spazio dei nomi: https://bingads.microsoft.com/CampaignManagement/v13

Usato da

AddAudiences
GetAudiencesByIds
UpdateAudiences

Condividi tramite