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 de l'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 tierce partie de l'analyse d'applications 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", vous ne pouvez pas définir une enchère pour toutes les campagnes, quel que soit l'objectif de conversion du client ou 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", celle-ci peut toujours être enchérissable. Par défaut, primaryForGoal est défini sur true si ce champ n'est pas défini. Dans V9, primaryForGoal ne peut être défini sur "false" qu'après sa création par le biais d'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.

La 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'interface utilisateur.

ConversionActionType

Types 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.
AD_CALL Conversions enregistrées lorsqu'un utilisateur clique sur l'extension d'appel d'une annonce.
CLICK_TO_CALL Conversions enregistrées lorsqu'un utilisateur clique sur un numéro de téléphone à partir d'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 enregistrées lorsqu'un utilisateur effectue un achat dans une application via la facturation Android.
UPLOAD_CALLS Conversions par appel dont le suivi est effectué par l'annonceur et qui sont importées.
UPLOAD_CLICKS Conversions suivies par l'annonceur et importées avec les clics attribués.
WEBPAGE Conversions se produisant sur une page Web.
WEBSITE_CALL Conversions enregistrées 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 "Ventes en magasin".
STORE_SALES Conversion des 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 Conversions de type "première ouverture" d'une application Android suivies 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 Conversions de type "première ouverture" d'une application iOS suivies via Firebase
FIREBASE_IOS_IN_APP_PURCHASE Suivi des conversions d'achat via une application iOS via Firebase
FIREBASE_IOS_CUSTOM Les conversions personnalisées liées aux applications iOS sont suivies via Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions de type "première ouverture" d'une application Android suivies via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Suivi des conversions d'achat via une application Android à l'aide d'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 Conversions de type "première ouverture" d'une application iOS suivies via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversions d'achat via une application iOS suivies à l'aide d'une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Les conversions personnalisées pour les applications iOS sont suivies à l'aide d'une solution d'analyse d'applications tierce.
ANDROID_APP_PRE_REGISTRATION Conversions enregistrées lorsqu'un utilisateur préinscrit une application mobile sur le Google Play Store. Lecture seule.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions effectuant le suivi de tous les téléchargements Google Play qui ne font pas l'objet d'un suivi selon un type spécifique à l'application. Lecture seule.
FLOODLIGHT_ACTION Activité Floodlight qui comptabilise le nombre de fois où les internautes 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 dans les produits et services Google après une interaction avec une annonce. Lecture seule.
LEAD_FORM_SUBMIT Conversions comptabilisé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 via les annonces d'une campagne intelligente sans configuration du suivi des appels, à l'aide des critères personnalisés de cette campagne. 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 via les annonces d'une campagne intelligente avec suivi des appels configuré et en utilisant les critères personnalisés de cette campagne. 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 des conversions d'événement personnalisé Google Analytics 4 associées.
GOOGLE_ANALYTICS_4_PURCHASE Conversions provenant des 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 associés à 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 associés à 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 à 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 la page 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

Le modèle d'attribution qui décrit comment répartir le crédit d'une conversion spécifique entre de nombreuses interactions antérieures (potentiellement)

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 l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Accorde 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 un crédit exponentiellement plus élevé d'une conversion aux clics les plus récents via l'attribution sur le Réseau de Recherche de Google (la demi-vie correspond à une semaine).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attribue 40% du crédit d'une conversion à ses premier et dernier clics. Les 20% restants sont répartis uniformément entre tous les autres clics. Elle 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 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. Elle n'a pas été mise à 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, c'est parce qu'il n'y a pas eu le nombre d'événements requis au cours des 30 derniers jours.
NEVER_GENERATED Le modèle basé sur les données n'a jamais été généré. Le plus souvent, c'est parce qu'il n'y a jamais eu le nombre d'événements requis 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 de la conversion.

ThirdPartyAppAnalyticsSettings

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

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

string

Uniquement en sortie. Nom du fournisseur de solution 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.