W tym przewodniku opisujemy sprawdzone metody, które możesz wdrożyć, aby zoptymalizować wydajność i skuteczność swoich aplikacji.
Zarządzanie aplikacją
Aby zapewnić nieprzerwane działanie aplikacji:
Upewnij się, że lista właścicieli i edytorów projektu Google Cloud jest aktualna. W razie nagłych sytuacji lub problemów związanych z przestrzeganiem Warunków korzystania z interfejsu API będziemy kontaktować się z tymi użytkownikami. Jeśli nie będziemy mogli się z Tobą skontaktować w sprawie przestrzegania Warunków korzystania z interfejsu API, Twój dostęp do interfejsu API może zostać ograniczony lub cofnięty.
Aby otrzymywać informacje o problemach, takich jak zmiany w produkcie, przerwy konserwacyjne i daty wycofania, zasubskrybuj naszego bloga o interfejsie API i bloga o produkcie.
Upewnij się, że Twoja aplikacja jest zgodna z Warunkami korzystania z interfejsu Google Ads API Terms and Conditions (T&C). W razie potrzeby zespół ds. zgodności z interfejsem API skontaktuje się z właścicielami i edytorami projektu Google Cloud, którzy mają dostęp do interfejsu API. Jeśli masz pytania lub wątpliwości dotyczące Warunków korzystania z usługi, możesz skontaktować się z zespołem ds. zgodności, odpowiadając na e-maila, którego otrzymasz po sprawdzeniu Twojego wniosku o dostęp do interfejsu API.
Optymalizacja
Możesz zoptymalizować swoją aplikację, 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 mutacji w interfejsie API jest zaprojektowana tak, aby akceptować tablicę operacji. Grupując wiele operacji w każdym żądaniu, 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 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, wyślij 100 żądań z 500 słowami kluczowymi lub nawet 10 żądań z 5 tys. słów kluczowych. Liczba operacji dozwolonych w żądaniu jest ograniczona, dlatego może być konieczne dostosowanie rozmiaru partii, aby uzyskać optymalną wydajność.
Wysyłanie obiektów rozproszonych
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 spadek wydajności. Aby temu zapobiec, interfejs Google Ads API obsługuje aktualizacje rzadkie, które pozwalają 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 (znanej 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 programowania prawdopodobnie napotkasz błędy. W tej sekcji opisujemy kwestie i strategie dotyczące wbudowania obsługi błędów w aplikację. Oprócz tej sekcji zapoznaj się z przewodnikiem Rozwiązywanie 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 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. Podaj jasne instrukcje, które pozwolą mu rozwiązać problem (patrz sugestie 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, który będzie reagować na 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
Znajomość różnic między typami błędów w interfejsie Google Ads API jest niezbędna do tworzenia niezawodnej obsługi błędów. 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 okresowe uruchamianie zadania synchronizacji, aby uzgodnić lokalną bazę danych z obiektami Google Ads na kontach. W przypadku
dużych hierarchii kont unikaj pobierania wszystkich obiektów z każdego konta
co noc, aby nie wyczerpać dziennych limitów. Zamiast tego wysyłaj zapytania do
ChangeStatus lub filtruj ostatnio zmodyfikowane jednostki, aby synchronizować
zmiany przyrostowo.
Błędy w logu
Wszystkie błędy należy rejestrować, aby ułatwić debugowanie i monitorowanie. Zarejestruj co najmniej 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 oczyszczone surowe żądanie i odpowiedź (pamiętaj o usunięciu poufnych danych uwierzytelniających, takich jak tokeny protokołu OAuth i wszelkie informacje umożliwiające identyfikację).
Ś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 programowania 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ć konta testowego, Twój projekt Google Cloud musi mieć tylko dostęp testowy, dzięki czemu możesz od razu rozpocząć programowanie za pomocą interfejsu Google Ads API, czekając na sprawdzenie przez Google Twojej aplikacji pod kątem wyższych poziomów dostępu do interfejsu API.