ins 代碼適用於採用 iframe/JavaScript 或 JavaScript 代碼的廣告,可提高驗證和報表資料的實用性。使用 ins 代碼有幾項好處:
- 對廣告客戶來說:這種代碼可透過「驗證」頁面提供更豐富的網域資訊,讓您深入瞭解廣告放送所在位置,同時能更有效地促進品牌安全及防堵垃圾內容。
- 對發布商來說:不需在這種代碼中加入快取破壞 (ord=),因此代碼導入作業更加簡便。
本文討論的主題
關於 ins 代碼
-
支援的廣告:任何採用 iframe/JavaScript 或 JavaScript 代碼的廣告均可使用 ins 代碼。Campaign Manager 360 只會針對在支援的刊登位置上放送的廣告產生 ins 代碼,因此您不必擔心自己的刊登位置是否屬於支援的類型。
-
代碼格式:ins 代碼使用 HTML 屬性,而非網址參數。當廣告代碼在您的網站上執行時,HTML 屬性會變更為廣告代碼中對應的參數,然後傳回要求的內容。
-
瀏覽器支援:如果顯示模式設定為 iframe,則瀏覽器必須同時支援 iframe 和 JavaScript 兩者,才能載入廣告。如果顯示模式設定為 JavaScript,則瀏覽器只須支援 JavaScript 即可。瀏覽器「必須」支援 JavaScript 才能使用 ins 代碼,因為這類代碼沒有 noscript 部分。
代碼的開頭會顯示 <ins
,其餘部分則會包含 class='dcmads'
。
以下提供的簡易代碼範例含有三項屬性:一項用於刊登位置 (data-dcm-placement
),一項用於自訂鍵/值參數 (data-dcm-param-custom_key
),一項用於顯示模式 (data-dcm-rendering-mode
)。
<ins class='dcmads'
style='display:inline-block;width:300px;height:250px'
data-dcm-placement='N7480.1664088DOUBLECLICK.NETTEST/B8299600.114131924'
data-dcm-param-custom_key='custom_value'
data-dcm-rendering-mode='iframe'>
<script src='https://www.googletagservices.com/dcm/dcmads.js'></script>
</ins>
如要瞭解產生代碼的步驟,請參閱代碼產生指南。
如何編輯 ins 代碼
如要在代碼中使用廣告參數,請以 HTML 屬性的形式在代碼的 HTML 程式碼中輸入所需參數。
-
在下方表格中找出所需的資料屬性。請注意,您無法加入快取破壞參數 (
ord=
)。代碼會自動新增隨機數值。 -
新增您需要的各項 HTML 屬性,每項獨立一行,以便在廣告代碼中找出及編輯這些屬性。請勿新增廣告參數,您只能新增 HTML 屬性。
使用 ins 代碼的優點之一即是您不需要加入快取破壞參數,這種代碼會自動加入快取破壞參數。
-
當代碼在您的網站上執行時,HTML 屬性會變更為對應的參數,然後傳回要求的內容。
資料屬性表
ins 代碼使用 HTML 資料屬性。在您的瀏覽器中,這些屬性會變更為對應的廣告參數。
HTML 屬性 | 變更為這個廣告請求參數 | 目的 |
---|---|---|
data-dcm-rendering-mode |
command | 為廣告代碼指定 adi 或 adj,表示該廣告代碼是 iframe 廣告代碼或 JavaScript 廣告代碼。顯示模式為「iframe」或「script」兩者之一。 |
data-dcm-refresh-count |
rc | 允許發布商提出聲明,表示目前的代碼是以原有廣告版位「重新整理」的形式載入 (即取代其他廣告)。這個值應為此廣告版位先前載入廣告的次數 (不用將初始載入指定為「0」)。假如載入屬於重新整理,但實際次數不明,那麼您可以使用「1」這個值。 |
data-dcm-placement |
placement | 使用字串指定 Campaign Manager 360 刊登位置。 |
data-dcm-click-tracker |
click | 第三方點擊追蹤程式網址。將點擊重新導向至第三方網站以便進行追蹤。 |
data-dcm-landing-page-escapes |
N in clickN | 到達網頁附加到第三方點擊追蹤程式之前,所逸出的次數。 |
data-dcm-interstitial |
dcopt=1_ist | 指定插頁式廣告。 |
data-dcm-impression-exchange-id |
pc | IAB 曝光交換機制 ID。 |
data-dcm-keywords |
kw | 用於指定目標的關鍵字,以逗號分隔。 |
data-dcm-dart-iframe-path |
mtfIFPath | 僅限互動式多媒體廣告素材:前往發布商提供的 DARTIframe.html 的路徑。 |
data-dcm-disable-iframe-breakout |
mtfIFrameRequest=false | 僅限互動式多媒體廣告素材:確保互動式多媒體內容的尺寸超出 iframe 尺寸時,互動式多媒體內容不會嘗試拆分 iframe。 |
data-dcm-top-float |
mtfTop | 僅限互動式多媒體廣告素材:從網頁頂端或檢視區域到插頁式互動式多媒體廣告素材顯示位置之間的距離 (以像素為單位)。 |
data-dcm-left-float |
mtfLeft | 僅限互動式多媒體廣告素材:從網頁左側或檢視區域到插頁式互動式多媒體廣告素材顯示位置之間的距離 (以像素為單位)。 |
data-dcm-multi-bottom-float |
mtfBottomFloat | 僅限互動式多媒體廣告素材:以逗號分隔的兩個數字。第一個數字代表互動式多媒體多點浮動插頁式廣告素材與網頁頂端之間的距離,第二個數字則代表互動式多媒體多點浮動插頁式廣告素材與網頁左側之間的距離,以像素、百分比或距離中心的像素 (pxc) 為單位。 |
data-dcm-multi-left-float |
mtfLeftFloat | 僅限互動式多媒體廣告素材:以逗號分隔的兩個數字。第一個數字代表互動式多媒體多點浮動插頁式廣告素材與網頁頂端之間的距離,第二個數字則代表互動式多媒體多點浮動插頁式廣告素材與網頁左側之間的距離,以像素、百分比或距離中心的像素 (pxc) 為單位。 |
data-dcm-multi-right-float |
mtfRightFloat | 僅限互動式多媒體廣告素材:以逗號分隔的兩個數字。第一個數字代表互動式多媒體多點浮動插頁式廣告素材與網頁頂端之間的距離,第二個數字則代表互動式多媒體多點浮動插頁式廣告素材與網頁左側之間的距離,以像素、百分比或距離中心的像素 (pxc) 為單位。 |
data-dcm-multi-top-float |
mtfTopFloat | 僅限互動式多媒體廣告素材:以逗號分隔的兩個數字。第一個數字代表互動式多媒體多點浮動插頁式廣告素材與網頁頂端之間的距離,第二個數字則代表互動式多媒體多點浮動插頁式廣告素材與網頁左側之間的距離,以像素、百分比或距離中心的像素 (pxc) 為單位。 |
data-dcm-param-dc_expa |
dc_expa | 僅限互動式多媒體廣告素材:即時追蹤可展開式互動式多媒體廣告素材的展開次數。發布商必須插入未逸出的網址,這個網址會在廣告素材展開時接收回傳內容。 |
data-dcm-param-[KEY] |
KEY | 可填入您在「其他鍵值」設定中為刊登位置所輸入的參數。您在此使用的所有參數均不得包含半形分號或大寫字母。 |
data-dcm-child-directed |
tag_for_child_directed_treatment | 接受的值為 0 或 1。如果這個值為 1,表示這項特定要求可能是由未滿 13 歲的使用者發出 (遵守 COPPA 規定)。 |
data-dcm-underage |
tfua | 接受的值為 0 或 1。如果這個值為 1,表示這項特定要求可能是由未滿 16 歲的使用者發出 (具體年齡依國家/地區不同),須遵守歐盟地區的《一般資料保護規則》(GDPR) 規定。 |
data-dcm-limit-ad-tracking |
dc_lat | 接受的值為 0 或 1。如果這個值為 1,表示使用者已啟用廣告識別碼或廣告 ID 的「限制廣告追蹤」選項,藉此停用個人化廣告和再行銷功能;如果這個值為 0,則表示「限制廣告追蹤」處於停用狀態。 |
data-dcm-limited-ads |
ltd | 由發布商設定;如果這個值為 1,表示使用者未同意使用 Cookie,因此曝光不會使用或建立 Cookie。此外,只能放送受限制的廣告。 |
data-dcm-resettable-device-id |
dc_rdid | 使用者可重設裝置識別碼,格式為 iOS 適用的廣告識別碼或 Android 適用的廣告 ID (AdID)。發布商必須傳送一個值給這個參數,才能啟用應用程式內轉換追蹤功能。這個值必須為未經雜湊處理的原始值;系統只接受透過已啟用 SSL 的代碼安全傳送的值。 |
data-dcm-external-id |
dc_xid | 外部不重複識別碼。發布商必須在設定行動回傳時傳送這個值。此外,這也是在回傳中傳回的參數值,用來表示轉換。 |
data-dcm-app-id |
dc_msid | 某個應用程式的 Google Play 商店或 iOS App Store ID。發布商必須傳送這個值,才能啟用應用程式和應用程式 ID 報表維度。 |
data-dcm-publisher-url |
dc_ref | 允許發布商在曝光放送時傳送確切網址。瞭解詳情 |
data-dcm-ssaid |
pdid 和 pdidtype | 適用於中國境內非 Google Play Android 裝置上的曝光、點擊和轉換追蹤。瞭解詳情 |
data-dcm-api-frameworks |
dc_sdk_apis | 發布商支援的 API 架構 ID 逗號分隔清單 (例如 支援 VPAID 2.0 和 OMID 1.0 的 ID 為「2,7」)。這類 ID 來自 AdCOM 規格 1.0。 |
data-dcm-omid-partner |
dc_omid_p | 發布商的開放評估 SDK 整合 ID,格式應為「合作夥伴名稱/合作夥伴版本」。系統必須使用這個 ID 顯示及驗證開放評估 SDK 整合的憑證狀態。 |
沒有對應 sz 的 HTML 屬性。系統會從 ins 代碼樣式中的寬度和高度屬性取得尺寸資訊。 |
sz | 刊登位置的尺寸 (寬 x 高)。Campaign Manager 360 會自動加入這項資訊。 |
沒有對應 ord 的 HTML 屬性。Campaign Manager 360 會自動加入快取清除數值,因此不需要這項屬性。 |
ord | 允許系統透過隨機數值清除快取。Campaign Manager 360 會自動加入隨機數值,因此您不需要新增任何 HTML 屬性。請勿在代碼中加入 ord 值。 |
巨集和 ins 代碼
您可將巨集插入與對應廣告參數相符的 ins 代碼屬性中。由於 ins 代碼會執行快取清除作業,因此這種代碼不會搭配快取破壞或時間戳記巨集一起使用。
以下範例代碼內含點擊追蹤巨集:
<ins class='dcmads'
style='display:inline-block;width:300px;height:250px'
data-dcm-placement='N7480.1664088DOUBLECLICK.NETTEST/B8299600.114131924'
data-dcm-rendering-mode='script'
data-dcm-click-tracker='${CLICK_URL}'>
<script src='https://www.googletagservices.com/dcm/dcmads.js'></script>
</ins>
資訊公開和同意聲明架構巨集
IAB 資訊公開和同意聲明架構第 2.0 版支援在廣告素材代碼中使用巨集,藉此指明資訊公開和同意聲明 (TC) 字串應該在網址中插入的位置、這類字串的傳送目標,以及用於辨識有哪些供應商。廣告客戶如果想整合 IAB 資訊公開和同意聲明架構第 2.0 版,就必須與他們的像素供應商合作,確保供應商正確支援下表中的巨集。瞭解詳情
巨集 | 說明 |
---|---|
|
0 = 非 GDPR 地區的流量,1 = GDPR 地區的流量。 |
${GDPR_CONSENT_xxxxx} |
xxxxx 是供應商的數字 ID。這裡的供應商是指在出價要求中收到資訊公開和同意聲明 (TC) 字串的供應商。 |
${ADDTL_CONSENT} |
這裡的 ADDTL_CONSENT 是一份以點分隔的清單,當中列有已取得使用者同意的 Google 廣告技術供應商 (ATP) ID。 |