P2
GA4 campaign/content 維度 ingestion(配合 UTM 發文 SOP,逐貼文精確歸因)
最新狀態
【範圍】ingest_articles/GA4 ingestion 加 sessionCampaignName+sessionManualAdContent(或解析 landingPagePlusQueryString)維度進 web_metrics;短網址建立時自動寫 article_social_links(match_method=utm)。
【口徑建議】utm_source=平台/utm_medium=organic_social/utm_campaign=文章識別/utm_content=貼文識別;UTM Builder select 選項要同步加。 【2026-07-24 關聯釐清】跟 todo-2026-07-09-oxqwtw(手動補登方案 B:頁面 UI+Worker 寫入)不是同一件,但是同一個目標「逐貼文精確歸因」的兩條路:本條=自動歸因(GA4 抓 utm_campaign/utm_content,靠社群草稿臺已在發的三條短連結),oxqwtw=人工補登的 UI。若本條做起來且短連結覆蓋率夠,方案 B 的必要性會大幅下降。合併與否待西西🌸 拍板。 【2026-07-24 西西🌸 拍板】不跟 oxqwtw 合併,兩條各自留著,但**一有結論或測試成功就要立刻勾掉**,不讓它們變殭屍條。球轉摳摳:v3 ingestion 整條 workstream 本來就是他在跑(manual_article_social_links.py／全量歷史回溯／Meta Ads 回撈),Supabase schema 與程式碼慣例都在他手上。 【2026-07-24 摳摳開工】ingestion 端第一段已完成:ingest_articles.py 新增 --include-utm-breakdown 抓 GA4 sessionSource/sessionMedium/sessionCampaignName/sessionManualAdContent/landingPagePlusQueryString 月資料,準備寫 web_metrics dimension_type=ga4_utm_landing;新增 --backfill-utm-social-links,可用 landing 對文章、utm_source 對平台、utm_content 對 social_posts.id/platform_post_id/permalink,命中時寫 article_social_links(match_method=utm)。新增 schema/2026-07-24_web_metrics_ga4_utm_landing.sql 放行 Supabase check constraint;新增 tests/test_ingest_articles_utm.py。驗證:py_compile PASS;UTM tests 6/6 PASS;既有 test_ingest_social_links 8/8 PASS;test_manual_article_social_links 6/6 PASS。實查限制:社群草稿臺 shortlinks.py 目前只產 utm_source+utm_medium=social,還沒有 campaign/content,所以 bridge 要等短鏈產生器補穩定 utm_content 並套 SQL migration 後,再跑小窗 dry-run/write。三方檔已記 §5.164。 【2026-07-24 摳摳短鏈補強完成】社群草稿臺 shortlinks.py 已補 utm_campaign=article_<WP ID/slug> 與 utm_content=<平台>_<短碼>;短碼由產生器先產出並以 /api/create custom_code 寫入,撞碼只重試,不覆蓋既有 s.myhousing 短碼。ingest_articles.py 的 UTM bridge 同步補 social_posts.caption 短碼 lookup,可用 fb_/threads_/ig_ content 反查貼文。文件同步: social-panel README/DESIGN、W_對外連結工具棧 HANDOFF。驗證:shortlinks py_compile PASS,test_shortlinks 6/6 PASS;ingest_articles UTM tests 7/7 PASS;既有社群連結回歸 8/8+6/6 PASS;social-panel test_parse 51篇/357版本 PASS,test_wp_select 14/14 PASS。尚未執行真 API 建鏈、未套 Supabase migration、未做 production write。 【2026-07-24 摳摳小窗 dry-run】本機無 psql/Supabase CLI/DB connection string,service-role REST key 不能套 DDL,migration 仍需西西🌸貼 Supabase SQL Editor。已用專案 venv 跑 2026-07-24 dry-run(不加 --write):WP fetched 8,prepared article_metrics 15/web_metrics 126,GA4 UTM candidates 50,resolved_article 38,resolved_post 0,resolved_both 0,bridge inputs articles_read 3745/posts_read 153。判讀:UTM 讀路徑可跑;0 bridge 是因小窗 GA4 目前 utm_content 仍為 (not set),尚未有新規則短鏈 hit。 【2026-07-24 摳摳小窗 write PASS】西西🌸 回報 SQL Editor migration 已跑完後,跑 articles_utm_write_2026-07-24_r2 --write 成功:WP fetched 8,prepared article_metrics 15/web_metrics 124,inserted_or_updated 158,Supabase counts articles 3750/article_metrics 185200/web_metrics 11536。第一輪 write 曾因同批 web_metrics duplicate conflict key 失敗(不是 constraint),已補 dedupe_metric_rows() 依 DB conflict identity 去重,重複採最後一筆覆蓋;測試 test_ingest_articles_utm 8/8、test_ingest_social_links 8/8、test_manual_article_social_links 6/6 PASS。唯讀驗證:DB 2026-07-01..2026-07-24 ga4_utm_landing 已有 98 rows(metrics=sessions/active_users)。utm_links 仍 0,因目前 GA4 content 還是 (not set),要等新規則短鏈有 hit 才能驗逐貼文 bridge。 【2026-07-27 摳摳小窗重驗】西西🌸 已請可樂確認昨天/今天另一工作流產短鏈方式：今天 6 篇全部走 000_Agent/scripts/social-panel/shortlinks.py 2026-07-24 後新規則，真實 redirect 查驗兩例：WP 286187 FB 短碼 l05e35 → utm_campaign=article_286187、utm_content=fb_l05e35；IG 短碼 57ltkb → utm_content=ig_57ltkb；custom_code 等於短碼本身。摳摳跑 2026-07-26..27 dry-run r2（artifact: v3.0/artifacts/ingestion/2026-07-27/articles_utm_dry_2026-07-26_27_new_shortlinks_r2/articles/articles_raw.json）：WP fetched 20、article_metrics 27、web_metrics 1224、utm_candidates 500、utm_links 0，artifact 不含 l05e35/57ltkb/fb_l05e35/ig_57ltkb。另用 GA4 exact filter 查 sessionManualAdContent=fb_l05e35 / ig_57ltkb（artifact: v3.0/artifacts/ingestion/2026-07-27/articles_utm_exact_filter_2026-07-26_27_new_shortlinks.json）兩者 row_count 皆 0。判讀：短鏈產法 gate 已過；目前卡的是這兩條樣本尚未在 GA4 查詢窗回 content row，可能尚未有點擊或 GA4 尚未處理完成；本條維持 active，下一步等有實際點擊/隔天再重跑 exact filter，小窗出 row 後再決定 --write。