adstage
追蹤串接設定

Daangn 廣告串接

在 adstage 中,你可以用追蹤連結衡量從 Daangn 廣告流入的點擊、安裝與事件,並依 daangn.ads 管道統計。把 adstage 追蹤連結放進 Daangn 廣告素材的到達網頁 URL,Daangn 就會在點擊發生的瞬間把廣告活動、廣告群組、素材 ID 與點擊 ID 填入連結後傳送。

1. 串接總覽

功能是否支援說明
點擊歸因支援把透過追蹤連結流入的點擊、安裝、事件依 daangn.ads 管道統計
轉換回傳支援把 adstage 衡量到的轉換回傳給 Daangn 廣告 OpenAPI(轉換追蹤代碼 + OpenAPI 金鑰)
費用蒐集支援透過 Daangn 廣告 OpenAPI 的成效查詢蒐集各廣告活動的每日費用(KST、KRW)

Daangn 自 2026 年起提供 Daangn 廣告 OpenAPI。廣告主在專家模式的線上諮詢中自行申領金鑰後,無需協商 MMP 登錄即可立即開啟費用蒐集與轉換回傳。OpenAPI 只能用於專家模式廣告帳戶,且 1 組金鑰對應 1 個廣告帳戶。

2. 建立追蹤連結

  1. 在 深層連結 > 建立 中選擇追蹤連結。

  2. 把廣告管道選為 Daangn Ads。

  3. 在廣告活動、廣告群組、廣告素材欄位中自行填寫名稱。Daangn 不提供名稱巨集,只提供 ID 巨集。即使名稱留空,ID 也一律會被記錄,但建議填成與 Daangn 廣告管理後台一致的名稱,便於在報表中識別。

  4. 如果是搜尋廣告,請在關鍵字欄位中填入 {{keyword}}。Daangn 會把它替換成使用者搜尋的關鍵字。非搜尋廣告請留空。

  5. 指定重新導向設定(App Store、應用程式、網頁)並儲存,然後複製產生的追蹤連結。

連結中包含下列巨集。無論是否填寫,點擊 ID 以及廣告活動、廣告群組、素材 ID 都會一律附帶。

adstage 參數Daangn 巨集值
click_id{{click_id}}Daangn 廣告點擊 ID(每次點擊都會核發,是歸因依據)
campaign_id{{campaign_id}}廣告活動 ID
ad_group_id{{adgroup_id}}廣告群組 ID
ad_creative_id{{material_id}}廣告素材 ID
term{{keyword}}搜尋關鍵字(僅搜尋廣告,且填寫了關鍵字欄位時)
campaign ad_group ad_creative無你自行填寫的名稱

範例:

https://adg.im/@{組織}/track/daangn.ads?short_path={連結路徑}&campaign=fall_promo&campaign_id={{campaign_id}}&ad_group_id={{adgroup_id}}&ad_creative_id={{material_id}}&click_id={{click_id}}

3. 把連結填進 Daangn 廣告

在 Daangn 廣告管理後台建立廣告素材時,把上面複製的追蹤連結填進 到達網頁 URL。廣告被點擊時,Daangn 會把連結中的 {{...}} 位置替換為實際值,然後導向該位址。

請注意

  • Daangn 不建議使用縮短 URL。請填入如上含有巨集的追蹤連結原文,而不是 adg.im/{連結路徑} 形式的短位址。
  • Daangn 的動態參數是以到達網站的廣告為準來說明的。以應用程式安裝為目標的廣告是否會被替換,請在投放前用測試點擊確認。如果報表中 campaign_id 等仍然是 {{campaign_id}},表示沒有被替換。

4. 申領 OpenAPI 金鑰

費用蒐集與轉換回傳都依靠一組 Daangn 廣告 OpenAPI 金鑰運作。金鑰由廣告主自行申請。

  1. 登入 Daangn Business 專家模式,點擊左側選單下方的 [客服中心] > [線上諮詢]。
  2. 在 [+ 提交諮詢] 中把諮詢類型選為 [廣告工具及轉換] > [申領 OpenAPI 金鑰]。
  3. 選擇要申領金鑰的**廣告帳戶(廣告主 ID)**並提交諮詢。
  4. 開啟隨即收到的金鑰確認連結並複製金鑰。

請注意

  • 金鑰確認連結在收到後 24 小時內只能開啟一次。開啟後請立即儲存到安全的地方。
  • 重新申領新金鑰會立即廢止原有金鑰。 如果重新申領過,也必須把 adstage 中填入的金鑰換成新金鑰。
  • OpenAPI 只能用於專家模式廣告帳戶。簡易模式帳戶無法申領金鑰。
  • 1 組金鑰只對應1 個廣告帳戶。如果經營多個帳戶,請為每個帳戶分別申領並登錄金鑰。

5. 開啟費用蒐集

在 串接 > 廣告管道串接 > Daangn Ads > 費用串接 標籤頁中點擊 新增帳戶,填入 OpenAPI 金鑰與廣告帳戶 ID。Daangn 要求每次 API 呼叫都帶上廣告帳戶 ID(X-ADVERTISER-ID),因此兩個值都填上才能完成串接(只傳送金鑰會被 Daangn 以 401 拒絕)。

adstage 先讀取廣告活動清單,再取得各廣告活動的每日成效(曝光、觸及、點擊、費用、安裝、轉換)。報表基準為 KST(Asia/Seoul)與 KRW。

6. 開啟轉換回傳

  1. 在 Daangn 專家模式的 廣告工具 > 轉換追蹤管理 中建立轉換追蹤代碼,並複製代碼 ID(kmctc)。
  2. 在 串接 > 廣告管道串接 > Daangn Ads > 轉換 API 標籤頁中儲存轉換追蹤代碼、OpenAPI 金鑰與廣告帳戶 ID。
  3. 如果要回傳應用程式轉換,還要填寫 應用程式 ID 欄位(Daangn 對應用程式轉換要求提供應用程式 ID)。
  4. 開啟切換開關後,adstage 衡量到的轉換就會回傳給 Daangn。

回傳的事件會對應到 Daangn 的 9 種轉換事件(安裝、造訪、註冊、登入、詳細頁瀏覽、加入購物車、潛在客戶蒐集、購買、服務申請)。預設對應中沒有的自訂事件不會回傳。page_view、screen_view 這類瀏覽型事件因呼叫量大而不在預設回傳範圍內。如果需要把造訪轉換(VIEW_PAGE)回傳給 Daangn,需要設定事件對應,請聯絡客戶支援。

安裝事件每台裝置只回傳一次。即使原生 SDK 在首次啟動時連續傳送 install 與 first_open,回傳給 Daangn 的安裝也只有 1 筆。

請注意

  • 只回傳歸因到 Daangn 的轉換(帶有 Daangn 點擊 ID kmckid,或管道為 daangn.ads 的事件)。
  • Daangn 要求 MMP 無論管道貢獻如何都回傳所有事件。adstage 不遵循這項要求,只回傳歸因到 Daangn 的轉換 —— 因為把從其他媒體進來的轉換也回傳,Daangn 就會把那部分成效算成自己的。因此 Daangn 廣告管理後台中看到的轉換數,可能少於 Daangn 自身的統計(Daangn 像素或已登錄的 MMP)。 兩個數字不一致是正常的,adstage 報表中的轉換才是 Daangn 實際貢獻的轉換。
  • 這與依連結設定的 媒體方回傳 是不同的功能。Daangn 的轉換回傳請在本標籤頁中開啟。
  • 如果你還把轉換追蹤代碼單獨登錄到了 Daangn 指定的 MMP(AppsFlyer、Airbridge、Adjust、Branch、Singular、Dfinery),請只使用其中一邊,以免同一轉換被統計兩次。

7. 蒐集到的資料

項目說明
管道名稱daangn.ads
歸因依據Daangn 廣告點擊 ID(click_id)
報表維度廣告活動、廣告群組、素材 ID,自行填寫的名稱,搜尋關鍵字

透過把管道名稱手動填為 daangn、karrot、당근 而建立的既有連結,新流入的資料同樣會依 daangn.ads 管道統計。

目錄