Campaign Manager 360 巨集

巨集簡介

什麼是 Campaign Manager 360 巨集？

Campaign Manager 360 巨集是簡短的指令，Campaign Manager 360 廣告伺服器會將這些指令展開為相對應的值，例如關鍵字、網站鍵名或網址。有些巨集可用來記錄報表資訊，有些巨集則決定放送的廣告為何，或是決定在使用者點按後，廣告重新導向的目標網頁。大多數巨集的長度只有幾個字元，很容易插入代碼中。

您可以將 Campaign Manager 360 巨集插入各種內容中，包括到達網頁網址、點擊追蹤程式代碼、重新導向網址、廣告素材的 HTML、頁框標頭或 Floodlight 代碼。巨集可能會在廣告放送時或其他事件 (例如 Floodlight 呼叫) 發生後展開，也可能會以動態方式 (透過使用者特定資訊引發) 展開，端視您所使用的巨集以及插入巨集的位置而定。

並非所有巨集都能在任何內容中運作。如果您將巨集插入至不支援的來源中，Campaign Manager 360 廣告伺服器可能會無法正確展開巨集。請參考下表，搭配正確的來源使用巨集。舉例來說，如果您將 %g 巨集插入到達網頁網址，Campaign Manager 360 廣告伺服器會展開巨集，但假如您將這個巨集插入點擊追蹤程式代碼，廣告伺服器就不會予以展開。

一般資訊

• Campaign Manager 360 巨集會區分大小寫。請一律以小寫格式輸入。舉例來說，%c 是有效巨集，而 %C 不是有效巨集。

• 您可視需要在巨集之間使用分隔字元，不過這並非必要。如要使用分隔字元，請使用逗號 (,) 或直立線符號 (|)。某些分隔字元只要用於錯誤的內容中，就會造成問題，因此除非您是經驗豐富的廣告投放專員，否則請避免使用其他分隔字元。

• 如要編輯供應商追蹤網址中的巨集，請使用事件代碼。基本程序如下：

  • 首先，在 Campaign Manager 360 中建立事件代碼，然後將供應商追蹤網址加入事件代碼中。供應商追蹤網址可以是點擊追蹤網址、曝光像素或問卷調查網址。您可以在 Campaign Manager 360 的事件代碼屬性中，輕鬆將巨集加入追蹤網址或是從中移除。

  • 備妥事件代碼後，請將其套用至廣告。當系統放送您的廣告時，便會使用事件代碼中的追蹤網址。您可以透過 Campaign Manager 360 輕鬆地將事件代碼一次套用至多個廣告。舉例來說，您可以將事件代碼設定為自動套用至廣告活動中的所有廣告。如要開始進行設定，請依照事件代碼指南中的步驟操作。

• 只有以下版本的展開巨集適用於 Floodlight 代碼：%ers!。瞭解詳情

巨集類型

%c：點擊字串巨集

%c 巨集會展開為廣告素材到達網頁網址中的 Campaign Manager 360 點擊字串。點擊字串是到達網頁網址的一部分，會將您的瀏覽器指向 Campaign Manager 360 廣告伺服器。

如要在自訂廣告素材中使用逸出版本的點擊字串，請使用 %c_esc 來取代 %c。Campaign Manager 360 點擊字串會使用連字號 (&)；如果您使用第三方伺服器，這可能會造成問題。

請注意，系統並不會藉由展開 %c 巨集納入自訂多媒體廣告素材的點擊事件代碼。

點擊字串的運作方式：當使用者點擊廣告素材後，瀏覽器會指向到達網頁網址。點擊字串會先將瀏覽器重新導向至 Campaign Manager 360 廣告伺服器，然後再傳送到廣告客戶的到達網頁。Campaign Manager 360 會在每次曝光時，自動將點擊字串加入到達網址中。

如要在自訂廣告素材的 HTML 中手動新增到達網頁網址，就必須加入 %c 巨集，確保點擊會重新導向至 Campaign Manager 360 廣告伺服器。此外，如果您想同時展開點擊字串和到達網頁網址，還可以一併加入 %u (到達網頁巨集)。%c%u 會展開為完整的到達網頁網址。

如何完成這種操作：以下是點擊字串的範例：

如要在自訂廣告素材的到達網頁網址中加入點擊字串，請將 %c 巨集插入廣告素材程式碼中到達網頁網址的開頭，如以下到達網址所示：

當廣告伺服器放送廣告素材時，%c 巨集會展開為點擊字串。以下範例顯示上述到達網頁網址在開頭的 %c 巨集展開後的樣式：

您會發現 %c 已展開為到達網頁網址開頭的點擊字串，形成完整的廣告素材網址。

如要一次插入完整的廣告素材網址，請將 %c 巨集 (點擊字串) 和 %u 巨集 (到達網頁網址) 合併如下：<a href="%c%u">。這兩個巨集會展開成完整的廣告素材網址。

舉例來說，假設您將 <a href="%c%u"> 插入 HTML 程式碼中，其展開後的可能樣式如下：

當 %u 展開為到達網頁網址時，到達網頁網址中的任何其他巨集也會自動展開，包括 %c 巨集。

%e - 展開巨集

%e 巨集會展開為廣告素材各種屬性的 ID。在巨集後面插入一個存取子，即可決定巨集要展開為哪個 ID，藉此決定要追蹤的廣告素材屬性。請參閱下方的存取子清單。

您可以利用對照表定義這些 ID，並為廣告素材屬性與 ID 建立關聯，ID 會連結至 Campaign Manager 360 中的說明 (以及您自己的後端資料庫)。您可使用這些 ID 透過 Campaign Manager 360 廣告伺服器追蹤各種廣告素材屬性。

「Floodlight 代碼」僅支援下列版本的展開巨集：%ers!，不支援其他種類的 %e 巨集。請注意，%ers! 適用於所有支援展開巨集的代碼 (請參閱上方表格)。

如果您在行動應用程式廣告空間中使用追蹤廣告，並採用靜態到達網頁，%e 巨集將無法正確展開。

到達網頁網址可包含的 %e 巨集數量沒有上限。以下到達網頁網址範例含有三個 %e 巨集：

%g - 地理區域資料巨集

%g 巨集可提供與廣告請求相關的地理區域資訊。這個巨集可用於動態反映標準、自訂和互動式多媒體廣告素材中的使用者位置。%g 巨集會展開為鍵/值字串，提供國家/地區縮寫、州/省縮寫、城市、郵遞區號、指定行銷區域 (Designated Market Area^®) 以及網際網路連線頻寬這類資訊，而這些資訊會透過 Campaign Manager 360 廣告伺服器傳回給您。

例如，如果使用者位於紐約市，%g 巨集可能會展開為下列字串：

ct=US&st=NY&ac=212&zp=10001&bw=4&dma=3&city=13275

%h - 廣告素材伺服器巨集

%h 巨集會展開為放送廣告素材的伺服器主機名稱，這樣就不必使用硬式編碼將主機名稱寫入代碼。廣告素材存放的主機名稱各有不同，而巨集會藉由動態形式展開每個廣告素材的主機名稱。

將 %h 巨集加到代碼的網址開頭，如以下圖片代碼所示，其中「123456」為廣告客戶 ID 預留位置：

%i - 曝光巨集

%i 巨集會展開為曝光字串。這種字串可讓 Campaign Manager 360 廣告伺服器在插頁式廣告曝光時追蹤曝光。

請將 %i 巨集加到代碼的網址開頭位置，如以下範例所示：

所有插頁式廣告都必須使用 %i 巨集，這樣一來，Campaign Manager 360 廣告伺服器就能在實際放送插頁式曝光時進行追蹤。

%k - 關鍵字巨集

%k 巨集會展開為廣告代碼中的子字串 (尤其是在要求網址中)。您可利用這個巨集在廣告素材中顯示使用者輸入的關鍵字。

這個巨集也適用於購買多個關鍵字的情況：它會根據使用者輸入的關鍵字，展開為相同廣告素材的多個關鍵字之一。舉例來說，看看 %k 巨集如何協助同時購買「car insurance」和「car loans」這兩個關鍵字的廣告客戶。當使用者搜尋「car insurance」時，內含這個巨集的廣告素材會顯示「Click Here for Car Insurance」；當使用者搜尋「car loans」時，同一個廣告素材卻會顯示「Click Here for Car Loans」。

利用鍵值組指定巨集要展開的子字串。鍵/值組合是由一個鍵 (start_key_string) 和一個對應值 (end_character) 所組成。

請按照以下順序插入巨集和鍵/值組合：巨集，接著是第一個值，然後是一個驚嘆號 (!)，最後是第二個值，格式如下：

%k 巨集會擷取這些參數指定的子字串。這個子字串會找出您指定的關鍵字，然後將巨集展開為該關鍵字。您可以將鍵/值組合插入 ad 或 jump Campaign Manager 360 代碼中。

%k 巨集的另一個用途是將逸出字元轉換成未逸出字元。當巨集將子字串傳送至廣告素材的 HTML 時，在已擷取的子字串中，所有逸出字元都會自動轉換回原始的字元集，例如：

如要在廣告素材中顯示「car insurance」，您必須將逸出字元「+」解碼，因此廣告客戶會將 %k 嵌入廣告素材的程式碼中。廣告伺服器會擷取子字串 kw=car+insurance、將 + 字元解碼，然後在廣告素材中將這個字串顯示為「car insurance」。

現在程式碼的樣式如下：

%k 和 %p 巨集的注意事項：這兩個巨集同樣會擷取由 start_key_string 指定的子字串，但傳送子字串的方式不同。%k 巨集會將子字串傳送至廣告素材的 HTML，%p 巨集則是將子字串傳送至網址。與 %p 巨集不同的是，%k 巨集只能在廣告素材的 HTML 程式碼中運作。

%m - 比對程式碼巨集

當使用者點擊廣告素材時，如果瀏覽器設定允許使用 Cookie，%m 巨集便會展開為使用者的 DoubleClick Cookie 值。這個巨集的用途之一，是產生一份使用者 ID 清單，然後重新指定先前曾回應廣告素材的使用者。使用者 ID 會透過廣告客戶 ID 加密金鑰進行加密。想進一步瞭解 Campaign Manager 360 帳戶中的使用者 ID 加密，請參閱這篇文章。

您可以將這個巨集插入到達網頁網址、重新導向網址、廣告素材程式碼，或是經過硬式編碼的點擊追蹤程式 (例如 ad.doubleclick.net/clk)。DoubleClick Cookie 值是一個 64 位元的整數，最長不超過 20 個半形字元。

%m 巨集必須位於跟在點擊事件後面的點擊字串中，廣告伺服器才會將其展開。位於廣告素材內時，廣告伺服器不會展開這個巨集。

• 如果使用者停用瀏覽器的 Cookie 或已選擇停用 Cookie，廣告伺服器會將 %m 展開為 0。
• 如果瀏覽器是透過 Proxy 進行存取，那麼 %m 巨集在廣告素材程式碼中就沒有作用。在這種情況下，廣告伺服器也會將 %m 展開為 0。

%n - 隨機編號巨集

%n 巨集會展開為隨機編號。隨機編號會阻止瀏覽器快取網址。廣告放送時，廣告伺服器會動態產生一個隨機編號，並將其附加到網址尾端取代 %n。由於每次放送廣告時，網址中都會有一個新的隨機編號，因此瀏覽器無法載入廣告的快取版本。只要讓快取失效，即可避免第三方伺服器漏算曝光次數。

當 Campaign Manager 360 必須將廣告素材重新導向至第三方時，通常發布商會使用 %n 巨集。第三方通常都有自己的隨機編號語法，類似於 Campaign Manager 360 的 ord=[random_number]?。

%n 巨集還可讓第三方得以追蹤點擊次數。由於每次的使用者點擊都會展開一個不重複的隨機編號取代 %n 巨集，因此第三方可以單獨追蹤每一次的點擊。廣告投放專員應與第三方確認，查明他們是否支援巨集展開的其他字元字串。

%p - 模式比對巨集

%p 巨集會展開成廣告代碼要求網址中的子字串。廣告放送時，這個巨集會展開為所指定開始字串與結束字元之間的任何值。

如何指定子字串：請使用鍵/值組合為您希望伺服器搜尋的子字串類型定義開頭和結尾。鍵/值組合是由兩個鍵/值組成：一個 start_key_string 值，和一個 end_character 值。

• [start_key_string]：這是鍵/值組合的鍵部分，必須加入廣告代碼中，這個值有大小寫之分，且不用加上預留位置的括號。

• [end_character]：這個字元用於代表鍵/值的結尾。在未標示結束字元的情況下，如果開始字串是代碼中的最後一個鍵/值，廣告伺服器就會複製整個字串。您可將每個值輸入為任何 ASCII 值的字串。但請注意，這個值的長度不得少於 2 個半形字元，且不用加上預留位置的括號。

基本格式如下：

%p 巨集的用途通常是展開為有助於追蹤報表資訊的關鍵字。舉例來說，假設您想擷取車款名稱，可以在廣告代碼中插入 %p 巨集和起始字串 (model=)，以及所選結尾字元 (在這個範例中為分號)。同樣請注意，不用加上預留位置的括號：

廣告放送時，Campaign Manager 360 會搜尋廣告代碼中的 model=，然後擷取 model= 與結束字元 (;) 之間的所有內容。

以下列舉 %p 巨集的部分常見用途：

• 廣告客戶可以將值或變數從 Floodlight 代碼傳入發布商代碼。

• 發佈商可以用動態方式將值傳送至到達網頁網址中。

%s - 網站鍵名巨集

視您將 %s 巨集新增至廣告代碼或 Floodlight 代碼而定，這個巨集展開的結果會有所不同。

• 代碼會展開為 Campaign Manager 360 網站鍵名：當使用者點擊 Campaign Manager 360 放送的廣告時，這個巨集會展開為放送廣告的網站鍵名。這個鍵名應與 Campaign Manager 360 中網站「屬性」分頁 (依序點選 [管理員] > [網站]) 所列出的鍵名相同。

  以這個網址為例，它的結尾處包含 %s 巨集：

  http://www.advertiser.com/cgi.bin/?%s

  假設這個網址包含在鍵名為 N255.010101.sandwiches 的網站所放送的廣告中，巨集會在使用者點按廣告時展開為 N255.010101.sandwiches：

  http://www.advertiser.com/cgi.bin/?N255.010101.sandwiches

  假如沒有即時的網站資訊，%s 可能會展開為空白字串。

• Floodlight 代碼會展開為 Campaign Manager 360 網站 ID：當網站上的 Floodlight 代碼開始執行時，%s 巨集會展開為網站的 ID。這是 Campaign Manager 360 用來識別網站的 ID。

%u - 到達網頁網址巨集

%u 巨集會展開為廣告素材的到達網頁網址。例如，<a href="%u"> 可能會展開為以下到達網頁網址：

如要一次插入完整的廣告素材網址，請將 %u 巨集與 %c 巨集合併。這兩個巨集會展開為完整網址：%c (點擊字串) + %u (到達網頁網址) = 完整的廣告素材網址。

舉例來說，假設您將 <a href="%c%u"> 插入 HTML 程式碼中，其展開後的可能樣式如下：

http://ad.doubleclick.net/click;361119;0-8388608;2;321977;1-468|60;0|0|0;;?http%3A%2F%2Fwww.doubleclick.com%2Fpath%2Fpage.html