Ce guide liste les différents types d'actions de conversion que vous pouvez créer à l'aide de l'API Google Ads et explique comment ils sont mappés à l'interface Web Google Ads.
Choisissez le bon type d'action de conversion
Pour vous aider à sélectionner le type d'action de conversion et le guide de configuration adaptés à votre intégration, utilisez le chemin de décision suivant :
Où l'événement de conversion se produit-il ?
- Hors connexion (par exemple, dans votre bureau, dans votre établissement ou par téléphone) : passez à l'étape 2.
- Directement sur votre site Web (par exemple, achats sur le site Web, inscriptions ou envois de formulaires) : passez à l'étape 3.
- Dans une application mobile : passez à l'étape 4.
- Via un appel téléphonique passé directement depuis vos annonces : utilisez Appels depuis les annonces (
AD_CALL) (avecCallAsset).
Conversions hors connexion :
S'agit-il d'un appel téléphonique ?
Oui : utilisez
Importation des conversions par appel (
UPLOAD_CALLS) pour suivre les résultats des appels.
S'agit-il d'une vente en magasin physique ?
Oui : utilisez
S'agit-il d'une vente hors connexion ou d'une progression de prospect résultant d'une visite sur un site Web ?
- Oui : utilisez le suivi avancé des conversions pour les prospects à l'aide de l'API Data Manager (recommandé) ou consultez Gérer les conversions hors connexion par clic pour les intégrations existantes de l'API Google Ads. (Remarque : À partir du 15 juin 2026, l'importation de conversions par clic à l'aide de
UploadClickConversionssera limitée aux jetons de développeur ayant déjà importé des conversions par clic hors connexion).
- Oui : utilisez le suivi avancé des conversions pour les prospects à l'aide de l'API Data Manager (recommandé) ou consultez Gérer les conversions hors connexion par clic pour les intégrations existantes de l'API Google Ads. (Remarque : À partir du 15 juin 2026, l'importation de conversions par clic à l'aide de
Conversions en ligne (sur le site Web) :
- Voulez-vous suivre les chargements de page (achats, reçus) ou les clics des utilisateurs ?
- Oui : utilisez Conversions sur le site Web avec l'extrait de code de balise défini sur
WEBPAGEouWEBPAGE_ONCLICK.
- Oui : utilisez Conversions sur le site Web avec l'extrait de code de balise défini sur
Voulez-vous suivre les appels générés par un numéro de téléphone indiqué sur votre site Web ?
Suivre la durée réelle des appels
Oui : utilisez
Appels depuis un site Web (
WEBSITE_CALL) avec un numéro de transfert Google dynamique et un extrait d'événement de balise.Non (suivre uniquement les clics sur les boutons/liens sur le site mobile) Utiliser
- Voulez-vous suivre les chargements de page (achats, reçus) ou les clics des utilisateurs ?
Conversions d'applications mobiles :
- Le suivi des installations ou des achats sur le Google Play Store est-il suffisant ?
- Oui : utilisez les conversions d'application (
GOOGLE_PLAY_DOWNLOADouGOOGLE_PLAY_IN_APP_PURCHASE).
- Oui : utilisez les conversions d'application (
Suivez-vous les actions dans l'application à l'aide de Google Analytics (GA4) ou d'une solution tierce d'analyse d'applications ?
Oui : utilisez
Firebase et les solutions d'analyse d'applications tierces (en activant les actions de conversion
FIREBASE_*ouTHIRD_PARTY_*).
- Le suivi des installations ou des achats sur le Google Play Store est-il suffisant ?
Conversions hors connexion
Les conversions hors connexion vous aident à suivre les événements de conversion qui se produisent dans le monde réel, par exemple dans votre bureau, dans votre établissement ou par téléphone.
Le tableau suivant indique les paramètres d'API ConversionActionType équivalents à utiliser pour chaque source dans l'interface Web Google Ads, ainsi qu'un lien vers la documentation de chaque type d'action de conversion spécifique :
| Type d'action de conversion | Source Google Ads | Guide de configuration de l'API |
|---|---|---|
UPLOAD_CLICKS |
Suivre les conversions après un clic et le suivi avancé des conversions pour les prospects | Utilisez l'API Data Manager (recommandé) ou consultez Gérer les conversions par clic hors connexion pour les intégrations existantes de l'API Google Ads. |
UPLOAD_CALLS |
Effectuer le suivi des conversions à partir d'appels | Guide d'importation des conversions par appel |
STORE_SALES |
Suivre les conversions "ventes en magasin" | Pour en savoir plus, consultez Ventes en magasin : importer dans une action de conversion avec reporting. |
Conversions en ligne (sur le site Web)
Une conversion sur un site Web vous permet de suivre les actions effectuées sur un site Web, comme les ventes en ligne, les clics sur des liens, les pages vues et les inscriptions.
Pour suivre les conversions sur votre site Web, vous devez créer un ConversionAction avec l'élément ConversionActionType défini sur WEBPAGE, puis ajouter un extrait de code appelé balise à la page de conversion de votre site Web.
ConversionAction englobe plusieurs types de conversions sur le site Web, qui sont distingués dans l'API par le champ type de chaque TagSnippet listé dans le champ tag_snippets d'un ConversionAction.
Un TagSnippet fournit le code de suivi qui doit être inclus dans votre site Web pour suivre vos actions de conversion.
Les conversions Site Web et Clic sur un numéro de téléphone nécessitent l'utilisation de l'event_snippet, qui doit être placé sur les pages Web indiquant une action de conversion (par exemple, une page de confirmation de paiement ou d'envoi de formulaire de lead), et de l'global_site_tag, qui doit être installé sur chaque page de votre site Web. Vous pouvez récupérer ces deux attributs avec ConversionActionService. Pour en savoir plus sur l'ajout de balises à vos pages, consultez notre Centre d'aide.
Le tableau suivant indique les paramètres d'API équivalents à utiliser pour chaque source dans l'interface Web Google Ads :
| Type de code de suivi | Source Google Ads |
|---|---|
WEBPAGE |
Site Web, Site Web (Google Analytics (GA4)) |
WEBPAGE_ONCLICK |
Site Web, Site Web (Google Analytics (GA4)) |
CLICK_TO_CALL |
Clics sur des numéros de téléphone |
les conversions liées aux applications ;
Une conversion d'application vous permet de suivre les installations d'applications mobiles ou les achats via une application depuis le Google Play Store.
Le tableau suivant présente les paramètres d'API ConversionActionType équivalents à utiliser pour chaque source dans l'interface Web Google Ads :
| Type d'action de conversion | Source Google Ads |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > Installations |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > Achats via une application |
Pour suivre d'autres actions d'application mobile à l'aide de propriétés Google Analytics 4 ou de fonctionnalités d'analyse d'applications tierces, consultez Autres types d'actions de conversion.
Conversions par appel téléphonique
Le suivi des conversions par appel téléphonique vous permet de suivre les appels provenant d'annonces, les appels vers un numéro figurant sur votre site Web et les clics sur les numéros affichés sur les sites mobiles.
Le tableau suivant présente les paramètres d'API ConversionActionType équivalents à utiliser pour chaque source dans l'interface Web Google Ads :
| Type d'action de conversion | Source Google Ads |
|---|---|
AD_CALL |
Appels à partir d'annonces utilisant des extensions d'appel ou d'annonces Appels uniquement |
WEBSITE_CALL |
Appels vers un numéro de téléphone indiqué sur votre site Web |
CLICK_TO_CALL |
Clics sur un numéro affiché sur votre site Web mobile |
AD_CALL
Une action de conversion AD_CALL s'affiche en tant que conversion Appels provenant d'annonces dans l'interface Web Google Ads.
Après avoir créé votre action de conversion AD_CALL, spécifiez son nom de ressource dans le champ call_conversion_action lorsque vous créez un CallAsset.
Les composants Appel vous permettent d'afficher un numéro de téléphone directement dans vos annonces.
Un appel est enregistré comme une conversion s'il dépasse une durée spécifiée. La valeur par défaut est de 60 secondes.
WEBSITE_CALL
Une action de conversion WEBSITE_CALL s'affiche en tant que conversion Appels à partir d'un site Web dans l'interface Web Google Ads.
Contrairement à AD_CALL, ce tracker nécessite l'ajout de event_snippet et de global_site_tag à votre site Web pour récupérer le numéro de transfert Google dynamique afin de suivre les appels vers les numéros listés sur votre site Web. Vous devez également configurer un composant Appel et
associez-le au niveau du client, de la campagne ou du groupe d'annonces.
CLICK_TO_CALL
Une action de conversion CLICK_TO_CALL s'affiche sous la forme d'une conversion Clics sur votre numéro sur votre site Web mobile dans l'interface Web Google Ads.
Le type CLICK_TO_CALL diffère du type AD_CALL, car il ne suit pas les appels téléphoniques réels. À la place, CLICK_TO_CALL ne suit que les clics sur un numéro de téléphone depuis un appareil mobile. Cette option est utile lorsque vous ne pouvez pas utiliser de numéro de transfert Google pour suivre les appels téléphoniques.
Suivi avancé des conversions
Le suivi avancé des conversions vous aide à améliorer la précision de votre mesure des conversions. En effet, il complète vos balises de conversion existantes avec des données de conversion first party, comme l'adresse e-mail, le nom, l'adresse postale et le numéro de téléphone.
Le tableau suivant présente les paramètres d'API équivalents à utiliser pour chaque type de suivi avancé des conversions :
| Type d'action de conversion | Type de suivi avancé des conversions | Guide de configuration de l'API |
|---|---|---|
UPLOAD_CLICKS |
Suivi avancé des conversions pour les prospects
Améliore la mesure des transactions réalisées hors connexion par un prospect identifié sur un site Web ou un visiteur de ce site |
Utilisez l'API Data Manager (recommandé) ou consultez Gérer les conversions par clic hors connexion pour les intégrations existantes de l'API Google Ads. |
WEBPAGE |
Suivi avancé des conversions pour le Web
Améliore la mesure des conversions en ligne |
Guide de configuration de l'API |
Autres types d'actions de conversion
L'API Google Ads permet d'inclure d'autres types d'actions de conversion dans les rapports, mais peut limiter ou interdire la création ou la modification de ces actions. Vous pouvez interroger vos actions de conversion et leurs types à l'aide de GoogleAdsService :
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.status
FROM conversion_action
Conversions SKAdNetwork
Si vous diffusez des campagnes pour applications iOS et que vous avez implémenté SKAdNetwork, vous pouvez accéder aux données SKAdNetwork fournies à Google au niveau de Customer et de Campaign à l'aide des ressources suivantes :
| Champ du rapport | Description |
|---|---|
metrics.sk_ad_network_installs |
Nombre d'installations indiqué par Apple. Cette métrique ne peut être segmentée que par n'importe quelle combinaison de segments.sk_ad_network_conversion_value et de segments liés à la date.
|
metrics.sk_ad_network_total_conversions |
Nombre total de conversions, y compris les installations et les autres types de conversions enregistrés par Apple. Cette métrique ne peut être segmentée que par des segments liés à SKAdNetwork et des segments liés à la date. |
segments.sk_ad_network_ad_event_type |
Type d'événement qui s'est produit pour une conversion donnée. |
segments.sk_ad_network_attribution_credit |
Comment l'attribution est créditée pour une conversion donnée. |
segments.sk_ad_network_fine_conversion_value |
Valeur d'une conversion enregistrée par Apple. Ce segment ne peut être appliqué à aucune métrique autre que Une valeur |
segments.sk_ad_network_coarse_conversion_value |
Valeur approximative d'une conversion individuelle. |
segments.sk_ad_network_postback_sequence_index |
Position du postback, dans l'ordre, pour une conversion donnée. |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
ID de l'application dans laquelle a été diffusée l'annonce ayant généré l'installation d'iOS SKAdNetwork. |
segments.sk_ad_network_source_domain |
Site Web sur lequel a été diffusée l'annonce ayant généré l'installation d'iOS SKAdNetwork. Une valeur nulle signifie que ce segment n'est pas applicable (par exemple, une campagne non iOS) ou qu'il n'était présent dans aucun postback envoyé par Apple. |
segments.sk_ad_network_source_type |
Type de source dans lequel a été diffusée l'annonce ayant généré l'installation d'iOS SKAdNetwork. Une valeur nulle signifie que ce segment n'est pas applicable (par exemple, une campagne non iOS) ou que ni le domaine source, ni l'application source n'étaient présents dans les postbacks envoyés par Apple. |
segments.sk_ad_network_user_type |
Type d'utilisateur ayant généré une conversion particulière. |
segments.sk_ad_network_redistributed_fine_conversion_value |
Les valeurs de conversion de ce segment incluent des valeurs nulles qui ont été redistribuées aux valeurs de conversion. Ce segment représente la somme des valeurs de conversion précises observées renvoyées par Apple et des valeurs nulles modélisées par Google. |
segments.sk_ad_network_version |
Version de l'API iOS StoreKit Ad Network utilisée. |
Google Analytics
Les conversions d'une propriété Google Analytics associée ont l'une des valeurs type suivantes :
Conversion de la propriété GA4 :
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
Vous pouvez également récupérer l'ID de la propriété GA4, le nom de la propriété et le nom de l'événement à partir du champ
google_analytics_4_settings.
Vous pouvez apporter les modifications suivantes à une conversion de propriété GA4 :
- Importez la conversion depuis votre propriété GA4 dans votre compte Google Ads en remplaçant la valeur du champ
statusparENABLEDau lieu deHIDDEN. - Modifiez ses champs
primary_for_goaletcategorypour indiquer l'impact qu'elle doit avoir sur les enchères et les rapports Google Ads. - Mettez à jour son
nameou sonvalue_settings. - Supprimez la conversion de votre compte Google Ads à l'aide d'une opération
remove.
Toute tentative de modification d'autres attributs d'une conversion GA4 importée ou de tout attribut d'une conversion Universal Analytics importée entraîne une erreur MUTATE_NOT_ALLOWED. Vous ne pouvez effectuer ces modifications que dans l'interface utilisateur de Google Ads.
Firebase et solutions d'analyse d'applications tierces
Pour importer des conversions d'analyse d'applications tierces ou de Firebase, remplacez l'status de ConversionAction par HIDDEN par ENABLED à l'aide de la méthode mutate de ConversionActionService. La modification de app_id n'est pas possible pour ces actions de conversion.
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
Ventes en magasin : importation dans une action de conversion avec reporting
Bien que vous ne puissiez pas créer d'actions de conversion STORE_SALES ou STORE_SALES_DIRECT_UPLOAD à l'aide de l'API Google Ads, l'API permet d'importer des transactions de ventes en magasin.
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
Types d'actions de conversion en lecture seule
Les types d'actions de conversion suivants sont en lecture seule dans l'API Google Ads et sont fournis à des fins de reporting.
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
Inconnu
Si votre compte Google Ads inclut d'autres types d'actions de conversion, vous constaterez peut-être que les requêtes et les rapports renvoient des actions de conversion dont le champ ConversionAction.type est défini sur UNKNOWN. L'API ne permet pas de gérer ces actions de conversion, mais elle les renvoie dans les rapports afin de fournir des résultats complets pour les métriques de conversion clés telles que metrics.conversions et metrics.conversions_value.