文件目錄

流量來源整合/AdsGram

已支援 · 可以使用

AGAdsGramMeetROAS

將 MeetROAS 投放網址放進 AdsGram,再把平台產生的轉換設定貼回 MeetROAS。沒有 MeetROAS tile 時請選擇 Custom/Other tracker。

能不能用

可以使用。儲存自己的 AdsGram token 並建立固定事件預設;下一次 Web Landing Campaign 投放後可在 Statistics 核對轉換。

複製什麼,貼到哪裡

複製貼到
MeetROAS 產生、含 {record_data} 的完整投放網址Web Landing Link
AdsGram 帳號產生的完整 Postback URLMeetROAS Campaign → 轉換整合

局部介面操作圖

AGAdsGram

Campaign → Web Landing Link;帳號 token 位於 AdsGram advertiser account

1
Web Landing Link貼上 MeetROAS 產生的完整投放網址

網址必須保留{record_data}

MeetROAS

Campaign → 轉換整合

2
事件轉換設定貼上一次完整 AdsGram Conversion Confirmation URL,並一鍵建立 goaltype 1、2、3

✓ 最後到 AdsGram 後台確認轉換成功

局部操作圖:先在 AdsGram 放入投放網址,再把轉換設定存回 MeetROAS。實際選單外觀可能隨平台更新。

需要準備的資料

平台入口Campaign → Web Landing Link;帳號 token 位於 AdsGram advertiser account
點擊 macro{record_data}
回傳方式HTTPS GET Postback

使用 https://api.adsgram.ai/confirm_conversion,並填寫自己帳號的 token;MeetROAS 固定保留 record={record_data},token 加密儲存且不會回顯。

設定步驟

  1. 在 MeetROAS 建立或開啟流量來源為 AdsGram 的 Campaign,並複製系統產生的投放網址。
  2. 建立 Web Landing Campaign,並將 MeetROAS 投放網址放入 Web Landing Link;網址已包含 {record_data}。
  3. 從 AdsGram advertiser account 取得 token;MeetROAS 會從一個 URL 產生 goaltype 1、2、3。
  4. 在 MeetROAS 貼上含自己 token 的完整 Conversion Confirmation URL,再一鍵建立註冊、首充/首購、重複充值/購買預設。
  5. 請求格式、事件映射、HTTP 200 成功判定與重試去重已依 AdsGram 官方文件驗證;這不是付費流量的全鏈路實證。投放後可在 AdsGram Statistics 核對實際轉換。

如果平台沒有 MeetROAS tile,請使用 Custom、Other tracker 或平台提供的通用 Postback。

事件與金額

一鍵預設固定為註冊 → goaltype=1、首充/首購 → goaltype=2、重複充值/購買 → goaltype=3。官方 API 沒有 value、price 或 currency 欄位,MeetROAS 不會猜測或傳送金額。

下游金額 → 上游參數對照

方向:下游 → MeetROAS Partner Event API → 歸因來源。value 是收益,price 是獲客成本,currency 是下游宣告的幣別。— 表示目前 MeetROAS connector 不投影該欄位,不代表上游沒有該功能。URL 金額欄列出可選範本 placeholder:範本有該參數且下游有該金額才替換,缺少金額就移除;不會自動加參數、互相代填或換匯。註冊與登入不能攜帶金額。

上游value →price →currency / 缺值規則
AdsGram——不投影 currency;不換匯

點擊、Goal 與槽位預設

點擊 macro 由上游展開為真實 click ID,再由 MeetROAS 回傳;不是下游的 mrc_。下表是目前新增預設的行為,既有手動綁定不會被自動覆蓋。帳號識別與 URL 必須從各上游取得,不從槽號或 token 推測事件。

上游投放網址 macro / 參數回傳 click 欄位事件 / Goal 對應
AdsGram{record_data}record={record_data}account_registration → goaltype=1;first_deposit → goaltype=2;deposit → goaltype=3。token 來自 AdsGram 帳號;每槽一個綁定

怎樣確認成功

請求格式、事件映射、HTTP 200 成功判定與重試去重已依 AdsGram 官方文件驗證;這不是付費流量的全鏈路實證。投放後可在 AdsGram Statistics 核對實際轉換。

  • 測試點擊由平台產生,並在 MeetROAS 歸因到正確來源。
  • MeetROAS 顯示事件已接收,且重試不會建立重複事件。
  • 最後請到 AdsGram 後台確認轉換已成功收到;以該平台後台顯示為準。

注意事項

  • Telegram Ads Campaign 不傳 AdsGram macro,不能使用這個 Conversion Confirmation API;必須使用 Web Landing Link。
  • 只有 HTTP 200 代表 AdsGram 已接受轉換;其他 2xx 不視為成功。

繼續操作