Ten przewodnik zawiera sprawdzone metody, które możesz wdrożyć, aby zoptymalizować wydajność i skuteczność aplikacji.
Zarządzanie aplikacją
Aby zapewnić nieprzerwane działanie aplikacji, wykonaj te czynności:
Sprawdź, czy lista właścicieli i edytujących Twój projekt Google Cloud jest aktualna. Będziemy się z nimi kontaktować w przypadku nagłych sytuacji lub kwestii związanych z zgodnością z Warunkami korzystania z interfejsu API. Jeśli nie będziemy mogli się z Tobą skontaktować w sprawie zgodności z Warunkami 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 usługach, przerwy konserwacyjne i daty wycofania, subskrybuj nasz blog o interfejsach API i blog o usługach.
Zadbaj o to, aby Twoja aplikacja była zgodna z Warunkami korzystania z interfejsu Google Ads API. W razie potrzeby zespół ds. zgodności interfejsu 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óry wysłaliśmy do Ciebie podczas sprawdzania Twojego wniosku o dostęp do interfejsu API.
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 szeregiem stałych kosztów, takich 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ę wysyłanych żą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 na przykład, ż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 aby uzyskać optymalną skuteczność, może być konieczne dostosowanie wielkości wsadu.
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 spadkiem 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 chcesz 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 po rozwiązywaniu 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 wywołują interfejs API bezpośrednio w odpowiedzi na działania użytkownika w interfejsie. Inne działają głównie offline, wywołując interfejs API w ramach okresowego procesu backendu. Wiele aplikacji łączy te 2 rodzaje. Podczas rozważania zarządzania błędami warto rozróżniać te różne typy żądań.
W przypadku żądań zainicjowanych przez użytkownika najważniejsze jest zapewnienie mu jak najlepszych wrażeń. Użyj konkretnego błędu, który wystąpił, aby zapewnić użytkownikowi jak najwięcej kontekstu w interfejsie. Podaj jasne instrukcje, które użytkownik może wykonać, aby rozwiązać problem (patrz 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 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 powoduje rozsynchronizowanie lokalnej bazy danych aplikacji. Jak wspomnieliśmy w 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 okresowe uruchamianie zadania synchronizacji w celu uzgodnienia lokalnej bazy danych z obiektami Google Ads na Twoich kontach. W przypadku dużych hierarchii kont unikaj pobierania wszystkich obiektów ze wszystkich kont co noc, aby nie wyczerpać dziennych limitów. Zamiast tego wysyłaj zapytania ChangeStatus lub filtruj ostatnio zmodyfikowane jednostki, aby synchronizować zmiany przyrostowo.
Błędy w logu
Wszystkie błędy powinny być rejestrowane, aby ułatwić debugowanie i monitorowanie. Zarejestruj co najmniej identyfikator żądania, operacje, które spowodowały błąd, i sam błąd. Inne informacje do rejestrowania to identyfikator klienta, usługa API, opóźnienie żądania w obie strony, liczba ponownych prób oraz oczyszczone surowe żądanie i odpowiedź (z zapewnieniem redakcji poufnych danych logowania, takich jak tokeny OAuth, tokeny dewelopera, jeśli nadal są uwzględnione w starszych nagłówkach żądań, oraz wszelkie informacje umożliwiające identyfikację).
Śledzenie trendów
Monitoruj trendy 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. 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. Aby używać projektu Google Cloud na koncie testowym, wystarczy dostęp testowy. Możesz więc od razu zacząć programować 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.