Advertising DSP巨集

最後更新： 2025年2月11日

建立對象：

  • 使用者

巨集是指令的簡短指令或簡稱，通常遵循格式${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}Cachebuster：介於1到1000000之間的隨機數字。長
${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)以來經過的秒數。長
${TM_VIDEO_DURATION}廣告視訊的持續時間（秒數）。整數

行動專用巨集

巨集替代說明型別
${CS_PLATFORM_ID}

(ComScore)對應到裝置作業系統的平台識別碼：

  • ios = Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • 當平台不是上述任何專案時other
varchar(50)
${CS_DEVICE_MODEL}(ComScore)裝置模型名稱，以URL編碼。字串
${CS_IMPLEMENTATION_TYPE}

(ComScore)提供廣告的環境：

  • a =行動應用程式
  • b =行動網站
字串（a或b）
${NS_PLATFORM_ID}

(Nielsen)對應到裝置作業系統的平台識別碼：

  • ios= Apple iOS
  • android = Google Android
  • windows = Windows Mobile
  • blackberry = Blackberry
  • 當平台不是上述任何專案時other
字串
${NS_DEVICE_GROUPING}

(Nielsen)廣告為檢視器的裝置型別：

  • TAB =平板電腦
  • PHN =行動
  • computer =電腦
字串
${UOO}

(Nielsen)使用者是否已選擇退出廣告追蹤：

  • 1 （DNT旗標= 1） =使用者已選擇退出廣告追蹤
  • 0 （DNT標幟= 0） =使用者已選擇加入廣告追蹤
整數（0或1）
${TM_BUNDLE}iOS或Android應用程式商店套件組合識別碼。 範例： com.zynga.wwf2.free或id804379658字串
gdpr=${GDPR_ENFORCED}&gdpr_consent=${GDPR_CONSENT}

gdpr=${GDPR_ENFORCED}指出出價者是否確定出價要求來自歐盟，且要求GDPR強制執行：

  • 1 =應強制執行GDPR
  • 0 =不應強制執行GDPR

gdpr_consent=${GDPR_CONSENT}是傳入競標要求中從供應合作夥伴傳遞的同意值：

  • 在大多數情況下，這是base64url編碼的同意字串，或daisybit （範例： BN5lERiOMYEdiAKAWXEND1HoSBE6CAFAApAMgBkIDIgM0AgOJxAnQA）
  • 0 =不同意
  • 1 =同意
Daisybit或整數