Objet de données ImpressionBasedRemarketingList - Gestion des campagnes

Article
11/13/2024

Définit un objet de données pour ImpressionBasedRemarketingList.

Syntaxe

XML
JSON

<xs:complexType name="ImpressionBasedRemarketingList" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Audience">
      <xs:sequence>
        <xs:element minOccurs="0" name="AdGroupId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="CampaignId" nillable="true" type="xs:long" />
        <xs:element minOccurs="0" name="EntityType" type="tns:ImpressionBasedEntityType" />
      </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": "ImpressionBasedRemarketingList",
  "AdGroupId": "LongValueHere",
  "CampaignId": "LongValueHere",
  "EntityType": "ValueHere"
}

Éléments

L’objet ImpressionBasedRemarketingList contient les éléments suivants : AdGroupId, CampaignId, EntityType.

Élément	Description	Type de données
AdGroupId	Identificateur de groupe d’annonces à associer à la liste de remarketing basée sur l’impression. Remarque : l’AdGroupId a la valeur Null pour une liste de remarketing basée sur l’impression avec des utilisateurs qui ont consulté une publicité dans le cadre d’une campagne.	long
CampaignId	Identificateur de campagne à associer à la liste de remarketing basée sur l’impression.	long
EntityType	Type d’entité d’une liste de remarketing basée sur l’impression.	ImpressionBasedEntityType

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

Éléments hérités

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

L’objet ImpressionBasedRemarketingList 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 à ImpressionBasedRemarketingList 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