Objet de données EventGoal - Gestion des campagnes

Article
12/21/2023

Définit un objectif de conversion d’événement personnalisé.

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.

Par défaut, la balise de suivi des conversions enregistre les visites des utilisateurs sur les pages de votre site web, ce qui permet à Microsoft Advertising de prendre en charge des types d’objectifs tels que UrlGoal, DurationGoal et PagesViewedPerVisitGoal. Toutefois, vous pouvez effectuer le suivi d’autres types d’événements, tels que l’abonnement à un bulletin d’informations ou le téléchargement d’un document. Microsoft Advertising active ce scénario avec EventGoal. En plus de créer un EventGoal, vous devez personnaliser votre code de suivi de balise de suivi des conversions pour signaler les valeurs d’un ou plusieurs des paramètres d’événement personnalisés. Pour plus d’informations, consultez Comment signaler des événements personnalisés avec le suivi des conversions.

Conseil

Pour obtenir une vue d’ensemble de l’implémentation, consultez le guide technique du suivi des événements universels .

Importante

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 sous le client est définie.

Syntaxe

<xs:complexType name="EventGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="ActionExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="ActionOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="CategoryExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="CategoryOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="LabelExpression" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="LabelOperator" nillable="true" type="tns:ExpressionOperator" />
        <xs:element minOccurs="0" name="Value" nillable="true" type="xs:decimal" />
        <xs:element minOccurs="0" name="ValueOperator" nillable="true" type="tns:ValueOperator" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet EventGoal contient les éléments suivants : ActionExpression, ActionOperator, CategoryExpression, CategoryOperator, LabelExpression, LabelOperator, Value, ValueOperator.

Élément	Description	Type de données
ActionExpression	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). Mettre à 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.	chaîne
ActionOperator	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). Mettre à 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.	ExpressionOperator
CategoryExpression	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). Mettre à 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.	chaîne
CategoryOperator	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). Mettre à 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.	ExpressionOperator
LabelExpression	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). Mettre à 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.	chaîne
LabelOperator	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). Mettre à 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.	ExpressionOperator
Valeur	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). Mettre à 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	Decimales
ValueOperator	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). Mettre à 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.	ValueOperator

L’objet EventGoal possède des éléments hérités.

Éléments hérités

Éléments hérités de ConversionGoal

L’objet EventGoal 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 à EventGoal 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	Détermine quel modèle d’attribution, LastTouch ou LastClick, est utilisé avec un objectif de conversion.	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 d’événement prennent en charge les catégories AddToCart, BeginCheckout, BookAppointment, Contact, GetDirections, Other, OutboundClick, PageView, Purchase, RequestQuote, Signup, SubmitLeadForm et Subscribe . Ajouter: Obligatoire à compter de juin 2021. Auparavant, si vous aviez laissé cet élément à zéro ou vide, la catégorie par défaut était définie sur Aucun. Mettre à jour: Facultatif si l’objectif de conversion a déjà une catégorie définie autre que None. 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
Revenus	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: 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. 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. Les valeurs possibles sont Compte et Client. Si elle n’est pas spécifiée, l’étendue est définie sur Client par défaut. Une fois que vous avez défini l’étendue, vous ne pouvez pas la modifier. Si vous souhaitez modifier l’étendue, vous devez créer un nouvel objectif de conversion et suspendre l’ancien. 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, par exemple si la balise de suivi des conversions est vérifiée ou non, consultez l’élément TrackingStatus. Ajouter: Optionnel Mettre à jour: Optionnel	ConversionGoalStatus
TagId	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 Mettre à jour: Optionnel	Long
TrackingStatus	Définit les valeurs de status possibles déterminées par le système d’un objectif de conversion. Il s’agit des valeurs status qui peuvent être définies par le système, par exemple, le système définit l’status sur TagUnverified si la balise de suivi des conversions n’a pas encore été vérifiée. Pour status valeurs qu’un utilisateur peut décider de définir, par exemple en définissant le status sur Suspendu si vous ne souhaitez plus suivre les conversions pour cet objectif, consultez l’élément Status. Ajouter: En lecture seule Mettre à jour: En lecture seule	ConversionGoalTrackingStatus
Type	Type de l’objectif de conversion. Cette valeur est Event 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: En lecture seule Mettre à jour: En lecture seule	ConversionGoalType
ViewThroughConversionWindowInMinutes	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. Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur ViewThroughConversionWindowInMinutes dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetConversionGoalsByIds et GetConversionGoalsByTagIds . Ajouter: Optionnel Mettre à jour: Optionnel	int

Configuration requise

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

Partager via