Objet de données ConversionGoal - Gestion des campagnes

Article
12/21/2023

Définit l’objet de base d’un objectif de conversion.

N’essayez pas d’instancier un Objet ConversionGoal. Vous pouvez créer un ou plusieurs des objets suivants qui en dérivent.

Syntaxe

<xs:complexType name="ConversionGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AttributionModelType" nillable="true" type="tns:AttributionModelType">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ConversionWindowInMinutes" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="CountType" nillable="true" type="tns:ConversionGoalCountType" />
    <xs:element minOccurs="0" name="ExcludeFromBidding" nillable="true" type="xs:boolean" />
    <xs:element minOccurs="0" name="GoalCategory" nillable="true" type="tns:ConversionGoalCategory">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsEnhancedConversionsEnabled" 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:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Revenue" nillable="true" type="tns:ConversionGoalRevenue" />
    <xs:element minOccurs="0" name="Scope" nillable="true" type="tns:EntityScope" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:ConversionGoalStatus" />
    <xs:element minOccurs="0" name="TagId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="TrackingStatus" nillable="true" type="tns:ConversionGoalTrackingStatus" />
    <xs:element minOccurs="0" name="Type" nillable="true" type="tns:ConversionGoalType" />
    <xs:element minOccurs="0" name="ViewThroughConversionWindowInMinutes" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Éléments

L’objet ConversionGoal contient les éléments suivants : AttributionModelType, ConversionWindowInMinutes, CountType, ExcludeFromBidding, GoalCategory, Id, IsEnhancedConversionsEnabled, Name, Revenue, Scope, Status, TagId, TrackingStatus, Type, ViewThroughConversionWindowInMinutes.

É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. Cet élément n’est pas retourné par défaut. Pour obtenir cet élément, incluez la valeur AttributionModelType dans l’élément ReturnAdditionalFields lorsque vous appelez les opérations de service GetConversionGoalsByIds et GetConversionGoalsByTagIds . Cet élément n’est pas applicable à AppInstallGoal, InStoreTransactionGoal et OfflineConversionGoal.	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).	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. Cet élément n’est pas applicable à AppInstallGoal.	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 ».	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. Reportez-vous donc à la page de référence correspondante pour connaître les exigences détaillées.	ConversionGoalCategory
ID	Identificateur Microsoft Advertising unique pour l’objectif de conversion.	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.	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. L’option VariableValue n’est pas disponible pour AppInstallGoal, DurationGoal ou PagesViewedPerVisitGoal.	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. Seule l’étendue Client est prise en charge pour AppInstallGoal.	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.	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. Cet élément n’est pas applicable à AppInstallGoal, InStoreTransactionGoal et OfflineConversionGoal.	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. Seuls les états NoRecentConversions et RecordingConversions sont applicables pour AppInstallGoal et OfflineConversionGoal.	ConversionGoalTrackingStatus
Type	Type de l’objectif de conversion. Pour plus d’informations sur les types d’objectifs de conversion, consultez les remarques.	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 . Cet élément n’est pas applicable à AppInstallGoal, InStoreTransactionGoal et OfflineConversionGoal.	int

Remarques

Pour Java et les langages .NET, ne définissez pas l’élément Type , car la valeur est déterminée par le type d’objectif de conversion que vous instanciez.

Si vous générez manuellement le soap, utilisez l’attribut type du <ConversionGoal> nœud, comme indiqué dans l’exemple suivant, pour spécifier le type de l’objectif de conversion.

<ConversionGoals i:nil="false">
  <ConversionGoal i:type="UrlGoal">
    <ConversionWindowInMinutes i:nil="false"></ConversionWindowInMinutes>
    <CountType i:nil="false">Unique</CountType>
    <Id i:nil="true" />
    <Name i:nil="false">My Url Conversion Goal</Name>
    <Revenue i:nil="false">
      <CurrencyCode i:nil="false">USDollar</CurrencyCode>
      <Type i:nil="false">FixedValue</Type>
      <Value i:nil="false">10.00</Value>
    </Revenue>
    <Scope i:nil="false">Customer</Scope>
    <Status i:nil="true" />
    <TagId i:nil="false"></TagId>
    <TrackingStatus i:nil="true" />
    <UrlExpression i:nil="false">contoso</UrlExpression>
    <UrlOperator i:nil="false">Contains</UrlOperator>
  </ConversionGoal>
</ConversionGoals>

Configuration requise

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

Utilisé par

AddConversionGoals
GetConversionGoalsByIds
GetConversionGoalsByTagIds
UpdateConversionGoals