Halaman ini diterjemahkan oleh Cloud Translation API.

Dasar-dasar 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.

Dengan Google Analytics Data API v1, Anda dapat membuat Ekspor Audiens, yang menyertakan ringkasan pengguna di audiens.

Buat Ekspor Audiens

Google Analytics Data API v1 menggunakan pendekatan asinkron untuk membuat Ekspor Audiens. Pertama, permintaan ke metode audienceExports.create diperlukan untuk membuat Ekspor Audiens pengguna. Kemudian, metode audienceExports.query digunakan untuk mengambil pengguna di audiens.

Selain itu, Anda dapat menggunakan audienceExports.get untuk mengambil metadata konfigurasi tentang Ekspor Audiens tertentu dan audienceExports.list untuk mencantumkan semua Ekspor Audiens untuk properti.

Pilih entitas pelaporan

Semua metode Data API v1 memerlukan ID properti Google Analytics 4 untuk ditentukan di dalam jalur permintaan URL dalam bentuk properties/GA4_PROPERTY_ID, seperti:

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

Laporan ini 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 memanipulasi jalur URL permintaan secara manual. 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.

Meminta pembuatan Ekspor Audiens

Untuk membuat Ekspor Audiens, panggil metode audienceExports.create menggunakan objek AudienceExport dalam permintaan. Parameter berikut diperlukan:

Nama audiens yang valid di kolom audience, dengan format properties/{propertyId}/audiences/{audienceId}. Anda dapat menggunakan metode audiences.list di Google Analytics Admin API v1 untuk mendapatkan nilai ini. Kolom Audience.name dari 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.

Contoh permintaan pembuatan 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 (seperti properties/1234567/audienceExports/123), yang dapat digunakan dalam kueri berikutnya untuk mengambil pengguna dari Ekspor Audiens.

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

Mengkueri status kesiapan Ekspor Audiens

Mungkin perlu waktu beberapa menit untuk membuat Ekspor Audiens setelah panggilan audienceExports.create. Anda dapat memperoleh status kesiapan untuk Ekspor Audiens dengan memanggil metode audienceExports.get.

Gunakan nama Ekspor Audiens (seperti properties/1234567/audienceExports/123) yang Anda terima dari respons audienceExports.create untuk menentukan Ekspor Audiens.

Contoh:

Permintaan HTTP

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

Status kesiapan untuk Ekspor Audiens ditampilkan di kolom state dalam respons. Setelah pembuatan Ekspor Audiens selesai, statusnya akan berubah dari CREATING menjadi ACTIVE.

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 dalam Ekspor Audiens

Setelah Ekspor Audiens yang dibuat menggunakan metode audienceExports.create dibuat, panggil metode audienceExports.query dan tentukan nama Ekspor Audiens (seperti properties/1234567/audienceExports/123).

Permintaan HTTP

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

Jika Ekspor Audiens sudah siap, respons yang berisi daftar pengguna dalam audiens akan ditampilkan:

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
}

Ekspektasi data Ekspor Audiens

Bagian berikut menetapkan ekspektasi data untuk keanggotaan pengguna di Ekspor Audiens.

Keaktualan data

Keaktualan data Ekspor Audiens adalah waktu yang dibutuhkan Google Analytics untuk mengumpulkan peristiwa, memproses peristiwa, lalu memperbarui keanggotaan pengguna di audiens. Jika seluruh proses tersebut memerlukan waktu 24 jam, maka keaktualan data Ekspor Audiens adalah 24 jam. Lihat Keaktualan Data untuk mempelajari lebih lanjut.

Misalnya, jika pengguna menyelesaikan pembelian pertamanya, lalu 7 jam kemudian, Anda membuat Ekspor Audiens untuk audiens "Pembeli", hampir dipastikan pengguna belum akan masuk dalam Ekspor Audiens "Pembeli". Dalam 14 hingga 38 jam setelah pembelian pertama, pengguna tersebut kemungkinan akan berada di Ekspor Audiens baru.

Ekspor Audiens adalah snapshot

Ekspor Audiens adalah daftar pengguna di audiens yang merupakan ringkasan pada waktunya. Untuk pemasaran ulang Google Ads, Google Analytics secara otomatis dan terus-menerus mengekspor pengguna dalam audiens ke Google Ads. Sebaliknya, dengan Ekspor Audiens yang dibuat menggunakan Data API v1, Anda perlu membuat Ekspor Audiens baru untuk melihat pengguna terbaru di audiens tersebut.

Ekspor Audiens dibuat berdasarkan keanggotaan pengguna terbaru yang tersedia. Namun, Ekspor Audiens dapat memiliki keaktualan data sebesar 20 jam, dan itu berarti Ekspor Audiens akan didasarkan pada semua peristiwa dari 20 jam sebelum momen saat ini.

Data keanggotaan terbaru diperbarui sekali per hari, biasanya selama waktu musim panas dalam zona waktu properti. Artinya, Ekspor Audiens untuk audiens yang sama pada pukul 09.00 & 11.00 kemungkinan akan menampilkan data yang sama, tetapi Ekspor Audiens pada pukul 15.00 mungkin akan berbeda berdasarkan penyertaan data tambahan untuk satu hari.

Akhir masa berlaku Ekspor Audiens

Masa berlaku Ekspor Audiens berakhir setelah 72 jam. Pengguna baru mungkin masuk dan keluar dari audiens setiap hari. Untuk mendapatkan ringkasan pengguna terbaru, Anda perlu membuat Ekspor Audiens baru untuk setiap hari.

Batas pengguna Ekspor Audiens

Jika ukuran audiens atau properti melebihi batas pengguna, Ekspor Audiens akan menampilkan sampel perwakilan audiens. Batas ini bergantung pada jenis properti Anda (yaitu, properti standar atau 360) dan diterapkan di setiap Ekspor Audiens satu per satu. Pengguna yang kembali adalah pengguna di audiens yang diminta, dan pengguna yang dianggap adalah pengguna yang mungkin atau mungkin bukan anggota audiens.

Jenis Batas	Batas Properti Standar	Batas Properti Analytics 360
Maks pengguna yang kembali	2 juta	200 juta
Maks pengguna yang dipertimbangkan	10 juta	1 miliar

Konsistensi identitas pelaporan

Identitas pelaporan menentukan cara pengguna menghapus duplikat dalam laporan. Ekspor Audiens TIDAK berubah berdasarkan setelan identitas pelaporan. Ekspor Audiens selalu mengidentifikasi pengguna berdasarkan User-ID, lalu ID perangkat.

Ini berarti laporan tentang audiens dapat menampilkan lebih banyak pengguna daripada yang ditampilkan Ekspor Audiens. Misalnya, jika Identitas Pelaporan ditetapkan ke "Berbasis perangkat" dan ID pengguna dikumpulkan, laporan tidak akan menghapus duplikat pengguna berdasarkan ID pengguna, tetapi Ekspor Audiens akan menghapus duplikatnya berdasarkan ID pengguna.

Konsistensi pengisian ulang

Saat Anda membuat Audiens di Google Analytics dan mengaktifkan pemasaran ulang Google Ads, Google Analytics akan mengisi ulang audiens tersebut di Google Ads dengan anggota yang baru-baru ini ditambahkan. Namun, laporan Google Analytics dan Ekspor Audiens TIDAK berisi keanggotaan audiens yang diisi ulang. Pengguna harus mencatat peristiwa ke dalam log setelah audiens dibuat untuk laporan dan Ekspor Audiens agar dapat menampilkan pengguna dalam audiens tersebut.

Misalnya, jika pengguna memicu peristiwa pembelian pada 20 Juni dan Anda membuat audiens "Pembeli" pada 21 Juni, Anda mungkin harus menunggu hingga 22 Juni agar dapat melihat pengguna tersebut di Ekspor Audiens baru. Namun, pengguna tersebut hanya akan berada dalam Ekspor Audiens jika ia telah mencatat peristiwa apa pun ke dalam log pada 21 Juni.