通知

請注意,客戶支援團隊不會以您目前的顯示語言提供疑難排解服務。如要與支援團隊人員聯絡,請先切換為英文或其他支援的語言 (西班牙文、葡萄牙文或日文)。

管理廣告代碼

刊登位置代碼

瞭解 Campaign Manager 360 代碼的運作方式,以及您可以下載哪些類型的刊登位置代碼。

展開所有部分 收合所有部分

運作方式

什麼是刊登位置代碼?

刊登位置代碼 (也稱為廣告代碼) 是一段程式碼,可在使用者造訪網站時呼叫廣告伺服器以取得廣告素材。只要使用者造訪的網站含有 Campaign Manager 360 刊登位置代碼,Campaign Manager 360 就會放送廣告。刊登位置代碼會指示使用者的瀏覽器發出廣告請求,而請求中通常會包含各項資訊,可讓 Campaign Manager 360 據此判斷要傳送的廣告類型。

Campaign Manager 360 會為廣告活動中的每個刊登位置產生專屬代碼。如果是支援多種尺寸的多媒體廣告素材,Campaign Manager 360 會為每種尺寸產生一個代碼。刊登位置代表網站上可顯示廣告的不同位置。廣告主或代理商通常會與發布商合作,決定代碼在網站上放置的位置,以及最適合的代碼類型。

基本流程如下:首先,廣告投放專員會設定廣告中的廣告素材。接著,廣告投放專員會透過 Campaign Manager 360 將廣告指派至刊登位置。完成 Campaign Manager 360 中的所有設定後,廣告投放專員便能產生代碼、加以測試,然後傳送給發布商。簡單來說,廣告投放專員先將廣告素材指派至廣告,再將廣告指派給刊登位置,之後就可以查看報表,瞭解廣告活動的成效。

如何在 Campaign Manager 360 中產生代碼

按一下廣告活動中的「代碼」,即可下載代碼或傳送通知給發布商 (如果需要審核付款)。

在 Campaign Manager 360 中,代碼工作流程可協助您選擇刊登位置、代碼類型,以及其他會決定代碼產生方式的代碼資訊。如要瞭解產生代碼的步驟,請參閱代碼產生指南。

注意事項

  • 代碼工作流程中有一個重要環節,就是您要將刊登位置設定為代理商付費或發布商付費。您無法直接下載發布商付費的刊登位置代碼,而必須透過 Campaign Manager 360 將代碼相關資訊提供給發布商。
  • 如果您整合了 IAB 資訊公開和同意聲明架構第 2.0 版,且資訊公開和同意聲明 (TC) 字串顯示 Google 沒有取得目的 1 的同意聲明,請將代碼中的 ad.doubleclick.net 替換成 pagead2.googlesyndication.com。這項規定適用於標準代碼、iframe/JavaScript 代碼 (不包括 ins 代碼)、預先擷取代碼 (包括影片)、追蹤廣告代碼和點擊追蹤程式代碼。進一步瞭解如何整合 IAB 資訊公開和同意聲明架構第 2.0 版

各素材資源所支援的代碼

無論廣告在何處放送,或您計劃觸及何種裝置,各廣告素材資源所支援的代碼都一樣。您可以透過這份表格確認您選擇的是正確的代碼。

  圖片素材資源* HTML5 素材資源 互動式多媒體 串流內
(影片和音訊)
VPAID 追蹤廣告素材
標準

僅限 1x1

不支援 不支援 不支援 不支援 不支援
iframe/JavaScript 支援 支援 支援 不支援 不支援 不支援
JavaScript 支援 支援 支援 不支援 不支援 不支援
預先擷取 不支援 不支援 不支援 支援 支援 不支援
內部重新導向 支援 支援 支援 不支援 不支援 不支援
點擊追蹤程式 不支援 不支援 不支援 不支援 不支援 不支援
追蹤廣告 不支援 不支援 不支援 不支援 不支援 支援

* 含有高密度圖片素材資源的刊登位置必須使用 ins 代碼,才能正確填入螢幕密度。

代碼與行動平台

行動裝置、行動網站或行動應用程式並沒有專用的代碼類型。

不過,您必須確定發布商能夠正確填入與行動廣告相關的 3 個參數 (尤其是必要的 dc_rdid 參數),才能啟用多項重要功能。詳情請參閱下方指南以及其他代碼說明。這些參數會出現在所有多媒體刊登位置中。

應用程式廣告空間專用的代碼參數

為使用多項重要功能,您必須在應用程式內放送的刊登位置代碼中加入額外參數,這些參數包括 dc_rdid=tag_for_child_directed_treatment=dc_lat=

由於任何多媒體刊登位置都可能會在應用程式內放送,因此系統會自動將這些參數全部加入所有多媒體刊登位置中。

請注意,如果刊登位置是由發佈商付費,您就必須先將刊登位置送交發佈商核准,才能進行下載。

必須確保發佈商能傳送相關值給這些參數的原因

沒有這些參數值,您的代碼就無法啟用 Floodlight 轉換追蹤、觸及率/展示頻率報表、展示頻率上限、廣告素材輪播或目標對象名單 (再行銷) 等功能。

參數定義

  • dc_rdid=:使用者可重設的裝置 ID,格式為 iOS 適用的廣告識別碼或 Android 適用的廣告 ID。此為必要參數。發佈商必須傳送一個值給這個參數,才能啟用應用程式內轉換追蹤功能。這個值必須為未經雜湊處理的原始值;系統只接受透過已啟用 SSL 的代碼安全傳送的值。

    注意:強烈建議您使用 dc_rdid 參數傳送裝置 ID,而不要使用舊版參數 dc_muid (這個參數可接受大寫的廣告識別碼、Android ID 和廣告 ID 的 MD5 雜湊值)。

    • SSAID 適用於中國境內的非 Google Play Android 裝置。

  • tag_for_child_directed_treatment=:接受的值為 0 或 1。如果這個值為 1,表示這項特定要求可能是由未滿 13 歲的使用者發出 (遵守 COPPA 規定)。

  • dc_lat=:接受的值為 0 或 1。如果這個值為 1,表示使用者已啟用 IDFA 或 AdID 的「限制廣告追蹤」選項,藉此停用按照興趣顯示的廣告和再行銷功能;如果這個值為 0,則表示「限制廣告追蹤」處於停用狀態。

代碼範例

以下提供幾個包含上述參數的代碼範例。這些參數都必須由發佈商填入,因此請確定發佈商同意傳送必要的值。

ins 代碼範例 (行動裝置環境的優先選項) 的開頭:

<ins class='dcmads'
 style='display:inline-block;width:320px;height:50px'
 data-dcm-placement='N9200.284657.MYSITE/B7841342.2'
 data-dcm-rendering-mode='script'
 data-dcm-click-tracker='${CLICK_URL}'
 data-dcm-limit-ad-tracking=0
 data-dcm-resettable-device-id='38400000-8cf0-11bd-b23e-10b96e4ddddd'
 data-dcm-child-directed=0>
 <script src='https://www.googletagservices.com/dcm/dcmads.js'></script>
</ins>

標準代碼範例 (用於圖片橫幅廣告):

<A HREF="https://ad.doubleclick.net/ddm/jump/N9200.284257.MYSITE/B7841142;sz=320x50;ord=[timestamp]?"> <IMG SRC="https://ad.doubleclick.net/ddm/ad/N9200.284257.MYSITE/B7841142;sz=320x50;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0?" BORDER=0 WIDTH=320 HEIGHT=50 ALT="Advertisement"></A>

JavaScript 代碼範例 (通常用於 HTML5 或互動式多媒體橫幅廣告) 的開頭:

<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/N9200.284657.MYSITE/B7841342.2;sz=320x50;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0?"> </SCRIPT>

預先擷取代碼範例 (用於串流內影片和音訊廣告):

VAST 2.0 預先擷取代碼

https://ad.doubleclick.net/ddm/pfadx/N9200.284657.MYSITE/B7841342.2;kw=[keyword];sz=widthxheight;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0;dcmt=text/xml;dc_sdk_apis=[APIFRAMEWORKS];dc_omid_p=[OMIDPARTNER]

VAST 3.0 預先擷取代碼

https://ad.doubleclick.net/ddm/pfadx/N9200.284657.MYSITE/B7841342.2;kw=[keyword];sz=widthxheight;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0;dcmt=text/xml;dc_sdk_apis=[APIFRAMEWORKS];dc_omid_p=[OMIDPARTNER];dc_vast=3

VAST 4.0 預先擷取代碼

https://ad.doubleclick.net/ddm/pfadx/N9200.284657.MYSITE/B7841342.2;kw=[keyword];sz=widthxheight;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0;dcmt=text/xml;dc_sdk_apis=[APIFRAMEWORKS];dc_omid_p=[OMIDPARTNER];dc_vast=4

曝光追蹤廣告圖片代碼範例:

<IMG SRC="https://ad.doubleclick.net/ddm/trackimp/N7480.169443360.MYSITE/B7967415.105398014;dc_trk_aid=278142637;dc_trk_cid=56651190;ord=[timestamp];dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0?" BORDER="0" HEIGHT="1" WIDTH="1" ALT="Advertisement">

點擊追蹤廣告代碼範例:

http://ad.doubleclick.net/ddm/trackclk/N7480.169443360.MYSITE/B7967415.105398014;dc_trk_aid=278142637;dc_trk_cid=56651190;dc_lat=0;dc_rdid=38400000-8cf0-11bd-b23e-10b96e4ddddd;tag_for_child_directed_treatment=0

支援的行動代碼

系統並沒有提供行動裝置、行動網站或行動應用程式專用的特殊刊登位置代碼類型,因此整體支援功能會有所不同。下方表格可協助您選擇正確的代碼。此外,您無法將裝置編號傳送至點擊追蹤程式的刊登位置代碼,因此請改用追蹤廣告。

行動網路相容性
  圖片 HTML5 互動式多媒體 串流內
(影片和
音訊)
VPAID 追蹤廣告素材
標準 僅限 1x1 不支援 不支援 不支援 不支援 不支援
iframe/JavaScript 支援 支援 支援 不支援 不支援 不支援
JavaScript 支援 支援 支援 不支援 不支援 不支援
預先擷取 不支援 不支援 不支援 支援 支援 不支援
內部重新導向 支援 支援 支援 不支援 不支援 不支援
點擊追蹤程式 不支援 不支援 不支援 不支援 不支援 不支援
追蹤廣告 不支援 不支援 不支援 不支援 不支援 支援
行動應用程式內相容性
  圖片 HTML5 互動式多媒體 串流內
(影片和
音訊)
VPAID 追蹤廣告素材
標準 僅限 1x1 不支援 不支援 不支援 不支援 不支援
iframe/JavaScript 不支援 不支援 不支援 不支援 不支援 不支援
JavaScript 支援 支援 支援 不支援 不支援 不支援
預先擷取 不支援 不支援 不支援 支援 支援 不支援
內部重新導向 支援 支援 支援 不支援 不支援 不支援
點擊追蹤程式 不支援 不支援 不支援 不支援 不支援 不支援
追蹤廣告 不支援 不支援 不支援 不支援 不支援 支援

標準代碼

標準代碼是一種刊登位置代碼,這種代碼只會針對尺寸為 1x1 的刊登位置放送廣告,並且使用一個錨定標記 (<A HREF>) 和一個圖片代碼 (<IMG SRC>)。

標準代碼範例
<A HREF="https://ad.doubleclick.net/ddm/jump/Nxxxx.site-keyname/Byyyyyyy.Pzzzz; sz=widthxheight;kw=[keyword];ord=[timestamp]?">

<IMG SRC="https://ad.doubleclick.net/ddm/ad/Nxxxx.site-keyname/Byyyyyyy.Pzzzz;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I?" BORDER=0 WIDTH=X HEIGHT=Y ALT="按這裡"></A>

無論何時,這些代碼都必須一起放送,順序為 A HREF 在前,IMG SRC 在後。

標準代碼的構成元素

A HREF這同時是 HTML 錨定標記和超連結參照代碼,能夠在使用者點擊圖片時,通知使用者的瀏覽器呼叫指定網址。

ad.doubleclick.netCampaign Manager 360 廣告伺服器的網址。

由於 IP 位址可能會變動,因此請確保網站使用的是代碼中的網址,而不是相對應的 IP 位址。

ddm這個新參數可用於區分 Campaign Manager 360 的代碼和舊產品 (DFA) 的代碼,但不會影響代碼的匯出或導入方式。

jump傳送給 Campaign Manager 360 廣告伺服器的指令,用於計算點擊次數。當使用者點擊圖片時,系統將動態替換實際的到達網址。

NxxxxCampaign Manager 360 帳戶 ID。

site-keyname網站的 ID (以網站的網址為依據)。

ByyyyCampaign Manager 360 廣告活動 ID。

.PzzzzCampaign Manager 360 刊登位置 ID。

sz=widthxheight刊登位置的尺寸,以像素為單位。Campaign Manager 360 廣告伺服器會根據這項資訊放送正確尺寸的廣告素材。如果是插頁式廣告刊登位置,則代碼中不會有 sz=

kw=[keyword]您可以使用 kw= 參數,將關鍵字傳送至 Campaign Manager 360 廣告伺服器。指定關鍵字功能一般是用於搜尋結果網頁中放送的廣告,而 kw= 屬性的值就是使用者的查詢。比方說,如果使用者搜尋「car」,代碼中的參數就會是 kw=car

網站可全權決定放送 Campaign Manager 360 刊登位置代碼的時機,並在代碼放送時插入適當的關鍵字。

ord=[timestamp]針對 ord= 參數,網站會負責在每次有使用者造訪時動態插入專屬字串 (不一定是時間戳記)。使用專屬代碼是為了防止網路瀏覽器向使用者放送快取廣告素材。

A HREFIMG SRC 代碼一起放送時,這兩個代碼的 ord= 參數值必須一樣。

IMG SRCHTML 圖片代碼。SRC 參數會告訴瀏覽器可在哪個地方找到要顯示的圖片。

ad將代碼歸類為標準代碼。

dc_lat=行動應用程式 dc_lat 鍵/值組合的鍵,用來指出使用者是否啟用了廣告識別碼或廣告 ID 的「限制廣告追蹤」選項,以停用個人化廣告和再行銷功能。

N這是 dc_lat 鍵/值組合的值。如果這個值為 1,表示使用者已啟用廣告識別碼或廣告 ID 的「限制廣告追蹤」選項。如果這個值為 0,則表示「限制廣告追蹤」處於停用狀態。

dc_rdid=行動應用程式 dc_rdid 鍵/值組合的鍵,用來傳送可重設的裝置 ID。該值是能夠由使用者重設的裝置 ID,格式可以是廣告識別碼 (iOS 適用) 或廣告 ID (Android 適用)。系統只接受透過已啟用 SSL 的代碼安全傳送的值,且必須由行動應用程式或廣告 SDK 在執行階段填入。

Czzzz這是 dc_rdid 鍵/值組合的值,並且是能夠由使用者重設的裝置 ID,格式可以是廣告識別碼 (iOS 適用) 或廣告 ID (Android 適用)。系統只接受透過已啟用 SSL 的代碼安全傳送的值,且必須由行動應用程式或廣告 SDK 在執行階段填入。

tag_for_child_directed_treatment=行動應用程式的鍵/值組合,用來指出特定要求是否可能由未滿 13 歲的使用者發出 (適用 COPPA 規定)。

I這是 tag_for_child_directed_treatment= 鍵/值組合的值。如果這個值為 1,表示這項特定要求可能是由未滿 13 歲的使用者發出 (適用 COPPA 規定)。

tfua=tfua= 鍵/值組合的鍵,用來指出特定要求是否可能是由未滿 16 歲的使用者發出 (具體年齡依國家/地區而異;適用歐盟地區的《一般資料保護規則》(GDPR) 規定)。

I這是 tag_for_underage_of_consent= 鍵/值組合的值。如果這個值為 1,表示這項特定要求可能是由未滿 16 歲的使用者提出 (具體年齡依國家/地區而異,適用歐盟地區的《一般資料保護規則》(GDPR) 規定)。

ltd=:由發布商設定。如果這個值為 1,表示使用者未同意使用 Cookie,因此曝光不會使用或建立 Cookie。此外,只能放送受限制的廣告

BORDER=0 WIDTH=X HEIGHT=Y設定顯示圖片的廣告版位尺寸,並指定圖片不加框線。

ALT="按這裡"ALT= 參數會設定在無法載入圖片時要顯示的文字。此外,使用者將滑鼠游標移到圖片上時會顯示這些文字,閱讀程式也會替視障的網路使用者讀出這些文字。根據預設,標準代碼的替代文字是「按這裡」,但廣告投放專員或發布商可以編輯這項內容。

代碼中可能出現的其他參數

無論代碼是放送至行動或非行動廣告空間,廣告代碼的樣式通常都相同。不過,您可能會看到一些額外參數 (前提是代碼安全無虞)。

dcapp=1

這個參數是用來在啟用多媒體相容性之前,先區別應用程式內刊登位置與網頁內刊登位置。不過,當您匯出舊版應用程式內刊登位置的代碼後,仍會看到這個參數。

dc_muid=

大寫的 IDFA、Android ID 或 AdID 的 MD5 雜湊值。進行雜湊處理前,請務必確認 ID 只包含大寫字母,這是因為 Campaign Manager 360 無法辨識小寫 ID 的 MD5 雜湊值。發布商必須負責將 MD5 雜湊函數套用至裝置 ID。

注意:我們強烈建議您使用 dc_rdid 傳送裝置 ID,而不要使用 dc_muid

dc_ref=

將這個參數加到刊登位置代碼中,可讓發布商在曝光放送時傳送確切網址。如果網頁版面配置非常複雜 (例如巢狀 iframe),發布商可能必須使用這個參數,以確保 Campaign Manager 360 能夠記錄發生曝光的主要網頁網址與 iframe 的位置。這樣一來,系統就能將這個參數所傳送的網址當做 Campaign Manager 360 驗證功能內的訊號使用。系統會自動將這個參數加到內部重新導向中,您也可以手動將它加到所有其他類型的刊登位置代碼中。

其他參數

在某些情況下,Campaign Manager 360 刊登位置代碼會包含本文未提及的參數 (可能是因為這些參數為特定 Campaign Manager 360 帳戶專用,或與不常使用的功能有關)。如果您對本文未提及的刊登位置代碼參數有任何疑問,請與支援團隊聯絡

iframe/JavaScript 代碼

iframe/JavaScript 廣告代碼是刊登位置最常用的廣告代碼類型,可放送標準圖片和互動式多媒體。開頭都是 IFRAME SRC=

瀏覽器支援

並非所有瀏覽器都能辨識 iframe HTML 元素,因此針對不同瀏覽器,這類代碼提供多種支援選項。

  • 如果瀏覽器無法辨識 iframe,系統會加入 JavaScript 代碼。

  • 如果瀏覽器無法辨識 iframe 和 JavaScript 代碼,系統也會加入一組標準代碼

根據 HTML 的標準,系統會忽略放在 <iframe></iframe> 代碼之間的代碼。因此在多數情況下,系統只會叫用 iframe 代碼。納入 JavaScript 和標準代碼是一種萬全之策,確保使用者即便使用舊版瀏覽器,也能看到廣告。

iframe 代碼範例
<IFRAME SRC="https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?" WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'>
<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;abr=!ie;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?">
</SCRIPT>
</IFRAME>
iframe/JavaScript 代碼的構成元素

以下說明 iframe/JavaScript 代碼中 iframe 代碼的構成元素。如需瞭解 JavaScript 代碼,請參閱 JavaScript 代碼一節。

以下說明 iframe/JavaScript 代碼範例的 iframe 部分:

<IFRAME SRC="https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?" WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'>

IFRAME SRC這個 HTML iframe (內嵌頁框) 代碼可讓 HTML 網頁嵌入另一個 HTML 網頁。SRC 參數會告訴瀏覽器可在哪個位置找到要載入 iframe 中的 HTML 網頁。

"https://ad.doubleclick.net/ddm/adi/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?":網址的參數與標準代碼中的參數大致相同,但有三項不同之處:

  • adi 參數會告訴 Campaign Manager 360 廣告伺服器該網址是 iframe 代碼的一部分。

  • abr=!ie 參數會指示 Campaign Manager 360 廣告伺服器不要向 Internet Explorer 瀏覽器放送 JavaScript 內容。

    按照 HTML 慣例,瀏覽器不得讀取 <iframe></iframe> 代碼之間的內容。因此,可辨識 iframe 的瀏覽器只能讀取 Campaign Manager 360 iframe 代碼,而無法讀取 JavaScript 代碼。不過,有些舊版 Internet Explorer 可同時讀取這兩種類型的代碼。abr=!ie 參數可確保在瀏覽器中,每組 Campaign Manager 360 刊登位置代碼都只會放送一個廣告。

    只有由 iframe/JavaScript 組合而成的代碼才會包含這個參數,不含 iframe 的 JavaScript 代碼則不會有此參數。
  • 廣告投放專員可以選擇納入 click= 參數。系統會利用這個參數將點擊重新導向至第三方網站,以便讓網站發布商能自行計算點擊次數。如要使用 click= 參數,發布商必須插入網址做為參數值。如果使用了 click= 參數,發布商就一定要同時在 iframe 和 JavaScript 代碼內使用它。另外,發布商必須把標準代碼重新導向至第三方網站。至於要採用哪種方法,將由他們自己決定。

    您用作 click= 參數值的網址必須是重新導向網址,而不是索取 1x1 像素圖片的請求。

WIDTH=X HEIGHT=Y MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'這些參數是用來設定 iframe 的尺寸和其他特性。根據預設,這些參數可以讓 iframe 與相關網頁緊密結合。

注意:部分廣告主可能會讓 iframe 或 JavaScript 代碼採用 ins 代碼。

JavaScript 代碼

JavaScript 代碼可用於放送圖片、HTML5 和互動式多媒體廣告素材。這種代碼適用於透過 iframe 設定複雜頁面配置的網站,或是不想使用 iframe 的發布商。

JavaScript 代碼中的參數與 iframe/JavaScript 代碼中 JavaScript 部分的參數大致相同,只是少了 abr=!ie 參數 (因為不需要排除任何瀏覽器類型)。

JavaScript 代碼的構成元素

為了讓您進一步瞭解 JavaScript 代碼,以下將逐一說明每個組成部分。

<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;dc_expa=URL;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?">

SCRIPT language='JavaScript1.1' SRC這個 HTML 指令碼代碼會指示瀏覽器將擷取自來源位置 (SRC) 的內容讀取為 JavaScript。

"https://ad.doubleclick.net/ddm/adj/Nxxxx.site-keyname/Byyyyyyy;sz=widthxheight;dc_expa=URL;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;kw=[keyword];click=?"網址的參數與標準代碼中的參數大致相同,但有三項不同之處:

  • adj 參數會告訴 Campaign Manager 360 廣告伺服器該網址是 JavaScript 代碼的一部分。

  • 廣告投放專員可以選擇納入 click= 參數。系統會利用這個參數將點擊重新導向至第三方網站,以便讓網站發布商能自行計算點擊次數。如要使用 click= 參數,發布商必須插入網址做為參數值。如果使用了 click= 參數,發布商就一定要同時在 iframe 和 JavaScript 代碼內使用它。另外,發布商必須把標準代碼重新導向至第三方網站。至於要採用哪種方法,將由他們自己決定。

  • 您可以為第三方手動新增 dc_expa= 參數,即時追蹤互動式多媒體展開式廣告素材的展開次數。發布商必須插入編碼過的網址做為參數值,這個網址會在廣告素材展開時接收回傳內容。

注意:部分廣告主可能會讓 iframe 或 JavaScript 代碼採用 ins 代碼。

預先擷取代碼

預先擷取代碼的用途是放送串流內音訊、音訊重新導向、串流內影片和串流內影片重新導向廣告素材。當預先擷取代碼提出廣告請求時,Campaign Manager 360 會先傳送廣告素材,然後在廣告素材載入後記錄該次曝光。Campaign Manager 360 會在主要音訊或影片素材資源已緩衝處理到一定程度,有足夠的內容可開始播放時才記錄曝光。代碼會在系統記錄曝光前「預先擷取」內容。Campaign Manager 360 支援 VAST 2.0、3.0 和 4.0,並提供這三種類型的預先擷取代碼。您可以選擇所需代碼,也可以將所有類型的代碼傳送給發布商。

預先擷取代碼範例

VAST 2.0 預先擷取代碼

https://ad.doubleclick.net/ddm/pfadx/Nxxxx.site-keyname/Byyyyyyy;kw=[keyword]; sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;dcmt=text/xml

VAST 3.0 預先擷取代碼

https://ad.doubleclick.net/ddm/pfadx/Nxxxx.site-keyname/Byyyyyyy;kw=[keyword]; sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;dcmt=text/xml;dc_vast=3

VAST 4.0 預先擷取代碼

https://ad.doubleclick.net/ddm/pfadx/Nxxxx.site-keyname/Byyyyyyy;kw=[keyword]; sz=widthxheight;ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;dcmt=text/xml;dc_vast=4

 

預先擷取代碼的構成元素

https://ad.doubleclick.net這些參數與標準代碼中的參數相同。

ddm這個新參數可用於區分 Campaign Manager 360 的代碼和舊產品 (DFA) 的代碼,但不會影響代碼的匯出或導入方式。

pfadx這個參數能讓廣告伺服器知道這是預先擷取 (pf) 代碼,並且是 XML 的廣告指令 (adx)。

Nxxxx.site-keyname/Byyyyyy;kw=[keyword];ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I這些參數與標準代碼中的參數相同。

sz=widthxheight刊登位置的尺寸,以像素為單位 (如果是 VAST 刊登位置,sz 參數的值一定會是 0x0)。

dcmt=text/xml:MIME 為 Multipurpose Internet Mail Extensions (多用途網際網路郵件擴展) 的縮寫,它能讓瀏覽器知道您正在傳送什麼類型的內容。在這種情況下,MIME 類型為 text/xml,也就是說您傳送的內容是以 XML 編碼格式編寫的文字。

dc_vast=3將代碼設成與 VAST 3.0 規格相容的格式。

dc_vast=4將代碼設成與 VAST 4.0 規格相容的格式。

dc_vpm這個參數必須由發布商填入,作用是在報表中啟用影片播放方法維度。

可能的值包括:

  • dc_vpm=0未指定
  • dc_vpm=1載入網頁時播放音效
  • dc_vpm=2載入網頁時音效預設為關閉
  • dc_vpm=3點擊時播放音效
  • dc_vpm=4滑鼠游標懸停時播放音效
  • dc_vpm=5進入可視區域時播放音效
  • dc_vpm=6進入可視區域時音效預設為關閉

dc_vconp:這個參數必須由發布商填入,作用是在報表中啟用影片連續播放維度。

可能的值包括:

  • dc_vconp=0未設定
  • dc_vconp=1連續
  • dc_vconp=2不連續

dc_sdk_apis=:發布商應將預留位置 [APIFRAMEWORKS] 替換成支援的 API 架構,格式為以半形逗號分隔的整數陣列,例如:dc_sdk_apis=1,2,3,4,5,6

可能的值包括:

  • dc_sdk_apis=1:VPAID 1.0
  • dc_sdk_apis=2:VPAID 2.0
  • dc_sdk_apis=3:MRAID 1.0
  • dc_sdk_apis=4:ORMMA
  • dc_sdk_apis=5:MRAID 2.0
  • dc_sdk_apis=6:MRAID 3.0
  • dc_sdk_apis=7:OMSDK JS API 1.0

dc_omid_p=:通過 IAB TechLab 認證的 OMID 整合應將預留位置 [OMIDPARTNER] 替換成其合作夥伴 ID,以及整合代碼的現行版本,格式為「合作夥伴 ID/版本」;例如:d_omid_p=Google/2.1。這個值會追蹤 OMID 整合代碼的認證狀態,並在報表中啟用 OMID 評估功能。

點擊追蹤程式代碼

「點擊追蹤程式」的用途是記錄以下項目的點擊次數:非由 Campaign Manager 360 放送的廣告素材、文字連結、電子郵件中的連結,或其他以硬式編碼方式寫入網站中的元素。

點擊追蹤程式代碼範例

以下是點擊追蹤程式代碼的範例。請注意,由於系統會自動清除點擊快取,因此不需要隨機號碼。

https://ad.doubleclick.net/ddm/clk/[ad ID];[placement ID];[verifier]?[landing page URL];ltd=[]
點擊追蹤程式代碼的構成元素

https://ad.doubleclick.net/這些參數與標準代碼中的參數相同。

clk讓 Campaign Manager 360 廣告伺服器知道這是點擊追蹤程式。

[ad ID];[placement ID]為這個點擊追蹤程式建立的廣告 ID,以及目標刊登位置的 ID。

[verifier]這是根據專屬演算法所建立的字元,會在內部用來驗證代碼是否未遭篡改。

dc_transparent:如果 dc_transparent=1,表示代碼會顯示網址重新導向鏈結。如果您針對刊登位置的追蹤廣告和點擊追蹤程式廣告使用靜態到達網頁網址,就會納入重新導向鏈結。進一步瞭解如何使用靜態到達網頁網址

?[landing page URL]使用者最終連往的網址。

只有靜態點擊追蹤程式才能納入到達網頁網址。動態點擊追蹤程式中沒有這個代碼的第二部分 (開頭為 ?)。當使用者點擊設有代碼的元素時,Campaign Manager 360 廣告伺服器會動態插入廣告投放專員在 Campaign Manager 360 中所指定的到達網頁網址。

ltd=:由發布商設定。如果這個值為 1,表示使用者未同意使用 Cookie,因此點擊追蹤程式不會使用或建立 Cookie,也不會啟用加強型歸因。如果 ltd=1,系統就不會在到達網頁網址尾端加上 DCLID 值,因而無法使用加強型歸因。

在中繼重新整理代碼內使用靜態點擊追蹤程式

中繼重新整理這個方法能指示網頁瀏覽器每隔一段時間就自動重新整理目前的網頁。如果您將時間間隔設為 0 秒,並把替代網址指定為最終到達網頁網址,就能把中繼重新整理當做網址重新導向使用。在某些情況下,我們會建議發布商將靜態點擊追蹤程式代碼嵌入中繼重新整理,做為到達網頁網址。舉例來說,發布商可以使用容易檢索或好記的網址做為文字連結,而不是包含 Campaign Manager 360 廣告伺服器呼叫的冗長網址。

如果點擊追蹤程式代碼是內嵌在網頁的 <meta> 代碼內,您必須把點擊追蹤程式代碼中的半形分號替換成對應的 ASCII 字元 (%3b),否則某些舊版瀏覽器會把半形分號解讀成 <meta> 代碼內的參數。

以下是 <meta> 代碼內的靜態點擊追蹤程式代碼範例,當中的半形分號已替換成對應的 ASCII 字元:

<html>
<head>
<meta http-equiv="refresh" content="0;https://ad.doubleclick.net/ clk%3b[ad ID]%3b[placement ID]%3b[verifier]?[landing page URL]">
</head>
</html>

注意:如果到達網址中含有半形分號,您也必須將它們替換成 %3b

內部重新導向代碼

您可以運用內部重新導向代碼,在採用 Google Ad Manager 的網站上放送 Campaign Manager 360 廣告。由於這類代碼是在 Campaign Manager 360 和 Ad Manager 系統內部進行處理,因此傳送內部重新導向給 Ad Manager 發布商有幾項好處,包括:

  • 縮短延遲時間:由於放送內部重新導向代碼時不需向其他伺服器提出請求,因此不會增加延遲時間。
  • 防止 Campaign Manager 360 與 Ad Manager 之間出現計數差異:內部重新導向代碼不需使用任何額外巨集即可追蹤點擊,並能夠將 Campaign Manager 360 與 Ad Manager 之間的點擊次數差異維持在 2% 以下。
  • 「驗證」工具提供了更豐富的網域資訊:內部重新導向代碼和 ins 代碼一樣,會在「驗證」工具中提供豐富的網域資訊,讓您深入瞭解廣告放送網域,同時進一步促進品牌安全及防堵垃圾內容。

內部重新導向代碼包含圖片網址到達網址;發布商必須負責在 Ad Manager 中輸入這兩項資訊。

這類代碼所使用的參數與標準代碼相同,但不包含以下這兩個參數:

  • keywords,原因是 Campaign Manager 360 會在內部處理指定關鍵字資訊。

  • ord=,原因是這些代碼已輸入至 Ad Manager 中,所以不需再處理瀏覽器快取。

針對圖片網址,您也可以手動新增 dc_expa= 參數,即時追蹤互動式多媒體展開式廣告素材的展開次數。發布商必須插入編碼過的網址做為參數值,這個網址會在廣告素材展開時接收回傳內容。

內部重新導向代碼範例

圖片網址 (這個代碼僅適用於 Google Ad Manager)

https://ad.doubleclick.net/ddm/ad/Nxxxx.site-keyname/Byyyyyyy.n;sz=widthxheight;dc_expa=URL

到達網址 (這個代碼僅適用於 Google Ad Manager)

https://ad.doubleclick.net/ddm/jump/Nxxxx.site-keyname/Byyyyyyy.n;sz=widthxheight

追蹤廣告代碼

在您的廣告代碼匯出檔案中,追蹤代碼會顯示為「追蹤廣告」部分,其中包含追蹤曝光與點擊的代碼網址。

如要在代碼匯出檔案中納入追蹤廣告代碼,請在廣告活動中開啟代碼工作流程 (「代碼」>「下載」),然後勾選左側的「納入追蹤廣告」核取方塊。如需詳細資訊,請參閱追蹤廣告指南

追蹤廣告提示
  • 下載代碼時,請勾選「納入追蹤廣告」

  • 如果您在刊登位置使用事件代碼,發布商必須導入用於追蹤曝光的 JavaScript 或 iframe 代碼網址。建議您同時傳送兩種類型,讓發布商決定要使用哪一個。兩種代碼分別加上了 impressions (JavaScript)impressions (iframe) 標籤。

  • 為確保代碼符合 Google Ads 的點擊追蹤規範,請在追蹤廣告中使用靜態到達網頁網址進行透明點擊追蹤。進一步瞭解如何使用靜態到達網頁網址

追蹤廣告代碼範例

以下是追蹤廣告的代碼格式範例。已指派的追蹤廣告素材會有不同的代碼版本。在代碼中,您會看到網站鍵值名稱、廣告素材/廣告/刊登位置編號,以及時間戳記的預留位置。

曝光 (圖片):

<IMG SRC="https://ad.doubleclick.net/ddm/trackimp/Nxxxx.site-keyname/Byyyyyyy.n;dc_trk_aid={ad_id};dc_trk_cid={creative_id};ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;
tfua=;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=;dc_tdv=1?"
attributionsrc BORDER="0" HEIGHT="1" WIDTH="1" ALT="Advertisement">

曝光 (iframe):

<IFRAME SRC="https://ad.doubleclick.net/ddm/trackimp/Nxxxx.site-keyname/Byyyyyyy.n;dc_trk_aid={ad_id};dc_trk_cid={creative_id};ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;
tfua=;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=;dc_tdv=1?"
WIDTH=1 HEIGHT=1 MARGINWIDTH=0 MARGINHEIGHT=0 HSPACE=0 VSPACE=0 FRAMEBORDER=0 SCROLLING=no BORDERCOLOR='#000000'></IFRAME>

曝光 (JavaScript):

<SCRIPT language='JavaScript1.1' SRC="https://ad.doubleclick.net/ddm/trackimp/Nxxxx.site-keyname/Byyyyyyy.n;dc_trk_aid={ad_id};dc_trk_cid={creative_id};ord=[timestamp];dc_lat=N;dc_rdid=Czzzz;tag_for_child_directed_treatment=I;
tfua=;gdpr=${GDPR};gdpr_consent=${GDPR_CONSENT_755};ltd=;dc_tdv=1?" attributionsrc></SCRIPT>

點擊:

https://ad.doubleclick.net/ddm/trackimp/Nxxxx.site-keyname/Byyyyyyy.n;dc_trk_aid={ad_id};dc_trk_cid={creative_id};dc_lat=N;dc_rdid=Czzzz;
tag_for_child_directed_treatment=I;tfua=;ltd=;dc_tdv=1

第三方廠商追蹤代碼:

<SCRIPT TYPE="application/javascript" SRC="https://pixel.adsafeprotected.com/xxxx/yyyy/111111/22222222/skeleton.js"></SCRIPT> <NOSCRIPT><IMG SRC="https://pixel.adsafeprotected.com/xxx/yy/333333/44444444/skeleton.gif" BORDER=0 WIDTH=1 HEIGHT=1 ALT=""></NOSCRIPT>

ins 代碼

ins 代碼是新形式的代碼,適用於 iframe 或 JavaScript,而且格式與其他代碼不一樣。這種代碼會在「驗證」工具中提供更豐富的網域資訊,讓您深入瞭解廣告放送網域。瞭解如何導入 ins 代碼

這對您有幫助嗎?

我們應如何改進呢?
true
2024 年隱私權完備性指南

採用能長期仰賴的評估設定流程,
因應不使用第三方 Cookie 的未來趨勢,並掌握善用 AI 的機會。
立即使用

搜尋
清除搜尋內容
關閉搜尋
主選單
9407169161614338047
true
搜尋說明中心
true
true
true
true
true
69192
false
false