Objet de données d’audience - Gestion des campagnes

Article
11/13/2024

Définit l’objet de base d’une audience.

N’essayez pas d’instancier une audience. Vous pouvez créer un ou plusieurs des objets suivants qui en dérivent.

Remarque

Microsoft Advertising génère automatiquement des audiences similaires pour les listes de remarketing pour les participants pilotes, c’est-à-dire que GetCustomerPilotFeatures retourne l’identificateur de fonctionnalité 317.

Syntaxe

<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:q124="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q124: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:q125="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="SupportedCampaignTypes" nillable="true" type="q125:ArrayOfstring" />
    <xs:element minOccurs="0" name="Type" type="tns:AudienceType" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet Audience a les éléments suivants : AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type.

Élément	Description	Type de données
AudienceNetworkSize	Nombre total de personnes qui sont des membres actifs de cette audience dans le réseau Audience. Cela vous donne une idée du nombre d’utilisateurs du réseau Audience que vous pouvez cibler. Consultez plus d’informations dans la documentation pour les objets qui héritent de cet élément, par exemple , RemarketingList.	long
CustomerShare	Détermine la liste des clients et des comptes qui partagent l’audience. Les détails incluent le nombre d’associations d’audiences. Cet élément n’est pris en charge qu’avec un RemarketingList. Les audiences d’autres types ne peuvent pas être partagées dans la hiérarchie du client.	CustomerShare
Description	Description de l’audience. Utilisez une description pour vous aider à vous souvenir de l’audience que vous ciblez. La description peut contenir un maximum de 1 024 caractères.	chaîne
ForwardCompatibilityMap	Liste des chaînes de clé et de valeur pour la compatibilité avant afin d’éviter les changements cassants lorsque de nouveaux éléments sont ajoutés dans la version actuelle de l’API. Les modifications de compatibilité avant seront notées ici dans les versions ultérieures. Il n’existe actuellement aucune modification de compatibilité avant pour cet objet.	Tableau KeyValuePairOfstringstring
Id	Identificateur Microsoft Advertising de l’audience.	long
MembershipDuration	Lorsque vous créez une audience, vous pouvez spécifier dans quelle mesure Microsoft Advertising doit rechercher les actions qui correspondent à votre définition d’audience. La durée minimale est de 1 jour et la durée maximale autorisée est de 180 jours.	int
Nom	Nom de l’audience. Le nom peut contenir un maximum de 128 caractères.	chaîne
ParentId	Identificateur Microsoft Advertising du compte ou du client. Si l’étendue est définie sur Compte, il s’agit de l’ID de compte et, sinon, il s’agit de l’ID client.	long
Portée	L’étendue définit les comptes qui peuvent utiliser cette audience. Si l’étendue est définie sur Compte, l’audience ne peut être associée qu’à des campagnes et des groupes d’annonces dans un seul compte, c’est-à-dire via le ParentId. Si l’étendue est définie sur Client, l’audience peut être associée à des campagnes et des groupes d’annonces dans tous les comptes du client.	EntityScope
SearchSize	Nombre total de personnes qui sont des membres actifs de cette audience dans le réseau de recherche. Cela vous donne une idée du nombre d’utilisateurs de recherche que vous pouvez cibler. Consultez plus d’informations dans la documentation pour les objets qui héritent de cet élément, par exemple , RemarketingList.	long
SupportedCampaignTypes	Liste des types de campagne qui prennent en charge cette audience. Les valeurs prises en charge sont Audience, DynamicSearchAds, Search et Shopping. De nouveaux types de campagne peuvent être ajoutés à l’avenir. Vous ne devez donc pas dépendre d’un ensemble fixe de valeurs.	tableau de chaînes
Type	Type de l’audience. Pour plus d’informations sur les types d’audience, consultez les remarques.	Type d’audience

Remarques

Pour Java et les langages .NET, ne définissez pas l’élément Type , car la valeur est déterminée par l’instanciation d’une audience personnalisée ou d’un autre type d’audience. Si vous générez manuellement le soap, utilisez l’attribut type du nœud Audience , comme indiqué dans l’exemple suivant.

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

Configuration requise

Service : CampaignManagementService.svc v13
Espace de noms: https://bingads.microsoft.com/CampaignManagement/v13

Utilisé par

AddAudiences
GetAudiencesByIds
UpdateAudiences

Partager via