ConversionAction

Une action de conversion.

Représentation JSON 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
Champs
resourceName

string

Immuable. Nom de ressource de l'action de conversion. Le nom des ressources d'action de conversion se présente sous la forme suivante:

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

État de cette action de conversion pour le décompte des événements de conversion.
type

enum (ConversionActionType)

Immuable. Type d'action de conversion.
origin

enum (ConversionOrigin)

Uniquement en sortie. Origine de la conversion associée à cette action de conversion.
category

enum (ConversionActionCategory)

Catégorie de conversions enregistrée pour cette action de conversion.
valueSettings

object (ValueSettings)

Paramètres liés à la valeur des événements de conversion associés à cette action de conversion.
countingType

enum (ConversionActionCountingType)

Comptabiliser les événements de conversion pour l'action de conversion
attributionModelSettings

object (AttributionModelSettings)

Paramètres associés au modèle d'attribution de cette action de conversion.
tagSnippets[]

object (TagSnippet)

Uniquement en sortie. Extraits utilisés pour le suivi des conversions.
mobileAppVendor

enum (MobileAppVendor)

Uniquement en sortie. Fournisseur de l'application mobile pour une action de conversion d'application.
firebaseSettings

object (FirebaseSettings)

Uniquement en sortie. Paramètres Firebase pour les types de conversion Firebase.
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

Uniquement en sortie. Paramètres de service d'analyse d'applications tierce pour les types de conversion tiers
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

Uniquement en sortie. Paramètres Google Analytics 4 pour les types de conversion Google Analytics 4.
id

string (int64 format)

Uniquement en sortie. ID de l'action de conversion.
name

string

Nom de l'action de conversion.

Ce champ est obligatoire. Il doit être renseigné lors de la création d'actions de conversion.
primaryForGoal

boolean

Si le bit "primaryForGoal" d'une action de conversion est défini sur "false", cette action ne peut pas être enchérissable pour toutes les campagnes, quel que soit l'objectif de conversion client ou de conversion de la campagne. Toutefois, les objectifs de conversion personnalisés ne respectent pas "primaryForGoal". Par conséquent, si une campagne comporte un objectif de conversion personnalisé configuré avec une action de conversion "primaryForGoal = "false", cette action de conversion reste enchérissable. Par défaut, "primaryForGoal" est défini sur "true" s'il n'est pas défini. Dans la version 9, primaryForGoal ne peut être défini sur "false" après sa création que via une opération de mise à jour, car il n'est pas déclaré comme facultatif.
ownerCustomer

string

Uniquement en sortie. Nom de ressource du client propriétaire de l'action de conversion, ou valeur "null" s'il s'agit d'une action de conversion définie par le système.
includeInConversionsMetric

boolean

Indique si cette action de conversion doit être incluse dans la métrique "Conversions".
clickThroughLookbackWindowDays

string (int64 format)

Nombre maximal de jours pouvant s'écouler entre une interaction (un clic, par exemple) et un événement de conversion.
viewThroughLookbackWindowDays

string (int64 format)

Nombre maximal de jours pouvant s'écouler entre une impression et une conversion sans interaction.
phoneCallDurationSeconds

string (int64 format)

Durée de l'appel téléphonique, en secondes, au terme de laquelle une conversion doit être enregistrée pour cette action de conversion.

Cette valeur doit être comprise entre 0 et 10 000 inclus.
appId

string

ID d'application pour une action de conversion d'application

ConversionActionStatus

États possibles d'une action de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED Les conversions seront enregistrées.
REMOVED Les conversions ne seront pas enregistrées.
HIDDEN Les conversions ne seront pas enregistrées et l'action de conversion n'apparaîtra pas dans l'UI.

ConversionActionType

Types d'action de conversion possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AD_CALL Conversions qui se produisent lorsqu'un utilisateur clique sur l'extension d'appel d'une annonce.
CLICK_TO_CALL Conversions qui se produisent lorsqu'un utilisateur clique sur un numéro de téléphone depuis un appareil mobile.
GOOGLE_PLAY_DOWNLOAD Conversions enregistrées lorsqu'un utilisateur télécharge une application mobile sur le Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions qui se produisent lorsqu'un utilisateur effectue un achat dans une application avec la facturation Android.
UPLOAD_CALLS Conversions par appel suivies par l'annonceur et importées.
UPLOAD_CLICKS Conversions suivies par l'annonceur et importées avec les clics attribués.
WEBPAGE Conversions enregistrées sur une page Web.
WEBSITE_CALL Conversions qui se produisent lorsqu'un utilisateur appelle un numéro de téléphone généré dynamiquement à partir du site Web d'un annonceur.
STORE_SALES_DIRECT_UPLOAD Conversion "Ventes en magasin" basée sur les importations de données first party ou tierces Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types d'importation directe pour les ventes en magasin.
STORE_SALES Conversion "ventes en magasin" basée sur les importations de données first party ou tierces de marchands et/ou sur les achats en magasin effectués à l'aide de cartes de réseaux de paiement Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types de ventes en magasin. Lecture seule.
FIREBASE_ANDROID_FIRST_OPEN Suivi des conversions à la première ouverture d'une application Android via Firebase
FIREBASE_ANDROID_IN_APP_PURCHASE Suivi des conversions d'achat via une application Android via Firebase
FIREBASE_ANDROID_CUSTOM Suivi des conversions personnalisées pour les applications Android via Firebase
FIREBASE_IOS_FIRST_OPEN Suivi des conversions de type "première ouverture" d'une application iOS via Firebase
FIREBASE_IOS_IN_APP_PURCHASE Suivi des conversions d'achat via une application iOS via Firebase
FIREBASE_IOS_CUSTOM Suivi des conversions personnalisées pour les applications iOS via Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Suivi des conversions de type "première ouverture" d'une application Android à l'aide d'une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Suivi des conversions d'achat dans une application Android via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Suivi des conversions personnalisées pour les applications Android à l'aide d'une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Suivi des conversions de type "première ouverture" d'une application iOS via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Suivi des conversions d'achat via une application iOS via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Suivi des conversions personnalisées pour les applications iOS via une solution d'analyse d'applications tierce
ANDROID_APP_PRE_REGISTRATION Conversions qui se produisent lorsqu'un utilisateur préinscrit une application mobile à partir du Google Play Store. Lecture seule.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions qui permettent d'effectuer le suivi de tous les téléchargements Google Play qui ne sont pas suivis par un type spécifique d'application. Lecture seule.
FLOODLIGHT_ACTION Activité Floodlight qui compte le nombre de fois où les utilisateurs ont consulté une page Web spécifique après avoir vu l'une des annonces d'un annonceur ou cliqué dessus. Lecture seule.
FLOODLIGHT_TRANSACTION Activité Floodlight effectuant le suivi du nombre de ventes réalisées ou du nombre d'articles achetés Vous pouvez également obtenir la valeur totale de chaque vente. Lecture seule.
GOOGLE_HOSTED Conversions qui suivent les actions locales effectuées dans les produits et services Google après une interaction avec une annonce. Lecture seule.
LEAD_FORM_SUBMIT Conversions enregistrées lorsqu'un utilisateur envoie un formulaire pour prospects. Lecture seule.
SALESFORCE Conversions provenant de Salesforce. Lecture seule.
SEARCH_ADS_360 Conversions importées à partir des données Floodlight Search Ads 360. Lecture seule.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversions par appel générées par les annonces d'une campagne intelligente sans configuration du suivi des appels, avec les critères personnalisés de la campagne intelligente. Lecture seule.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL L'utilisateur clique sur un élément d'appel dans Google Maps. Campagne intelligente uniquement. Lecture seule.
SMART_CAMPAIGN_MAP_DIRECTIONS L'utilisateur demande l'itinéraire vers un établissement dans Google Maps. Campagne intelligente uniquement. Lecture seule.
SMART_CAMPAIGN_TRACKED_CALLS Conversions par appel générées par les annonces d'une campagne intelligente avec configuration du suivi des appels et utilisant les critères personnalisés de la campagne intelligente. Lecture seule.
STORE_VISITS Conversions enregistrées lorsqu'un utilisateur se rend dans le magasin d'un annonceur. Lecture seule.
WEBPAGE_CODELESS Conversions créées à partir d'événements sur le site Web (envois de formulaires ou chargements de pages, par exemple) qui n'utilisent pas d'extraits d'événement codés individuellement. Lecture seule.
UNIVERSAL_ANALYTICS_GOAL Conversions provenant d'objectifs Universal Analytics associés.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions provenant de transactions Universal Analytics associées.
GOOGLE_ANALYTICS_4_CUSTOM Conversions provenant de conversions d'événements personnalisés Google Analytics 4 associés.
GOOGLE_ANALYTICS_4_PURCHASE Conversions provenant de conversions d'achat Google Analytics 4 associées.

ValueSettings

Paramètres liés à la valeur des événements de conversion associés à cette action de conversion.

Représentation JSON 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Champs
defaultValue

number

Valeur à utiliser lorsque les événements de conversion de cette action de conversion sont envoyés avec une valeur non valide, non autorisée ou manquante, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut.
defaultCurrencyCode

string

Code de devise à utiliser lorsque les événements de conversion de cette action de conversion sont envoyés avec un code de devise non valide ou manquant, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut.
alwaysUseDefaultValue

boolean

Détermine si la valeur et le code de devise par défaut sont utilisés ou non à la place de la valeur et du code de devise spécifiés dans les événements de conversion pour cette action de conversion.

ConversionActionCountingType

Indique comment les conversions seront comptabilisées pour cette action. Pour en savoir plus, consultez https://support.google.com/google-ads/answer/3438531.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ONE_PER_CLICK Comptabiliser une seule conversion par clic.
MANY_PER_CLICK Comptabiliser toutes les conversions par clic.

AttributionModelSettings

Paramètres associés au modèle d'attribution de cette action de conversion.

Représentation JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Champs
attributionModel

enum (AttributionModel)

Type de modèle d'attribution de cette action de conversion.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

Uniquement en sortie. État du modèle d'attribution basée sur les données pour l'action de conversion.

AttributionModel

Modèle d'attribution qui décrit comment répartir le crédit d'une conversion spécifique entre un grand nombre d'interactions antérieures.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
EXTERNAL Utilise une attribution externe.
GOOGLE_ADS_LAST_CLICK Attribue tout le crédit d'une conversion à son dernier clic.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Attribue tout le crédit d'une conversion à son premier clic via le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Attribue le crédit d'une conversion de manière égale entre tous ses clics à l'aide de l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attribue une part de crédit exponentielle plus élevée à une conversion aux clics les plus récents à l'aide du modèle d'attribution sur le Réseau de Recherche de Google (la moitié de la vie correspond à une semaine).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attribue 40% du crédit d'une conversion à ses premiers et derniers clics. Les 20% restants sont répartis uniformément entre tous les autres clics. Ce modèle utilise l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Modèle flexible qui utilise le machine learning pour déterminer la répartition appropriée du crédit entre les clics à l'aide de l'attribution sur le Réseau de Recherche de Google

DataDrivenModelStatus

Énumère les états des modèles basés sur les données.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AVAILABLE Le modèle basé sur les données est disponible.
STALE Le modèle basé sur les données est obsolète. Elles n'ont pas été mises à jour depuis au moins sept jours. Il est toujours utilisé, mais expirera s'il n'est pas mis à jour pendant 30 jours.
EXPIRED Le modèle basé sur les données a expiré. Il n'a pas été mis à jour depuis au moins 30 jours et ne peut pas être utilisé. Le plus souvent, cela est dû au fait que le nombre d'événements n'a pas été atteint au cours des dernières 30 jours.
NEVER_GENERATED Le modèle basé sur les données n'a jamais été généré. Le plus souvent, cela est dû au fait que le nombre d'événements n'a jamais été atteint sur une période de 30 jours.

FirebaseSettings

Paramètres associés à une action de conversion Firebase.

Représentation JSON 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
Champs
propertyId

string (int64 format)

Uniquement en sortie. ID de la propriété GA de la conversion.
propertyName

string

Uniquement en sortie. Nom de la propriété GA de la conversion.
eventName

string

Uniquement en sortie. Nom d'événement d'une conversion Firebase.
projectId

string

Uniquement en sortie. ID du projet Firebase pour la conversion.

ThirdPartyAppAnalyticsSettings

Paramètres associés à une action de conversion de solution d'analyse d'applications tierce.

Représentation JSON 
{
  "providerName": string,
  "eventName": string
}
Champs
providerName

string

Uniquement en sortie. Nom du fournisseur de solutions d'analyse d'applications tiers.
eventName

string

Uniquement en sortie. Nom d'événement d'une conversion d'analyse d'applications tierce.

GoogleAnalytics4Settings

Paramètres associés à une action de conversion Google Analytics 4.

Représentation JSON 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
Champs
eventName

string

Uniquement en sortie. Nom de l'événement GA4.
propertyName

string

Uniquement en sortie. Nom de la propriété GA4.
propertyId

string (int64 format)

Uniquement en sortie. ID de la propriété GA4.