Firmy zewnętrzne nie są bezpośrednimi użytkownikami Ad Managera, ponieważ nie mają własnej sieci Ad Managera. Zamiast tego tworzą dla swoich klientów, którzy są klientami Ad Managera, usługi lub integracje z Ad Managerem. Ten przewodnik zawiera podstawowe informacje o integracjach z firmami zewnętrznymi, a także sprawdzone metody, wskazówki i triki.
W tym przewodniku przyjęto założenie, że masz podstawową wiedzę o interfejsie API Ad Managera. Jeśli nie znasz interfejsu API Ad Managera, zapoznaj się z naszą dokumentacją dla początkujących.
Pierwsze kroki jako osoba trzecia
Aby używać interfejsu API Ad Managera do uzyskiwania dostępu do sieci klienta Ad Managera, postępuj zgodnie z poniższymi wskazówkami. Nie jest wymagane dodatkowe zatwierdzenie przez Google, ale pamiętaj, że uzyskując dostęp do interfejsu API Ad Managera lub korzystając z niego, akceptujesz warunki interfejsu API Ad Managera.
Testowanie integracji z usługą Ad Manager jako podmiot zewnętrzny
Jako podmiot zewnętrzny możesz zastanawiać się, jak przetestować integrację z Ad Managerem przed uruchomieniem jej w sieciach produkcyjnych klientów. Zalecamy utworzenie sieci testowej. Aby to zrobić, nie musisz być klientem Ad Managera. Każda osoba z kontem Google może utworzyć sieć testową.
Pamiętaj jednak o różnicach między sieciami testowymi a produkcyjnymi. Sieci testowe nie mogą wyświetlać reklam. Sieci testowe nie muszą też zawierać wszystkich funkcji, które mogą być dostępne dla klientów w ich sieciach produkcyjnych. Jeśli chcesz przeprowadzić testy funkcji Ad Managera, które nie są dostępne w Twojej sieci testowej, możesz kupić dostęp do sieci nietestowej za pośrednictwem odsprzedawcy Ad Managera.
Dodatkowo musisz jasno informować klientów o tym, jakie funkcje muszą być dostępne w ich sieci produkcyjnej, aby Twoja aplikacja działała prawidłowo. Aplikacja powinna obsługiwać przypadki, w których funkcje mogą nie istnieć, poprzez przechwytywanie wyjątków i prawidłowe działanie w przypadku awarii lub prowadzenie listy klientów i funkcji, które każdy z nich ma lub nie ma. Za zarządzanie funkcjami w swojej sieci odpowiada klient, który powinien w tym celu współpracować z osobą kontaktową w Google.
Uwierzytelnianie: jak prawidłowo uzyskać dostęp do sieci Ad Managera klienta
Aby aplikacja miała dostęp do sieci Ad Managera klienta, musisz bezpiecznie skonfigurować przepływ pracy uwierzytelniania.
Obejmuje to 2 etapy:
- Utwórz adres e-mail konta Google, którego będziesz używać do uzyskiwania dostępu do sieci klienta.
- Poproś klienta o dodanie tego konta jako użytkownika do jego sieci Ad Managera.
W kroku 1 możesz utworzyć osobne konto Google dla każdego klienta lub jedno główne konto, którego będziesz używać w przypadku wszystkich klientów. Pierwsza opcja jest bezpieczniejsza w przypadku, gdy ktoś uzyska dostęp do jednego z Twoich kont. Oznacza to, że krok 1 wystarczy wykonać tylko raz.
Niezależnie od tego, co zrobisz w kroku 1, w kroku 2 musisz poprosić każdego nowego klienta o dodanie odpowiedniego konta Google utworzonego dla niego jako użytkownika do jego sieci Ad Managera.
1. Tworzenie konta Google
Istnieją różne sposoby utworzenia konta Google, które można dodać do sieci Ad Managera.
Opcja 1. Utwórz konto usługi OAuth2, które wygeneruje dla Ciebie adres e-mail konta usługi działający jako konto Google. Instrukcje tworzenia nowego konta usługi
Opcja 2. Możesz utworzyć zwykłe konto Google (konto „Gmail”), rejestrując się jako nowy użytkownik. Jeśli masz już konto Google, zarejestruj się w oknie incognito lub w nowej sesji przeglądarki. Jeśli Twoja firma korzysta z Google Workspace, możesz utworzyć konto Google w domenie firmy i używać go zamiast konta osobistego. W tym przewodniku będziemy określać oba te typy konta jako „zwykłe” konto Google.
2. Poproś klienta o dodanie Twojego konta Google do jego sieci.
Po uzyskaniu konta Google, które umożliwia dostęp do sieci klienta, poproś go o dodanie tego konta jako nowego użytkownika w jego sieci Ad Managera.
Jeśli podajesz adres e-mail konta usługi OAuth2, poproś użytkownika, aby dodał go do swojej sieci.
Jeśli udostępniasz im zwykłe konto Google, poproś ich o dodanie Twojego konta jako użytkownika do ich sieci.
Niezależnie od wybranej metody porozmawiaj z klientem o tym, jakie role i uprawnienia powinno mieć Twoje konto, aby aplikacja mogła uzyskiwać dostęp do potrzebnych danych w sieci klienta.
Teraz możesz zacząć wykonywać wywołania interfejsu API w sieci Ad Managera klienta. Upewnij się, że nagłówek SOAP networkCode jest ustawiony na kod sieci klienta, do którego wysyłasz wywołanie interfejsu API. Wszystkie nasze biblioteki klienta umożliwiają programowe ustawianie tej opcji. Na przykład w bibliotece klienta Java do reklam możesz programowo ustawić kod sieci podczas tworzenia instancji DfpSession.
Bądź na bieżąco z interfejsem API
Ważne jest, aby być na bieżąco z informacjami o wersjach interfejsu API, które zostały wycofane lub wygaszone, oraz o datach wprowadzenia nowych wersji. Nie chcesz być zaskoczony, gdy wersja zostanie wycofana, i ryzykować, że Twoi klienci nie będą mogli korzystać z usługi. Nie zawsze możemy kontaktować się z osobami trzecimi w sprawie zbliżających się wycofań i zakończeń usług, tak jak robimy to w przypadku naszych klientów. Dlatego musisz zasubskrybować jeden z 3 głównych kanałów, na których publikujemy aktualizacje interfejsu API, i dostosować ustawienia powiadomień:
Na naszej stronie dla deweloperów udostępniamy też harmonogram wycofywania, który należy regularnie sprawdzać.