Objet de données OfflineConversionGoal - Gestion des campagnes

Article
12/21/2023

Définit un objectif de conversion hors connexion. Utilisez ce type d’objectif si vous avez la génération de prospects comme objectif. La génération de prospects est lorsque les clients potentiels remplissent un formulaire ou un devis d’intérêt, puis que la vente est effectuée hors connexion en personne ou par téléphone (par exemple, achat de voiture, devis d’assurance, hypothèques, etc.).

Pour configurer le suivi des conversions hors connexion, créez un OfflineConversionGoal, patientez deux heures, puis envoyez à Microsoft Advertising les données OfflineConversion via l’opération ApplyOfflineConversions .

Importante

Vous devez créer OfflineConversionGoal via l’API Gestion des campagnes pour définir la propriété IsExternallyAttributed .

Conseil

Pour plus d’informations, consultez Suivi des conversions hors connexion.

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="OfflineConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="IsExternallyAttributed" nillable="true" type="xs:boolean">
          <xs:annotation>
            <xs:appinfo>
              <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
            </xs:appinfo>
          </xs:annotation>
        </xs:element>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Éléments

L’objet OfflineConversionGoal contient les éléments suivants : IsExternallyAttributed.

Élément	Description	Type de données
IsExternallyAttributed	Cela détermine si votre objectif de conversion hors connexion utilise votre propre modèle d’attribution et vous permet d’importer un crédit fractionnaire pour chaque MSCLKID. Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur IsExternallyAttributed dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetConversionGoalsByIds et GetConversionGoalsByTagIds . Remarque : Vous pouvez uniquement définir IsExternallyAttributed via l’API De gestion des campagnes. Ajouter: Optionnel Mettre à jour: Optionnel	boolean

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

Éléments hérités

Éléments hérités de ConversionGoal

L’objet OfflineConversionGoal 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 à OfflineConversionGoal 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 conversion hors connexion.	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 par défaut est 43200. 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 avec des durées de conversion hors connexion différentes qui se produisent après un clic publicitaire seront comptabilisées. Il s’agit d’un choix courant pour les ventes. - Unique : seule la première conversion qui se produit après un clic publicitaire est 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. Les conversions hors connexion dupliquées avec les mêmes MicrosoftClickId et ConversionTime seront ignorées. En d’autres termes, seule la première conversion hors connexion pour un MicrosoftClickId et un ConversionTime donnés sont comptés. 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 conversion hors connexion 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. Si le type de revenu est FixedValue ou VariableValue, les éléments ConversionCurrencyCode et ConversionValue des données OfflineConversion appliquées sont prioritaires sur le code et la valeur monétaires ConversionGoalRevenue . 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. 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. Si elle n’est pas spécifiée, l’étendue est définie sur Compte par défaut. Mettre à jour: En lecture seule. Vous ne pouvez pas mettre à jour l’étendue de l’objectif de conversion hors connexion.	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 conversion hors connexion.	Long
TrackingStatus	Non applicable aux objectifs de conversion hors connexion.	ConversionGoalTrackingStatus
Type	Type de l’objectif de conversion. Cette valeur est OfflineConversion lorsque vous récupérez un objectif de conversion hors connexion. 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 conversion hors connexion.	int

Configuration requise

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

Partager via