Mengonfigurasi tujuan dan header

Konsep Destination dan header permintaan sering muncul saat bekerja dengan Data Manager API. Baca panduan ini untuk memahami cara mengonfigurasi tujuan dan header untuk berbagai skenario.

Kapan harus menggunakan tujuan atau header

• Gunakan Destination dalam permintaan penyerapan. Permintaan penyerapan menggunakan IngestionService untuk menambahkan atau menghapus anggota dalam audiens atau mengirim peristiwa. Daftar destinations 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.

  Anda dapat menyertakan beberapa tujuan dalam permintaan penyerapan yang sama.

  Tips: Jangan tetapkan header permintaan dalam permintaan IngestionService. Data Manager API mengabaikan header dalam permintaan penyerapan.

• Gunakan header permintaan dalam permintaan pengelolaan resource yang membuat, memperbarui, menghapus, atau mengambil resource. Header menentukan jalur akses untuk kredensial permintaan ke akun target permintaan pengelolaan resource. Berikut daftar resource dengan metode pengelolaan resource yang mendukung header permintaan:

  • Insights
  • PartnerLink
  • UserList
  • UserListDirectLicense
  • UserListGlobalLicense
  • UserListGlobalLicenseCustomerInfo

Misalnya, jika Anda ingin membuat audiens, menambahkan anggota ke audiens, memeriksa diagnostik, lalu mengambil audiens untuk memeriksa ukurannya, berikut setiap langkah, jenis permintaan yang akan digunakan, dan apakah Anda harus menggunakan tujuan atau header permintaan:

Langkah	Jenis permintaan	Header tujuan atau permintaan
Buat audiens	Pengelolaan resource	Header permintaan
Menambahkan anggota ke audiens	Penyerapan	Tujuan
Periksa diagnostik	Penyerapan	Tujuan
Mengambil audiens	Pengelolaan resource	Header permintaan

Beralihlah di antara detail dalam panduan ini untuk setiap jenis permintaan dengan mengklik tab Penyerapan atau Pengelolaan resource di sekitar setiap tabel.

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

• Google Ads
• Display & Video 360
• Google Analytics

Jika Anda adalah partner data, buka Skenario partner data untuk mengetahui contoh cara menyetel header dan membuat Destination untuk mengelola resource dan mengirim data ke akun dengan link produk ke akun partner data Anda:

• Google Ads
• Display & Video 360
• Google Analytics

Bagian Persyaratan mendetail membahas persyaratan dan aturan validasi secara mendalam.

Skenario pengiklan

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

Google Ads

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

Akun pengelola M1

M1 memiliki dua akun turunan langsung:

1. Akun pengelola M2
2. Akun klien C1

Akun Google [e-mail] adalah pengguna di M1.

Akun pengelola M2

M2 memiliki dua akun turunan langsung:

1. Akun klien C1
2. Akun klien C2

Akun Google [e-mail] adalah pengguna di M2.

Akun klien C1

C1 memiliki dua akun pengelola induk langsung:

1. Akun pengelola M1
2. Akun pengelola M2

Akun Google [e-mail] 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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ADS/accounts/GOOGLE_ADS_CUSTOMER_ID
linked-account	Jangan tetapkan header linked-account.

Berikut adalah contoh skenario akses langsung, menggunakan akun dari diagram dan kredensial untuk Akun Google [e-mail]:

Penyerapan

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

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

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ADS/accounts/C1_CUSTOMER_ID
linked-account	Jangan tetapkan header linked-account.

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID
linked-account	Jangan tetapkan header linked-account.

Berikut contoh skenario akses pengelola untuk akun klien Google Ads C2 dari diagram dan kredensial untuk Akun Google [e-mail]:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_ID
linked-account	Jangan tetapkan header linked-account.

Berikut contoh lain skenario akses pengelola untuk akun klien Google Ads C2 dan kredensial untuk Akun Google [e-mail], yang merupakan pengguna di akun pengelola Google Ads M1:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ADS/accounts/M1_CUSTOMER_ID
linked-account	Jangan tetapkan header linked-account.

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Jangan tetapkan header linked-account.

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

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DISPLAY_VIDEO_ADVERTISER/accounts/DISPLAY_VIDEO_ADVERTISER_ID
linked-account	Jangan tetapkan header linked-account.

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

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

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

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 DISPLAY_VIDEO_PARTNER_ID, dan akun pengiklan Display & Video 360 DISPLAY_VIDEO_ADVERTISER_ID harus merupakan turunan dari akun partner DISPLAY_VIDEO_PARTNER_ID.

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

Google Analytics

Catatan: Jika operating_account adalah akun Google Analytics, maka jangan tetapkan login_account atau tetapkan ke nilai yang sama dengan operating_account. Jika tidak, permintaan akan gagal dengan error OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH.

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Jangan tetapkan header linked-account.

Berikut contoh Destination untuk mengirim peristiwa ke Google Analytics:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/GOOGLE_ANALYTICS_PROPERTY/accounts/PROPERTY_ID
linked-account	Jangan tetapkan header linked-account.

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.

Catatan: Dalam setiap skenario partner data, kredensial harus berupa Akun Google yang merupakan pengguna di akun partner data.

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

Google Ads

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

Partner data H1

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

Akun Google [e-mail] adalah pengguna di D1.

Partner data D2

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

Akun Google [e-mail] 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 [e-mail] guna mengirim data ke akun pengelola M2, akun klien C1, atau akun klien C2, menggunakan tujuan dengan login_account yang ditetapkan ke akun partner data D1 dan linked_account yang 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 [e-mail] 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.

• Partner data D1 ditautkan ke akun pengelola Google Ads. Berikut adalah contoh skenario penautan produk pengelola.
• Partner data D2 ditautkan ke akun klien Google Ads. Berikut adalah contoh skenario link produk langsung.

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

Berikut contoh skenario link produk langsung menggunakan akun dari diagram, dan header permintaan yang sesuai untuk permintaan pengelolaan resource. 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 [e-mail]:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/D2_CUSTOMER_ID
linked-account	Jangan tetapkan header linked-account.

Skenario penautan produk pengelola

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

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/MANAGER_CUSTOMER_ID

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 [e-mail]:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/D1_CUSTOMER_ID
linked-account	accountTypes/GOOGLE_ADS/accounts/M2_CUSTOMER_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.

Skenario link produk langsung

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

Berikut adalah contoh Destination untuk skenario link produk langsung untuk mengirim data ke pengiklan Display & Video 360, dan header permintaan yang sesuai untuk permintaan pengelolaan resource:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

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.

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

Berikut adalah contoh Destination untuk skenario link produk langsung guna mengirim data ke partner Display & Video 360, dan header permintaan yang sesuai untuk permintaan pengelolaan resource:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	Jangan tetapkan header linked-account.

Skenario penautan produk partner Display & Video 360

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:

Penyerapan

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.

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_ID

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:

Penyerapan

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

Pengelolaan resource

Header permintaan
login-account	accountTypes/DATA_PARTNER/accounts/DATA_PARTNER_ID
linked-account	accountTypes/DISPLAY_VIDEO_PARTNER/accounts/DISPLAY_VIDEO_PARTNER_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 untuk permintaan IngestionService, header permintaan yang setara untuk permintaan pengelolaan resource, 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:

• Akun Google Ads
• Akun pengiklan Display & Video 360
• Akun partner Display & Video 360
• Properti Google Analytics
• Akun partner data jika mengirim data ke audiens yang dimiliki oleh akun partner data.

Tidak ada header permintaan yang sesuai dengan kolom operating_account dari Destination. Saat mengirim permintaan pengelolaan resource, akun target permintaan adalah akun operasi.

kolom login_account dan header permintaan login-account

login_account tidak selalu diperlukan, dan secara default adalah operating_account dalam permintaan IngestionService, dan akun target dalam permintaan pengelolaan resource. Dalam permintaan pengelolaan resource, gunakan header permintaan login-account untuk mengidentifikasi akun login.

Data Manager API memverifikasi bahwa:

1. Akun Google kredensial adalah pengguna di akun login.

2. Akun login adalah salah satu dari berikut:

   • Sama dengan operating_account. Ini adalah nilai default jika Anda tidak menyetel login_account dari Destination dalam permintaan IngestionService, atau tidak menyetel header login-account dalam permintaan pengelolaan resource.

   • Akun pengelola Google Ads atau partner Display & Video 360 yang merupakan induk dari operating_account dalam permintaan IngestionService, atau induk dari akun target dalam permintaan pengelolaan resource.

   • Akun partner data dengan link produk ke linked_account dalam permintaan IngestionService, atau header linked-account dalam permintaan pengelolaan resource.

kolom linked_account dan header permintaan linked-account

Catatan: Hanya tentukan akun tertaut jika akun login telah disetel account_type ke DATA_PARTNER dan induk operating_account ditautkan ke akun partner data. Jika operating_account ditautkan langsung ke akun partner data, jangan tetapkan linked_account.

linked_account menunjukkan akun mana yang memiliki penautan produk ke login_account permintaan IngestionService, atau akun target permintaan pengelolaan resource.

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. Ambil ID ini menggunakan UI Google Ads atau Data Manager API.

UI Google Ads

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.

Data Manager API

Ambil UserList menggunakan metode List, berikan header permintaan jika diperlukan, dan gunakan id dari UserList untuk ID tujuan produk.

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. Ambil ID ini menggunakan UI Display & Video 360 atau Data Manager API.

UI Display & Video 360

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.

Data Manager API

Ambil UserList menggunakan metode List, berikan header permintaan jika diperlukan, dan gunakan id dari UserList untuk ID tujuan produk.

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.