Objet de données AppInstallGoal - Gestion des campagnes

Article
11/13/2024

Définit un objectif de conversion d’installation d’application. Utilisez ce type d’objectif pour effectuer le suivi chaque fois qu’une personne installe votre application en tant que conversion.

Pour les autres types d’objectifs de conversion, vous créez une balise De suivi des événements universels (UET), ajoutez-la à votre site web, puis créez un objectif de conversion. Toutefois, pour les objectifs de conversion d’installation d’application, il vous suffit d’utiliser l’URL spécifique à l’application fournie par le partenaire certifié Microsoft Advertising. Pour plus d’informations, consultez Guide pratique pour suivre les installations d’applications mobiles en tant que conversions.

Conseil

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

<xs:complexType name="AppInstallGoal" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:ConversionGoal">
      <xs:sequence>
        <xs:element minOccurs="0" name="AppPlatform" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="AppStoreId" nillable="true" type="xs:string" />
      </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": "AppInstall",
  "ViewThroughConversionWindowInMinutes": IntValueHere,
  "AppPlatform": "ValueHere",
  "AppStoreId": "ValueHere"
}

Éléments

L’objet AppInstallGoal contient les éléments suivants : AppPlatform, AppStoreId.

Élément	Description	Type de données
AppPlatform	Plateforme d’application. Les valeurs possibles incluent Android, iOS, Windows et WindowsPhone. Ajouter: Obligatoire Mettre à jour: Optionnel	chaîne
AppStoreId	Identificateur d’application fourni par l’App Store. Ajouter: Obligatoire Mettre à jour: Optionnel	chaîne

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

Éléments hérités

Éléments hérités de ConversionGoal

L’objet AppInstallGoal 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 à AppInstallGoal 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 d’installation d’application.	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	Non applicable aux objectifs d’installation d’application.	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’installation d’application prennent uniquement en charge la catégorie Télécharger . Ajouter: Optionnel. Si vous laissez cet élément à zéro ou vide, la catégorie par défaut est définie sur Télécharger. 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. L’option VariableValue n’est pas disponible pour les objectifs de conversion d’installation d’application. 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. Pour les objectifs d’installation de l’application, 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 d’installation d’application.	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 la status sur RecordingConversions si nous avons enregistré des conversions au cours des 7 derniers jours. Seuls les états NoRecentConversions et RecordingConversions sont applicables aux objectifs de conversion d’installation d’application. 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 AppInstall lorsque vous récupérez un objectif d’installation d’application. 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 d’installation d’application.	int

Configuration requise

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

Partager via