Film: obejrzyj prezentację o sprawdzonych metodach z warsztatów w 2019 r.
Ten przewodnik zawiera 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:
Sprawdź, czy lista administratorów i właścicieli projektu 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 nasze
Zapewnij zgodność aplikacji z Warunkami korzystania z interfejsu Google Ads API. W razie potrzeby zespół ds. zgodności interfejsów API skontaktuje się z administratorami i właścicielami 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 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 sieci 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 z tylko jedną 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, wyślij 100 żądań z 500 słowami kluczowymi lub nawet 10 żądań z 5000 słów kluczowych. Liczba operacji dozwolonych w jednym żądaniu jest ograniczona, więc 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 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 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. Więcej informacji o zarządzaniu błędami znajdziesz w przewodniku po rozwiązywaniu problemów.
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, wysyłając wywołania interfejsu API w ramach okresowego procesu backendu. Wiele aplikacji łączy te 2 funkcje. Podczas rozważania kwestii 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 (zapoznaj się z poniższymi sugestiami).
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 wieczorem 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. 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 surowe żądanie i odpowiedź.
Ś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 mieć dostęp testowy. Możesz więc od razu zacząć tworzyć aplikacje z użyciem interfejsu Google Ads API, czekając na sprawdzenie przez Google Twojej aplikacji pod kątem wyższych poziomów dostępu do interfejsu API.