Kreator zapytań Google Ads to interaktywne narzędzie, które pomaga interaktywnie 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, kreator zapytań może uprościć proces pobierania z interfejsu Google Ads API dokładnie tych danych, których potrzebujesz.
Zalety
- Łatwość użycia: upraszcza proces pisania zapytań GAQL bez konieczności znajomości konkretnej składni i dostępnych pól.
- Wykrywalność: pomaga odkrywać i znajdować dostępne zasoby, pola, segmenty i dane w modelu danych interfejsu Google Ads API.
- Mniej błędów: dzięki udostępnianiu uporządkowanego interfejsu i menu z prawidłowymi opcjami pomaga zapobiegać błędom składni i literówkom, dzięki czemu wygenerowane zapytanie jest prawidłowe.
- Szybsze tworzenie zapytań: przyspiesza proces tworzenia przez automatyzację generowania ciągów zapytań.
- Weryfikacja: narzędzie jest połączone z API Explorerem 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 podstawowy przepływ pracy:
- Wybierz zasób: zacznij od wybrania głównego zasobu na karcie Pliki referencyjne w wersji, o którą chcesz zapytać. Ten zasób będzie w klauzuli
FROM. Zasoby reprezentują jednostki w Google Ads, takie jakcampaign,ad_grouplubkeyword_view. Kreator wyświetla listę wszystkich dostępnych zasobów. - 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. - Zastosuj filtry: możesz dodać warunki klauzuli
WHERE, aby filtrować wyniki. Kreator pomaga wybrać pola, operatory i wartości, zapewniając prawidłową składnię. - Kolejność wyników: określ kolejność sortowania za pomocą klauzuli
ORDER BY. - Ustawianie limitów: dodaj klauzulę
LIMIT, aby kontrolować liczbę zwracanych wyników. - Weryfikacja: narzędzie samo w sobie prowadzi Cię do prawidłowych kombinacji pól, ale zawiera też link do APIs Explorer, dzięki czemu możesz przetestować zapytanie na danych konta. Dostępny jest też osobny [walidator zapytań](link do strony), w którym możesz wklejać i sprawdzać ręcznie napisane zapytania GAQL.
- Eksportowanie: gdy zapytanie będzie gotowe, skopiuj i wklej przetestowany, poprawny pod względem składni ciąg GAQL do żądań klienta
GoogleAdsService.SearchlubSearchStream.
Kreator dba o to, aby wybrane pola, segmenty i dane były 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. Możesz to zrobić na 2 sposoby: przejść do konkretnej strony w dokumentacji raportowania lub rozpocząć eksplorację na stronie przeglądu Kreatora zapytań.
Z dokumentacji raportowania
- 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 użytkownika po lewej stronie.
- Kliknij Pomóż mi utworzyć zapytanie, aby przejść do Konstruktora zapytań dotyczącego tego konkretnego zasobu.
Na stronie Przegląd konstruktora zapytań
W sekcji Kreator zapytań w dokumentacji raportowania 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 kreatorze zapytań możesz przetestować w eksploratorze interfejsu API lub sprawdzić za pomocą narzędzia do sprawdzania zapytań.
API Explorer
Po utworzeniu zapytania kliknij Wypróbuj w narzędziu API Explorer, aby otworzyć zapytanie w narzędziu 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 artykule 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ą narzędzia do tworzenia zapytań będzie miało prawidłową składnię. Jeśli jednak znasz zasób, do którego kierujesz zapytanie, walidator zapytań umożliwi Ci szybkie wpisanie zapytania i sprawdzenie jego poprawności. Więcej informacji o tym narzędziu znajdziesz w artykule Walidator zapytań.