Principes de base des rapports sur les conversions

Ce guide explique comment utiliser la fonctionnalité de rapports sur les conversions dans l'API Data Google Analytics 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 pouvez trouver dans la section Publicité > Conversions de l' interface utilisateur 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 comptabilisent que les événements, les rapports sur les conversions appliquent un modèle d'attribution pour répartir le crédit entre les points de contact qui ont mené à une conversion.

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

  • Les rapports basés sur les événements fournissent des nombres bruts d'événements (par exemple, eventCount) et sont utiles pour comprendre l'activité générale sur votre propriété.
  • Les rapports sur les conversions se concentrent sur les événements qui ont été marqués comme conversions. Ils utilisent des dimensions et des métriques spécifiques (consultez 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 runReport méthode. 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'conversionSpec objet 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. 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 runReport méthode pour générer un rapport sur les conversions affichant les conversions par nom de campagne à l'aide du modèle d'attribution "Basé sur les données".

HTTP

Ouvrir dans l'API 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 getMetadata méthode pour trouver les ID d'action 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 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écuter le rapport

Appelez la runReport méthode. Utilisez les ID d'action 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'interface utilisateur en affichant les clics publicitaires, le coût publicitaire, le coût publicitaire par clic, le coût publicitaire par toutes les conversions, les impressions publicitaires, le retour sur les dépenses publicitaires, le revenu total et toutes les conversions par groupe de canaux par défaut.

HTTP

Ouvrir dans l'API 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 pour 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 sur les conversions en vous assurant 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.