Membuat ekspor audiens

Audiens di Google Analytics 4 memungkinkan Anda menyegmentasikan pengguna dengan cara yang penting bagi bisnis Anda. Dengan audiens, Anda dapat mengelompokkan pengguna situs atau aplikasi berdasarkan atribut yang dibagikan.

Anda dapat mengekspor audiens, termasuk ringkasan pengguna mereka, menggunakan Data API.

Lihat panduan Ekspektasi data ekspor audiens untuk mengetahui informasi penting tentang data yang Anda lihat dalam ekspor audiens.

Ringkasan

Buat permintaan Data API berikut untuk membuat dan melakukan kueri ekspor audiens:

1. Panggil metode audienceExports.create untuk membuat ekspor audiens.
2. Panggil metode audienceExports.query yang digunakan untuk mengambil pengguna di audiens.

Untuk informasi selengkapnya, Anda dapat memanggil audienceExports.get untuk mengambil metadata konfigurasi tentang ekspor audiens tertentu, dan audienceExports.list untuk mencantumkan semua ekspor audiens untuk properti tertentu.

Pilih entitas pelaporan

Semua metode Data API mengharuskan ID properti Google Analytics 4 ditentukan di dalam jalur permintaan URL, dalam bentuk properties/GA4_PROPERTY_ID. Berikut contohnya:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports

Laporan dibuat berdasarkan data peristiwa Google Analytics yang dikumpulkan di properti Google Analytics 4 yang ditentukan.

Jika menggunakan salah satu library klien Data API, Anda tidak perlu mengubah jalur URL permintaan. Sebagian besar klien API menyediakan parameter property yang mengharapkan string dalam bentuk properties/GA4_PROPERTY_ID. Lihat Panduan memulai cepat untuk mengetahui contoh penggunaan library klien.

Membuat ekspor audiens

Untuk membuat ekspor audiens, panggil metode audienceExports.create menggunakan objek AudienceExport dalam permintaan Anda. Parameter berikut wajib diisi:

• Nama audiens yang valid di kolom audience, yang diformat sebagai properties/{propertyId}/audiences/{audienceId}. Anda dapat menggunakan metode audiences.list Google Analytics Admin API v1 untuk mendapatkan nilai ini. Kolom Audience.name respons audiences.list berisi nama audiens.
• Daftar dimensi yang valid di kolom dimensions. Daftar dimensi yang didukung oleh metode ini dapat ditemukan di dokumentasi Skema ekspor audiens. Hanya data untuk dimensi yang disebutkan dalam kolom ini yang disertakan dalam ekspor audiens.

Berikut contoh permintaan untuk membuat ekspor audiens:

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

Respons metode audienceExports.create berisi nama ekspor audiens di kolom name, misalnya properties/1234567/audienceExports/123. Berikut adalah contoh respons:

Respons HTTP

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

Anda dapat menggunakan name untuk membuat kueri pengguna dari ekspor audiens.

Mengkueri status kesiapan ekspor audiens

Mungkin perlu waktu beberapa menit untuk membuat ekspor audiens setelah panggilan audienceExports.create.

Anda dapat memeriksa status kesiapan ekspor audiens dengan memanggil metode audienceExports.get.

Gunakan nama ekspor audiens dari respons audienceExports.create untuk menentukan ekspor audiens dalam permintaan Anda.

Berikut adalah contoh permintaan:

Permintaan HTTP

GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123

Status kesiapan untuk ekspor audiens ditampilkan di kolom state respons. Setelah pembuatan ekspor audiens selesai, statusnya berubah dari CREATING menjadi ACTIVE.

Berikut adalah contoh respons:

Respons HTTP

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

Anda dapat memperoleh status semua ekspor audiens dengan memanggil metode audienceExports.list.

Mengambil pengguna dari ekspor audiens

Setelah ekspor audiens dibuat, panggil metode audienceExports.query, dan tentukan name ekspor audiens dalam permintaan.

Berikut adalah contoh permintaan:

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Jika ekspor audiens sudah siap, panggilan ini akan menampilkan daftar pengguna di audiens.

Berikut adalah contoh respons:

Respons HTTP

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}