Setiap Destination dalam
IngestAudienceMembersRequest atau
IngestEventsRequest menentukan:
- Akun yang menerima data. Misalnya, akun Google Ads atau properti Google Analytics.
- Entitas tujuan untuk data dalam akun, seperti tindakan konversi Google Ads atau aliran Google Analytics.
- 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.
Google Ads
Berikut adalah diagram yang menunjukkan contoh kumpulan akun dan pengguna Google Ads.
- Akun pengelola M1
M1 memiliki dua akun turunan langsung:
- Akun pengelola M2
- Akun klien C1
Akun Google
cloudysanfrancisco@gmail.comadalah pengguna di M1.- Akun pengelola M2
M2 memiliki dua akun turunan langsung:
- Akun klien C1
- Akun klien C2
Akun Google
baklavainthebalkans@gmail.comadalah pengguna di M2.- Akun klien C1
C1 memiliki dua akun pengelola induk langsung:
- Akun pengelola M1
- Akun pengelola M2
Akun Google
jeffersonloveshiking@gmail.comadalah 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 |
|
||||
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 |
|
||||
login_account |
|
||||
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:
- Akses langsung, dengan kredensial untuk Akun Google yang merupakan pengguna di akun partner atau pengiklan Display & Video 360.
- 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 |
|
||||
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 |
|
||||
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 |
|
||||
login_account |
|
||||
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 |
|
||||
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.
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.
- Partner data H1
Penautan produk ada antara D1 dan akun pengelola Google Ads M2.
Akun Google
222larabrown@gmail.comadalah pengguna di D1.- Partner data D2
Penautan produk ada antara D2 dan akun klien Google Ads C1.
Akun Google
jeffersonloveshiking@gmail.comadalah pengguna di D2.- Akun pengelola M1
M1 memiliki dua akun turunan langsung:
- Akun pengelola M2
- Akun klien C1
- Akun pengelola M2
M2 memiliki dua akun turunan langsung:
- Akun klien C1
- Akun klien C2
- Akun klien C1
C1 memiliki dua akun pengelola induk langsung:
- Akun pengelola M1
- 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.comguna mengirim data ke akun pengelola M2, akun klien C1, atau akun klien C2, menggunakan tujuan denganlogin_accountditetapkan ke akun partner data D1 danlinked_accountditetapkan 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.comguna mengirim data ke akun klien C1, menggunakan tujuan denganlogin_accountyang ditetapkan ke akun partner data D2 danlinked_accountyang 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:
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
linked_account |
|
||||
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:
- Gunakan link produk langsung antara akun partner data dan akun partner atau pengiklan Display & Video 360.
- 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:
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
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 |
|
||||
login_account |
|
||||
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"
}
]
}
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:
| Destination | |||||
|---|---|---|---|---|---|
operating_account |
|
||||
login_account |
|
||||
linked_account |
|
||||
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_accountoperating_accountwajib diisi.operating_accountmenunjukkan akun mana yang menerima data dalam permintaan.operating_accountdapat 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.
login_accountlogin_accounttidak selalu diperlukan, dan defaultnya adalahoperating_account.Data Manager API memverifikasi bahwa:
Akun Google kredensial adalah pengguna di
login_account.login_accountadalah salah satu dari berikut ini:Sama dengan
operating_account. Nilai ini adalah nilai default jika Anda tidak menetapkanlogin_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_accountmenunjukkan akun mana yang memiliki link produk kelogin_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:
- Buka Pengelola audiens di UI Google Ads.
- Klik nama audiens untuk melihat detail.
- ID audiens tercantum di samping ID Daftar.
Untuk mendapatkan ID audiens dari Google Ads API:
Kirim permintaan
SearchatauSearchStreamkeGoogleAdsServicedengan kueri berikut:SELECT user_list.id, user_list.name FROM user_list WHERE user_list.name = 'USER_LIST_NAME'Dapatkan ID audiens dari kolom
iddiuser_listdalam 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:
- Buka Konversi di UI Google Ads.
- Klik nama tindakan konversi untuk melihat detail.
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:
Kirim permintaan
SearchatauSearchStreamkeGoogleAdsServicedengan kueri berikut:SELECT conversion_action.id, conversion_action.name FROM conversion_action WHERE conversion_action.name = 'CONVERSION_ACTION_NAME'Dapatkan ID tindakan konversi dari kolom
iddiconversion_actiondalam 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:
- Login ke UI Display & Video 360 di https://displayvideo.google.com.
- Buka partner atau pengiklan Display & Video 360 yang Anda gunakan untuk
operating_account. - Buka Audiens di menu kiri, lalu pilih Semua audiens.
- 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
- Buka Akses dan keamanan
di UI Google Ads untuk
login_account. - Pilih tab Pengguna.
- Jika
login_accountadalah akun pengelola Google Ads, nonaktifkan tombol Tampilkan pengguna dalam hierarki lengkap untuk menyembunyikan pengguna dari akun turunan. - Pastikan Akun Google untuk kredensial Anda ada dalam daftar akun yang ditampilkan di tab Pengguna.
Display & Video 360
- Buka Pengelolaan pengguna dan preferensi email di UI Display & Video 360.
- Pastikan Pengelolaan pengguna menunjukkan bahwa Akun Google untuk kredensial Anda adalah pengguna di
login_account.
Google Analytics
- Buka Pengelolaan akses properti di UI Google Analytics.
- Pastikan properti Google Analytics yang ditentukan di
login_accountdipilih. - Pastikan Akun Google untuk kredensial Anda memiliki peran Editor atau Administrator di properti tersebut.