Sprawdzone metody

Film: Poznaj sprawdzone metody z warsztatów 2019

W tym przewodniku znajdziesz sprawdzone metody, które możesz zastosować, aby zoptymalizować wydajność swoich aplikacji.

Bieżące działania

Aby mieć pewność, że aplikacja będzie działać bez zakłóceń:

  • Kontaktowy adres e-mail dewelopera w interfejsie API powinien być aktualny. 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, Twój dostęp do interfejsu API może zostać anulowany bez Twojej wcześniejszej wiedzy. Unikaj używania osobistego adresu e-mail powiązanego z kontem indywidualnym lub niemonitorowanym.

  • Aby otrzymywać informacje o zmianach, produktach, przerwach konserwacyjnych, datach wycofania itd., zasubskrybuj

Forum jest regularnie monitorowane przez zespół zajmujący się interfejsem Google Ads API, dzięki czemu idealnie nadaje się do publikowania pytań na temat interfejsu API.

  • Zadbaj o zgodność aplikacji z Warunkami korzystania z usługi Google Ads API (T&amp). W razie potrzeby zespół weryfikacyjny tokena i zespół ds. zgodności skontaktuje się z Tobą, korzystając z Twojego kontaktowego adresu e-mail. Jeśli masz pytania lub wątpliwości związane z T&amp, możesz skontaktować się z zespołem weryfikatora, odpowiadając na e-maila, którego użył w trakcie weryfikacji Twojego tokena.

Optymalizacja

Operacje grupowe

Żądanie wysyłane do interfejsu API wiąże się z pewnymi stałymi kosztami, takimi jak opóźnienie w obiegu sieci, serializacja i adializacja oraz wywołania systemów backendu. Aby zmniejszyć wpływ tych stałych kosztów i zwiększyć ogólną wydajność, większość metod mutacji w interfejsie API została zaprojektowana tak, by akceptować różne działania. Łącząc wiele operacji w jednym żądaniu, możesz zmniejszyć liczbę wysyłanych żądań i powiązane koszty stałe. Jeśli masz taką możliwość, nie wykonuj tylko jednej operacji.

Załóżmy na przykład, że dodajesz do kampanii 50 000 słów kluczowych w wielu grupach reklam. Zamiast wysyłać 50 000 żądań po 1 słowie kluczowym, wykonaj 100 żądań po 500 słów kluczowych, a nawet 10 żądań z 5000 słów kluczowych. Liczba żądań dozwolonych w żądaniu jest ograniczona, więc aby uzyskać optymalną wydajność, konieczne może być dostosowanie rozmiaru wsadu.

Wysyłaj mało znane obiekty

Gdy obiekty są przesyłane do interfejsu API, pola muszą być dyskretne, weryfikowane 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 zapobiec, interfejs Google Ads API obsługuje drobne aktualizacje, dzięki czemu możesz zapełniać tylko pola w obiekcie, który chcesz zmienić lub które są wymagane. Niewielkie aktualizacje są przetwarzane szybciej, a prawdopodobieństwo wystąpienia błędów jest mniejsze. Pola, które nie są w masce aktualizacji (nazywanej też FieldMask), pozostają niezmienione.

Na przykład aplikacji, która aktualizuje stawki na poziomie słowa kluczowego, warto używać skróconych aktualizacji, bo wypełnione są tylko identyfikator grupy reklam, identyfikator kryterium i stawki.

Obsługa błędów i zarządzanie

Podczas programowania możesz napotkać błędy. Ta sekcja zawiera omówienie uwag i strategii dotyczących zarządzania błędami w aplikacji. Informacje na temat zarządzania błędami znajdziesz w tej sekcji.

Rozróżnianie źródeł żądań

Niektóre aplikacje są interaktywne, co wywołuje wywołania interfejsu API bezpośrednio w odpowiedzi na działania inicjowane przez użytkownika w interfejsie. Inne działają głównie w trybie offline, wysyłając wywołania interfejsu API w ramach okresowego backendu. Wiele aplikacji łączy te dwa narzędzia. Podczas zarządzania błędami warto rozróżnić te typy żądań.

W przypadku żądań zainicjowanych przez użytkownika najważniejsze jest zapewnienie użytkownikom wygody. Błąd, który wystąpił w Twojej aplikacji, powinien dać użytkownikowi jak najwięcej kontekstu. Podpowie Ci, co może zrobić, by rozwiązać problem (zobacz sugestie poniżej).

W przypadku żądań zainicjowanych należy zaimplementować moduły obsługi różnego typu błędów, które mogą wystąpić w aplikacji. Zawsze używaj domyślnego modułu obsługi, aby usuwać rzadkie lub wcześniej napotkane błędy. Dobrym rozwiązaniem w przypadku domyślnego modułu obsługi jest dodanie nieudanej operacji i błędu do kolejki, w której pracownik człowieka musi sprawdzić i rozwiązać problem.

Rozróżnianie typów błędów

Znajomość różnic między typami błędów w interfejsie Google Ads API ma kluczowe znaczenie dla tworzenia skutecznej obsługi błędów. Oto niektóre z najczęstszych rodzajów błędów:

  1. Błędy uwierzytelniania
  2. Błędy ponawiane
  3. Błędy weryfikacji
  4. Błędy związane z synchronizacją

Więcej informacji znajdziesz w artykułach Typy błędów i Typowe błędy.

Koniec synchronizacji

Użytkownicy aplikacji, którzy mają ręczny dostęp do kont Google Ads, mogą wprowadzać zmiany, o których nie wiedzą, powodując synchronizację lokalnej bazy danych z aplikacją. Jak wspomnieliśmy w przewodniku po typach błędów, możesz usuwać błędy związane z synchronizacją, gdy występują. Możesz też jednak aktywnie im zapobiegać. Jedną z aktywnych strategii jest uruchamianie nocnej 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. Podaj przynajmniej identyfikator żądania, operacje, które spowodowały błąd, i sam błąd. Inne informacje, które musisz zapisać, to identyfikator klienta, usługa API, czas oczekiwania na żądanie w obie strony, liczbę ponownych prób oraz nieprzetworzone żądanie i odpowiedź.

Pamiętaj o monitorowaniu trendów w błędach interfejsu API, by móc wykrywać i rozwiązywać problemy z aplikacją. Rozważ opracowanie własnego rozwiązania lub użycie jednego z wielu dostępnych narzędzi komercyjnych, które mogą wykorzystywać Twoje 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. Możesz użyć konta testowego do eksperymentowania z interfejsem Google Ads API i sprawdzenia, czy połączenie aplikacji, logika zarządzania kampanią lub inne przetwarzanie działa zgodnie z oczekiwaniami. Token programisty nie musi być zatwierdzony, aby można było go używać na koncie testowym, dlatego można zacząć tworzyć go za pomocą interfejsu Google Ads API od razu po przesłaniu prośby o token dewelopera, jeszcze zanim aplikacja zostanie sprawdzona.