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à 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 Data sono simili ai report sull'attribuzione che puoi trovare nella sezione Pubblicità > Conversioni dell'interfaccia utente di Google Analytics. Per ulteriori informazioni, consulta l'articolo del Centro assistenza sul report Rendimento delle conversioni.

Scopo dei report sulle conversioni

I report sulle conversioni ti 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 concentra sugli eventi contrassegnati come conversioni. Utilizzano dimensioni e metriche specifiche (vedi 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.

Attivare i report sulle conversioni

Per generare un report sulle conversioni, utilizza il metodo runReport. Una richiesta viene trattata come report sulle conversioni se esegue 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 all'interno dell'elenco conversions nella risposta del metodo GetMetadata.
  • attributionModel: il modello di attribuzione da utilizzare. I valori supportati sono DATA_DRIVEN (predefinito) e LAST_CLICK.

Generare 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: ricreare 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 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 sull'interfaccia utente del rendimento delle conversioni mostrando clic sugli annunci, costo degli annunci, costo degli annunci per clic, costo degli annunci per tutte le conversioni, impressioni degli annunci, ritorno sulla spesa pubblicitaria, 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 una risposta di esempio 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 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.