Firmy zewnętrzne nie są bezpośrednimi użytkownikami Ad Managera, ponieważ mogą nie mieć własnej sieci Ad Managera. Zamiast tego tworzą usługi lub integracje z Ad Managerem dla swoich klientów, którzy są klientami Ad Managera. W tym przewodniku znajdziesz podstawowe informacje o integracji z usługami innych firm, a także sprawdzone metody, porady i wskazówki.
W tym przewodniku zakładamy, że masz praktyczną wiedzę na temat interfejsu API Ad Managera. Jeśli nie znasz interfejsu API Ad Managera, zapoznaj się z 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 wymagana żadna dodatkowa zgoda od Google, ale pamiętaj, że uzyskując dostęp do interfejsu API Ad Managera lub korzystając z niego, akceptujesz warunki korzystania z tego interfejsu.
Jak przetestować integrację z Ad Managerem jako firma zewnętrzna
Jako firma zewnętrzna możesz się zastanawiać, jak przetestować integrację z Ad Managerem przed uruchomieniem jej w sieciach produkcyjnych klientów. Zalecamy utworzenie sieci testowej. Nie musisz być klientem Ad Managera, aby to zrobić. Każda osoba z kontem Google może utworzyć sieć testową.
Pamiętaj jednak o różnicach między sieciami testowymi i produkcyjnymi. Sieci testowe nie mogą wyświetlać reklam. Sieci testowe nie muszą też zawierać wszystkich funkcji, które klienci mogą mieć dostępne w swoich sieciach produkcyjnych. Jeśli chcesz przetestować funkcje Ad Managera, które nie są dostępne w Twojej sieci testowej, możesz kupić dostęp do sieci nietestowej u sprzedawcy Ad Managera.
Dodatkowo należy jasno poinformować klientów, jakie funkcje muszą być dostępne w ich sieci produkcyjnej, aby aplikacja działała prawidłowo. Aplikacja powinna obsługiwać przypadki, w których funkcje mogą nie istnieć, przez przechwytywanie wyjątków i łagodne kończenie działania lub prowadzenie listy klientów i funkcji, które każdy z nich ma lub których nie ma. Klient powinien współpracować z osobą kontaktową w Google, aby zarządzać funkcjami w swojej sieci.
Uwierzytelnianie: jak prawidłowo uzyskać dostęp do sieci Ad Managera klienta
Aby aplikacja mogła uzyskać dostęp do sieci Ad Managera klienta, musisz skonfigurować proces uwierzytelniania w bezpieczny sposób.
Wymaga to wykonania 2 czynności:
- 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 konto główne, którego będziesz używać w przypadku wszystkich klientów. Pierwsza opcja jest bezpieczniejsza, jeśli jedno z Twoich kont zostanie przejęte. W tym drugim przypadku wystarczy wykonać krok 1 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, które zostało dla niego utworzone, jako użytkownika do jego sieci Ad Managera.
1. Tworzenie konta Google
Istnieje kilka sposobów tworzenia konta Google, które można dodać do sieci Ad Managera.
Opcja 1. Utwórz konto usługi OAuth2, które wygeneruje 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, dokończ rejestrację 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 oba te rodzaje kont nazywamy „zwykłymi” kontami Google.
2. Poproś klienta o dodanie Twojego konta Google do jego sieci.
Gdy uzyskasz konto Google, aby uzyskać 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ś o dodanie go do 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 omów z klientem, jakie role i uprawnienia powinno mieć Twoje konto, aby aplikacja mogła uzyskać dostęp do potrzebnych danych w sieci klienta.
Teraz możesz zacząć wykonywać wywołania interfejsu API do sieci Ad Managera klienta. Upewnij się, że nagłówek SOAP networkCode jest ustawiony na kod sieci klienta, dla którego wykonujesz wywołanie interfejsu API. Wszystkie nasze biblioteki klienta umożliwiają ustawienie tego programowo. Na przykład w bibliotece klienta Java dla reklam możesz programowo ustawić kod sieci podczas tworzenia instancji DfpSession.
Bądź na bieżąco z interfejsem API
Ważne jest, aby na bieżąco sprawdzać, które wersje interfejsu API zostały wycofane lub wyłączone oraz kiedy zostały wydane nowe wersje. Nie chcesz, aby wycofanie wersji Cię zaskoczyło i spowodowało problemy u Twoich klientów. Nie zawsze jesteśmy w stanie skontaktować się z firmami zewnętrznymi w sprawie zbliżającego się wycofania i zakończenia obsługi, tak jak robimy to w przypadku naszych klientów. Dlatego musisz zasubskrybować jeden z naszych 3 głównych kanałów, aby otrzymywać aktualizacje interfejsu API, i dostosować ustawienia powiadomień:
Na naszej stronie dla deweloperów udostępniamy też harmonogram wycofywania, który należy regularnie sprawdzać.