Nozioni di base sui report sulle conversioni

Questa guida spiega come utilizzare la funzionalità di generazione di report sulle conversioni nell'API Google Analytics Data v1. Questa funzionalità ti consente di generare report incentrati sugli eventi di conversione con il supporto di diversi modelli di attribuzione. I report sulle conversioni creati con l'API di dati sono simili ai report sull'attribuzione che puoi trovare nella sezione Pubblicità > Conversioni dell'interfaccia utente di Google Analytics. Per saperne di più, consulta l'articolo del Centro assistenza Report sul rendimento delle conversioni.

Scopo dei report sulle conversioni

I report sulle conversioni consentono di analizzare l'efficacia delle tue iniziative di marketing attribuendo le conversioni a campagne, sorgenti e mezzi specifici. A differenza dei report standard basati sugli eventi che conteggiano solo gli eventi, i report sulle conversioni applicano un modello di attribuzione per distribuire il merito tra i touchpoint che hanno portato a una conversione.

Conversioni e report basati sugli eventi

  • Report basati sugli eventi: forniscono conteggi non elaborati degli eventi (ad es. eventCount) e sono utili per comprendere l'attività generale nella tua proprietà.
  • Report sulle conversioni: si concentrano sugli eventi contrassegnati come conversioni. Utilizzano dimensioni e metriche specifiche (consulta lo schema dei report sulle conversioni) e ti consentono di visualizzare i dati attribuiti in base a modelli come quello basato sui dati o sull'ultimo clic.

Attiva i report sulle conversioni

Per generare un report sulle conversioni, utilizza il metodo runReport. Una richiesta viene considerata un report sulle conversioni se esegue una query su una o più metriche di conversione (ad esempio allConversionsByInteractionDate) o se il campo conversionSpec è compilato nel corpo della richiesta.

L'oggetto conversionSpec contiene i seguenti campi:

  • conversionActions: un elenco di nomi delle risorse delle azioni di conversione da includere nel report (ad es. ["conversionActions/12345"]). Se vuoto, vengono incluse tutte le conversioni. Gli ID azione di conversione validi possono essere recuperati dal campo conversion_action nell'elenco conversions nella risposta del metodo GetMetadata.
  • attributionModel: il modello di attribuzione da utilizzare. I valori supportati sono DATA_DRIVEN (predefinito) e LAST_CLICK.

Genera un report sulle conversioni

Ecco una richiesta di esempio che utilizza il metodo runReport per generare un report sulle conversioni che mostra le conversioni per nome della campagna utilizzando il modello di attribuzione basata sui dati.

HTTP

Apri in Explorer API 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

Esempio: ricrea un report sul rendimento delle conversioni

Questo esempio mostra come recuperare prima le azioni di conversione disponibili per una proprietà e poi utilizzarle per creare un report simile al report sul rendimento delle conversioni mostrato nell'interfaccia utente di Google Analytics in Pubblicità > Conversioni > Rendimento delle conversioni.

Passaggio 1: recupera le azioni di conversione

Chiama il metodo getMetadata per trovare gli ID azione di conversione validi per la tua proprietà. Assicurati di specificare l'ID proprietà GA (anziché utilizzare 0 per ottenere i campi comuni a tutte le proprietà) per visualizzare le azioni di conversione create per la tua proprietà.

La risposta contiene un elenco conversions con le azioni di conversione disponibili:

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

Passaggio 2: esegui il report

Chiama il metodo runReport. Utilizza gli ID azione di conversione trovati nel passaggio 1 per filtrare il report o lascia conversionActions vuoto per generare report su tutte le conversioni. Questa richiesta ricrea un report UI sul rendimento delle conversioni mostrando i clic sugli annunci, il costo degli annunci, il costo per clic degli annunci, il costo per tutte le conversioni degli annunci, le impressioni degli annunci, il ritorno sulla spesa pubblicitaria, le entrate totali e tutte le conversioni per gruppo di canali predefinito.

HTTP

Apri in Explorer API 
{
    "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"
    }
}

Ecco un esempio di risposta per questa richiesta:

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

Puoi verificare che la risposta sia stata trattata come un report sulle conversioni controllando che il campo metadata.section nella risposta sia impostato su SECTION_ADVERTISING.

Per un elenco completo delle dimensioni e delle metriche disponibili per i report sulle conversioni, consulta lo schema dei report sulle conversioni.