Membuat ekspor audiens

Audiens di Google Analytics memungkinkan segmentasi pengguna menurut kebutuhan bisnis Anda. Dengan Anda dapat mengelompokkan pengguna situs atau aplikasi berdasarkan .

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

Lihat Ekspektasi data ekspor audiens panduan untuk mendapatkan informasi penting tentang data yang Anda lihat di ekspor audiens.

Ringkasan

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

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

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

Pilih entitas pelaporan

Semua metode Data API memerlukan properti Google Analytics ID yang ditentukan di dalam jalur permintaan URL, dalam dalam bentuk properties/GA_PROPERTY_ID. Berikut contohnya:

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

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

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

Membuat ekspor audiens

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

• Nama audiens yang valid di audience kolom, dengan format properties/{propertyId}/audiences/{audienceId}. Anda dapat gunakan audiences.list Google Analytics Admin API v1 untuk mendapatkan nilai ini. Tujuan Audience.name kolom respons audiences.list berisi nama audiens.
• Daftar dimensi yang valid di dimensions kolom tersebut. Daftar dimensi yang didukung oleh metode ini dapat ditemukan di Dokumentasi skema ekspor audiens. Hanya data untuk dimensi yang disebutkan di kolom ini disertakan dalam audiens ekspor.

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 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 audienceExports.create panggilan telepon.

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

Gunakan nama ekspor audiens dari respons audienceExports.create untuk tentukan 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 tersebut. Setelah pembuatan ekspor audiens selesai, statusnya perubahan 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 audienceExports.list .

Mengambil pengguna dari ekspor audiens

Setelah ekspor audiens dibuat, panggil metode audienceExports.query, dan tentukan mengekspor name 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 Anda.

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
}