Advertising DSP巨集

Last update: Fri May 10 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
DSP Ads

建立對象：

User

巨集是指令的簡短指令或簡稱，通常遵循格式 ${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)平台ID，對應至裝置的作業系統：

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)平台ID，對應至裝置的作業系統：

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 應用程式商店套件組合ID。範例： 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或整數

按一下協力廠商顯示廣告的巨集

若要使用協力廠商顯示標籤精確追蹤廣告點按次數，DSP需要顯示點按巨集。只需要一個巨集版本；相關的巨集視標籤型別而定。

巨集

替代說明

型別

${TM_CLICK_URL}

可讓廣告伺服器追蹤及計算平台中廣告點按次數的重新導向URL。

字串

${TM_CLICK_URL_URLENC}

此重新導向URL可讓需要URL編碼的廣告伺服器追蹤及計算平台中的廣告點按次數。

字串

當您符合下列條件時，DSP會自動在協力廠商顯示標籤中插入顯示點選巨集：

從廣告伺服器合作夥伴匯出廣告標籤
大量上傳 Flashtalking 或 Google DoubleClick for Advertisers 直接在DSP中新增標籤

如果您在建置顯示廣告時遺失按一下巨集，DSP會顯示警告訊息，提示您手動在標籤的正確區域中插入適當的顯示按一下巨集。

Analytics for Advertising 巨集

針對專用於下列專案的其他巨集 Analytics for Advertising 客戶，請參閱"附加 Analytics for Advertising 巨集至 Flashtalking 廣告標籤「和」附加 Analytics for Advertising 巨集至 Google Campaign Manager 360 廣告標籤.」

疑難排解巨集錯誤

將巨集新增至程式碼時，請確定您使用巨集的確切語法。驗證巨集時，DSP會檢查巨集是否與其中一個有效的巨集完全相符。

如果巨集名稱的開頭或結尾缺少字元，則會產生錯誤。例如，如果出現下列情況，則會顯示錯誤訊息：

您會忘記巨集名稱開頭的一或多個字元，例如 ${. 如果未包含完整語法，則無法將專案辨識為有效的巨集。
巨集的結尾不是有效的字元集，例如 }.

recommendation-more-help

9ff4800f-94be-45f0-a5bf-09d0d7e96baa