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 serupa dengan laporan atribusi yang dapat Anda temukan di bagian Iklan > Konversi di UI Google Analytics. Untuk mengetahui informasi selengkapnya, lihat artikel pusat bantuan Laporan performa konversi.

Tujuan pelaporan konversi

Pelaporan konversi memberikan 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 menghasilkan konversi.

Laporan berbasis peristiwa versus konversi

  • Laporan Berbasis Peristiwa: Memberikan jumlah mentah peristiwa (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 mengkueri satu atau beberapa metrik konversi (misalnya, allConversionsByInteractionDate), atau jika kolom conversionSpec diisi di 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 menurut 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: Ambil tindakan konversi

Panggil metode getMetadata untuk menemukan ID tindakan konversi yang valid untuk properti Anda. 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: Jalankan laporan

Panggil metode runReport. Gunakan ID tindakan konversi yang ditemukan di Langkah 1 untuk memfilter laporan, atau biarkan conversionActions kosong 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 mengetahui daftar lengkap dimensi dan metrik yang tersedia untuk laporan konversi, lihat Skema Laporan Konversi.