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 dan/atau aplikasi berdasarkan atribut yang dibagikan.

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

Membuat 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 tertentu.

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

Membuat kueri 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 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 bisa mendapatkan 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 di 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 dalam Ekspor Audiens.

Keaktualan Data

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

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

Ekspor Audiens adalah Ringkasan

Ekspor Audiens adalah daftar pengguna di audiens pada ringkasan waktu. 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 misalnya 20 jam, dan itu berarti Ekspor Audiens akan didasarkan pada semua peristiwa dari 20 jam sebelum saat ini.

Data keanggotaan terbaru diperbarui sekali per hari, biasanya selama waktu siang 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 satu hari tambahan.

Akhir Masa Berlaku Ekspor Audiens

Masa berlaku Ekspor Audiens berakhir setelah 72 jam. Pengguna baru dapat 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 satu per satu di setiap Ekspor Audiens. Pengguna yang kembali adalah pengguna dalam audiens yang diminta, dan pengguna yang dipertimbangkan adalah pengguna yang mungkin merupakan anggota audiens, mungkin juga bukan.

Jenis Batas	Batas Properti Standar	Batas Properti Analytics 360
Pengguna kembali maks	2 juta	200 juta
Pengguna yang dipertimbangkan maksimum	10 juta	1 miliar

Melaporkan Konsistensi Identitas

Identitas pelaporan menentukan cara penghapusan duplikat pengguna 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 nilai Ekspor Audiens. Misalnya, jika Identitas Pelaporan "Berbasis perangkat" dan ID pengguna dikumpulkan, laporan tidak akan menghapus duplikat pengguna berdasarkan ID pengguna, tetapi Ekspor Audiens akan menghapus duplikatnya berdasarkan ID pengguna.

Laporan tentang audiens juga dapat menampilkan lebih sedikit pengguna dibandingkan hasil Ekspor Audiens. Misalnya, jika Identitas Pelaporan "Digabungkan", laporan akan menghapus duplikat pengguna berdasarkan Sinyal Google, tetapi Ekspor Audiens tidak.

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 agar laporan dan Ekspor Audiens dapat menampilkan pengguna dalam audiens tersebut.

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