Kreator zapytań Google Ads to interaktywne narzędzie, które pomaga tworzyć i weryfikować zapytania za pomocą języka Google Ads Query Language (GAQL). Niezależnie od tego, czy dopiero zaczynasz korzystać z GAQL, czy jesteś doświadczonym użytkownikiem, Kreator zapytań może uprościć proces pobierania dokładnych danych, których potrzebujesz z interfejsu Google Ads API.
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 uporządkowanemu interfejsowi i menu z prawidłowymi opcjami pomaga zapobiegać błędom składni i literówkom, co zapewnia prawidłowość wygenerowanego zapytania.
- Szybsze tworzenie zapytań: przyspiesza proces tworzenia, automatyzując generowanie ciągów zapytań.
- Weryfikacja: narzędzie jest połączone z narzędziem API Explorer i walidatorem zapytań, dzięki czemu przed wykonaniem zapytania można sprawdzić, czy jest ono zgodne z regułami interfejsu API.
Jak to działa
Kreator zapytań Google Ads udostępnia przyjazny dla użytkownika interfejs, który umożliwia wizualne tworzenie zapytań GAQL. Tak wygląda podstawowa procedura:
- Wybierz zasób: zacznij od wybrania zasobu podstawowego na karcie
Dokumentacja dla wersji
o którą chcesz wysłać zapytanie. Ten zasób jest umieszczany w klauzuli
FROM. Zasoby reprezentują elementy w Google Ads, takie jakcampaign,ad_groupczykeyword_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 oraz jego zasobami z atrybutami (które można łączyć w sposób dorozumiany). Możesz zaznaczyć pola wyboru, które chcesz uwzględnić 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: dodaj warunki klauzuli
WHERE, aby odfiltrować wyniki. Kreator pomaga wybrać pola, operatory i wartości, co zapewnia prawidłową składnię. - Uporządkuj wyniki: określ kolejność sortowania za pomocą klauzuli
ORDER BY. - Ustaw limity: dodaj klauzulę
LIMIT, aby kontrolować liczbę zwracanych wyników. - Sprawdź: narzędzie automatycznie kieruje Cię do prawidłowych kombinacji pól , a także zawiera link do narzędzia 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 wkleić i sprawdzić ręcznie napisane zapytania GAQL.
- Eksportuj: gdy zapytanie będzie odpowiednie, skopiuj i wklej przetestowany, poprawny składniowo ciąg GAQL do żądań klienta
GoogleAdsService.SearchlubSearchStream.
Kreator sprawdza, czy wybrane pola, segmenty i dane są zgodne i mogą być używane razem w jednym zapytaniu, odwołując się do podstawowych metadanych interfejsu Google Ads API.
Rozpocznij
Kreator zapytań możesz otworzyć na 2 sposoby: przejść do konkretnej strony w dokumentacji raportowania lub przejść do strony przeglądu Kreatora zapytań.
W dokumentacji raportowania
- Zacznij od dokumentacji raportowania, i wybierz konkretny zasób z listy wszystkich zasobów. Możesz też przejść bezpośrednio do zasobu w panelu użytkownika po lewej stronie.
- Kliknij Pomóż mi utworzyć zapytanie, aby otworzyć Kreator zapytań dla tego konkretnego zasobu.
Na stronie przeglądu Kreatora 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 Kreatorze zapytań możesz przetestować w narzędziu API Explorer lub sprawdzić za pomocą walidatora zapytań.
API Explorer
Gdy utworzysz zapytanie, 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, a 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ą Kreatora zapytań ma już prawidłową składnię, ale jeśli znasz zasób, o który wysyłasz zapytanie, walidator zapytań umożliwia szybkie wpisanie zapytania i sprawdzenie jego prawidłowości. Więcej informacji o tym narzędziu znajdziesz w artykule Walidator zapytań.