Partager via


Objet de données AccountProperty - Gestion des campagnes

Mappe un nom de propriété au niveau du compte à une valeur de chaîne.

Syntaxe

<xs:complexType name="AccountProperty" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="Name" type="tns:AccountPropertyName" />
    <xs:element minOccurs="0" name="Value" nillable="true" type="xs:string" />
  </xs:sequence>
</xs:complexType>

Éléments

L’objet AccountProperty contient les éléments suivants : Name, Value.

Élément Description Type de données
Nom Nom de la propriété de compte. AccountPropertyName
Valeur Valeur de la propriété de compte nommée.

La valeur varie selon le nom de la propriété de compte. Pour plus d’informations, consultez Valeurs de propriété de compte dans la section ci-dessous.
chaîne

Remarques

Valeurs des propriétés de compte

AdClickParallelTracking

Détermine si le suivi parallèle est activé.

Si vous utilisez le suivi d’URL, lorsque les clients cliquent sur votre annonce, ils doivent généralement passer par un certain nombre de redirections avant d’atteindre votre page. Il s’agit du suivi séquentiel.

Avec le suivi parallèle, lorsque les clients cliquent sur votre annonce, ils voient immédiatement votre page d’accueil. Simultanément, Microsoft Advertising exécute vos URL de suivi en arrière-plan. Ainsi, l’expérience utilisateur de vos clients est améliorée et vous bénéficiez toujours du même excellent suivi des mesures.

Vous devez avoir {lpurl} ou l’une de ses variantes dans le modèle de suivi de votre URL pour que le suivi parallèle fonctionne. Pour plus d’informations, consultez Le suivi parallèle permet aux clients d’accéder plus rapidement à votre paged’accueil et Quels paramètres de suivi ou d’URL puis-je utiliser ?.

Si l’élément Name est défini sur AdClickParallelTracking, la valeur retournée peut être true ou false. Si la valeur est true, le suivi parallèle est activé.

Importante

Le suivi parallèle est requis pour tous les comptes créés après le 31 mai 2020. Jusqu’en janvier 2021, vous pouvez activer et désactiver la fonctionnalité pour les comptes créés avant le 1er juin 2020, c’est-à-dire définir la propriété sur true ou false. À la mi-janvier 2021, tous les comptes seront activés pour le suivi parallèle, et la valeur ne peut être définie que sur true.

AllowImageAutoRetrieve

Détermine si Microsoft Advertising est autorisé à utiliser des images de votre domaine pour améliorer vos publicités sur le Réseau d’audience Microsoft.

Importante

En optant, vous acceptez que les images ou le contenu créatif récupérés à partir de la page d’accueil de l’annonceur soient du contenu « fourni par » l’annonceur en vertu de la licence d’utilisation du contenu dans le Contrat de publicité (Section 2) et que l’annonceur accepte que Microsoft puisse utiliser ce contenu pour créer automatiquement des publicités et des extensions pour lui.

Remarque

Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas, c’est bientôt disponible !

Si l’élément Name est défini sur AllowImageAutoRetrieve, la valeur value peut être définie sur true ou false. Si la valeur est true, la fonctionnalité de récupération automatique d’image est activée.

AutoApplyRecommendations

Détermine si Microsoft Advertising est autorisé à appliquer automatiquement des recommandations publicitaires destinées à vous aider à améliorer les performances publicitaires.

Avertissement

AutoApplyRecommendations dans l’API De gestion des campagnes est déconseillé à compter du 30 novembre 2022. Nous vous encourageons vivement à utiliser la nouvelle interface de gestion d’application automatique dans l’API Ad Insight.

Remarque

Tout le monde n’a pas encore cette fonctionnalité. Si ce n’est pas le cas, ne vous inquiétez pas, c’est bientôt disponible !

Nous vous informerons quand les annonces suggérées sont prêtes à être examinées. Vous trouverez des recommandations publicitaires sur la page Recommandations. Si vous n’effectuez pas d’action, nous les appliquerons automatiquement après la période de révision :

  • Annonces multimédias : 7 jours
  • Tous les autres : 14 jours

Vous pouvez modifier vos options d’application automatique à tout moment. Si vous ne choisissez pas d’appliquer automatiquement les recommandations publicitaires, vous pourrez toujours appliquer les recommandations manuellement.

Si l’élément Name est défini sur AutoApplyRecommendations, la valeur peut inclure une liste de types de recommandations.

Dans l’élément Value , la liste des paires clé/valeur est délimitée par un point-virgule (;). Dans cet exemple, l’application automatique des recommandations publicitaires est activée pour les annonces multimédias, mais pas pour les annonces de recherche réactives ou les annonces textuelles développées.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>AutoApplyRecommendations</Name>
      <Value>MultimediaAdsAutoApply=true;ResponsiveSearchAdsAutoApply=false;ExpandedTextAdsAutoApply=false</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Les paires clé/valeur par défaut sont les suivantes :

  • MultimediaAdsAutoApply=true ;
  • ResponsiveSearchAdsAutoApply=false ;
  • ExpandedTextAdsAutoApply=false ;

Si la valeur d’une clé est définie sur true, la fonctionnalité d’application automatique est activée pour le type de recommandation.

Vous pouvez choisir de définir uniquement les paires clé-valeur que vous souhaitez mettre à jour. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.

BusinessAttributes

Vous permet de mettre en évidence les valeurs métier clés destinées à vous aider à améliorer les performances publicitaires.

Les attributs métier sont facultatifs et vous pouvez choisir un ou plusieurs attributs qui s’appliquent à votre entreprise.

Si l’élément Name est défini sur BusinessAttributes, la valeur peut inclure une liste de types d’attributs.

Dans l’élément Value , la liste des attributs métier est délimitée par un point-virgule (;). Les valeurs possibles sont les suivantes : AlcoholFree, AllergyFriendly, AsianOwned, BlackOwned, CarbonNegative, CarbonNeutral, CrueltyFree, DiabeticFriendly, EcoFriendly, FamilyFriendly, FamilyOwned, GlutenFree, Halal, HearingAssistance, Kosher, LatinOwned, LocalBusiness, LGBTIFriendly, LGBTIOwned, MinorityOwned, MobilityAssistance, NoContactDelivery, Nonprofit, PetFriendly, SmallBusiness, SupportACure, SupportDiseaseResearch, Sustainable, Végétarien, Végétarien, VisualAssistance, TouchlessPickup, Unisexe, WebAccessibility, WheelchairAccessible et WomenOwned.

Dans cet exemple, les attributs professionnels sélectionnés sont sans alcool, familiales et véganes.

<SetAccountPropertiesRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
  <AccountProperties xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
    <AccountProperty>
      <Name>BusinessAttributes</Name>
      <Value>AlcoholFree;FamilyOwned;Vegan</Value>
    </AccountProperty>
  </AccountProperties>
</SetAccountPropertiesRequest>

Si l’attribut apparaît dans la propriété value, il est sélectionné ; si l’attribut n’apparaît pas dans la propriété value, il n’est pas sélectionné.

Pour supprimer les attributs métier du compte, définissez le nom sur BusinessAttributes et la valeur sur « » (chaîne vide).

Vous pouvez choisir de définir uniquement les attributs métier que vous souhaitez mettre à jour. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.

FinalUrlSuffix

Si l’élément Name est défini sur FinalUrlSuffix, la valeur représente le suffixe d’URL final de votre compte.

Le suffixe d’URL final peut inclure des paramètres de suivi qui seront ajoutés à la fin de l’URL de votre page d’accueil. Nous vous recommandons de placer les paramètres de suivi requis par votre page d’accueil dans un suffixe d’URL final afin que vos clients soient toujours envoyés à votre page d’accueil. Pour plus d’informations et les règles de validation, consultez Suffixe d’URL final dans les guides techniques.

Pour supprimer le suffixe d’URL final du compte, définissez le nom sur FinalUrlSuffix et la valeursur « » (chaîne vide).

IncludeViewThroughConversions

Détermine si vous souhaitez inclure des conversions d’affichage pour les campagnes dans le compte.

Les conversions d’affichage sont des conversions effectuées par des personnes après avoir vu votre annonce, même si elles n’ont pas cliqué sur la publicité.

Si l’élément Name est défini sur IncludeViewThroughConversions, la valeur value peut être définie sur true ou false. Si la valeur est true, les conversions d’affichage sont incluses. Par défaut, si vous êtes dans le pilote de fonctionnalités (GetCustomerPilotFeatures renvoie 616), cette propriété a la valeur true, ce qui signifie que les valeurs dans les colonnes de conversions « Toutes » de vos rapports de performances incluent les conversions en mode affichage. Vous pouvez choisir de le désactiver si vous ne souhaitez pas inclure les conversions d’affichage.

Remarque

Les conversions d’affichage nécessitent un UETTag. Par conséquent, cette propriété n’est pas applicable pour AppInstallGoal, InStoreTransactionGoal et OfflineConversionGoal.

MSCLKIDAutoTaggingEnabled

Détermine si l’étiquetage automatique du paramètre de chaîne de requête MSCLKID est activé. Le MSCLKID est un GUID de 32 caractères qui est unique pour chaque clic publicitaire.

Si l’élément Name est défini sur MSCLKIDAutoTaggingEnabled, la valeur value peut être définie sur true ou false. Si la valeur est true, la fonctionnalité d’étiquetage automatique MSCLKID est activée. Vous souhaiterez peut-être activer l’étiquetage automatique de MSCLKID pour le suivi des prospects via des objectifs de conversion hors connexion. Si l’étiquetage automatique de MSCLKID est activé, le MSCLKID est automatiquement ajouté à l’URL de la page d’accueil lorsqu’un client clique sur votre annonce. Par exemple, www.contoso.com/?msclkid={msclkid}. L’ID de clic est unique pour chaque clic publicitaire et plusieurs clics sur la même annonce du même utilisateur entraînent plusieurs ID de clic.

Importante

La valeur MSCLKIDAutoTaggingEnabled est définie sur true par défaut lors de la création d’un compte. Vous pouvez désactiver manuellement le cas échéant. Chaque fois que vous ajoutez ou mettez à jour un nouveau DurationGoal, EventGoal, OfflineConversionGoal, PagesViewedPerVisitGoal ou UrlGoal via l’application web Microsoft Advertising ou l’API De gestion des campagnes, la valeur MSCLKIDAutoTaggingEnabled de la propriété AccountProperty correspondante est définie automatiquement sur true . Si l’étendue de l’objectif est définie au niveau du client , la propriété AccountProperty de tous les comptes existants sous le client est définie.

ProfileExpansionEnabled

Détermine s’il faut développer le ciblage de profil LinkedIn sur votre compte pour atteindre des clients supplémentaires similaires à ceux que vous ciblez actuellement.

L’activation de l’expansion du ciblage de profil permet à Microsoft Advertising de montrer vos annonces à d’autres clients similaires à ceux que vous ciblez actuellement. Par exemple, si vous ciblez un segment d’audience LinkedIn spécifique, nous ciblerons également les utilisateurs Bing qui n’ont pas de compte LinkedIn confirmé, mais qui partagent les mêmes caractéristiques que les utilisateurs LinkedIn dans ce segment.

Si l’élément Name est défini sur ProfileExpansionEnabled, la valeur value peut être définie sur true ou false. Si la valeur est true, la fonctionnalité d’extension de ciblage de profil LinkedIn est activée.

TrackingUrlTemplate

Si l’élément Name est défini sur TrackingUrlTemplate, la valeur représente le modèle de suivi de votre compte à utiliser par défaut pour toutes les URL de votre compte. La valeur de la clé TrackingUrlTemplate peut être définie sur n’importe quelle chaîne valide, comme décrit ci-dessous.

  • Les modèles de suivi définis pour les entités de niveau inférieur, par exemple, les mot clé remplacent ceux définis pour les entités de niveau supérieur, par exemple la campagne. Pour plus d’informations, consultez Limites d’entité.

  • La longueur du modèle de suivi est limitée à 2 048 caractères. La chaîne de protocole HTTP ou HTTPS compte pour la limite de 2 048 caractères.

  • Le modèle de suivi doit être une URL bien formée commençant par l’une des suivantes : http://, https://, {lpurl} ou {unscapedlpurl}.

  • Vous devez inclure au moins l’un des paramètres d’URL de page d’accueil suivants : {lpurl}, {lpurl+2}, {lpurl+3}, {unscapedlpurl}, {escapedlpurl}. En outre, vous pouvez utiliser n’importe quel paramètre dynamique pris en charge par Microsoft Advertising. Pour obtenir la liste des paramètres pris en charge, consultez les sections Paramètres disponibles dans l’article d’aide de Microsoft Advertising Configurer un modèle de suivi.

  • Microsoft Advertising ne vérifie pas s’il existe des paramètres personnalisés. Si vous utilisez des paramètres personnalisés dans votre modèle de suivi et qu’ils n’existent pas, l’URL finale inclut les espaces réservés de clé et de valeur de vos paramètres personnalisés sans substitution. Par exemple, si votre modèle de suivi est par exemple https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl}, et que ni {_season} ni {_promocode} n’est défini au niveau de la campagne, du groupe d’annonces, du mot clé ou de la publicité, l’URL finale sera la même.

Pour supprimer le modèle de suivi du compte, définissez le nom sur TrackingUrlTemplate et la valeursur « » (chaîne vide).

Configuration requise

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

Utilisé par

GetAccountProperties
SetAccountProperties