Partager via


Objet de données InMarketAudience - Gestion des campagnes

Définit une audience sur le marché.

Remarque

Vous ne pouvez pas ajouter, mettre à jour ou supprimer une audience sur le marché à l’aide de l’API Bing Ads. Cela dit, vous pouvez ajouter et supprimer des associations et des exclusions d’audience sur le marché. Bing Ads’API retourne toujours toutes les audiences actuellement actives sur le marché. Le service ne retourne pas d’audiences sur le marché supprimées, ni aucun téléchargement delta pour voir ce qui a changé. Les audiences sur le marché retournées via Bing Ads’API sont une union de toutes les audiences disponibles sur le marché sur tous les marchés, par exemple AU, CA, DE, FR, Royaume-Uni et États-Unis. AudienceNetworkSize et SearchSize sont une somme de tailles de listes sur tous les marchés pris en charge pour une audience sur le marché donnée dans le réseau correspondant. L’API Bing Ads ne fournit pas de détails sur les tailles de liste par marché. Par exemple, la taille de l’audience « Publicité et marketing » dans le réseau de recherche peut être retournée en tant que 17070879 (17,1 M) via l’API Bing Ads. La répartition par marché indiquée dans l’application web Microsoft Advertising peut être : 2,88 M aux États-Unis ; 474 Ko en UA ; 13,7 millions au Royaume-Uni.
Vous ne devez pas prendre de dépendances sur les audiences du bac à sable sur le marché. Certaines audiences sur le marché sont disponibles dans le bac à sable, mais pas en production. Les valeurs des propriétés d’audience sur le marché peuvent également différer entre le bac à sable et la production, par exemple, le nom et la taille de l’audience.

Remarque

Cette fonctionnalité est disponible en Australie, au Canada, en France, en Allemagne, au Royaume-Uni et aux États-Unis.

Conseil

Pour obtenir une vue d’ensemble des audiences sur le marché, consultez la rubrique d’aide À propos des audiences sur le marché .

Syntaxe

<xs:complexType name="InMarketAudience" 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>

Éléments

L’objet InMarketAudience possède des éléments hérités.

Éléments hérités

Éléments hérités de l’audience

L’objet InMarketAudience dérive de l’objet Audience et hérite des éléments suivants : AudienceNetworkSize, CustomerShare, Description, ForwardCompatibilityMap, Id, MembershipDuration, Name, ParentId, Scope, SearchSize, SupportedCampaignTypes, Type. Les descriptions ci-dessous sont spécifiques à InMarketAudience et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet Audience .

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

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
long
CustomerShare Cet élément n’est pas pris en charge pour les audiences sur le marché.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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 l’objet Audience .
Tableau KeyValuePairOfstringstring
Id Identificateur Microsoft Advertising de l’audience.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
int
Nom Nom de l’audience. Le nom peut contenir un maximum de 128 caractères.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
chaîne
ParentId Identificateur Microsoft Advertising du client qui contient l’audience sur le marché.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
long
Portée L’étendue définit les comptes qui peuvent utiliser cette audience.

Pour une audience sur le marché, la seule étendue prise en charge est Client, et l’audience peut être associée à des campagnes et des groupes d’annonces dans tous les comptes du client.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
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.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
tableau de chaînes
Type Type de l’audience. Cette valeur est InMarket lorsque vous récupérez une audience sur le marché. Pour plus d’informations sur les types d’audience, consultez Les remarques sur les objets de données d’audience.

Ajouter: Non pris en charge
Mettre à jour: Non pris en charge
Type d’audience

Configuration requise

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