Ce guide explique comment utiliser la fonctionnalité de reporting des conversions dans l'API Google Analytics Data v1. Cette fonctionnalité vous permet de générer des rapports axés sur les événements de conversion, avec la prise en charge de différents modèles d'attribution. Les rapports sur les conversions créés avec l'API Data sont semblables aux rapports sur l'attribution que vous trouverez dans la section Publicité > Conversions de l'interface utilisateur de Google Analytics. Pour en savoir plus, consultez l'article du Centre d'aide sur le rapport sur les performances des conversions.
Objectif du reporting des conversions
Le reporting des conversions vous permet d'analyser l'efficacité de vos efforts marketing en attribuant les conversions à des campagnes, des sources et des supports spécifiques. Contrairement aux rapports standards basés sur les événements, qui ne comptabilisent que les événements, le reporting des conversions applique un modèle d'attribution pour répartir le crédit entre les points de contact ayant mené à une conversion.
Rapports sur les conversions et rapports basés sur les événements
- Rapports basés sur les événements : fournissent le nombre brut d'événements (par exemple,
eventCount) et sont utiles pour comprendre l'activité générale sur votre propriété. - Rapports sur les conversions : se concentrent sur les événements marqués comme conversions. Ils utilisent des dimensions et des métriques spécifiques (voir le schéma des rapports sur les conversions) et vous permettent de voir les données attribuées en fonction de modèles tels que l'attribution basée sur les données ou au dernier clic.
Activer les rapports sur les conversions
Pour exécuter un rapport sur les conversions, utilisez la méthode runReport. Une requête est traitée comme un rapport sur les conversions si elle interroge une ou plusieurs métriques de conversion (par exemple, allConversionsByInteractionDate) ou si le champ conversionSpec est renseigné dans le corps de la requête.
L'objet conversionSpec contient les champs suivants :
conversionActions: liste des noms de ressources d'actions de conversion à inclure dans le rapport (par exemple,["conversionActions/12345"]). Si ce champ est vide, toutes les conversions sont incluses. Vous pouvez récupérer les identifiants de l'action de conversion valides à partir du champconversion_actionde la listeconversionsdans la réponse de la méthodeGetMetadata.attributionModel: modèle d'attribution à utiliser. Les valeurs acceptées sontDATA_DRIVEN(par défaut) etLAST_CLICK.
Générer un rapport sur les conversions
Voici un exemple de requête utilisant la méthode runReport pour générer un rapport sur les conversions indiquant les conversions par nom de campagne à l'aide du modèle d'attribution basée sur les données.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "campaignName" } ], "metrics": [ { "name": "allConversionsByConversionDate" } ], "conversionSpec": { "conversionActions": [], "attributionModel": "DATA_DRIVEN" } }
Exemple : Recréer un rapport sur les performances des conversions
Cet exemple montre comment récupérer d'abord les actions de conversion disponibles pour une propriété, puis les utiliser pour créer un rapport semblable au rapport sur les performances des conversions affiché dans l'interface utilisateur de Google Analytics sous Publicité > Conversions > Performances des conversions.
Étape 1 : Récupérer les actions de conversion
Appelez la méthode getMetadata pour trouver les identifiants de l'action de conversion valides pour votre propriété. Veillez à spécifier l'ID de la propriété GA (au lieu d'utiliser 0 pour obtenir les champs communs à toutes les propriétés) afin d'afficher les actions de conversion créées pour votre propriété.
La réponse contient une liste conversions avec les actions de conversion disponibles :
{
...
"conversions": [
{
"conversionAction": "conversionActions/12345",
"displayName": "purchase"
},
{
"conversionAction": "conversionActions/67890",
"displayName": "sign_up"
}
]
}
Étape 2 : Exécutez le rapport
Appelez la méthode runReport.
Utilisez les identifiants de l'action de conversion trouvés à l'étape 1 pour filtrer votre rapport, ou laissez conversionActions vide pour inclure toutes les conversions dans le rapport. Cette requête recrée un rapport de l'UI sur les performances des conversions en affichant les clics sur les annonces, le coût des annonces, le coût par clic des annonces, le coût des annonces pour toutes les conversions, les impressions d'annonces, le retour sur les dépenses publicitaires, le revenu total et toutes les conversions par groupe de canaux par défaut.
HTTP
{ "dateRanges": [ { "startDate": "2026-04-01", "endDate": "2026-04-30" } ], "dimensions": [ { "name": "defaultChannelGroup" } ], "metrics": [ { "name": "allConversionsByInteractionDate" }, { "name": "advertiserAdCost" }, { "name": "advertiserAdCostPerAllConversionsByInteractionDate" }, { "name": "advertiserAdImpressions" }, { "name": "advertiserAdClicks" }, { "name": "advertiserAdCostPerClick" }, { "name": "totalRevenueByInteractionDate" }, { "name": "returnOnAdSpendByInteractionDate" } ], "conversionSpec": { "conversionActions": [ "conversionActions/12345" ], "attributionModel": "DATA_DRIVEN" } }
Voici un exemple de réponse à cette requête :
{
"dimensionHeaders": [
{
"name": "defaultChannelGroup"
}
],
"metricHeaders": [
{
"name": "allConversionsByInteractionDate",
"type": "TYPE_FLOAT"
},
{
"name": "advertiserAdCost",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdCostPerAllConversionsByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "advertiserAdImpressions",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdClicks",
"type": "TYPE_INTEGER"
},
{
"name": "advertiserAdCostPerClick",
"type": "TYPE_CURRENCY"
},
{
"name": "totalRevenueByInteractionDate",
"type": "TYPE_CURRENCY"
},
{
"name": "returnOnAdSpendByInteractionDate",
"type": "TYPE_FLOAT"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Paid Search"
}
],
"metricValues": [
{
"value": "75.2"
},
{
"value": "500"
},
{
"value": "6.65"
},
{
"value": "10000"
},
{
"value": "500"
},
{
"value": "1"
},
{
"value": "1500"
},
{
"value": "3"
}
]
}
],
"rowCount": 1,
"metadata": {
"schemaRestrictionResponse": {},
"currencyCode": "USD",
"timeZone": "America/Los_Angeles",
"section": "SECTION_ADVERTISING"
},
"kind": "analyticsData#runReport"
}
Vous pouvez vérifier que la réponse a été traitée comme un rapport de conversion en vérifiant que le champ metadata.section de la réponse est défini sur SECTION_ADVERTISING.
Pour obtenir la liste complète des dimensions et métriques disponibles pour les rapports sur les conversions, consultez le schéma des rapports sur les conversions.