媒體方回傳

像獎勵型應用程式、衝榜媒體這類使用自有追蹤系統的媒體方，會要求「發生轉換時請通知我們的網址」。adstage 以依連結設定的方式處理這類需求。只要填入媒體方提供的回呼 URL，當透過該連結進入的使用者觸發安裝、購買等事件時，adstage 就會代為呼叫媒體方的網址。

無須為每家媒體方另行開發。取得規格後在儀表板中填寫即可立即完成串接。

1. 在哪裡設定

在 深層連結 > 建立 或既有連結的詳細畫面中，開啟 媒體方回傳 區塊。設定是依連結分別儲存的，因此請依媒體方分別建立連結，並在各連結中填入該媒體方的網址。

2. 設定項目

若媒體方表示「點擊時我們會以名為 cb 的參數傳遞我們的點擊 ID」，就在 點擊 ID 參數名稱 中填入 cb。

3. URL 範本與巨集

將媒體方提供的網址原樣貼上，並在需要填入值的位置使用巨集。

https://postback.network.com/install?cb={click_id}&adid={adid}

可以使用的巨集如下。

媒體方要求清單中沒有的巨集時

若媒體方要求 {sub_id}、{pub_id} 這類他們專用的值，直接照寫即可。 清單中沒有的巨集會以**將點擊時以該名稱傳入的參數原樣回送（echo）**的方式運作。

也就是說，若媒體方在點擊 URL 上附加了 ?sub_id=abc123，那麼回傳中 {sub_id} 的位置就會被填入 abc123。

請注意

若點擊時沒有傳入該參數，發送時就會是空值。請確認媒體方規格中的參數是否確實包含在實際的點擊 URL 中。

4. 運作方式

1. 使用者點擊媒體方廣告，進入 adstage 追蹤連結。此時點擊 ID 與媒體方參數會一併被記錄。

2. 該使用者安裝應用程式或觸發所設定的事件時，adstage 會透過歸因找出對應的媒體方點擊。

3. 將 URL 範本中的巨集替換為實際值，並呼叫媒體方網址。

防止重複

對於同一次點擊，同一事件只會發送一次。即使使用者多次開啟應用程式或事件被重複收集，也不會向媒體方發送兩次。

install 與 first_open 這類意義相同的事件名稱會被歸併處理，因此即使兩者都進來，回傳也只會發出一次。

失敗時重試

若媒體方伺服器暫時沒有回應，為了不讓轉換悄悄遺失，系統會自動重試。

5. 串接前需要向媒體方確認的事項

與新媒體方串接時，只需取得下列四項。

1. 回傳 URL — 安裝用的網址，若另有事件用的網址也一併提供
2. 點擊 ID 參數名稱 — 在點擊 URL 中以什麼名稱附加識別碼
3. 需要的巨集清單 — 希望接收哪些值
4. 目標事件 — 只需要安裝，還是也需要購買等其他事件

6. 注意事項

• 回傳設定以連結為單位。向同一家媒體方提供多個連結時，必須在每個連結中都完成設定。
• 必須成立歸因才會發送回傳。未經過媒體方連結的流量不在對象範圍內。
• URL 中填入的值會自動進行 URL 編碼。請勿在巨集的位置預先填入已編碼的值。
• 有些媒體方會透過回應內文區分成功／失敗。adstage 僅依 HTTP 狀態碼判定，並將 2xx 與 3xx 視為成功。若媒體方在內文中帶上錯誤卻以 200 回應，adstage 將無法察覺失敗，因此請要求其在發生錯誤時回傳 4xx、5xx。