Jenis akun di Google Ads API

Dokumen ini menjelaskan berbagai istilah yang digunakan untuk mendeskripsikan akun di Google Ads API dan hubungannya satu sama lain.

Ringkasan

Google Ads API menggunakan beberapa istilah untuk mendeskripsikan akun, yang terkadang dapat menyebabkan kebingungan. Memahami perbedaan ini penting untuk mengelola akun dan menafsirkan respons API.

Jenis akun

Definisi berikut menjelaskan berbagai jenis akun yang akan Anda temui saat menggunakan Google Ads API.

Akun pengelola

Akun pengelola adalah akun utama yang digunakan untuk mengelola beberapa akun Google Ads.

• Nama sebelumnya: Sebelumnya dikenal sebagai "MCC" (Pusat Klien Saya). Anda mungkin masih melihat istilah ini dalam dokumentasi atau diskusi lama.
• Tujuan: Gunakan akun pengelola jika Anda ingin menautkan dan mengelola beberapa akun melalui satu hierarki.
• Representasi API: Diidentifikasi oleh resource Customer dengan customer.manager adalah true.

Akun pengiklan (penayangan)

Akun pengiklan (atau akun penayangan) adalah akun Google Ads perorangan yang menjalankan kampanye iklan.

• Tujuan: Di sinilah kampanye, grup iklan, grup aset, dan iklan dibuat dan ditayangkan.
• Representasi API: Diidentifikasi oleh resource Customer dengan customer.manager adalah false.

Akun klien

Akun klien adalah akun apa pun (baik akun pengiklan maupun akun pengelola lain) yang ditautkan ke dan dikelola oleh akun pengelola yang lebih tinggi dalam hierarki.

• Konteks: Istilah "klien" mengacu pada hubungan dalam hierarki (dikelola oleh pengelola), bukan berarti "klien" dalam arti bisnis.
• Representasi API: Kueri CustomerClient untuk memeriksa akun dalam hierarki pengelola, dan gunakan CustomerClientLink untuk mengelola penautan antara akun pengelola dan klien.

Pelanggan

Dalam konteks API, Pelanggan adalah resource yang merepresentasikan akun Google Ads, baik akun pengelola maupun akun pengiklan.

• Representasi: Semua akun diwakili oleh resource Customer, yang diidentifikasi oleh customer_id.
• Peran: Jenis akun (pengelola atau penayangan) bergantung pada resource tertentu.

Akun percobaan

Akun pengujian adalah akun pengiklan khusus yang disusun dalam akun pengelola pengujian khusus untuk menguji integrasi API. Akun pengelola pengujian dan akun pengiklan pengujian di bawahnya telah menetapkan kolom customer.test_account ke true. Akun pengujian tidak dapat dibuat di akun pengelola produksi.

• Tujuan: Akun uji coba memungkinkan Anda menguji panggilan API tanpa menayangkan iklan aktif atau menimbulkan biaya. Item baris ini tidak menayangkan iklan live.
• Representasi API: Diidentifikasi oleh resource Customer dengan customer.test_account adalah true (dengan customer.manager yang membedakan akun pengelola pengujian dari akun pengiklan pengujian).

Contoh hierarki

Hierarki standar terlihat seperti ini:

• Akun Pengelola A (Tingkat teratas)
  • Akun Klien B (Akun pengiklan)
  • Akun Klien C (Akun pengelola lain)
    • Akun Klien D (Akun pengiklan)

Dalam contoh ini:

• Akun A adalah akun pengelola.
• Akun B, C, dan D adalah akun klien relatif terhadap induknya.
• Akun B dan D adalah akun pengiklan (penayangan).
• Akun C adalah akun klien (untuk A) dan akun pengelola (untuk D).