2021聯盟網 CPA串接文件

更新 2021/3/5
聯盟網 – 程式串接說明文件
前提
聯盟行銷使用各種媒體 (分享文、論壇、關鍵字廣告、EDM 等) 導引消費者到商家自有的網路商
城或登陸頁。安裝轉換追蹤碼讓廣告商了解各廣告媒體最終效果。CPA 廣告以實際產生的訂單或
名單來計算廣告費用。
聯盟網提供串接程式目錄：
一、 CPL(Cost per Lead) 會員註冊或表單填寫

A. 伺服器對接 (Server to Server) ………………………………………………………………... p2
B. JavaScript …………………………………………………………………………………………. p3
二、 CPS(Cost per Sale) 商品導購或完成交易

A. 伺服器對接 (Server to Server) .….……………………………………………………………. p5
B. JavaScript …………………………………………………………………………………………. p6
【串接方式說明】
S2S (Server-to-Server) 伺服器對接
開始刊登廣告前，配置追蹤標籤在終點網址。標籤是指您所指定的代名來記錄固定或非固定的參數。通常廣告商會需
要記錄媒體通路、子頻道、關鍵字、訪客網站來源或活動項目等。如以下範例，「pid」標籤置入參數 google，「cid」
標籤置入參數 april_sale。
例如網址：http://www.yourdomain.com/?pid=google&cid=april_sale
JavaScript 追蹤技術
JavaScript 使用 Cookie 追蹤技術來記錄消費者到訪商城時間，與購買狀況。串接需埋入「瀏覽碼」與「成效碼」在
登入頁與成效頁面。
安裝追蹤碼前，請先評估貴公司適合的串接方式。謝謝！
1
有疑問請來信 support@upstartdna.com，並於信內附上截圖與詳細說明遇到的狀況，以加速聯盟網回應、解答。
更新 2021/3/5
一、CPL(Cost per Lead) 會員註冊或表單填寫
A) 伺服器對接 S2S (Server to Server)
(步驟 1)
1. 請先提供聯盟網廣告終點網址並帶入預設的追蹤標籤。此標籤參數必須能記錄到商家的追蹤
Cookie 或資料庫，請提供一到兩組標籤給聯盟網使用。
【推廣網址範例】
說明：假設廠商所提供的推廣頁面/表單頁 (登陸頁 Landing Page)：
http://www.yourdomain.com/index.html?pid=affiliates&id={聯盟會員編號}&id2={點擊編號}
解譯：以上 affiliates 值代表廠商所設定的媒體來源，{聯盟會員編號} 與 {點擊編號} 參數將由聯盟網
提供。
(i) 聯盟網可傳送會員編號（非必提供）及點擊編號（必提供）到廠商追蹤網址裡。pid、
id、id2 欄位名稱廠商可以自己預設，但點擊編號必須要紀錄，之後回傳給聯盟網。
(ii) 透過聯盟網的廣告追蹤網址，將會帶入以下參數到廠商提供的終點網址 (以下範例)：

http://www.yourdomain.com/index.html?pid=affiliates&id=1001&id2=b5fbb9a075d4
1be4a4853d80ed89d023
※ {聯盟會員編號} 提供廠商審查會員品質，如不需要可不記錄。
※ {點擊編號} 是聯盟網系統生成的 32 個字符的字母數字。
(步驟 2)
2. 名單成立後廠商需回報點擊編號參數到聯盟網 S2S Post Back 網址。
【聯盟網 S2S Post back 網址】
https://vbtrax.com/track/postback/conversions/8/global?server_subid=[id2]&adv_unique_id=
注釋：可使用 GET 或 POST 方式回報。
(i) 使用以上案例，廠商將回報：
https://vbtrax.com/track/postback/conversions/8/global?server_subid=b5fbb9a075d4
1be4a4853d80ed89d023&adv_uniq_id={名單編號}
2
更新 2021/3/5
※ 如有名單編號或交易 ID 參數請帶入 adv_uniq_id=。

※ 聯盟網收到廠商端拋回的點擊編號後，系統會主動核對是否正確，如果正確，系統會回覆
「OK」；如果失敗，系統會回覆「FAILS」。
B) Javascript
(步驟 1) - 安裝 JS 瀏覽碼
1. 確定使用 JavaScript 串接方式後請提供推廣頁/名單頁網址並向聯盟網申請網址追蹤編號
( Site ID )。聯盟網將提供 #### 編號。
2. 將以下語法貼到首頁/名單頁/活動頁 HTML 裡的<head></head>中。
----------------------------------------------------------------------------------------------------------------------
<script type="text/javascript">
(function () {
var VARemoteLoadOptions = {
whiteLabel: { id: 8, siteId: ####, domain: 't.adotone.com' },
locale: "en-US", mkt: true
};
(function (c, o, n, v, e, r, l, y) {
c['VARemoteLoadOptions'] = e; r = o.createElement(n), l = o.getElementsByTagName(n)[0];
r.async = 1; r.src = v; l.parentNode.insertBefore(r, l);
})(window, document, 'script', 'https://cdn.adotone.com/javascripts/va.js', VARemoteLoadOptions);
})();
</script>
----------------------------------------------------------------------------------------------------------------------
(步驟 2) - 安裝 JS 成交碼
1. 將以下語法貼到成效頁 HTML 裡的<body></body>中，並將名單編號資料帶入。執行 JS 成
交碼前請排除其他 CPA 媒體來源或使用 GTM (Google Tag Manager) 追蹤判別功能。完成
後可通知聯盟網人員索取測試連結進行名單測單。
----------------------------------------------------------------------------------------------------------------------
(function () {
conversion: true,
conversionData: {
3
更新 2021/3/5
step: 'default', // conversion name

adv_uniq_id: '置入名單編號' // optional lead id
},
};
})();
</script>
----------------------------------------------------------------------------------------------------------------------
adv_uniq_id = [名單/交易編號] → 消費者的名單編號
※ 任何已點擊聯盟網廣告並且在合作 cookie 追蹤時間範圍內，JavaScript 成交碼都會成功記錄產

生訂單。如需排除其他 CPA 媒體來源，歡迎使用有條件式語法執行。成效將已最終點擊 (Last Click)
計算。
4
更新 2021/3/5
二、 CPS(Cost per Sale) 商品導購或完成交易
A) 伺服器對接 S2S (Server to Server)
(步驟 1)
1. 請先提供聯盟網廣告終點網址並帶入預設的追蹤標籤。此標籤參數必須能記錄到商家的追蹤
Cookie 或資料庫，請提供一到兩組標籤給聯盟網使用。
【推廣網址範例】
說明：假設廠商所提供的推廣頁面/商城 (登陸頁 Landing Page)：
http://www.yourdomain.com/index.html?pid=affiliates&id={聯盟會員編號}&id2={點擊編號}
解譯：{聯盟會員編號} 與 {點擊編號} 參數將由聯盟網提供。
(i) 聯盟網可傳送會員編號（非必提供）及點擊編號（必提供）到廠商追蹤網址裡。pid、
id、id2 欄位名稱廠商可以自己預設，但點擊編號必須要紀錄，之後回傳給聯盟網。
(ii) 透過聯盟網的廣告追蹤網址，將會帶入以下參數到廠商提供的終點網址 (以下範例)：

http://www.yourdomain.com/index.html?pid=affiliates&id=1001&id2=b5fbb9a075d4
1be4a4853d80ed89d023
※ {聯盟會員編號} 提供廠商審查會員品質，如不需要可不記錄。
※ {點擊編號} 是聯盟網系統生成的 32 碼的字母數字。
(步驟 2)
2. 訂單成立後廠商需回報點擊編號參數到聯盟網 S2S Post Back 網址。
【聯盟網 S2S Post back 網址】
https：//vbtrax.com/track/postback/conversions/8/global?order=[訂單編號]& order_total=[購
買總金額]&revenue=[佣金金額]&server_subid=[id2]&step=sale
注釋：可使用 GET 或 POST 方式回報。
order = [訂單編號] → 消費者的訂單編號
order_total= [購買總金額] → 訂單金額(扣除紅利、折扣…等) ; 僅限於數字，請勿包含貨幣、千位數符號。
revenue = [廣告佣金金額] → 限用於不同商品/類別做不同分潤計算。如分潤比例全館一致，請勿使用此欄位，佣金
將由合約以平台設置為主。
server_subid = [id2] 的參數由聯盟網自動帶入 URL 中，請廠商協助紀錄，並拋回給聯盟網。
5
更新 2021/3/5
※「order_total」(訂單總金額) 和「revenue」(CPA 金額/分潤金額)可都提供或二選一，但如廠

商需以不同商品/類別做不同分潤計算，則分潤總金額需先計算後再帶入「revenue」標籤。當只
提供「revenue」參數時，聯盟網將以「revenue」參數判斷佣金總額。
(i) 使用以上案例，廠商將回報：（回報訂單總金額方式）
https://vbtrax.com/track/postback/conversions/8/global?order=586523&order_total=15
00&server_subid=b5fbb9a075d41be4a4853d80ed89d023&step=sale
(ii) 使用以上案例，廠商將回報：（回報佣金金額方式）
https://vbtrax.com/track/postback/conversions/8/global?order=586523&revenue=75&s
erver_subid=b5fbb9a075d41be4a4853d80ed89d023&step=sale
※ 聯盟網收到廠商端拋回的點擊編號後，系統會主動核對是否正確，如果正確，系統會回覆
「OK」；如果失敗，系統會回覆「FAILS」。
B) JavaScript
(步驟 1) - 安裝 JS 瀏覽碼
a. 確定使用 JavaScript 串接方式後請提供推廣頁/商城網址並向聯盟網申請網址追蹤編號 ( Site
ID )。聯盟網將提供 #### 編號。
b. 將以下語法貼到首頁/商品頁/商品類別頁/活動頁 HTML 裡的<head></head>中。
----------------------------------------------------------------------------------------------------------------------
(function () {
};
})();
</script>
----------------------------------------------------------------------------------------------------------------------
6
更新 2021/3/5
(步驟 2) - 安裝 JS 成交碼
2. 將以下語法貼到成效頁 HTML 裡的<body></body>中，並將訂單編號、訂單總金額（或
分潤金額）資料帶入。
----------------------------------------------------------------------------------------------------------------------
(function () {
conversion: true,
conversionData: {
step: 'sale', // conversion name
orderTotal: '置入訂單總金額', // order total
order: '置入訂單編號', // order number
},
};
})();
</script>
----------------------------------------------------------------------------------------------------------------------
order = [訂單編號] → 消費者的訂單編號
orderTotal= [購買總金額] → 訂單金額(扣除紅利、折扣…等) ; 僅限於數字，請勿包含貨幣、千位數符號。
revenue = [廣告佣金金額] →限用於不同商品/類別做不同分潤計算。如分潤比例全館一致，請勿使用此欄位，佣金
將由合約以平台設置為主。
※「order_total」(訂單總金額) 和「revenue」(CPA 金額/分潤金額)可都提供或二選一，但如廠

商需以不同商品/類別做不同分潤計算，則分潤總金額需先計算後再帶入「revenue」標籤。當只
提供「revenue」參數時，聯盟網將以「revenue」參數判斷佣金總額。
※※ 任何已點擊聯盟網廣告並且在合作 cookie 追蹤時間範圍內，JavaScript 成交碼都會成功記錄

產生訂單。如需排除其他 CPA 媒體來源，歡迎使用有條件式語法執行。成效將已最終點擊 (Last
Click) 計算。
7

2021聯盟網 CPA串接文件

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

2021聯盟網 CPA串接文件

Uploaded by

Copyright:

Available Formats

更新 2021/3/5

一、 CPL(Cost per Lead) 會員註冊或表單填寫

二、 CPS(Cost per Sale) 商品導購或完成交易

JavaScript 使用 Cookie 追蹤技術來記錄消費者到訪商城時間，與購買狀況。串接需埋入「瀏覽碼」與「成效碼」在

一、CPL(Cost per Lead) 會員註冊或表單填寫

A) 伺服器對接 S2S (Server to Server)

(ii) 透過聯盟網的廣告追蹤網址，將會帶入以下參數到廠商提供的終點網址 (以下範例)：

※ 如有名單編號或交易 ID 參數請帶入 adv_uniq_id=。

step: 'default', // conversion name

adv_uniq_id = [名單/交易編號] → 消費者的名單編號

※ 任何已點擊聯盟網廣告並且在合作 cookie 追蹤時間範圍內，JavaScript 成交碼都會成功記錄產

二、 CPS(Cost per Sale) 商品導購或完成交易

A) 伺服器對接 S2S (Server to Server)

(ii) 透過聯盟網的廣告追蹤網址，將會帶入以下參數到廠商提供的終點網址 (以下範例)：

order_total= [購買總金額] → 訂單金額(扣除紅利、折扣…等) ; 僅限於數字，請勿包含貨幣、千位數符號。

revenue = [廣告佣金金額] → 限用於不同商品/類別做不同分潤計算。如分潤比例全館一致，請勿使用此欄位，佣金

server_subid = [id2] 的參數由聯盟網自動帶入 URL 中，請廠商協助紀錄，並拋回給聯盟網。

※「order_total」(訂單總金額) 和「revenue」(CPA 金額/分潤金額)可都提供或二選一，但如廠

order = [訂單編號] → 消費者的訂單編號

orderTotal= [購買總金額] → 訂單金額(扣除紅利、折扣…等) ; 僅限於數字，請勿包含貨幣、千位數符號。

revenue = [廣告佣金金額] →限用於不同商品/類別做不同分潤計算。如分潤比例全館一致，請勿使用此欄位，佣金

※「order_total」(訂單總金額) 和「revenue」(CPA 金額/分潤金額)可都提供或二選一，但如廠

※※ 任何已點擊聯盟網廣告並且在合作 cookie 追蹤時間範圍內，JavaScript 成交碼都會成功記錄

You might also like