Dokumentace
Data Studio: tvorba reportů z dat AutoPSEO
AutoPSEO nemá vlastní konektor pro Data Studio. Použijte konektor Search Console od Googlu, nahrání souboru CSV nebo tabulku Google Sheets, kterou průběžně aktualizuje REST API.
AutoPSEO nenabízí konektor pro Data Studio, nástroj Googlu pro tvorbu dashboardů, dříve známý jako Looker Studio. Jeho čísla tam ale vizualizovat můžete, a to třemi způsoby: pomocí konektoru Search Console od Googlu pro surová data, pomocí souboru CSV exportovaného z reportu AutoPSEO, nebo pomocí tabulky Google Sheets, kterou plánovaný skript plní z REST API AutoPSEO. Který způsob zvolit, závisí na tom, jak aktuální musí dashboard být a zda potřebuje analýzy z AutoPSEO, nebo jen surové metriky.
Možnost 1: konektor Search Console od Googlu
Konektor od Googlu čte data přímo ze Search Console, takže přináší surové metriky, ale žádné analýzy z AutoPSEO. Podle průvodce Googlu k tomuto konektoru:
- Nabízí dvě tabulky, Site Impression a URL Impression, a jeden zdroj dat používá vždy jen jednu z nich. Chcete-li v reportu zobrazit obě, přidejte dva zdroje dat.
- Potřebujete alespoň oprávnění k zobrazení pro danou vlastnost v Search Console a v obou produktech musíte být přihlášeni stejným účtem Google.
- Site Impression pokrývá webové, obrazové, video a zpravodajské výsledky; URL Impression navíc zahrnuje Discover a Google News.
Přidáte ho přes Create → Data Source → Search Console: vyberte web, tabulku a výchozí typ vyhledávání a potom klikněte na Connect.
Možnost 2: nahrání souboru CSV z AutoPSEO
Pro jednorázový nebo měsíční dashboard exportujte tabulku z libovolného reportu (Export dat) a přidejte ji pomocí konektoru Data Studio pro nahrávání souborů CSV. O způsobu exportu rozhodují požadavky Googlu na nahrávané soubory:
- Pole musí být oddělena čárkami, proto nejprve nastavte Account → CSV export format na Standard (US / UK).
- Soubor musí být v kódování UTF-8 a mít řádek se záhlavím, což exporty z AutoPSEO splňují.
- Každý soubor přidaný do datové sady musí mít přesně stejné sloupce ve stejném pořadí, proto pokaždé exportujte stejný report se stejnými sloupci a stejným nastavením porovnání.
- Nové soubory se připojují a duplicity se neodstraňují, proto nenahrávejte překrývající se časová období.
- Soubor může mít až 100 MB a každý uživatel má k dispozici 2 GB úložiště pro nahrávání.
Procenta se exportují se znakem procenta (27.03%), proto po nahrání zkontrolujte typy polí.
Možnost 3: tabulka Google Sheets plněná přes REST API
Pro dashboard, který se aktualizuje sám, nechte plánovanou úlohu zapisovat čísla z AutoPSEO do tabulky Google Sheets a tu pak připojte. Konektor pro Google Sheets při každém dotazu reportu zkontroluje změněné hodnoty a nové řádky.
- V AutoPSEO otevřete MCP & API a vytvořte klíč API s rozsahem Read only. Zobrazí se pouze jednou, proto ho uložte do tajných proměnných své úlohy.
- Z plánované úlohy (Google Apps Script, úloha cron nebo nástroj pro workflow) zavolejte REST API a zapište řádky do tabulky.
- V Data Studio přidejte tabulku pomocí konektoru Google Sheets a zaškrtněte Use first row as headers.
Volání pro nejčastější dotazy za posledních 28 dní vypadá takto:
curl -s "https://app.autopseo.com/v1/properties/sc-domain%3Aexample.com/queries?range=28d&limit=1000" \
-H "Authorization: Bearer apk_live_..."
Každá odpověď je ve formátu JSON, přičemž výsledek je v poli data a podrobnosti o volání v poli meta. REST API nabízí stejných 19 nástrojů pro Search Console a GA4 jako server MCP: vlastnosti, řádky analýzy vyhledávání, nejčastější dotazy, stránky a země, porovnání období, změny pozic, nové a ztracené pozice, úpadek obsahu, kanibalizaci, benchmark CTR, přebírání stránek, kontrolu URL, sitemapy, anotace a v GA4 přehled, rozpady a klíčové události. Nejčastější dotazy a nejčastější stránky vracejí až 1 000 řádků, nejčastější země až 300 a search-analytics až 5 000 surových řádků pro jednu nebo dvě dimenze. Volání jsou omezena na 60 za minutu na klíč a 1 000 za hodinu na účet a dokument OpenAPI 3.1 na adrese https://app.autopseo.com/v1/openapi.json popisuje všechny parametry.
Kterou možnost zvolit
| Potřebujete | Použijte |
|---|---|
| Surové kliknutí a zobrazení, aktualizované Googlem | Konektor Search Console od Googlu |
| Měsíční snímek jednoho reportu z AutoPSEO | Nahrání souboru CSV |
| Analýzy z AutoPSEO podle plánu, například změny pozic nebo úpadek obsahu | Tabulka Google Sheets plněná přes REST API |
Pokud dashboard slouží hlavně k tomu, aby klientovi ukázal čísla, může být méně práce sdílený odkaz na report nebo plánovaný report do Slack nebo Microsoft Teams. Náš FAQ o Search Console v Looker Studiu popisuje konektor od Googlu podrobněji.