Film: sprawdzone metody omawiane podczas warsztatów w 2019 r.
Z tego przewodnika dowiesz się, jakie sprawdzone metody możesz wdrożyć, aby zoptymalizować wydajność i skuteczność swoich aplikacji.
Bieżące działania
Aby zapewnić nieprzerwane działanie aplikacji:
upewnij się, że lista administratorów i właścicieli 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, dostęp do interfejsu API może zostać ograniczony lub cofnięty.
Aby otrzymywać informacje o problemach, takich jak zmiany w usłudze, przerwy konserwacyjne i daty wycofania, subskrybuj naszego
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 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 otrzymasz po sprawdzeniu Twojego zgłoszenia o dostęp do interfejsu API.
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 pewnymi stałymi kosztami, takimi jak opóźnienie sieciowe 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 na przykład, ż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. Liczba operacji dozwolonych w żądaniu jest ograniczona, 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 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 trzeba 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 Rozwiązywanie problemów w celu uzyskania dodatkowych informacji na temat zarządzania 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 procedury obsługi różnych typów błędów, które mogą wystąpić w aplikacji. Zawsze uwzględniaj domyślną procedurę obsługi, aby rozwiązywać rzadkie lub wcześniej nieznane błędy. Dobrym rozwiązaniem w przypadku domyślnej procedury 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 ważne jest, aby znać różnice 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. 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 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żyć konta testowego, aby eksperymentować z interfejsem Google Ads API i sprawdzić, czy połączenie aplikacji, logika zarządzania kampaniami lub inne przetwarzanie działają zgodnie z oczekiwaniami. Aby używać konta testowego, projekt Google Cloud musi mieć tylko poziom dostępu Konto testowe, dzięki czemu możesz od razu rozpocząć tworzenie aplikacji za pomocą interfejsu Google Ads API, czekając na sprawdzenie przez Google Twojego zgłoszenia o wyższe poziomy dostępu do interfejsu API.