Kreator zapytań Google Ads

Kreator zapytań Google Ads to interaktywne narzędzie, które pomaga tworzyć i weryfikować zapytania za pomocą języka zapytań Google Ads (GAQL). Niezależnie od tego, czy dopiero zaczynasz korzystać z GAQL, czy masz już doświadczenie w tym zakresie, Kreator zapytań może uprościć proces pobierania z interfejsu Google Ads API dokładnie tych danych, których potrzebujesz.

Korzyści

  • Łatwość użycia: upraszcza proces pisania zapytań GAQL bez konieczności znajomości konkretnej składni i dostępnych pól.
  • Wykrywalność: pomaga przeglądać i znajdować dostępne zasoby, pola, segmenty i dane w modelu danych interfejsu Google Ads API.
  • Mniej błędów: dzięki udostępnieniu uporządkowanego interfejsu i menu z prawidłowymi opcjami zapobiega błędom składni i literówkom, co zapewnia prawidłowość wygenerowanego zapytania.
  • Szybsze tworzenie zapytań: przyspiesza proces tworzenia przez automatyzację generowania ciągów zapytań.
  • Weryfikacja: narzędzie jest połączone z API Explorer i Query Validator, aby sprawdzać zapytania pod kątem zgodności z zasadami interfejsu API przed ich wykonaniem.

Jak to działa

Kreator zapytań Google Ads udostępnia przyjazny interfejs, który umożliwia wizualne tworzenie zapytań GAQL. Tak wygląda podstawowa procedura:

  1. Wybierz zasób: zacznij od wybrania zasobu podstawowego na karcie Odwołanie dla wersji, o którą chcesz zapytać. Ten zasób jest umieszczony w klauzuli FROM. Zasoby reprezentują jednostki w Google Ads, takie jak campaign, ad_group lub keyword_view. Kreator wyświetla listę wszystkich dostępnych zasobów.
  2. Wybierz pola: po wybraniu zasobu narzędzie wyświetla wszystkie pola, które można wybrać, w tym atrybuty, segmenty i dane związane z tym zasobem i jego przypisanymi (niejawnie złączonymi) zasobami. Możesz zaznaczyć pola, aby uwzględnić je w klauzuli SELECT. W miarę dokonywania wyborów narzędzie dynamicznie generuje odpowiedni ciąg zapytania GAQL, wyświetla błędy i odfiltrowuje niezgodne kombinacje pól.
  3. Stosowanie filtrów: dodaj warunki klauzuli WHERE, aby filtrować wyniki. Kreator pomaga wybrać pola, operatory i wartości, zapewniając poprawną składnię.
  4. Sortowanie wyników: określ kolejność sortowania za pomocą klauzuli ORDER BY.
  5. Ustawianie limitów: dodaj klauzulę LIMIT, aby kontrolować liczbę zwracanych wyników.
  6. Weryfikacja: narzędzie samo podpowiada prawidłowe kombinacje pól, a także zawiera link do API Explorer, dzięki czemu możesz przetestować zapytanie na danych na koncie. Dostępny jest też osobny walidator zapytań, w którym możesz wklejać i sprawdzać ręcznie napisane zapytania GAQL.
  7. Eksportowanie: gdy będziesz zadowolony(-a) z zapytania, skopiuj i wklej przetestowany, poprawny pod względem składni ciąg GAQL do żądań klienta GoogleAdsService.Search lub SearchStream.

Kreator dba o to, aby wybrane pola, segmenty i dane były ze sobą zgodne i mogły być używane razem w jednym zapytaniu, odwołując się do metadanych interfejsu Google Ads API.

Rozpocznij

Kreator zapytań możesz otworzyć na 2 sposoby: przechodząc do niego z konkretnej strony w dokumentacji raportowania lub z poziomu strony przeglądu Kreatora zapytań.

W dokumentacji raportowania

  1. Zacznij od dokumentacji referencyjnej raportowania i wybierz konkretny zasób, od którego chcesz zacząć, na liście wszystkich zasobów. Możesz też przejść bezpośrednio do zasobu w panelu nawigacyjnym po lewej stronie.
  2. Kliknij Pomóż mi utworzyć zapytanie, aby przejść do Konstruktora zapytań dotyczącego tego konkretnego zasobu.

Na stronie przeglądu Konstruktora zapytań

Otwórz sekcję Kreator zapytań w dokumentacji raportowania i wybierz zasób, który chcesz zbadać.

Integracja z innymi narzędziami

Kreator zapytań jest zintegrowany z innymi narzędziami w zestawie narzędzi dla programistów interfejsu Google Ads API. Zapytanie utworzone w konstruktorze zapytań możesz przetestować w eksploratorze interfejsu API lub zweryfikować za pomocą narzędzia do sprawdzania zapytań.

API Explorer

Po utworzeniu zapytania kliknij Wypróbuj w API Explorer, aby otworzyć je w API Explorer. Zapytanie zostanie automatycznie wypełnione w treści żądania. Następnie możesz je przetestować, uruchamiając je na danych na koncie. Więcej informacji o tym narzędziu znajdziesz w API Explorer.

Walidator zapytań

Gdy klikniesz Wpisz lub edytuj zapytanie, otworzy się walidator zapytań. Użyj walidatora zapytań, aby sprawdzić składnię zapytania. Każde zapytanie utworzone w całości za pomocą konstruktora zapytań ma już prawidłową składnię, ale jeśli znasz zasób, do którego kierujesz zapytanie, walidator zapytań umożliwia szybkie wpisanie zapytania i sprawdzenie jego poprawności. Więcej informacji o tym narzędziu znajdziesz w sekcji Walidator zapytań.