Objet de données CustomAudience - Gestion des campagnes

Article
11/13/2024

Définit une audience personnalisée.

Remarque

Seules les mises à jour du nom et de la description sont prises en charge. Vous pouvez supprimer mais ne pouvez pas ajouter une audience personnalisée à l’aide de l’API Bing Ads. Cela dit, vous pouvez ajouter et supprimer des associations et des exclusions d’audience personnalisées.

Une audience personnalisée est un type de liste de remarketing qui est généré à l’aide de vos propres données client pour créer des segments d’utilisateurs plus riches. Vous pouvez utiliser des audiences personnalisées conjointement avec vos listes de remarketing, généralement par le biais de votre fournisseur de gestion des données (DMP). Lorsque votre DMP se connecte à notre fonctionnalité d’audience personnalisée, vous pouvez importer vos audiences personnalisées dans Microsoft Advertising pour le remarketing de recherche. Vous pouvez utiliser des audiences personnalisées séparément du remarketing, sans aucun suivi de suivi des conversions.

Conseil

Pour obtenir une vue d’ensemble des audiences personnalisées, consultez la rubrique d’aide À propos des audiences personnalisées .

<xs:complexType name="CustomAudience" 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": "Custom"
}

Éléments

L’objet CustomAudience a des éléments hérités.

Éléments hérités

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

L’objet CustomAudience 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 à CustomAudience 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. L’audience doit avoir au moins 300 personnes avant que Microsoft Advertising ne l’utilise pour les optimisations. Ajouter: Non pris en charge Mettre à jour: En lecture seule	long
CustomerShare	Cet élément n’est pas pris en charge pour les audiences personnalisées. 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: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié. Pour supprimer le paramètre précédent, définissez cet elemment sur une valeur de chaîne vide (« »).	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: Obligatoire et en lecture seule	long
MembershipDuration	La durée d’appartenance détermine à quel moment Microsoft Advertising doit rechercher les actions qui correspondent à votre définition d’audience personnalisée afin d’ajouter des personnes à votre liste. Pour un public personnalisé, la durée d’appartenance n’est pas définie dans l’application web Microsoft Advertising, et Microsoft Advertising s’en remet aux paramètres de votre fournisseur d’audience personnalisé. Lorsque vous demandez l’audience personnalisée via l’API Bing Ads, la durée d’appartenance retournée est null. 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: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	chaîne
ParentId	Identificateur Microsoft Advertising du client qui contient l’audience personnalisée. 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 personnalisée, la seule étendue prise en charge est Customer, 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. L’audience doit avoir au moins 300 personnes avant que Microsoft Advertising ne l’utilise pour les optimisations. Cette propriété sera nulle ou vide pendant jusqu’à 24 heures pendant la génération de l’audience, par exemple si vous avez importé de nouvelles audiences personnalisées à partir de DMP, la génération de l’audience prend 24 heures et, en attendant, cette propriété sera nulle ou vide. Ajouter: Non pris en charge Mettre à jour: En lecture seule	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: En lecture seule	tableau de chaînes
Type	Type de l’audience. Cette valeur est Personnalisée lorsque vous récupérez une audience personnalisée. 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: En lecture seule	Type d’audience

Configuration requise

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

Partager via