Objet de données InStoreTransactionGoal - Gestion des campagnes

Article
11/13/2024

Définit un objectif de transaction en magasin.

Les transactions en magasin donnent aux annonceurs une vue holistique du retour sur les dépenses publicitaires. Vous pouvez observer comment des comptes et des campagnes Microsoft Advertising spécifiques favorisent les achats hors connexion.

Remarque

Les objectifs de transaction en magasin ne sont disponibles que pour les clients pilotes alpha. Un seul objectif de transaction en magasin peut être créé par client.

<xs:complexType name="InStoreTransactionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence />
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

{
  "AttributionModelType": "ValueHere",
  "ConversionWindowInMinutes": IntValueHere,
  "CountType": "ValueHere",
  "ExcludeFromBidding": "ValueHere",
  "GoalCategory": "ValueHere",
  "Id": "LongValueHere",
  "IsEnhancedConversionsEnabled": "ValueHere",
  "Name": "ValueHere",
  "Revenue": {
    "CurrencyCode": "ValueHere",
    "Type": "ValueHere",
    "Value": DecimalValueHere
  },
  "Scope": "ValueHere",
  "Status": "ValueHere",
  "TagId": "LongValueHere",
  "TrackingStatus": "ValueHere",
  "Type": "InStoreTransaction",
  "ViewThroughConversionWindowInMinutes": IntValueHere
}

Éléments

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

Éléments hérités

Éléments hérités de ConversionGoal

L’objet InStoreTransactionGoal dérive de l’objet ConversionGoal et hérite des éléments suivants : AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes. Les descriptions ci-dessous sont spécifiques à InStoreTransactionGoal et peuvent ne pas s’appliquer à d’autres objets qui héritent des mêmes éléments de l’objet ConversionGoal .

Élément	Description	Type de données
AttributionModelType	Non applicable aux objectifs de transaction en magasin.	AttributionModelType
ConversionWindowInMinutes	La fenêtre de conversion correspond à la durée, en minutes, après un clic, que vous souhaitez suivre. Si vous définissez cette valeur sur 43200 minutes (30 jours), les conversions qui se produisent dans les 30 jours suivant un clic sont suivies. Les conversions passées ne sont pas affectées. La valeur minimale prise en charge est de 1 minute, mais gardez à l’esprit qu’une fenêtre de conversion plus courte réduit le nombre de conversions que votre compte enregistre. La valeur maximale prise en charge est de 129600 minutes (90 jours). Ajouter: Optionnel Mettre à jour: Optionnel	int
CountType	Cela détermine la façon dont vos conversions sont enregistrées dans la fenêtre de conversion choisie. Il existe deux choix, et si vous ne définissez pas de valeur, la valeur par défaut est All : - Tout : toutes les conversions qui se produisent après un clic publicitaire seront comptabilisées. Il s’agit d’un choix courant pour les ventes. - Unique : une seule conversion qui se produit après un clic sur une annonce sera comptabilisée. Il s’agit d’un choix courant pour les prospects. Par exemple : vous effectuez le suivi de deux conversions : les prospects et les ventes. Vous choisissez Unique pour les prospects et Tous pour les ventes. Lorsqu’un clic publicitaire se transforme en deux prospects et deux ventes, il est compté comme trois conversions : une pour le prospect unique et deux pour toutes les ventes. Ajouter: Optionnel Mettre à jour: Optionnel	ConversionGoalCountType
ExcludeFromBidding	Détermine s’il faut ou non exclure des données liées à cet objectif de conversion d’un sous-ensemble de colonnes de rapport de performances. Cet élément est disponible uniquement pour les clients qui sont activés pour la fonctionnalité Inclure dans les conversions (GetCustomerPilotFeatures renvoie la valeur 574). Si cet élément a la valeur true, les données associées à cet objectif de conversion sont exclues des `Conversions`colonnes de rapport , `ConversionRateCostPerConversion`, `ReturnOnAdSpend`, `RevenuePerConversion`, et `Revenue` . En outre, si vous utilisez une stratégie d’enchère automatisée, la définition de cette propriété true entraîne la non-prise en compte des conversions de l’objectif en calculs d’enchères automatisés. Définir cette propriété « true » revient en fait à décocher « Inclure dans les conversions » dans l’application web Microsoft Advertising. Quelle que soit la valeur de cet élément, les `AllConversions`colonnes de rapport , `AllConversionRateAllCostPerConversion`, `AllReturnOnAdSpend`, `AllRevenuePerConversion`, et `AllRevenue` incluent des données pour tous les objectifs de conversion. Par défaut, cet élément est false et les données liées à cet objectif de conversion sont incluses dans toutes les colonnes de rapport. Pour plus d’informations, consultez Attributs de rapport et statistiques de performances et l’article d’aide Objectifs de conversion : « Conversions » et « Toutes les conversions ». Ajouter: Optionnel Mettre à jour: Optionnel	boolean
GoalCategory	Catégorie utilisée pour segmenter l’objectif de conversion. Catégoriser vos objectifs de conversion est toutefois judicieux pour votre entreprise. Les catégories d’objectifs n’affectent pas les performances : elles sont là pour vous aider à segmenter vos objectifs et leurs métriques de performances. Les valeurs de catégorie prises en charge varient selon le type d’objectif de conversion. Les objectifs de transaction en magasin prennent uniquement en charge la catégorie Achat . Ajouter: Optionnel. Si vous laissez cet élément nul ou vide, la catégorie par défaut est définie sur Purchase. Mettre à jour: Optionnel. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.	ConversionGoalCategory
Id	Identificateur Microsoft Advertising unique pour l’objectif de conversion. Ajouter: En lecture seule Mettre à jour: Obligatoire et Read-Only	long
IsEnhancedConversionsEnabled	Détermine si les conversions améliorées sont activées pour un objectif de conversion. Remarque : Pour créer un objectif de conversion amélioré et définir `isEnhancedConversionsEnabled=true`, vous devez créer un objectif de conversion pour le compte via l’interface utilisateur Microsoft Advertising avec le paramètre de conversion amélioré sélectionné et la case associée cochée.	boolean
Nom	Nom de l’objectif de conversion. La longueur maximale du nom est de 100 et le nom doit être unique parmi tous les objectifs de conversion appartenant au même client. Ajouter: Obligatoire Mettre à jour: Optionnel	chaîne
Revenu	Détermine la valeur de chaque conversion pour votre entreprise. Lorsque vous ajoutez un objectif de conversion si vous ne spécifiez pas de préférences de suivi des revenus, chaque ConversionGoalRevenue est défini sur leurs valeurs par défaut respectives. Lors de la mise à jour d’un objectif de conversion, si l’élément Revenue est nul ou vide, aucune des propriétés imbriquées n’est mise à jour. Toutefois, si cet élément n’est pas nul ou vide, vous remplacez efficacement toutes les propriétés de revenu existantes. Vous devez spécifier le CurrencyCode ConversionGoalRevenue lors de l’ajout ou de la mise à jour d’un objectif de transaction en magasin. Ajouter: Optionnel Mettre à jour: Optionnel	ConversionGoalRevenue
Portée	Détermine si l’objectif s’applique à tous les comptes ou uniquement au compte spécifié dans l’élément d’en-tête CustomerAccountId requis. Pour les objectifs de transaction en magasin, l’étendue au niveau du compte n’est pas prise en charge. Vous pouvez définir cet élément sur Customer ou le laisser nul. Si elle n’est pas spécifiée, l’étendue est définie sur Client par défaut. Ajouter: Optionnel Mettre à jour: Optionnel	EntityScope
Statut	Définit les valeurs de status d’un objectif de conversion déterminées par l’utilisateur. Il s’agit des valeurs status qu’un utilisateur peut décider de définir. Par exemple, un objectif peut être défini sur Paused si vous ne souhaitez plus suivre les conversions pour cet objectif. Pour status valeurs qui peuvent être définies par le système, consultez l’élément TrackingStatus. Ajouter: Optionnel Mettre à jour: Optionnel	ConversionGoalStatus
TagId	Non applicable aux objectifs de transaction en magasin.	long
TrackingStatus	Non applicable aux objectifs de transaction en magasin.	ConversionGoalTrackingStatus
Type	Type de l’objectif de conversion. Cette valeur est InStoreTransaction lorsque vous récupérez un objectif de transaction dans le magasin. Pour plus d’informations sur les types d’objectifs de conversion, consultez les remarques relatives à l’objet de données ConversionGoal. Ajouter: En lecture seule Mettre à jour: En lecture seule	ConversionGoalType
ViewThroughConversionWindowInMinutes	Non applicable aux objectifs de transaction en magasin.	int

Configuration requise

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

Partager via