Principes de base des rapports sur les conversions

Ce guide explique comment utiliser la fonctionnalité de création de rapports sur les 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'UI Google Analytics. Pour en savoir plus, consultez l'article du Centre d'aide sur le rapport "Performances des conversions".

Objectif des rapports sur les conversions

Les rapports sur les conversions vous permettent 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 font que les comptabiliser, les rapports sur les conversions appliquent un modèle d'attribution pour répartir le crédit entre les points de contact qui ont conduit à une conversion.

Comparaison entre les rapports sur les conversions et les rapports basés sur les événements

  • Rapports basés sur les événements : ils 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 : concentrez-vous 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 d'afficher les données attribuées en fonction de modèles tels que "Basé sur les données" ou "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 cette liste est vide, toutes les conversions sont incluses. Les ID d'action de conversion valides peuvent être récupérés à partir du champ conversion_action dans la liste conversions de la réponse de la méthode GetMetadata.
  • attributionModel : modèle d'attribution à utiliser. Les valeurs acceptées sont DATA_DRIVEN (par défaut) et LAST_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 affichant les conversions par nom de campagne à l'aide du modèle d'attribution basée sur les données.

HTTP

Ouvrir dans APIs Explorer 
{
    "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 à celui sur les performances des conversions affiché dans l'interface utilisateur 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 ID d'actions de conversion valides pour votre propriété. Veillez à spécifier l'ID de propriété GA (au lieu d'utiliser 0 pour obtenir les champs communs à toutes les propriétés) afin de voir 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 : Générez le rapport

Appelez la méthode runReport. Utilisez les ID d'actions de conversion trouvés à l'étape 1 pour filtrer votre rapport ou laissez conversionActions vide pour générer un rapport sur toutes les conversions. Cette requête recrée un rapport sur les performances des conversions dans l'UI. Elle affiche les clics sur les annonces, le coût des annonces, le coût des annonces par clic, le coût des annonces par 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

Ouvrir dans APIs Explorer 
{
    "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 demande :

{
  "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"
}

Pour vérifier que la réponse a été traitée comme un rapport sur les conversions, assurez-vous que le champ metadata.section de la réponse est défini sur SECTION_ADVERTISING.

Pour obtenir la liste complète des dimensions et des métriques disponibles pour les rapports sur les conversions, consultez le schéma des rapports sur les conversions.