Kreator zapytań Google Ads to interaktywne narzędzie, które pomaga w interaktywnym tworzeniu i weryfikowaniu zapytań 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.
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 w eksplorowaniu i znajdowaniu dostępnych zasobów, pól, segmentów i danych w modelu danych interfejsu Google Ads API.
- Mniej błędów: dzięki uporządkowanemu interfejsowi i menu rozwijanym z prawidłowymi opcjami pomaga zapobiegać błędom składni i literówkom, zapewniając, że wygenerowane zapytanie jest prawidłowe.
- 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ń, aby sprawdzać zapytania pod kątem reguł interfejsu API przed ich wykonaniem.
Jak to działa
Kreator zapytań Google Ads udostępnia przyjazny dla użytkownika interfejs do wizualnego tworzenia zapytań GAQL. Tak wygląda podstawowa procedura:
- Wybierz zasób: zacznij od wybrania zasobu głównego na karcie
Odniesienie w wersji
o którą chcesz wysłać zapytanie. Ten zasób będzie znajdować się w klauzuli
FROM. Zasoby reprezentują encje 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, 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: możesz dodać warunki klauzuli
WHERE, aby filtrować wyniki. Kreator pomaga wybrać pola, operatory i wartości, zapewniając 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 samo w sobie prowadzi Cię do prawidłowych kombinacji pól, ale też zawiera linki 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żna otworzyć na 2 sposoby. Możesz przejść do konkretnej strony w dokumentacji referencyjnej dotyczącej raportowania lub eksplorować z poziomu strony przeglądu Kreatora zapytań.
Z dokumentacji referencyjnej dotyczącej raportowania
- Zacznij od dokumentacji referencyjnej dotyczącej raportowania, i wybierz konkretny zasób z listy wszystkich zasobów. Możesz też przejść bezpośrednio do zasobu w panelu nawigacyjnym po lewej stronie.
- Kliknij Pomóż mi utworzyć zapytanie, aby otworzyć Kreator zapytań dla tego konkretnego zasobu.
Ze strony przeglądu Kreatora zapytań
Otwórz sekcję Kreator zapytań w dokumentacji referencyjnej dotyczącej 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
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, 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ń będzie miało prawidłową składnię, ale jeśli znasz zasób, o który wysyłasz zapytanie, walidator zapytań zapewni szybki sposób na wpisanie zapytania i sprawdzenie jego poprawności. Więcej informacji o tym narzędziu znajdziesz w artykule Walidator zapytań.