Mengonfigurasi tujuan

Setiap Destination dalam IngestAudienceMembersRequest atau IngestEventsRequest menentukan:

  1. Akun yang menerima data. Misalnya, akun Google Ads atau properti Google Analytics.
  2. Entitas tujuan untuk data dalam akun, seperti tindakan konversi Google Ads atau aliran Google Analytics.
  3. Jalur akses untuk kredensial permintaan ke akun yang menerima data.

Jika Anda adalah pengiklan atau agensi, buka Skenario pengiklan untuk melihat contoh cara membuat Destination:

Jika Anda adalah partner data, buka Skenario partner data untuk melihat contoh cara membuat Destination untuk mengirim data ke akun dengan link produk ke akun partner data Anda:

Bagian Persyaratan mendetail membahas persyaratan dan aturan validasi secara mendalam.

Skenario pengiklan

Berikut cara mengonfigurasi Destination untuk skenario umum bagi pengiklan dan agensi. Diagram ini menunjukkan cara Data Manager API menggunakan kredensial dan kolom Destination untuk mengakses akun pengiklan.

Jalur akses pengiklan

Google Ads

Berikut adalah diagram yang menunjukkan contoh kumpulan akun dan pengguna Google Ads.

Akun dan pengguna Google Ads

Akun pengelola M1

M1 memiliki dua akun turunan langsung:

  1. Akun pengelola M2
  2. Akun klien C1

Akun Google cloudysanfrancisco@gmail.com adalah pengguna di M1.

Akun pengelola M2

M2 memiliki dua akun turunan langsung:

  1. Akun klien C1
  2. Akun klien C2

Akun Google baklavainthebalkans@gmail.com adalah pengguna di M2.

Akun klien C1

C1 memiliki dua akun pengelola induk langsung:

  1. Akun pengelola M1
  2. Akun pengelola M2

Akun Google jeffersonloveshiking@gmail.com adalah pengguna di C1.

Akun klien C2

Akun pengelola M2 adalah satu-satunya induk langsung C2.

Tidak ada Akun Google yang tercantum yang merupakan pengguna di C2.

Skenario akses langsung dan Skenario akses pengelola menunjukkan cara mengonfigurasi tujuan untuk mengirim data ke akun ini.

Skenario akses langsung

Jika Anda ingin mengirim data ke akun Google Ads dan kredensial Anda adalah untuk Akun Google yang merupakan pengguna di akun Google Ads:

Destination
operating_account
account_id ID pelanggan akun Google Ads
account_type GOOGLE_ADS
login_account Jangan tetapkan login_account, atau tetapkan ke nilai yang sama dengan operating_account.
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens atau tindakan konversi.

Berikut contoh skenario akses langsung, menggunakan akun dari diagram dan kredensial untuk Akun Google jeffersonloveshiking@gmail.com.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "loginAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"

      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Skenario akses pengelola

Jika Anda ingin mengirim data ke akun Google Ads dan kredensial Anda adalah untuk Akun Google yang merupakan pengguna di akun pengelola Google Ads tempat akun pengiklan adalah akun turunan:

Destination
operating_account
account_id ID pelanggan akun klien Google Ads
account_type GOOGLE_ADS
login_account
account_id ID pelanggan akun pengelola Google Ads
account_type GOOGLE_ADS
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens atau tindakan konversi.

Berikut contoh skenario akses pengelola untuk akun klien Google Ads C2 dari diagram dan kredensial untuk Akun Google baklavainthebalkans@gmail.com:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Berikut contoh lain skenario akses pengelola untuk akun klien Google Ads C2 dan kredensial untuk Akun Google cloudysanfrancisco@gmail.com, yang merupakan pengguna di akun pengelola Google Ads M1:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "M1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

Anda dapat mengirim data ke Display & Video 360 menggunakan dua pendekatan:

  1. Akses langsung, dengan kredensial untuk Akun Google yang merupakan pengguna di akun partner atau pengiklan Display & Video 360.
  2. Akses partner Display & Video 360, dengan kredensial untuk Akun Google yang merupakan pengguna di akun partner Display & Video 360, dan akun operasi adalah akun pengiklan Display & Video 360 di akun partner.

Skenario akses langsung

Jika Anda ingin mengirim data ke akun pengiklan Display & Video 360 dan kredensial Anda adalah untuk Akun Google yang merupakan pengguna di akun pengiklan:

Destination
operating_account
account_id ID akun pengiklan Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account Jangan tetapkan login_account, atau tetapkan ke nilai yang sama dengan operating_account.
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens.

Berikut contoh Destination untuk skenario akses langsung guna mengirim data ke pengiklan Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Demikian pula, jika Anda ingin mengirim data ke akun partner Display & Video 360 dan kredensial Anda adalah untuk Akun Google yang merupakan pengguna di akun partner:

Destination
operating_account
account_id ID akun partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account Jangan tetapkan login_account, atau tetapkan ke nilai yang sama dengan operating_account.
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens.

Berikut contoh Destination untuk skenario akses langsung guna mengirim data ke partner Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Skenario akses partner Display & Video 360

Jika Anda ingin mengirim data ke pengiklan Display & Video 360 dan kredensial Anda adalah untuk Akun Google yang merupakan pengguna di akun partner Display & Video 360 induk pengiklan:

Destination
operating_account
account_id ID akun pengiklan Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id ID akun partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens.

Berikut contoh Destination untuk skenario akses partner guna mengirim data ke pengiklan Display & Video 360. Dalam skenario ini, kredensial harus untuk Akun Google yang merupakan pengguna di akun partner Display & Video 360 PARTNER_ID, dan akun pengiklan Display & Video 360 ADVERTISER_ID harus merupakan turunan dari akun partner PARTNER_ID.

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Analytics

Catatan: operating_account dan login_account harus identik jika tujuannya adalah akun Google Analytics. Jika tidak, permintaan akan gagal dengan error OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Destination
operating_account
account_id ID properti Google Analytics
account_type GOOGLE_ANALYTICS_PROPERTY
login_account Jangan tetapkan login_account, atau tetapkan ke nilai yang sama dengan operating_account.
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID pengukuran aliran data.

Berikut contoh Destination untuk mengirim peristiwa ke Google Analytics:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "loginAccount": {
        "accountId": "PROPERTY_ID",
        "accountType": "GOOGLE_ANALYTICS_PROPERTY"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ]
}

Skenario partner data

Berikut cara mengonfigurasi Destination untuk skenario umum bagi partner data yang mengirim data ke akun pengiklan dengan penautan produk yang sudah dibuat ke akun partner data.

Diagram ini menunjukkan cara Data Manager API menggunakan kredensial dan kolom Destination untuk mengakses akun pengiklan melalui link produk.

Jalur akses partner data

Google Ads

Berikut diagram yang menunjukkan contoh serangkaian akun Google Ads dan partner data. Diagram ini juga menunjukkan Akun Google mana yang merupakan pengguna di setiap akun Google Ads atau partner data, serta penautan produk antar-akun.

Akun dan pengguna partner data dan Google Ads

Partner data H1

Penautan produk ada antara D1 dan akun pengelola Google Ads M2.

Akun Google 222larabrown@gmail.com adalah pengguna di D1.

Partner data D2

Penautan produk ada antara D2 dan akun klien Google Ads C1.

Akun Google jeffersonloveshiking@gmail.com adalah pengguna di D2.

Akun pengelola M1

M1 memiliki dua akun turunan langsung:

  1. Akun pengelola M2
  2. Akun klien C1
Akun pengelola M2

M2 memiliki dua akun turunan langsung:

  1. Akun klien C1
  2. Akun klien C2
Akun klien C1

C1 memiliki dua akun pengelola induk langsung:

  1. Akun pengelola M1
  2. Akun pengelola M2
Akun klien C2

Akun pengelola M2 adalah satu-satunya induk langsung C2.

Berikut yang dapat Anda lakukan dengan kumpulan akun ini:

Bertindak sebagai partner data D1

Untuk bertindak sebagai partner data D1, gunakan kredensial untuk Akun Google 222larabrown@gmail.com guna mengirim data ke akun pengelola M2, akun klien C1, atau akun klien C2, menggunakan tujuan dengan login_account ditetapkan ke akun partner data D1 dan linked_account ditetapkan ke akun pengelola M2.

Sebagai partner data D1, Anda tidak dapat mengirim data ke akun pengelola M1 karena tidak ada penautan produk antara D1 dan M1.

Bertindak sebagai partner data D2

Untuk bertindak sebagai partner data D2, gunakan kredensial untuk Akun Google jeffersonloveshiking@gmail.com guna mengirim data ke akun klien C1, menggunakan tujuan dengan login_account yang ditetapkan ke akun partner data D2 dan linked_account yang ditetapkan ke akun klien C1.

Sebagai partner data D2, Anda tidak dapat mengirim data ke akun pengelola M1, akun pengelola M2, atau akun klien C2 karena tidak ada penautan produk antara D2 dan salah satu akun tersebut atau akun pengelola induknya.

Perbedaan utama antara partner data D1 dan D2 adalah cara partner data ditautkan ke akun Google Ads.

Skenario link produk langsung

Jika Anda ingin mengirim data ke akun Google Ads dan penautan produk dilakukan antara akun Google Ads dan akun partner data Anda:

Destination
operating_account
account_id ID pelanggan akun Google Ads
account_type GOOGLE_ADS
login_account
account_id ID pelanggan akun partner data
account_type DATA_PARTNER
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens atau tindakan konversi.

Berikut adalah contoh skenario link produk langsung menggunakan akun dari diagram. Dalam skenario ini, partner data D2 mengirim data anggota audiens ke pelanggan klien Google Ads C1 menggunakan link produk antara D2 dan C1, serta kredensial untuk Akun Google jeffersonloveshiking@gmail.com:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C1_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D2_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Skenario penautan produk pengelola

Jika Anda ingin mengirim data ke akun Google Ads dan link produknya adalah antara akun pengelola Google Ads induk dan akun partner data Anda:

Destination
operating_account
account_id ID pelanggan akun klien Google Ads
account_type GOOGLE_ADS
login_account
account_id ID pelanggan akun partner data
account_type DATA_PARTNER
linked_account
account_id ID pelanggan akun pengelola Google Ads
account_type GOOGLE_ADS
product_destination_id ID audiens atau tindakan konversi.

Berikut adalah contoh skenario link produk pengelola menggunakan akun dari diagram. Dalam skenario ini, partner data D1 mengirimkan data anggota audiens ke pelanggan klien Google Ads C2 menggunakan link produk antara D1 dan M2, serta kredensial untuk Akun Google 222larabrown@gmail.com:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "C2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "loginAccount": {
        "accountId": "D1_CUSTOMER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "M2_CUSTOMER_ID",
        "accountType": "GOOGLE_ADS"
      },
      "productDestinationId": "USER_LIST_ID"
    }
  ]
}

Display & Video 360

Sebagai partner data, Anda dapat mengirim data ke akun Display & Video 360 menggunakan dua pendekatan:

  1. Gunakan link produk langsung antara akun partner data dan akun partner atau pengiklan Display & Video 360.
  2. Mengirim data ke pengiklan Display & Video 360 menggunakan penautan produk antara akun partner data dan akun partner Display & Video 360 induk pengiklan.

Jika Anda ingin mengirim data ke pengiklan Display & Video 360 dan link produk berada di antara akun pengiklan Display & Video 360 dan akun partner data Anda:

Destination
operating_account
account_id ID akun pengiklan Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id ID pelanggan akun partner data
account_type DATA_PARTNER
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens atau tindakan konversi.

Berikut contoh Destination untuk skenario link produk langsung guna mengirim data ke pengiklan Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Jika ingin mengirim data ke akun partner Display & Video 360, Anda harus memiliki penautan produk antara akun partner Display & Video 360 dan akun partner data Anda.

Destination
operating_account
account_id ID akun partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
login_account
account_id ID pelanggan akun partner data
account_type DATA_PARTNER
linked_account Jangan tetapkan kolom linked_account.
product_destination_id ID audiens atau tindakan konversi.

Berikut contoh Destination untuk skenario link produk langsung guna mengirim data ke partner Display & Video 360:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Jika Anda ingin mengirim data ke pengiklan Display & Video 360 dan link produk ke akun partner data Anda adalah dengan akun partner Display & Video 360 yang akun pengiklannya merupakan akun turunan:

Destination
operating_account
account_id ID akun pengiklan Display & Video 360
account_type DISPLAY_VIDEO_ADVERTISER
login_account
account_id ID pelanggan akun partner data
account_type DATA_PARTNER
linked_account
account_id ID akun partner Display & Video 360
account_type DISPLAY_VIDEO_PARTNER
product_destination_id ID audiens atau tindakan konversi.

Berikut contoh Destination untuk skenario penautan produk partner guna mengirim data ke pengiklan Display & Video 360 menggunakan penautan produk antara partner data dan partner Display & Video 360 induk pengiklan:

{
  "destinations": [
    {
      "operatingAccount": {
        "accountId": "DISPLAY_VIDEO_ADVERTISER_ID",
        "accountType": "DISPLAY_VIDEO_ADVERTISER"
      },
      "loginAccount": {
        "accountId": "DATA_PARTNER_ID",
        "accountType": "DATA_PARTNER"
      },
      "linkedAccount": {
        "accountId": "DISPLAY_VIDEO_PARTNER_ID",
        "accountType": "DISPLAY_VIDEO_PARTNER"
      },
      "productDestinationId": "AUDIENCE_ID"
    }
  ]
}

Google Analytics

Data Manager API tidak mendukung pengiriman data ke akun Google Analytics menggunakan link produk. Sebagai gantinya, gunakan pendekatan skenario pengiklan untuk Google Analytics.

Persyaratan mendetail

Bagian ini berisi persyaratan mendetail untuk kolom akun Destination, tips tentang cara menetapkan product_destination_id, dan cara menentukan tempat kredensial Anda memiliki akses.

Kolom akun

Destination dapat memiliki hingga 3 akun berbeda:

operating_account

operating_account wajib diisi.

operating_account menunjukkan akun mana yang menerima data dalam permintaan. operating_account dapat berupa salah satu dari berikut:

login_account

login_account tidak selalu diperlukan, dan defaultnya adalah operating_account.

Data Manager API memverifikasi bahwa:

  1. Akun Google kredensial adalah pengguna di login_account.

  2. login_account adalah salah satu dari berikut ini:

    • Sama dengan operating_account. Nilai ini adalah nilai default jika Anda tidak menetapkan login_account.

    • Akun pengelola Google Ads atau partner Display & Video 360 yang merupakan induk dari operating_account.

    • Akun partner data dengan link produk ke linked_account.

linked_account

linked_account menunjukkan akun mana yang memiliki link produk ke login_account.

ID tujuan produk

product_destination_id dari Destination mengidentifikasi objek mana dalam operating_account yang menerima data. Misalnya, ini bisa berupa ID audiens untuk Google Ads atau Display & Video 360, ID tindakan konversi untuk Google Ads, atau ID pengukuran untuk aliran Google Analytics.

Berikut cara menemukan ID untuk setiap jenis tujuan produk.

Audiens Google Ads

ID tujuan produk untuk memasukkan anggota audiens adalah ID audiens.

Untuk mendapatkan ID audiens dari UI Google Ads:

  1. Buka Pengelola audiens di UI Google Ads.
  2. Klik nama audiens untuk melihat detail.
  3. ID audiens tercantum di samping ID Daftar.

Untuk mendapatkan ID audiens dari Google Ads API:

  1. Kirim permintaan Search atau SearchStream ke GoogleAdsService dengan kueri berikut:

    SELECT
      user_list.id,
      user_list.name
    FROM user_list
    WHERE user_list.name = 'USER_LIST_NAME'
    
  2. Dapatkan ID audiens dari kolom id di user_list dalam respons.

    [
      {
        "results": [
          {
            "userList": {
              "resourceName": "customers/CUSTOMER_ID/userLists/USER_LIST_ID",
              "id": "USER_LIST_ID",
              "name": "USER_LIST_NAME"
            }
          }
        ]
      }
    ]
    

Peristiwa Google Ads

ID tujuan produk untuk menyerap peristiwa adalah ID tindakan konversi.

Untuk mendapatkan ID tindakan konversi dari UI Google Ads:

  1. Buka Konversi di UI Google Ads.
  2. Klik nama tindakan konversi untuk melihat detail.
  3. ID tindakan konversi adalah nilai untuk parameter kueri URL yang bernama ctId.

    https://ads.google.com/aw/conversions/detail?ocid=...&ctId=CONVERSION_ACTION_ID&...
    

Untuk mendapatkan ID tindakan konversi dari Google Ads API:

  1. Kirim permintaan Search atau SearchStream ke GoogleAdsService dengan kueri berikut:

    SELECT
      conversion_action.id,
      conversion_action.name
    FROM conversion_action
    WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'
    
  2. Dapatkan ID tindakan konversi dari kolom id di conversion_action dalam respons.

    [
      {
        "results": [
          {
            "conversionAction": {
              "resourceName": "customers/CUSTOMER_ID/conversionActions/CONVERSION_ACTION_ID",
              "id": "CONVERSION_ACTION_ID",
              "name": "CONVERSION_ACTION_NAME"
            }
          }
        ]
      }
    ]
    

Audiens Display & Video 360

ID tujuan produk untuk memasukkan anggota audiens adalah ID audiens.

Untuk mendapatkan ID audiens dari UI Display & Video 360:

  1. Login ke UI Display & Video 360 di https://displayvideo.google.com.
  2. Buka partner atau pengiklan Display & Video 360 yang Anda gunakan untuk operating_account.
  3. Buka Audiens di menu kiri, lalu pilih Semua audiens.
  4. Temukan audiens dalam daftar. ID audiens adalah angka di samping nama di kolom Nama.

Peristiwa Google Analytics

ID tujuan produk untuk menyerap peristiwa adalah ID pengukuran aliran data.

Menentukan tempat kredensial memiliki akses

Kredensial yang Anda gunakan untuk mengotorisasi permintaan Data Manager API dikaitkan dengan Akun Google tertentu.

  • Jika Anda menggunakan kredensial pengguna, permintaan akan diizinkan sebagai Akun Google pengguna yang memberikan izin untuk bertindak atas nama mereka saat Anda membuat kredensial.
  • Jika Anda menggunakan kredensial akun layanan, permintaan akan diotorisasi sebagai Akun Google akun layanan.

Berikut cara memverifikasi bahwa Akun Google untuk kredensial Anda memiliki akses ke akun Google Ads, Display & Video 360, atau Google Analytics.

Google Ads atau partner data

  1. Buka Akses dan keamanan di UI Google Ads untuk login_account.
  2. Pilih tab Pengguna.
  3. Jika login_account adalah akun pengelola Google Ads, nonaktifkan tombol Tampilkan pengguna dalam hierarki lengkap untuk menyembunyikan pengguna dari akun turunan.
  4. Pastikan Akun Google untuk kredensial Anda ada dalam daftar akun yang ditampilkan di tab Pengguna.

Display & Video 360

  1. Buka Pengelolaan pengguna dan preferensi email di UI Display & Video 360.
  2. Pastikan Pengelolaan pengguna menunjukkan bahwa Akun Google untuk kredensial Anda adalah pengguna di login_account.

Google Analytics

  1. Buka Pengelolaan akses properti di UI Google Analytics.
  2. Pastikan properti Google Analytics yang ditentukan di login_account dipilih.
  3. Pastikan Akun Google untuk kredensial Anda memiliki peran Editor atau Administrator di properti tersebut.