Film: sprawdzone metody omawiane podczas warsztatów w 2019 r.
W tym przewodniku opisujemy sprawdzone metody, które możesz wdrożyć, aby zoptymalizować wydajność i skuteczność swoich aplikacji.
Bieżące działania
Aby zapewnić nieprzerwane działanie aplikacji:
Dbaj o aktualność adresu e-mail dewelopera w centrum interfejsu API. Jest to 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. Unikaj używania osobistego adresu e-mail powiązanego z kontem indywidualnym lub nieobserwowanym. Aby wyświetlić centrum interfejsu API, musisz zalogować się na konto menedżera.
Aby otrzymywać informacje o problemach, takich jak zmiany w usłudze, przerwy konserwacyjne, daty wycofania itp., zasubskrybuj nasz
Dbaj o zgodność aplikacji z warunkami korzystania z interfejsu Google Ads API (T&C). W razie potrzeby 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 korzystania z usługi, możesz skontaktować się z zespołem ds. weryfikacji, odpowiadając na e-maila, którego zespół wysłał do Ciebie podczas sprawdzania Twojego zgłoszenia o token programisty.
Optymalizacja
Aplikację możesz zoptymalizować, wykonując operacje wsadowe i, w razie potrzeby, wysyłając obiekty rzadkie.
Operacje wsadowe
Wysłanie żądania do interfejsu API wiąże się z kilkoma stałymi kosztami, takimi jak opóźnienie sieci w obie strony, przetwarzanie serializacji i deserializacji oraz wywołania systemów backendowych. Aby zmniejszyć wpływ tych stałych kosztów i zwiększyć ogólną wydajność, większość metod mutate w interfejsie API jest zaprojektowana tak, aby akceptować tablicę operacji. Łącząc wiele operacji w jedno żądanie, możesz zmniejszyć liczbę wysyłanych żądań i powiązane z nimi stałe koszty. Jeśli to możliwe, unikaj wysyłania żądań z tylko jedną operacją.
Załóżmy, że dodajesz 50 tys. słów kluczowych do kampanii w wielu grupach reklam. Zamiast wysyłać 50 tys. żądań z 1 słowem kluczowym, wyślij 100 żądań z 500 słowami kluczowymi lub nawet 10 żądań z 5 tys. słów kluczowych. Istnieją limity liczby operacji dozwolonych w żądaniu, dlatego może być konieczne dostosowanie wielkości wsadu, 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 spowodować dodatkowy czas przetwarzania i zmniejszenie wydajności.
Aby temu zapobiec, interfejs Google Ads API obsługuje aktualizacje rzadkie, dzięki czemu możesz wypełniać tylko te pola w obiekcie, które chcesz zmienić lub które są wymagane. Aktualizacje rzadkie 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łowa kluczowego, może korzystać z aktualizacji rzadkich, ponieważ trzeba będzie 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 dotyczące wbudowania w aplikację obsługi błędów. Oprócz tej sekcji zapoznaj się z przewodnikiem dotyczącym rozwiązywania problemów, aby uzyskać więcej informacji o zarządzaniu błędami.
Rozróżnianie źródeł żądań
Niektóre aplikacje są przede wszystkim interaktywne i wysyłają wywołania interfejsu API bezpośrednio w odpowiedzi na działania użytkownika w interfejsie. Inne działają głównie offline i wysyłają wywołania interfejsu API w ramach okresowego procesu backendowego. Wiele aplikacji łączy te 2 podejścia. Podczas planowania obsługi błędów warto rozróżniać te różne typy żądań.
W przypadku żądań inicjowanych przez użytkownika najważniejsze jest zapewnienie użytkownikom dobrego doświadczenia. Użyj konkretnego błędu, który wystąpił, aby przekazać użytkownikowi jak najwięcej kontekstu w interfejsie. Zaproponuj proste kroki, które może wykonać, aby rozwiązać problem (zapoznaj się z sugestiami poniżej).
W przypadku żądań inicjowanych w backendzie zaimplementuj obsługę 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 nieznane 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
Podczas tworzenia niezawodnej obsługi błędów kluczowe jest poznanie różnic między typami błędów w interfejsie Google Ads API. Najczęstsze typy błędów:
Więcej informacji znajdziesz w sekcjach Typy błędów i Typowe błędy.
Synchronizowanie 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 przewodniku Typy 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 zadania synchronizacji na wszystkich kontach, pobieranie obiektów Google Ads na kontach i porównywanie ich z lokalną bazą danych.
Błędy w logu
Wszystkie błędy należy rejestrować, aby ułatwić debugowanie i monitorowanie. Co najmniej zarejestruj identyfikator żądania, operacje, które spowodowały błąd, i sam błąd. Inne informacje, które należy zarejestrować, to identyfikator klienta, usługa interfejsu API, opóźnienie żądania w obie strony, liczba ponownych prób oraz surowe żądanie i odpowiedź.
Śledź trendy
Pamiętaj, aby śledzić trendy dotyczące błędów 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. Możesz używać konta testowego do eksperymentowania z interfejsem Google Ads API i sprawdzania, czy połączenie aplikacji, logika zarządzania kampaniami lub inne przetwarzanie działają zgodnie z oczekiwaniami. Aby używać tokena programisty na koncie testowym, nie musisz go zatwierdzać, więc możesz zacząć tworzyć aplikację za pomocą interfejsu Google Ads API od razu po wysłaniu prośby o token programisty, jeszcze zanim Twoja aplikacja zostanie sprawdzona.