Firmy zewnętrzne nie są bezpośrednimi użytkownikami Ad Managera, ponieważ mogą nie mieć własnej sieci Ad Managera. Zamiast tego tworzy usługi i integracje z Ad Managerem dla swoich klientów, którzy korzystają z tej usługi. Ten przewodnik zawiera podstawowe informacje o integracji z usługami innych firm oraz zawiera sprawdzone metody, porady i wskazówki.
W tym przewodniku zakładamy, że masz już praktyczną wiedzę na temat interfejsu Ad Manager API. Jeśli nie znasz jeszcze interfejsu Ad Manager API, zapoznaj się z dokumentacją dla początkujących.
Pierwsze kroki jako firma zewnętrzna
Aby uzyskać dostęp do sieci klienta Ad Managera za pomocą interfejsu API Ad Managera, postępuj zgodnie z poniższymi wskazówkami. Nie jest wymagane dodatkowe zatwierdzenie ze strony Google. Pamiętaj jednak, że korzystając z interfejsu API Ad Managera, zgadzasz się na Warunki korzystania z tego interfejsu.
Testowanie integracji z Ad Managerem jako firma zewnętrzna
Jako firma zewnętrzna możesz zastanawiać się, jak przetestować integrację z Ad Managerem, zanim zaczniesz mierzyć skuteczność w sieciach produkcyjnych klientów. Zalecamy utworzenie sieci testowej. Nie musisz być klientem Ad Managera, Każdy z kontem Google może utworzyć sieć testową.
Zwróć jednak uwagę na różnice między sieciami testowymi a produkcyjnymi. Sieci testowe nie mogą wyświetlać reklam. Ponadto sieci testowe nie muszą zawierać wszystkich funkcji, które są dostępne w sieciach produkcyjnych Twoich klientów. Jeśli chcesz przetestować działanie funkcji Ad Managera, które są niedostępne w Twojej sieci testowej, możesz kupić dostęp do sieci innej niż testowa od sprzedawcy Ad Managera.
Dodatkowo wyjaśnij klientom, jakie funkcje muszą być dostępne w sieci produkcyjnej, aby aplikacja działała prawidłowo. Aplikacja powinna obsługiwać przypadki, w których funkcje mogą nie istnieć, bo wykrywają wyjątki i wpadają w pamięć, a także przechowuje listę klientów z listą funkcji i ich brakiem. Obowiązkiem klienta powinna być współpraca z jego osobą kontaktową w Google przy zarządzaniu funkcjami w jego 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ć przepływ pracy uwierzytelniania w bezpieczny sposób.
Wymaga to wykonania 2 kroków:
- 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 swojej sieci Ad Managera.
W pierwszym kroku możesz utworzyć osobne konto Google dla każdego klienta lub główne, którego będziesz używać dla wszystkich klientów. Pierwsza opcja jest bezpieczniejsza w przypadku przejęcia jednego z kont. Oznacza to, że krok 1 wystarczy tylko raz.
Bez względu na to, co zrobisz w kroku 1, w kroku 2 musisz poprosić każdego nowego klienta, żeby dodał do jego sieci Ad Managera odpowiednie konto Google, które zostało dla niego utworzone jako użytkownika.
1. Tworzenie konta Google
Konto Google, które można dodać do sieci Ad Managera, można utworzyć na różne sposoby.
Opcja 1. Utwórz konto usługi OAuth2, które wygeneruje adres e-mail konta usługi będącego kontem 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ć tego konta. Na potrzeby niniejszego przewodnika będziemy je nazywać „zwykłym” kontem Google.
2. Poproś klienta o dodanie Twojego konta Google do swojej sieci
Po uzyskaniu konta Google umożliwiającego dostęp do sieci klienta poproś go o dodanie tego konta jako nowego użytkownika w sieci Ad Managera.
Jeśli podajesz adres e-mail konta usługi OAuth2, poproś go o dodanie go do swojej sieci.
Jeśli udostępniasz mu zwykłe konto Google, poproś go o dodanie Twojego konta jako użytkownika do swojej sieci.
Niezależnie od tego, którą wybierzesz, przedyskutuj z klientem role i uprawnienia, które powinny mieć Twoje konto, aby aplikacja mogła uzyskiwać dostęp do potrzebnych danych w sieci klienta.
Teraz możesz wywoływać interfejs API w sieci Ad Managera klienta. Pamiętaj, aby ustawić nagłówek SOAP NetworkCode na kod sieci klienta, do którego wysyłasz wywołanie interfejsu API. Wszystkie nasze biblioteki klienckie umożliwiają automatyczne konfigurowanie tych ustawień. Na przykład w bibliotece klienta reklam w języku Java możesz automatycznie ustawić kod sieci podczas tworzenia wystąpienia DfpSession.
Bądź na bieżąco z interfejsem API
Ważne jest, aby na bieżąco śledzić, które wersje interfejsu API są wycofywane lub wyłączone oraz kiedy pojawią się nowe wersje. Dzięki temu unikniesz zagubienia wersji i unikniesz obaw, że stracisz klienta. Nie zawsze możemy kontaktować się z firmami zewnętrznymi w sprawie nadchodzących wycofywania produktów lub usług, jak robimy to w przypadku naszych klientów. W związku z tym Twoim obowiązkiem jest zasubskrybowanie jednego z naszych 3 głównych kanałów, na którym będziesz otrzymywać informacje o aktualizacjach interfejsu API i dostosowanie ustawień powiadomień:
- nasza grupa ogłoszeń o wycofaniu interfejsów API Ad Managera.
- na naszym blogu dla programistów reklam.
Na stronie dewelopera dostępny jest też harmonogram wycofywania, który należy regularnie sprawdzać.
Korzystanie z pomocy
Jeśli napotkasz problemy z integracją z Ad Managerem, w zależności od problemu możesz skorzystać z tych kanałów pomocy. Jeśli masz pytania na poziomie produktów, napisz je na forach usług Ad Managera. Jeśli masz pytania dotyczące interfejsu API, napisz na forach interfejsu API Ad Managera. W tym poście na blogu znajdziesz wskazówki, jak rozróżnić, czy chodzi o pytanie na poziomie produktu czy też o interfejs API.