Rodzaje kont w interfejsie Google Ads API

W tym dokumencie wyjaśniamy różne terminy używane do opisywania kont w interfejsie Google Ads API oraz ich wzajemne powiązania.

Przegląd

Interfejs Google Ads API używa kilku terminów do opisywania kont, co może czasami prowadzić do nieporozumień. Zrozumienie tych różnic jest ważne dla zarządzania kontami i interpretowania odpowiedzi interfejsu API.

Rodzaje kont

Poniższe definicje wyjaśniają różne rodzaje kont, które napotkasz podczas pracy z interfejsem Google Ads API.

Konto menedżera

Konto menedżera to konto główne służące do zarządzania wieloma kontami Google Ads.

• Poprzednia nazwa: wcześniej usługa ta była znana jako „MCK” (Moje Centrum Klienta). Możesz nadal zobaczyć ten termin w starszej dokumentacji lub dyskusjach.
• Cel: używaj konta menedżera, gdy chcesz połączyć wiele kont i zarządzać nimi w ramach jednej hierarchii.
• Reprezentacja interfejsu API: identyfikowana przez zasób Customer, gdzie customer.manager to true.

Konto reklamodawcy (wyświetlania reklam)

Konto reklamodawcy (lub konto wyświetlania reklam) to indywidualne konto Google Ads, na którym prowadzone są kampanie reklamowe.

• Cel: to tutaj tworzone i wyświetlane są kampanie, grupy reklam, grupy komponentów i reklamy.
• Reprezentacja interfejsu API: identyfikowana przez zasób Customer, gdzie customer.manager to false.

Konto klienta

Konto klienta to dowolne konto (konto reklamodawcy lub inne konto menedżera), które jest połączone z kontem menedżera nadrzędnym w hierarchii i jest przez nie zarządzane.

• Kontekst: termin „klient” odnosi się do relacji w hierarchii (zarządzanej przez menedżera), a niekoniecznie do „klienta” w sensie biznesowym.
• Reprezentacja interfejsu API: zapytanie CustomerClient do sprawdzania kont w hierarchii menedżera i CustomerClientLink do zarządzania połączeniami między kontami menedżera i kontami klienta.

Klient

W kontekście interfejsu API Customer to zasób reprezentujący dowolne konto Google Ads, niezależnie od tego, czy jest to konto menedżera czy konto reklamodawcy.

• Reprezentacja: wszystkie konta są reprezentowane przez zasób Customer, który jest identyfikowany przez customer_id.
• Rola: charakter konta (menedżer lub konto wyświetlające reklamy) zależy od konkretnego zasobu.

Konto testowe

Konta testowe to specjalne konta reklamodawców, które są przypisane do dedykowanego testowego konta menedżera i służą do testowania integracji interfejsu API. Zarówno testowe konto menedżera, jak i testowe konta reklamodawcy, które się na nim znajdują, mają pole customer.test_account ustawione na true. Kont testowych nie można tworzyć na produkcyjnym koncie menedżera.

• Cel: konta testowe umożliwiają testowanie wywołań interfejsu API bez wyświetlania reklam i ponoszenia kosztów. Nie wyświetlają reklam na żywo.
• Reprezentacja interfejsu API: identyfikowane przez zasób Customer, gdzie customer.test_account to true (przy czym customer.manager odróżnia testowe konto menedżera od testowego konta reklamodawcy).

Przykład hierarchii

Typowa hierarchia wygląda tak:

• Konto menedżera A (najwyższy poziom)
  • Konto klienta B (konto reklamodawcy)
  • Konto klienta C (inne konto menedżera)
    • Konto klienta D (konto reklamodawcy)

W tym przykładzie:

• Konto A to konto menedżera.
• Konta B, C i D są kontami klienta w stosunku do kont nadrzędnych.
• Konta B i D to konta reklamodawcy (konta wyświetlania reklam).
• Konto C jest zarówno kontem klienta (dla konta A), jak i kontem menedżera (dla konta D).