Google Analytics 4 (імпарт)

1. Што імпартуецца, а што не

Абодва шляхі чытаюць з вашага акаўнта Google і ўключаюцца асобна. Яны адказваюць на розныя пытанні, і абодва не абавязковыя.

Шлях	Што атрымлівае	Для чаго
Data API	Штодзённыя вынікі: сеансы, карыстальнікі, прагляды старонак, уцягнутыя сеансы	Пытанне ахопу. GA4 лічыць 3,000 сеансаў, MousePlayer запісаў 40 — без эталоннай лічбы розніцу нават не заўважыць.
Імпарт BigQuery	Асобныя сеансы GA4 разам з падзеямі	Што адбылося падчас наведвання, якога MousePlayer не запісаў.

Імпартаваны сеанс нельга прайграць. GA4 не захоўвае здымак старонкі або рух мышы, таму няма з чаго будаваць прайграванне. Вы атрымліваеце лічбы і падзеі побач з запісамі — не больш, і мы не выдаём гэта за большае.

Імпарт знаходзіцца ва ўласных табліцах і ніколі не змешваецца з запісамі. Інакш сэнс кожнай вытворнай лічбы — профіляў паводзін, ацэнкі наведвальнікаў, аналізу перашкод — незаўважна змяніўся б, і потым ніхто не адрозніў бы вымераны радок ад атрыманага.

2. Шлях 1: Data API

Патрэбны дзве рэчы: ID рэсурсу і ключ сэрвіснага акаўнта.

ID рэсурсу — не ID вымярэння

Гэта найчасцейшая памылка, і паведамленне Google яе не называе. Гэты ID вымярэння выглядае як G-ABC123XYZ, знаходзіцца ў кодзе адсочвання і бачны ўсюды. А ID рэсурсу складаецца толькі з лічбаў і бачны ў адміністрацыйным раздзеле налад рэсурсу. Патрэбны другі; першы мы адхіляем з заўвагай замест памылкі 400.

Стварэнне і аўтарызацыя сэрвіснага акаўнта

У Google Cloud Console стварыце сэрвісны акаўнт і ключ JSON.
У тым жа праекце ўключыце Google Analytics Data API.
У GA4, у кіраванні доступам рэсурсу, дадайце пошту сэрвіснага акаўнта як Назіральніка. Сэрвісны акаўнт — асобны карыстальнік; без гэтага Google адказвае 403 без тлумачэння.

Устаўце змесціва JSON-файла ў поле. Яно захоўваецца шыфраваным і потым паказваецца толькі скарочаным.

3. Шлях 2: імпарт BigQuery

Гэты шлях чытае зыходны экспарт GA4. Яго трэба аднойчы наладзіць у GA4: Адміністратар, Сувязі BigQuery. Табліцы з'явяцца толькі на наступны дзень — раней імпарт нічога не знойдзе, і гэта не збой.

Што ўводзіць

Гэты ID праекта GCP , дзе знаходзіцца экспарт. Гэта не абавязкова праект для экспарту MousePlayer.
Гэты ID набору даных. GA4 называе яго analytics_<propertyId>.
Ключ сэрвіснага акаўнта з роляй BigQuery Data Viewer у наборы даных і BigQuery Job User у праекце. Чытання дастаткова; не давайце больш правоў.

Колькі каштуе і хто плаціць

BigQuery бярэ плату за прачытаныя байты, і гэты рахунак ваш. Таму імпарт чытае толькі некалькі дзён за запуск і робіць толькі адзін запыт — другі прачытаў бы тыя ж табліцы зноў. Дадаткова жорсткая мяжа спыняе запыт да таго, як ён стане дарагім; тады журнал дастаўкі паведаміць, што інтэрвал занадта вялікі.

Перыядычнасць

Па змаўчанні кожныя шэсць гадзін з паўторным чытаннем апошніх трох дзён. Гэта не выпадкова: GA4 дапаўняе даныя да 48 гадзін, а штодзённы экспарт з'яўляецца толькі на наступны дзень. Часцейшыя запыты дадуць не свежыя лічбы, а тыя ж самыя.

4. Ключ сувязі двух бакоў

Калі таксама наладзіць аналітычны мост на GA4, MousePlayer запісвае ID кліента з cookie _ga у кожны сеанс. Гэта менавіта значэнне BigQuery у полі user_pseudo_id.

Яно дазваляе супаставіць сеанс GA4 з вашым запісам і ўбачыць, што GA4 палічыў падчас таго ж наведвання. Без моста бакі проста існуюць побач без сувязі.

Тое ж поле захоўвае ваш уласны ID кліента пры выкарыстанні setUserId(). Абодва немагчымыя: там альбо ID кліента Google, альбо ваш нумар.

5. Згода, захоўванне і выдаленне

У імпартаваных даных быў cookie

Імпартуюцца толькі радкі з user_pseudo_id . Пры адмове наведвальніка GA4 адпраўляе звароты без cookies у Consent Mode і без гэтага значэння — яны адсейваюцца самі. Мадэляваныя, гэта значыць ацэначныя, радкі таксама не ўваходзяць: захоўваць ацэнку як сеанс азначала б захоўваць наведванні, якіх не было.

Тэрмін захоўвання

Па змаўчанні 180 дзён ад дня, які апісвае радок, а не моманту імпарту. Інакш тэрмін ніколі не скончыўся б, бо кожны запуск чытае тыя ж дні.

Выдаленне

Калі наведвальнік просіць сцерці даныя, выдаляюцца і яго імпартаваныя сеансы GA4, наколькі іх можна аднесці да ідэнтыфікатара вышэй. Пры выдаленні праекта яны выдаляюцца ўсе, уключаючы не звязаныя з вашымі запісамі. Штодзённая ачыстка запісаў наўмысна іх не кранае: у GA4 свой тэрмін, а вашы запісы знікаюць раней.

6. Калі нічога не паступае

Кожны запуск піша вынік у журнал дастаўкі на старонцы інтэграцый — разам са збоямі, зразумелымі словамі. Звычайна гэта ўжо тлумачыць, чаго не хапае.

Паведамленне	Што рабіць
ID рэсурсу павінен складацца толькі з лічбаў	Вы ўвялі ID вымярэння. Правільны нумар у наладах рэсурсу GA4.
HTTP 403 ад Data API	Сэрвісны акаўнт не мае ролі Назіральніка GA4 або Data API не ўключаны ў праекце GCP.
Набор даных або табліцы экспарту не знойдзены	Няма сувязі BigQuery, іншая назва набору або яшчэ не мінуў дзень.
Доступ забаронены (BigQuery)	Няма ролі BigQuery Data Viewer для набору або BigQuery Job User для праекта.
Запыт прачытаў бы занадта шмат	Ліміт кошту спыніў яго да налічэння платы. Выберыце меншы інтэрвал.
няма сеансаў у інтэрвале	Гэта не збой. У атрыманыя дні не было сеансаў са згодай.

Чым мы можам дапамагчы?