Film: Zobacz prezentację o sprawdzonych metodach omówioną podczas warsztatów w 2019 roku
W tym przewodniku omawiamy kilka sprawdzonych metod, które możesz wdrożyć, aby zoptymalizować wydajność aplikacji.
Bieżące działania
Aby mieć pewność, że aplikacja będzie działać bez przerw:
Dbaj o aktualność swojego kontaktowego adresu e-mail dewelopera w Centrum interfejsów API. To jest 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 interfejsów API, możemy Ci odebrać dostęp do interfejsu API bez Twojej wcześniejszej wiedzy. Unikaj stosowania osobistego adresu e-mail powiązanego z kontem indywidualnym lub niemonitorowanym kontem.
Aby otrzymywać informacje o zmianach w usłudze, przestojach w konserwacji, datach wycofania
Forum jest regularnie monitorowane przez zespół ds. interfejsu Google Ads API, dzięki czemu jest idealnym miejscem do publikowania pytań dotyczących interfejsu API.
- Zadbaj o zgodność aplikacji z Warunkami korzystania z usługi interfejsu Google Ads API. W razie potrzeby zespół ds. sprawdzania tokenów i zgodności skontaktuje się z Tobą, korzystając z Twojego kontaktowego adresu e-mail. Jeśli masz pytania lub wątpliwości dotyczące Warunków, możesz skontaktować się z zespołem ds. sprawdzania, odpowiadając na e-maila, którego wysłaliśmy Ci podczas sprawdzania Twojego zgłoszenia tokena programisty.
Optymalizacja
Operacje grupowe
Wysyłanie żądań do interfejsu API wiąże się z pewnymi stałymi kosztami, takimi jak opóźnienia sieciowe w obie strony, serializacja i deserializacja oraz wywołania systemów backendu. Większość metod mutacji w interfejsie API ma na celu zmniejszenie wpływu tych stałych kosztów i zwiększenie ogólnej wydajności. Grupowanie wielu operacji do każdego żądania pozwala zmniejszyć liczbę wysyłanych żądań i powiązanych z nimi stałych kosztów. Jeśli to możliwe, unikaj wysyłania żądań za pomocą tylko jednej operacji.
Załóżmy np., że dodajesz 50 000 słów kluczowych do kampanii w wielu grupach reklam. Zamiast 50 000 żądań z 1 słowom kluczowym, możesz przesłać 100 żądań po 500 słów kluczowych albo nawet 10 żądań z 5000 słów kluczowych. Liczba operacji dozwolonych w żądaniu jest ograniczona, więc uzyskanie optymalnej wydajności może wymagać dostosowania rozmiaru wsadu.
Wysyłaj rozproszone obiekty
Gdy obiekty są wysyłane do interfejsu API, pola muszą zostać poddane deserializacji, weryfikowaniu i przechowywane w bazie danych. Przekazywanie pełnych obiektów, gdy chcesz zaktualizować tylko kilka pól, może wydłużyć czas przetwarzania i zmniejszyć wydajność.
Aby temu zaradzić, interfejs Google Ads API obsługuje rozproszone aktualizacje, dzięki czemu możesz wypełniać tylko te pola w obiekcie, które chcesz zmienić lub są wymagane. Rozproszone aktualizacje przebiegają szybciej i rzadziej powodują wystąpienie błędów.
Pola, które nie występują w masce update_mask (czyli FieldMask), pozostają niezmienione.
Na przykład aplikacja, która aktualizuje stawki na poziomie słowa kluczowego, może skorzystać na stosowaniu niewielkich aktualizacji, ponieważ trzeba wypełnić tylko pola identyfikatora grupy reklam, identyfikatora kryterium i stawek.
Obsługa błędów i zarządzanie nimi
W trakcie programowania mogą wystąpić błędy. W tej sekcji opisujemy ważne kwestie i strategie związane z wdrażaniem zarządzania błędami w aplikacji. Poza tą sekcją zapoznaj się z przewodnikiem dotyczącym rozwiązywania problemów, w którym znajdziesz więcej informacji o zarządzaniu błędami.
Rozróżnianie źródeł żądań
Niektóre aplikacje są przede wszystkim interaktywne, ponieważ wywołują interfejs API bezpośrednio w odpowiedzi na inicjowane przez użytkownika działania w interfejsie. Inne działają głównie offline, wywołując wywołania interfejsu API w ramach okresowego procesu backendu. Wiele aplikacji łączy te 2 elementy. Przy zarządzaniu błędami warto rozróżnić te różne typy żądań.
W przypadku żądań zainicjowanych przez użytkownika głównym problemem powinno być zapewnienie użytkownikom wygody. Opisz błąd, który wystąpił, aby przekazać użytkownikowi jak najwięcej informacji w interfejsie. Zaproponuj proste czynności, które mogą wykonać, aby naprawić błąd (zapoznaj się z sugestiami poniżej).
W przypadku żądań zainicjowanych przez backend zaimplementuj moduły obsługi różnych typów błędów, które może napotkać Twoja aplikacja. Zawsze uwzględniaj domyślny moduł obsługi, aby rozwiązać rzadkie lub wcześniej niewidziane błędy. Dobrym podejściem w przypadku domyślnego modułu obsługi jest dodanie nieudanej operacji i błędu do kolejki, aby operator mógł sprawdzić i określić odpowiednie rozwiązanie.
Rozróżnij typy błędów
Znajomość różnic między typami błędów w interfejsie Google Ads API ma kluczowe znaczenie dla skutecznej obsługi błędów. Najczęstsze typy błędów to:
- Błędy uwierzytelniania
- Błędy, które można ponawiać
- Błędy weryfikacji
- Błędy związane z synchronizacją
Więcej informacji znajdziesz w artykułach Typy błędów i Typowe błędy.
Synchronizacja zaplecza
Jeśli użytkownicy Twojej aplikacji mają ręczny dostęp do kont Google Ads, mogą wprowadzać zmiany, których aplikacja nie wie, co spowoduje przerwanie synchronizacji lokalnej bazy danych. Jak wspomnieliśmy w przewodniku po typach błędów, możesz reagować na błędy związane z synchronizacją, gdy tylko wystąpią, ale możesz też zapobiegać im. Jedną ze strategii jest przeprowadzenie conocnej synchronizacji na wszystkich kontach, pobranie obiektów Google Ads z tych kont i porównanie ich z lokalną bazą danych.
Błędy w logu
Wszystkie błędy powinny być logowane, aby ułatwić debugowanie i monitorowanie. Zarejestruj identyfikator żądania, operacje, które spowodowały błąd, oraz sam błąd. Inne informacje, które należy zarejestrować, to identyfikator klienta, usługa interfejsu API, czas oczekiwania na żądanie w obie strony, liczba ponownych prób oraz nieprzetworzone żądania i odpowiedzi.
Śledź trendy
Obserwuj trendy dotyczące błędów interfejsu API, aby móc wykrywać i rozwiązywać problemy z aplikacją. Rozważ utworzenie własnego rozwiązania lub użycie jednego z wielu dostępnych komercyjnych narzędzi, które mogą wykorzystywać logi do tworzenia interaktywnych paneli i wysyłania automatycznych alertów.
Programowanie
Użyj kont testowych
Konta testowe to konta Google Ads, które nie wyświetlają reklam. Za pomocą konta testowego możesz eksperymentować z interfejsem Google Ads API i sprawdzać, czy połączenia w aplikacji, logika zarządzania kampanią lub inne procesy przetwarzania działają zgodnie z oczekiwaniami. Token programisty nie musi zostać zatwierdzony do użycia na koncie testowym, więc tworzenie aplikacji z interfejsem Google Ads API możesz rozpocząć od razu po wysłaniu prośby o ten token, jeszcze przed sprawdzeniem aplikacji.