Dasar-dasar pelaporan konversi

Panduan ini menjelaskan cara menggunakan fungsi pelaporan konversi di Google Analytics Data API v1. Fitur ini memungkinkan Anda membuat laporan yang berfokus pada peristiwa konversi dengan dukungan untuk berbagai model atribusi. Laporan konversi yang dibuat dengan Data API mirip dengan laporan atribusi yang dapat Anda temukan di bagian Iklan > Konversi pada UI Google Analytics. Untuk mengetahui informasi selengkapnya, lihat artikel pusat bantuan Laporan performa konversi.

Tujuan pelaporan konversi

Pelaporan konversi menyediakan cara untuk menganalisis efektivitas upaya pemasaran Anda dengan mengatribusikan konversi ke kampanye, sumber, dan media tertentu. Tidak seperti laporan berbasis peristiwa standar yang hanya menghitung peristiwa, pelaporan konversi menerapkan model atribusi untuk mendistribusikan kredit di antara poin kontak yang mengarah ke konversi.

Konversi versus laporan berbasis peristiwa

  • Laporan Berbasis Peristiwa: Memberikan jumlah peristiwa mentah (misalnya, eventCount) dan berguna untuk memahami aktivitas umum di properti Anda.
  • Laporan Konversi: Berfokus pada peristiwa yang telah ditandai sebagai konversi. Laporan ini menggunakan dimensi dan metrik tertentu (lihat Skema Laporan Konversi) dan memungkinkan Anda melihat data yang diatribusikan berdasarkan model seperti Berbasis data atau Klik terakhir.

Mengaktifkan laporan konversi

Untuk menjalankan laporan konversi, gunakan metode.runReport Permintaan diperlakukan sebagai laporan konversi jika permintaan tersebut mengkueri satu atau lebih metrik konversi (misalnya, allConversionsByInteractionDate), atau jika kolom conversionSpec diisi dalam isi permintaan.

Objek conversionSpec berisi kolom berikut:

  • conversionActions: Daftar nama resource tindakan konversi yang akan disertakan dalam laporan (misalnya, ["conversionActions/12345"]). Jika kosong, semua konversi akan disertakan. ID tindakan konversi yang valid dapat diambil dari kolom conversion_action dalam daftar conversions dalam respons metode GetMetadata.
  • attributionModel: Model atribusi yang akan digunakan. Nilai yang didukung adalah DATA_DRIVEN (default) dan LAST_CLICK.

Membuat laporan konversi

Berikut adalah contoh permintaan menggunakan metode runReport untuk membuat laporan konversi yang menampilkan konversi berdasarkan nama kampanye menggunakan model atribusi Berbasis data.

HTTP

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

Contoh: Membuat ulang laporan performa konversi

Contoh ini menunjukkan cara mengambil tindakan konversi yang tersedia untuk properti terlebih dahulu, lalu menggunakannya untuk membuat laporan yang mirip dengan laporan Performa Konversi yang ditampilkan di UI Google Analytics di bagian Iklan > Konversi > Performa konversi.

Langkah 1: Mengambil tindakan konversi

Panggil metode untuk menemukan ID tindakan konversi yang valid untuk properti Anda.getMetadata Pastikan untuk menentukan ID properti GA (bukan menggunakan 0 untuk mendapatkan kolom yang umum untuk semua properti) agar dapat melihat tindakan konversi yang dibuat untuk properti Anda.

Respons berisi daftar conversions dengan tindakan konversi yang tersedia:

{
  ...

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

Langkah 2: Menjalankan laporan

Panggil metode runReport. Gunakan ID tindakan konversi yang ditemukan di Langkah 1 untuk memfilter laporan Anda, atau kosongkan conversionActions untuk melaporkan semua konversi. Permintaan ini membuat ulang laporan UI Performa Konversi dengan menampilkan klik iklan, biaya iklan, biaya iklan per klik, biaya iklan per semua konversi, tayangan iklan, laba atas belanja iklan, total pendapatan, dan semua konversi menurut grup saluran default.

HTTP

Buka di 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"
    }
}

Berikut adalah contoh respons untuk permintaan ini:

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

Anda dapat memverifikasi bahwa respons diperlakukan sebagai laporan konversi dengan memeriksa apakah kolom metadata.section dalam respons ditetapkan ke SECTION_ADVERTISING.

Untuk daftar lengkap dimensi dan metrik yang tersedia untuk laporan konversi, lihat Skema Laporan Konversi.