Přejít k obsahu
GetProfit
Přihlásit se

← Všechny pojmy

GAQL (dotazovací jazyk Google Ads)

GAQL je dotazovací jazyk rozhraní Google Ads API: každý dotaz podobný SQL určuje jeden zdroj a pole, segmenty a metriky, které se pro něj vrátí.

Jak to funguje

Dotaz potřebuje SELECT a FROM; WHERE, ORDER BY, LIMIT a PARAMETERS jsou volitelné. FROM uvádí jediný zdroj (resource). JOIN neexistuje: chcete-li pole souvisejícího zdroje, například kampaně dané reklamní sestavy, přidáte je do SELECT.

Chybí také GROUP BY: každý segment ve SELECT, například segments.date, rozdělí metriky na jeden řádek pro každou hodnotu. Pokud vyberete segment s datem, WHERE musí určit konečné období. WHERE spojuje podmínky jen pomocí AND; místo OR Google doporučuje IN nebo REGEXP_MATCH.

Pro přehled podle produktu obsahuje shopping_performance_view metriky produktů, které se zobrazovaly v reklamách, shopping_product aktuální stav každého produktu a asset_group_product_group_view skupiny produktů (listing groups) v Performance Max. Stejné dotazy běží ve skriptech Google Ads i na MCP serveru Googlu. Funkční dotazy a datové pasti, kterým se vyhnout, najdete v textu Google Ads API pro přehledy podle produktu.

Příklad

Ukázkový obchod, nejde o data klientů.

SELECT segments.product_item_id, metrics.impressions, metrics.cost_micros
FROM shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS

Obchod se stolním nádobím dostane 1 200 řádků, jeden na každý produkt se zobrazeními; zbylých 1 800 z jeho 3 000 produktů řádek nedostane. Výdaje přicházejí v mikrojednotkách (micros), tedy miliontinách jednotky měny: talíř s cost_micros 25 000 000 stál 25.

Nezaměňovat s

  • Google Ads API — rozhraní, přes které GAQL běží. GAQL data jen čte; změny se posílají jako samostatné požadavky mutate.
  • BigQuery Data Transfer Service — načítá reporty Google Ads do tabulek BigQuery nejvýše jednou denně. Dotaz GAQL může definovat vlastní report, ale uložené tabulky se dotazují v BigQuery.

Správný a chybný výklad

  • Špatně: „WHERE segments.product_item_id = 'PLT-0457' nic nevrací, takže talíř se nikdy nezobrazil.“ Správně: v účtech našich klientů vracejí produktové reporty ID produktu malými písmeny a = rozlišuje velikost písmen. Filtrujte podle 'plt-0457' nebo použijte LIKE, které velikost písmen ignoruje.
  • Špatně: „V reportu členěném po dnech chybí řádek pro 14. března, takže se data nenačetla.“ Správně: jakmile je report segmentovaný, řádky, v nichž jsou všechny vybrané metriky nulové, se vynechávají.

Zdroje