Partager via

Enregistrement d’objectif d’événement - En bloc

  • Article

Définit un objectif de conversion d’événements personnalisé qui peut être chargé et téléchargé dans un fichier en bloc.

Utilisez ce type d’objectif pour compter chaque fois qu’une personne effectue une action spécifique telle que l’abonnement à un bulletin d’informations ou le téléchargement d’un document en tant que conversion.

Vous pouvez télécharger tous les enregistrements d’objectif d’événement dans le compte en incluant la valeur DownloadEntityd’EventGoals dans la demande de service DownloadCampaignsByAccountIds ou DownloadCampaignsByCampaignIds . En outre, la demande de téléchargement doit inclure l’étendue EntityData . Pour plus d’informations sur le service en bloc, y compris les meilleures pratiques, consultez Téléchargement et chargement en bloc.

L’exemple csv en bloc suivant ajoute un nouvel objectif d’événement.

Type,Id,Attribution Model Type,Count Type,Exclude From Bidding,Goal Category,Is Enhanced Conversions Enabled,Name,Conversion Currency Code,Revenue Value,Revenue Type,Scope,UET Tag Id,Status,View Through Conversion Window In Minutes,Conversion Window In Minutes,Category Expression,Category Operator,Action Expression,Action Operator,Label Expression,Label Operator,Event Value,Event Value Operator,URL Expression,URL Operator,Minimum Duration In Second,App Platform,App Id,Minimum Pages Viewed  
Format Version,,,,,,,6.0,,,,,,,,,,,,,,,,,,,,,,  
Event Goal,,LastTouch,Unique,False,AddToCart,False,GoalA,USD,1,FixedValue,Account,123431,Active,150,367,video,Contains,buy,Contains,lb,Contains,3,Equals,,,,,,

Pour un enregistrement d’objectif d’événement, les champs d’attribut suivants sont disponibles dans le schéma de fichier en bloc.

Expression d’action

Type d’interaction utilisateur que vous souhaitez suivre. Par exemple , « play » ou « pause ».

Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément ActionOperator est également requis.

La chaîne ne peut pas dépasser la longueur maximale de 100.

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value).
Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ActionOperator et ActionExpression lors de la mise à jour, tous les paramètres ActionOperator et ActionExpression existants seront supprimés.

Opérateur d’action

Opérateur qui peut être appliqué à la valeur de l’élément ActionExpression .

Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément ActionExpression est également requis.

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value).
Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ActionOperator et ActionExpression lors de la mise à jour, tous les paramètres ActionOperator et ActionExpression existants seront supprimés.

Type de modèle d’attribution

Détermine quel modèle d’attribution, LastTouch ou LastClick, est utilisé avec un objectif de conversion.

Ajouter : facultatif
Mise à jour : facultatif

Expression de catégorie

Catégorie d’événement que vous souhaitez suivre. Par exemple, « video ».

Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément CategoryOperator est également requis.

La chaîne ne peut pas dépasser la longueur maximale de 100.

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value). Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas CategoryOperator et CategoryExpression lors de la mise à jour, tous les paramètres CategoryOperator et CategoryExpression existants sont supprimés.

Category, opérateur

Opérateur qui peut être appliqué à la valeur de l’élément CategoryExpression.

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value).
Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas CategoryOperator et CategoryExpression lors de la mise à jour, tous les paramètres CategoryOperator et CategoryExpression existants sont supprimés.

Fenêtre de conversion en minutes

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 : facultatif
Mise à jour : facultatif

Type de nombre

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 : Mise à jour facultative : facultatif

Code monétaire

Type de devise dont vous souhaitez que le chiffre d’affaires de l’objectif de conversion soit déclaré.

Pour obtenir la liste des valeurs de chaîne possibles, consultez Devises Microsoft Advertising.

Si l’élément Scope est défini sur Customer et si type estFixedValue ou VariableValue, cette propriété est obligatoire.

Ajouter: Facultatif sauf indication contraire ci-dessus.
Mettre à jour: Facultatif sauf indication contraire ci-dessus.

Valeur de l’événement

Valeur numérique associée à cet événement. Par exemple, la valeur peut être la durée pendant laquelle la vidéo a été lue.

Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément ValueOperator est également requis.

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value). Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ValueOperator et Value pendant la mise à jour, les paramètres ValueOperator et Value existants seront supprimés

Opérateur de valeur d’événement

Opérateur qui peut être appliqué à la valeur de l’élément Value .

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value). Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas ValueOperator et Value lors de la mise à jour, les paramètres ValueOperator et Value existants seront supprimés.

Exclure des enchères

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 Conversionscolonnes 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 AllConversionscolonnes 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 : facultatif
Mise à jour : facultatif

Catégorie d’objectif

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 d’événement prennent uniquement en charge la catégorie Télécharger .

Ajouter : facultatif. Si vous laissez cet élément à zéro ou vide, la catégorie par défaut est définie sur Télécharger.
Mise à jour : facultatif. Si aucune valeur n’est définie pour la mise à jour, ce paramètre n’est pas modifié.

ID

Identificateur Microsoft Advertising unique pour l’objectif de conversion.

Ajouter: En lecture seule
Mettre à jour: Lecture seule et Obligatoire

Est-ce que les conversions améliorées sont activées ?

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.

Ajouter : facultatif
Mise à jour : facultatif

Expression d’étiquette

Nom de l’élément à l’origine de l’action. Par exemple « trailer » ou « behindthescenes ».

Si cet élément est spécifié pendant une opération d’ajout ou de mise à jour, l’élément LabelOperator est également requis.

La chaîne ne peut pas dépasser la longueur maximale de 100.

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value).
Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas LabelOperator et LabelExpression lors de la mise à jour, tous les paramètres LabelOperator et LabelExpression existants seront supprimés.

Opérateur d’étiquette

Opérateur qui peut être appliqué à la valeur de l’élément LabelExpression .

Ajouter : facultatif si vous incluez un ou plusieurs des autres événements ; Vous devez inclure une ou plusieurs des paires d’opérateurs d’événement suivantes : (ActionOperator et ActionExpression), (CategoryOperator et CategoryExpression), (LabelOperator et LabelExpression), (ValueOperator et Value).
Mise à jour : facultatif si vous incluez un ou plusieurs des autres événements ; Si vous n’incluez pas LabelOperator et LabelExpression lors de la mise à jour, tous les paramètres LabelOperator et LabelExpression existants seront supprimés.

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
Mise à jour : facultatif

Type de chiffre d’affaires

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.

Ajouter : facultatif
Mise à jour : facultatif

Valeur du chiffre d’affaires

Valeur ou montant du chiffre d’affaires. Si vous affectez des valeurs à vos conversions, vous serez en mesure de voir la valeur totale générée par votre publicité pour différentes conversions, plutôt que simplement le nombre de conversions qui se sont produites.

La valeur par défaut est effectivement 0, et les valeurs possibles sont comprises entre 0 et 999 9999. Les valeurs acceptées dépendent du type de revenu. Consultez donc l’élément Type pour plus d’informations.

Ajouter : facultatif. S’il n’est pas spécifié, le type par défaut est effectivement 0.
Mise à jour : facultatif. S’il n’est pas spécifié, le type par défaut est effectivement 0.

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. Si vous avez plusieurs comptes Microsoft Advertising, vous pouvez suivre les conversions sur tous ces comptes. Si vous associez un objectif à un compte, les conversions seront suivies pour ce compte uniquement.

Pour les objectifs d’événement, 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 : facultatif
Mise à jour : facultatif

État

Définit les valeurs d’état déterminées par l’utilisateur possibles d’un objectif de conversion. Il s’agit des valeurs d’état qu’un utilisateur peut décider de définir. Par exemple, un objectif peut être défini sur Suspendu si vous ne souhaitez plus suivre les conversions pour cet objectif.

Pour connaître les valeurs d’état qui peuvent être définies par le système, consultez l’élément TrackingStatus .

Ajouter : facultatif
Mise à jour : facultatif

État du suivi

Définit les valeurs d’état possibles déterminées par le système d’un objectif de conversion. Il s’agit des valeurs d’état qui peuvent être définies par le système, par exemple, le système définit l’état sur RecordingConversions si nous avons enregistré des conversions au cours des 7 derniers jours.

Pour connaître les valeurs d’état qu’un utilisateur peut décider de définir, par exemple en définissant l’état sur Suspendu si vous ne souhaitez plus suivre les conversions pour cet objectif, consultez l’élément Status.

Ajouter : lecture seule
Mise à jour : lecture seule

Type

Type de l’objectif de conversion. Cette valeur est InStoreTransaction lorsque vous récupérez un objectif d’événement. Pour plus d’informations sur les types d’objectifs de conversion, consultez les remarques relatives à l’objet de données ConversionGoal.

Ajouter : lecture seule
Mise à jour : lecture seule

ID de balise de suivi des conversions

Identificateur Microsoft Advertising unique de la balise de suivi des conversions que vous avez ajoutée à votre site web pour permettre à Microsoft Advertising de collecter les actions que les utilisateurs effectuent sur votre site web.

Avant de prendre une dépendance sur l’ID de balise, notez que la balise de suivi des conversions peut être partagée avec ou à partir d’un autre client. Les audiences et les balises de suivi des conversions partagées sont uniquement disponibles pour les clients pilotes. Pour obtenir une vue d’ensemble du partage d’audiences et de balises de suivi des conversions dans une hiérarchie de clients, consultez le guide technique Partager les audiences et les balises de suivi des conversions.

Ajouter : obligatoire
Mise à jour : facultatif

Afficher les minutes de la fenêtre de conversion

La fenêtre de conversion d’affichage est la durée en minutes après un clic que vous souhaitez suivre pour effectuer le suivi des conversions d’affichage. Si vous définissez cette valeur sur 43 200 minutes (30 jours), les conversions d’affichage 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 43 200 minutes (30 jours).

La propriété de compte IncludeViewThroughConversions doit également être définie sur true pour que les conversions d’affichage soient suivies.

Ajouter : Mise à jour facultative : facultatif