Film: sprawdzone metody – prezentacja z warsztatów w 2019 r.
Ten przewodnik zawiera sprawdzone metody, które możesz wdrożyć, aby zoptymalizować wydajność i skuteczność aplikacji.
Bieżące działania
Aby zapewnić nieprzerwane działanie aplikacji:
Dbaj o aktualność adresu e-mail dewelopera w centrum interfejsu API. To jest alias, którego używamy do kontaktowania się z Tobą. Jeśli nie będziemy mogli się z Tobą skontaktować w sprawie zgodności z Warunkami korzystania z interfejsu API, dostęp do interfejsu API może zostać cofnięty bez Twojej wiedzy. Nie używaj osobistego adresu e-mail powiązanego z kontem indywidualnym lub niekontrolowanym. Aby wyświetlić Centrum interfejsu API, musisz zalogować się na konto menedżera.
Aby otrzymywać informacje o problemach, takich jak zmiany w usługach, przerwy konserwacyjne, daty wycofania itp., subskrybuj
Forum jest regularnie monitorowane przez zespół interfejsu Google Ads API, dlatego jest to idealne miejsce na zadawanie pytań dotyczących interfejsu API.
- Zadbaj o zgodność aplikacji z Warunkami korzystania z interfejsu Google Ads API. Jeśli zajdzie taka potrzeba, zespół ds. weryfikacji tokenów i zgodności skontaktuje się z Tobą pod podanym adresem e-mail. Jeśli masz pytania lub wątpliwości dotyczące Warunków, możesz skontaktować się z zespołem weryfikacyjnym, odpowiadając na e-maila, którego wysłaliśmy do Ciebie podczas sprawdzania Twojego wniosku o token dewelopera.
Optymalizacja
Możesz zoptymalizować aplikację, wykonując operacje wsadowe i w razie potrzeby wysyłając obiekty rzadkie.
Operacje wsadowe
Wysyłanie żądań do interfejsu API wiąże się z kilkoma stałymi kosztami, takimi jak opóźnienie sieciowe w obie strony, przetwarzanie serializacji i deserializacji oraz wywołania systemów backendu. Aby zmniejszyć wpływ tych kosztów stałych i zwiększyć ogólną skuteczność, większość metod mutacji w interfejsie API jest zaprojektowana tak, aby akceptować tablicę operacji. Grupując wiele operacji w każdym żądaniu, możesz zmniejszyć liczbę żądań i powiązane z nimi koszty stałe. Jeśli to możliwe, unikaj wysyłania próśb zawierających tylko 1 operację.
Załóżmy, że dodajesz do kampanii 50 tys. słów kluczowych w wielu grupach reklam. Zamiast wysyłać 50 tys. żądań z 1 słowem kluczowym w każdym z nich, wyślij 100 żądań z 500 słowami kluczowymi w każdym z nich lub nawet 10 żądań z 5000 słów kluczowych w każdym z nich. Liczba operacji dozwolonych w jednym żądaniu jest ograniczona, więc może być konieczne dostosowanie rozmiaru partii, aby uzyskać optymalną wydajność.
Wysyłanie obiektów rzadkich
Gdy obiekty są wysyłane do interfejsu API, pola muszą zostać zdeserializowane, zweryfikowane i zapisane w bazie danych. Przekazywanie pełnych obiektów, gdy chcesz zaktualizować tylko kilka pól, może skutkować dodatkowym czasem przetwarzania i obniżeniem wydajności.
Aby temu zapobiec, interfejs Google Ads API obsługuje aktualizacje rzadkie, które umożliwiają wypełnianie tylko tych pól w obiekcie, które musisz zmienić lub które są wymagane. Rzadkie aktualizacje są przetwarzane szybciej i rzadziej powodują błędy.
Pola, których nie ma w update_mask (znanym też jako FieldMask), pozostają bez zmian.
Na przykład aplikacja, która aktualizuje stawki na poziomie słów kluczowych, może korzystać z rzadkich aktualizacji, ponieważ wystarczy wypełnić tylko pola identyfikatora grupy reklam, identyfikatora kryterium i stawek.
Obsługa błędów i zarządzanie nimi
Podczas tworzenia aplikacji prawdopodobnie napotkasz błędy. W tej sekcji opisujemy kwestie i strategie związane z wdrażaniem w aplikacji funkcji zarządzania błędami. Oprócz tej sekcji zapoznaj się z przewodnikiem rozwiązywania problemów, aby dowiedzieć się więcej o zarządzaniu błędami.
Rozróżnianie źródeł żądań
Niektóre aplikacje są przede wszystkim interaktywne i wykonują wywołania interfejsu API bezpośrednio w odpowiedzi na działania użytkownika w interfejsie. Inne działają głównie w trybie offline, wysyłając wywołania interfejsu API w ramach okresowego procesu backendu. Wiele aplikacji łączy te dwie funkcje. Podczas rozważania zarządzania błędami warto rozróżniać te różne typy żądań.
W przypadku żądań inicjowanych przez użytkowników Twoim głównym celem powinno być zapewnienie im wygody. Użyj konkretnego błędu, który wystąpił, aby zapewnić użytkownikowi jak najwięcej kontekstu w interfejsie. Zaproponuj proste czynności, które użytkownik może wykonać, aby rozwiązać problem (sprawdź poniższe sugestie).
W przypadku żądań inicjowanych na serwerze backendu zaimplementuj procedury obsługi różnych typów błędów, które mogą wystąpić w aplikacji. Zawsze uwzględniaj domyślny moduł obsługi, aby rozwiązywać rzadkie lub wcześniej niespotykane błędy. Dobrym rozwiązaniem w przypadku domyślnego modułu obsługi jest dodanie nieudanej operacji i błędu do kolejki, aby operator mógł je sprawdzić i określić odpowiednie rozwiązanie.
Rozróżnianie typów błędów
Znajomość różnic między typami błędów w interfejsie Google Ads API ma kluczowe znaczenie podczas tworzenia niezawodnej obsługi błędów. Najczęstsze typy błędów to:
Więcej informacji znajdziesz w sekcjach Rodzaje błędów i Typowe błędy.
Synchronizacja backendów
Jeśli użytkownicy Twojej aplikacji mają ręczny dostęp do kont Google Ads, mogą wprowadzać zmiany, o których Twoja aplikacja nie wie, co spowoduje rozsynchronizowanie lokalnej bazy danych aplikacji. Jak wspomnieliśmy w naszym przewodniku Rodzaje błędów, możesz reagować na błędy związane z synchronizacją, gdy wystąpią, ale możesz też próbować im zapobiegać. Jedną z proaktywnych strategii jest uruchamianie codziennie w nocy zadania synchronizacji na wszystkich kontach, pobieranie obiektów Google Ads z kont i porównywanie ich z lokalną bazą danych.
Błędy w logu
Wszystkie błędy powinny być rejestrowane, aby ułatwić debugowanie i monitorowanie. Rejestruj co najmniej identyfikator żądania, operacje, które spowodowały błąd, i sam błąd. Inne informacje do zarejestrowania to identyfikator klienta, usługa API, czas oczekiwania na odpowiedź na żądanie, liczba ponownych prób oraz surowe żądanie i odpowiedź.
Śledzenie trendów
Monitoruj trendy w błędach interfejsu API, aby wykrywać i rozwiązywać problemy z aplikacją. Możesz utworzyć własne rozwiązanie lub skorzystać z jednego z wielu dostępnych narzędzi komercyjnych, które mogą używać Twoich logów do tworzenia interaktywnych paneli i wysyłania automatycznych alertów.
Programowanie
Podczas tworzenia aplikacji używaj kont testowych.
Korzystanie z kont testowych
Konta testowe to konta Google Ads, które nie wyświetlają reklam. Konta testowego możesz używać do eksperymentowania z interfejsem Google Ads API i sprawdzania, czy łączność aplikacji, logika zarządzania kampaniami lub inne procesy działają zgodnie z oczekiwaniami. Token programisty nie musi być zatwierdzony, aby można go było używać na koncie testowym, więc możesz zacząć tworzyć aplikacje za pomocą interfejsu Google Ads API od razu po przesłaniu prośby o token programisty, jeszcze przed sprawdzeniem aplikacji.