Nozioni di base sui report sulle conversioni

Questa guida spiega come utilizzare la funzionalità di report sulle conversioni nell'API Data di Google Analytics 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 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 Report sul rendimento delle conversioni.

Scopo dei report sulle conversioni

I report sulle conversioni consentono di analizzare l'efficacia delle attività di marketing attribuendo le conversioni a campagne, sorgenti e mezzi specifici. A differenza dei report standard basati sugli eventi che contano 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.

Report sulle conversioni rispetto ai 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 sulla tua proprietà.
  • Report sulle conversioni: si concentrano 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 Data-driven o Ultimo clic.

Attivare i report sulle conversioni

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

L'conversionSpec oggetto 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 delle azioni 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 (valore predefinito) e LAST_CLICK.

Generare un report sulle conversioni

Di seguito è riportata una richiesta di esempio che utilizza il runReport metodo 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: recuperare le azioni di conversione

Chiama il getMetadata metodo per trovare gli ID delle azioni 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: eseguire il report

Chiama il runReport metodo. Utilizza gli ID delle azioni di conversione trovati nel passaggio 1 per filtrare il report oppure lascia vuoto conversionActions per generare report su tutte le conversioni. Questa richiesta ricrea un report dell'interfaccia utente sul rendimento delle conversioni mostrando per impostazione predefinita 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"
    }
}

Di seguito è riportata 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 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.