宏是指令的簡稱或簡稱,通常遵循格式 ${MACRO_NAME}
. 創意程式碼或點進URL中包含的巨集,會展開為廣告伺服器可了解的較長程式碼字串。 DSP廣告伺服器會在提供或點按廣告時執行巨集。
廣告伺服器巨集對於將重要資訊傳遞至DSP或協力廠商廣告伺服器很實用。 巨集最常用於販運第三方和自訂創意程式碼或中繼資料(例如第三方像素)。
您可以在任何地方手動插入巨集,例如在VAST標籤、任何URL中,或在DSP或第三方事件像素中。 不過,每個DSP用戶端和合作夥伴都有不同的廣告標籤格式,因此巨集應插入標籤中的不同位置。 每次您與新用戶端或合作夥伴合作時,請向對方索取相關檔案,說明要在哪些位置插入巨集,而這些巨集會在其廣告標籤中DSP流量。
視需要使用所有廣告和標籤類型的一般追蹤巨集來傳回特定資料。
巨集 | 替換說明 | 類型 |
---|---|---|
${TM_ACCOUNT_ID} |
帳戶ID。 | 整數 |
${TM_AD_ID} |
廣告金鑰(adKey)。 | 字串 |
${TM_AD_ID_NUM} |
廣告ID。 | 整數 |
${TM_ADVERTISER_ID} |
廣告商ID。 | 整數 |
${TM_CAMPAIGN_ID} |
促銷活動金鑰。 | 字串 |
${TM_CAMPAIGN_ID_NUM} |
促銷活動ID。 | 整數 |
${TM_CLICK_URL} |
重新導向URL,可讓廣告伺服器追蹤及計算廣告點按次數。 提供廣告時,如果使用者點按廣告,則會啟動巨集,並記錄點按並計入以用於報表用途。 | 字串 |
${TM_CLICK_URL_URLENC} |
編碼的重新導向URL,可讓廣告伺服器追蹤及計算廣告點按。 提供廣告時,如果使用者點按廣告,則會啟動巨集,並記錄點按並計入以用於報表用途。 除非您要建立協力廠商廣告,且您的廠商需要URL編碼,否則請勿使用此巨集。 | 字串 |
${TM_FEED_ID} |
媒體放置的索引鍵(feedKey)。 | 字串 |
${TM_FEED_ID_NUM} |
媒體投放的ID。 | 整數 |
${TM_MACRO_PLACEMENT_SITE_KEY |
版位的網站索引鍵。 需要 AppsFlyer 按一下行動應用程式安裝廣告的追蹤器。 | 字串 |
${TM_PLACEMENT_ID} |
位置鍵(cpKey)。 | 字串 |
${TM_PLACEMENT_ID_NUM} |
版位ID。 | 整數 |
${TM_RANDOM} |
快捷人:1到1000000之間的隨機數。 | long |
${TM_SESSION_ID} |
工作階段的ID,與廣告標籤的單一擷取相對應。 | 字串 |
${TM_SITE_DOMAIN_URLENC} |
從競標請求中的URL剖析的頁面子網域;URL編碼。 橫幅廣告中不支援點按播放廣告。 | 字串 |
${TM_SITE_NAME} |
版位的網站名稱。 | 字串 |
${TM_SITE_URL_URLENC} |
競標請求中傳遞的URL;URL編碼。 橫幅廣告中不支援點按播放廣告。 | 字串 |
${TM_SITE_ID_NUM} |
版位的網站ID。 | 整數 |
${TM_TIMESTAMP} |
Unix時間戳記,指出自1970年1月1日午夜(00:00 UTC)以來經過的秒數。 | long |
${TM_VIDEO_DURATION} |
廣告視訊的持續時間(以秒為單位)。 | 整數 |
巨集 | 替換說明 | 類型 |
---|---|---|
${CS_PLATFORM_ID} |
(ComScore)平台ID,此ID對應至裝置的作業系統:
|
varchar(50) |
${CS_DEVICE_MODEL} |
(ComScore)裝置型號名稱,以URL編碼。 | 字串 |
${CS_IMPLEMENTATION_TYPE} |
(ComScore)提供廣告的環境:
|
字串(a 或 b ) |
${NS_PLATFORM_ID} |
(Nielsen)平台ID,此ID對應至裝置的作業系統:
|
字串 |
${NS_DEVICE_GROUPING} |
(Nielsen)廣告檢視器所在的裝置類型:
|
字串 |
${UOO} |
(Nielsen)使用者是否已選擇退出廣告追蹤:
|
整數(0 或 1 ) |
${TM_BUNDLE} |
此 iOS 或 Android 應用程式商店套件ID。 範例:com.zynga.wwf2.free或id804379658 | 字串 |
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT} |
gdpr=${GDPR_ENFORCED} 指出競標者是否判定競標請求來自歐盟來源且需要GDPR強制執行:
gdpr_consent=${GDPR_CONSENT} 是傳入競標請求中從供應合作夥伴傳遞的同意值:
|
daisybit或整數 |
為了使用第三方顯示標籤準確追蹤廣告的點按次數,DSP需要顯示點按巨集。 只需要一個宏版本;相關巨集取決於標籤的類型。
巨集 | 替換說明 | 類型 |
---|---|---|
${TM_CLICK_URL} |
可讓廣告伺服器追蹤及計算平台中廣告點按次數的重新導向URL。 | 字串 |
${TM_CLICK_URL_URLENC} |
重新導向URL,可讓需要URL編碼的廣告伺服器追蹤及計算平台中的廣告點按次數。 | 字串 |
當您執行下列動作時,DSP會自動在協力廠商顯示標籤中插入顯示點按巨集:
如果您在建立顯示廣告時遺失點按巨集,DSP會顯示警告訊息,提示您在標籤的正確區域手動插入適當的顯示點按巨集。
將巨集新增至程式碼時,請務必使用巨集的確切語法。 驗證巨集時,DSP會檢查該巨集是否與其中一個有效巨集完全相符。
如果宏名稱的開頭或結尾缺少字元,則會產生錯誤。 例如,若出現下列情況,您會看到錯誤訊息:
${
. 如果您未包含完整語法,則無法將該項目辨識為有效的巨集。}
.