Film: sprawdź sprawdzone metody omówione podczas warsztatów w 2019 r.
W tym przewodniku znajdziesz sprawdzone metody optymalizacji skuteczności i wydajności aplikacji.
Bieżące działania
Aby zapewnić płynne działanie aplikacji:
Upewnij się, że Twój adres e-mail kontaktowy dewelopera w centrum interfejsu API jest aktualny. To jest 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 cofnąć Ci dostęp do interfejsu API bez wcześniejszego powiadomienia. Unikaj używania osobistego adresu e-mail powiązanego z osobistym lub niezabezpieczonym kontem. Aby wyświetlić Centrum interfejsu API, musisz zalogować się na konto menedżera.
Aby otrzymywać informacje o takich kwestiach jak zmiany w usługach, przerwy w działaniu usługi czy daty wycofywania, zasubskrybuj nasz
Jest ono regularnie monitorowane przez zespół interfejsu Google Ads API, dzięki czemu stanowi idealne miejsce do zadawania pytań dotyczących interfejsu API.
- Zadbaj o to, aby Twoja aplikacja była zgodna z Warunkami korzystania z interfejsu Google Ads API. W razie potrzeby zespół ds. sprawdzania tokenów i zgodności skontaktuje się z Tobą pod podanym adresem e-mail. Jeśli masz pytania lub wątpliwości dotyczące warunków, skontaktuj się z zespołem ds. sprawdzania, odpowiadając na e-maila, który został Ci wysłany podczas sprawdzania Twojego zgłoszenia dotyczącego tokenu dewelopera.
Optymalizacja
Możesz zoptymalizować aplikację, wykonując operacje zbiorcze i w odpowiednich przypadkach wysyłając rzadkie obiekty.
Operacje grupowe
Wysyłanie żądania do interfejsu API wiąże się z pewnymi kosztami stałymi, takimi jak opóźnienie sieci w obie strony, serializacja i deserializacja oraz wywołania systemów backendowych. Aby zmniejszyć wpływ tych kosztów stałych i zwiększyć ogólną wydajność, większość metod modyfikacji w interfejsie API została zaprojektowana tak, aby przyjmować wiele operacji. Łącząc wiele operacji w każde żądanie, możesz zmniejszyć liczbę wysyłanych żądań i powiązane z tym koszty stałe. Jeśli to możliwe, unikaj wysyłania żądań z jedną operacją.
Załóżmy np., że dodasz do kampanii 50 tys. słów kluczowych w kilku 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łowami kluczowymi. Liczba operacji dozwolonych w żądaniu jest ograniczona, więc aby osiągnąć optymalną wydajność, konieczne może być dostosowanie rozmiaru partii.
Wysyłanie rzadkich obiektów
Gdy obiekty są wysyłane do interfejsu API, pola muszą zostać zdeserializowane, zweryfikowane i zmagazynowane w bazie danych. Przekazywanie pełnych obiektów, gdy chcesz zaktualizować tylko kilka pól, może wydłużyć czas przetwarzania i obniżyć wydajność.
Aby temu zapobiec, interfejs Google Ads API obsługuje rzadkie aktualizacje, co pozwala wypełniać tylko te pola obiektu, które trzeba zmienić lub które są wymagane. Rozproszone aktualizacje są przetwarzane szybciej i mają mniejsze prawdopodobieństwo wystąpienia błędów.
Pola, których nie ma w update_mask (czyli FieldMask), pozostają bez zmian.
Na przykład aplikacja, która aktualizuje stawki na poziomie słowa kluczowego, może korzystać z rzadkich aktualizacji, ponieważ trzeba wypełnić tylko pola identyfikatora grupy reklam, identyfikatora kryterium i stawek.
Obsługa i zarządzanie błędami
Podczas tworzenia aplikacji możesz napotkać błędy. W tej sekcji znajdziesz informacje i strategie dotyczące zarządzania błędami w aplikacji. Więcej informacji o tym zagadnieniu znajdziesz w przewodniku dotyczącym rozwiązywania problemów.
Rozróżnianie źródeł żądań
Niektóre aplikacje są głównie interaktywne i wywołują wywołania interfejsu API bezpośrednio w odpowiedzi na działania użytkownika w interfejsie. Inne działają głównie w trybie offline, wysyłając wywołania interfejsu API w ramach okresowego procesu w back-endzie. Wiele aplikacji łączy te dwa rozwiązania. Podczas rozważania kwestii zarządzania błędami warto odróżnić te różne typy żądań.
W przypadku żądań inicjowanych przez użytkownika Twoim głównym celem powinno być zapewnienie użytkownikom wygody. Użyj konkretnego błędu, aby przekazać użytkownikowi jak najwięcej informacji w interfejsie. Zaproponuj łatwe kroki, które mogą wykonać, aby rozwiązać problem (zobacz sugestie poniżej).
W przypadku żądań inicjowanych po stronie serwera 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 podejściem w przypadku domyślnego przetwarzacza jest dodanie nieudanej operacji i błędu do kolejki, aby operator mógł je sprawdzić i znaleźć odpowiednie rozwiązanie.
Rozróżnianie typów błędów
Znajomość różnic między typami błędów w interfejsie Google Ads API jest kluczowa podczas tworzenia niezawodnej obsługi błędów. Oto niektóre najczęstsze typy błędów:
- Błędy uwierzytelniania
- Błędy z możliwością ponownego próby
- Błędy walidacji
- Błędy związane z synchronizacją
Więcej informacji znajdziesz w sekcji Typy błędów i Typowe błędy.
Kończy się synchronizacja wsteczna
Jeśli użytkownicy aplikacji mają ręczny dostęp do kont Google Ads, mogą wprowadzać zmiany, których aplikacja nie zauważy, co spowoduje brak synchronizacji lokalnej bazy danych aplikacji. Jak opisano w naszym przewodniku Typy błędów, błędy związane z synchronizacją można usuwać, gdy się pojawią, ale można też próbować zapobiegać ich występowaniu. Jedną z działań zapobiegawczych jest codzienne uruchamianie zadania synchronizacji na wszystkich kontach, pobieranie obiektów Google Ads z kont i porównywanie ich z lokalną bazą danych.
Błędy w logu
Aby ułatwić debugowanie i monitorowanie, należy rejestrować wszystkie błędy. Należy przynajmniej zarejestrować identyfikator żądania, operacje, które spowodowały błąd, oraz sam błąd. Inne informacje do rejestrowania to identyfikator klienta, usługa interfejsu API, opóźnienie żądania w obie strony, liczba powtórzeń oraz żądanie i odpowiedź w postaci surowych danych.
Obserwowanie trendów
Monitoruj trendy dotyczące błędów interfejsu API, aby wykrywać i rozwiązywać problemy z aplikacją. Rozważ stworzenie własnego rozwiązania lub skorzystanie z jednego z dostępnych narzędzi komercyjnych, które może używać Twoich dzienników do tworzenia interaktywnych pulpitów nawigacyjnych i wysyłania automatycznych alertów.
Programowanie
Podczas tworzenia reklam używaj kont testowych.
Korzystanie z kont testowych
Konta testowe to konta Google Ads, na których nie wyświetlają się reklamy. Na koncie testowym możesz eksperymentować z interfejsem Google Ads API i sprawdzać, czy łączność aplikacji, logika zarządzania kampanią lub inne przetwarzanie działają zgodnie z oczekiwaniami. Aby używać tokenu programisty na koncie testowym, nie musisz go zatwierdzać. Możesz więc zacząć tworzyć aplikacje za pomocą interfejsu Google Ads API od razu po wysłaniu prośby o token programisty, nawet zanim aplikacja zostanie sprawdzona.