Objet de données CombinedList - Gestion des campagnes

Article
11/13/2024

Une liste combinée est une audience créée à partir d’une combinaison de plusieurs audiences existantes.

Vous pouvez combiner des audiences personnalisées, des listes de clients, des audiences de produits, des audiences similaires et des listes de remarketing. Vous ne pouvez pas inclure d’autres listes combinées ou audiences sur le marché dans une liste combinée.

Vous pouvez créer un maximum de 1 000 listes combinées par compte publicitaire et jusqu’à 5 000 par client. Chaque liste peut inclure jusqu’à 100 règles de combinaison ou ensembles de conditions logiques, et chaque combinationRule peut contenir jusqu’à 100 ID d’audience.

Conseil

Pour obtenir une vue d’ensemble et plus d’informations sur les audiences, consultez le guide technique des API d’audience .

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

{
  "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": "CombinedList",
  "CombinationRules": [
    {
      "AudienceIds": [
        "LongValueHere"
      ],
      "Operator": "ValueHere"
    }
  ]
}

Éléments

L’objet CombinedList contient les éléments suivants : CombinationRules.

Élément	Description	Type de données
CombinationRules	Conditions logiques utilisées pour déterminer qui ajouter à votre liste combinée. Chaque liste peut inclure jusqu’à 100 règles de combinaison ou ensembles de conditions logiques, et chaque combinationRule peut contenir jusqu’à 100 ID d’audience. Pour plus d’informations, consultez les remarques sur la règle combinée. Ajouter: Obligatoire Mettre à jour: Obligatoire. Si vous souhaitez conserver l’une des règles précédentes, vous devez les définir explicitement à nouveau lors de la mise à jour.	Tableau CombinationRule

L’objet CombinedList contient des éléments hérités.

Éléments hérités

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

L’objet CombinedList 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 à CombinedList 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: En lecture seule Mettre à jour: En lecture seule	long
CustomerShare	Cet élément n’est pas pris en charge pour les audiences de liste combinée. 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: Optionnel Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	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: En lecture seule Mettre à jour: Obligatoire et en lecture seule	long
MembershipDuration	Cet élément n’est pas pris en charge pour les audiences de liste combinée. 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: Obligatoire 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 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. Ajouter: Obligatoire Mettre à jour: En lecture seule. Vous ne pouvez pas modifier l’ID parent.	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. Ajouter: Obligatoire Mettre à jour: Optionnel. Vous pouvez modifier l’étendue de Compte en Client, mais vous ne pouvez pas modifier l’étendue de Client à Compte.	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 ajoutez ou mettez à jour la durée d’appartenance à la liste combinée, la règle ou l’identificateur de balise. Cette propriété est nulle ou vide si la balise de suivi des conversions associée à la liste combinée a un status non vérifié ou inactif, car la liste combinée ne peut pas recevoir les informations client de votre site web dont elle a besoin pour créer la liste. Ajouter: En lecture seule 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: En lecture seule Mettre à jour: En lecture seule	tableau de chaînes
Type	Type de l’audience. Cette valeur est CombinedList lorsque vous récupérez une audience de liste combinée. Pour plus d’informations sur les types d’audience, consultez Les remarques sur les objets de données d’audience. Ajouter: En lecture seule Mettre à jour: En lecture seule	Type d’audience

Configuration requise

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

Partager via