Film: zapoznaj się ze sprawdzonymi metodami przedstawionymi w warsztatach z 2019 roku
W tym przewodniku opisujemy kilka sprawdzonych metod, które możesz zastosować, aby zoptymalizować wydajność swoich aplikacji.
Bieżące działania
Aby zapewnić nieprzerwane działanie aplikacji:
Na bieżąco aktualizuj kontaktowy adres e-mail dewelopera w Centrum interfejsów API. To alias, którego używamy do kontaktowania się z Tobą. Jeśli nie uda nam się skontaktować z Tobą w sprawie zgodności z Warunkami korzystania z interfejsu API, możemy Ci odebrać dostęp do interfejsu API bez Twojej wcześniejszej wiedzy. Unikaj używania osobistego adresu e-mail powiązanego z kontem indywidualnym lub niemonitorowanym.
Aby otrzymywać informacje o zmianach w usługach, przerwach konserwacyjnych, datach wycofania itp., zasubskrybuj nasz
Forum jest regularnie monitorowane przez zespół ds. interfejsu API Google Ads, dzięki czemu to idealne miejsce na publikowanie pytań o interfejs API.
- Zadbaj o zgodność aplikacji z Warunkami korzystania z usługi dotyczącymi interfejsu Google Ads API. W razie potrzeby zespół ds. sprawdzania i zgodności tokenów 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 weryfikatorów, odpowiadając na e-maila wysłanego do Ciebie podczas sprawdzania wniosku o token programisty.
Optymalizacja
Operacje grupowe
Wysłanie żądania do interfejsu API wiąże się z wieloma stałymi kosztami, takimi jak czas oczekiwania w sieci w obie strony, serializacja i przetwarzanie deserializacji oraz wywołania do systemów backendu. Aby ograniczyć wpływ tych stałych kosztów i zwiększyć ogólną wydajność, większość metod mutacji w interfejsie API jest zaprojektowana w taki sposób, aby akceptowała szereg 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 żądań z tylko jedną operacją.
Załóżmy, że dodajesz 50 000 słów kluczowych do kampanii złożonej z wielu grup reklam. Zamiast 50 tys. żądań z jednym słowem kluczowym, utwórz 100 żądań zawierających po 500 słów kluczowych albo nawet 10 żądań zawierających po 5000 słów kluczowych. Istnieją limity liczby operacji dozwolonych w żądaniu, dlatego konieczne może być dostosowanie rozmiaru wsadu w celu uzyskania optymalnej wydajności.
Wysyłaj rzadkie obiekty
Gdy obiekty są wysyłane do interfejsu API, pola muszą być deserializowane, zweryfikowane 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 rzadkie aktualizacje. Dzięki temu możesz wypełniać tylko pola wymagane w obiekcie, które musisz zmienić. Rozproszone aktualizacje są przetwarzane szybciej i rzadziej powodują błędy.
Pola, których nie ma w elemencie update_mask (FieldMask), pozostają bez zmian.
Na przykład w przypadku aplikacji, która aktualizuje stawki na poziomie słów kluczowych, warto stosować niewielkie aktualizacje, ponieważ trzeba będzie wypełnić tylko pola identyfikatora grupy reklam, identyfikatora kryterium oraz stawek.
Obsługa błędów i zarządzanie nimi
Podczas programowania mogą wystąpić błędy. W tej sekcji znajdziesz uwagi i strategie związane z wdrażaniem zarządzania błędami w aplikacji. Oprócz tego znajdziesz w przewodniku 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 to głównie interaktywne, wywołujące interfejs API bezpośrednio w odpowiedzi na inicjowane przez użytkownika działania w interfejsie. Inne działają głównie offline, wywołania interfejsu API w ramach okresowego procesu backendu. Wiele aplikacji łączy je ze sobą. Gdy zastanawiamy się nad zarządzaniem błędami, warto przyjrzeć się różnym rodzajom żądań.
W przypadku żądań wysyłanych przez użytkownika przede wszystkim należy zadbać o wygodę użytkowników. Wykorzystaj konkretny 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 rozwiązać problem (zapoznaj się z poniższymi sugestiami).
W przypadku żądań zainicjowanych w backendzie zaimplementuj moduły 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 naprawić rzadkie lub wcześniej niezauważalne błędy. Dobrym sposobem w przypadku domyślnej obsługi jest dodanie nieudanej operacji i błędu do kolejki, gdzie operator może sprawdzić i określić odpowiednie rozwiązanie.
Wskaż różnice
Znajomość różnic między typami błędów w interfejsie Google Ads API jest kluczowa przy tworzeniu solidnej obsługi błędów. Najczęstsze typy błędów:
- Błędy uwierzytelniania
- Błędy, które można ponownie napotkać
- Błędy weryfikacji
- Błędy związane z synchronizacją
Więcej informacji znajdziesz w informacjach o typach błędów i typowych błędach.
Zakończenie synchronizacji
Jeśli użytkownicy aplikacji mają ręczny dostęp do kont Google Ads, mogą wprowadzać zmiany, o których nie wiadomo, co powoduje, że lokalna baza danych aplikacji nie jest synchronizowana. Zgodnie z naszym przewodnikiem Typy błędów możesz reagować na błędy synchronizacji, gdy tylko się pojawią, ale możesz też spróbować im zapobiegać. Jedną ze strategii proaktywnej jest uruchamianie nocnego zadania synchronizacji na wszystkich kontach, pobieranie obiektów Google Ads z Twoich kont i porównywanie tych obiektów z lokalną bazą danych.
Błędy w logu
Aby ułatwić debugowanie i monitorowanie, wszystkie błędy powinny być rejestrowane. Zapisz przynajmniej identyfikator żądania, operacje, które spowodowały błąd, i sam błąd. Inne informacje do zarejestrowania to identyfikator klienta, usługa interfejsu API, czas oczekiwania na żądanie w obie strony, liczba ponownych prób oraz nieprzetworzone żądanie i odpowiedź.
Śledź trendy
Śledź trendy w błędach w interfejsie API, aby móc wykrywać i rozwiązywać problemy z aplikacją. Rozważ utworzenie własnego rozwiązania lub skorzystanie z jednego z wielu dostępnych komercyjnych narzędzi, które wykorzystują Twoje logi do tworzenia interaktywnych paneli i wysyłania automatycznych alertów.
Programowanie
Korzystanie z 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 sprawdzić, czy łączność aplikacji, logika zarządzania kampanią lub inne procesy przetwarzania działają zgodnie z oczekiwaniami. Token dewelopera nie musi zostać zatwierdzony do użycia na koncie testowym, więc możesz zacząć programować za pomocą interfejsu Google Ads API od razu po jego wysłaniu, jeszcze przed sprawdzeniem aplikacji.