Rodzaje kont w interfejsie Google Ads API

Z tego dokumentu dowiesz się, jakie terminy są używane do opisywania kont w interfejsie Google Ads API i jak się one odnoszą do siebie.

Przegląd

Interfejs Google Ads API używa kilku terminów do opisywania kont, co czasami może prowadzić do nieporozumień. Zrozumienie tych różnic jest ważne do 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 główne konto służące do zarządzania wieloma kontami Google Ads.

  • Poprzednia nazwa: wcześniej było to „MCK” (Moje Centrum Klienta). Ten termin może być nadal widoczny w starszej dokumentacji lub dyskusjach.
  • Cel: używaj konta menedżera, gdy chcesz połączyć się z wieloma kontami i zarządzać nimi w ramach jednej hierarchii.
  • Reprezentacja w interfejsie API: identyfikowane przez zasób Customer w którym customer.manager ma wartość true.

Konto reklamodawcy (wyświetlania)

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

  • Cel: to miejsce, w którym tworzone i wyświetlane są kampanie, grupy reklam, grupy komponentów i reklamy.
  • Reprezentacja w interfejsie API: identyfikowane przez zasób Customer w którym customer.manager ma wartość false.

Konto klienta

Konto klienta to dowolne konto (konto reklamodawcy lub inne konto menedżera), które jest połączone z nadrzędnym kontem menedżera w hierarchii i 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 w interfejsie API: aby sprawdzić konta w hierarchii menedżera, użyj zapytania CustomerClient, a do zarządzania połączeniami między kontami menedżera i kontami klienta – CustomerClientLink.

Klient

W kontekście interfejsu API klient 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 identyfikowany przez customer_id.
  • Rola: charakter konta (menedżera lub wyświetlania) zależy od konkretnego zasobu.

Konto testowe

Konta testowe to specjalne konta reklamodawcy zorganizowane w ramach specjalnego testowego konta menedżera przeznaczonego do testowania integracji z interfejsem API. Zarówno testowe konto menedżera, jak i testowe konta reklamodawcy pod nim mają swoje customer.test_account pole ustawione na true. Nie można tworzyć kont testowych na koncie menedżera w wersji produkcyjnej.

  • Cel: konta testowe umożliwiają testowanie wywołań interfejsu API bez wyświetlania reklam na żywo i ponoszenia kosztów. Nie wyświetlają reklam na żywo.
  • Reprezentacja w interfejsie API: identyfikowane przez zasób Customer w którym customer.test_account ma wartość true (a 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 jest kontem menedżera.
  • Konta B, C i D są kontami klienta w stosunku do swoich kont nadrzędnych.
  • Konta B i D są kontami reklamodawcy (wyświetlania).
  • Konto C jest zarówno kontem klienta (w stosunku do konta A), jak i kontem menedżera (w stosunku do konta D).