DIL 使用案例和程式碼範例

特定DIL使用案例的程式碼範例和說明。

使用DIL將資料元素傳送至Audience Manager

建立物件變數,將頁面元素的相關資訊傳送至Audience Manager。 這對於一般資料收集或是使用Analytics變數收集資料的替代方式非常有用。

說明

下列程式碼示範如何收集頁面資料,並使用DIL將它傳送至Audience Manager。 這些範例使用變數將資料元素保存在平面清單或陣列中。 請記住,將變數傳入為key-value對。 此外,請注意key-value對中鍵前的c_前置詞。 此必要前置詞將資訊標識為用戶定義的資料。 在第一個範例中,您需要手動將c_附加至索引鍵。 在第二個範例中,DIL會自動為您執行此動作。

讓值屬性保持一致

傳入資料時,請記得保持值屬性相同。 例如,如果您有兩個具有相同值的鍵,則最後一個鍵值對的值優先於前一個值對象。 例如,傳入color:bluecolor:red會將傳回的值設為紅色(覆寫藍色)。

範例1:以鍵值配對傳送資料

此基本範例會以索引鍵值配對的形式,將色彩和價格資料傳送至Audience Manager。 您的程式碼看起來可能類似下列:


var sample_dil = DIL.create({partner:"partner name"}); 
sample_dil.api.signals({ 
   c_color:"blue", 
   c_price:"900" 
}); 
sample_dil.api.submit();

範例2:在物件中傳送資料

此進階範例示範如何將物件中的資料傳送至Audience Manager。 使用此方法時,DIL可讓您將物件作為函式參數傳遞至signals()方法。 DIL 您的程式碼看起來可能類似下列:


var my_object = { 
   color : "blue", 
   price : "900" 
}; 
 
var sample_dil = DIL.create({ partner : "partner name" }); 
//Load the object and append "c_" to all keys in the key-value pairs and send data to AudienceManager. 
sample_dil.api.signals(my_object,"c_").submit();

範例3:在陣列中傳送頁面資料

在這種情況下,變數my_object使用陣列來保存資料。 此範例以上述建議方法傳入的資訊為基礎,但會新增額外的圖層以容納產品類型和型號。 您的程式碼看起來可能類似下列:


var my_objects = [{ 
   color : "blue", 
   price : "900" 
}, { 
   type : "acura", 
   model : "tl" 
}]; 
 
var sample_dil = DIL.create({ partner : "partner name" }); 
 
for (var i = 0; i < my_objects.length; i++) 
//Load the object and append "c_" to all the keys in the key-value pairs.  
{ 
    sample_dil.api.signals(my_objects[i], "c_"); 
} 
sample_dil.api.submit();

擷取反向連結URL

擷取反向連結URL並傳送至Audience Manager。

注意

此方法僅適用於使用者在使用類似通訊協定(HTTP與HTTPS)的頁面之間移動時。 例如,當您從安全網站導覽至其他安全網站時,瀏覽器會保留反向連結URL。 當您在安全與不安全的網站之間移動時,瀏覽器不會保留反向連結URL。 此行為是一般的瀏覽器功能,無法由DIL規避。

程式碼範例

您的程式碼看起來可能類似下列:


var adobe_dil = DIL.create({ partner : "partner name" }); 
adobe_dil.api.signals({ d_referer : document.referrer }).submit();

擷取搜尋引擎類型和關鍵字搜尋詞

傳送搜尋引擎類型和關鍵字搜尋的相關資訊至Audience Manager。

重要

本節說明最新版DIL不支援的舊版功能。

支援的搜尋引擎

依預設,DIL.getSearchReferrer會識別這些搜尋引擎的搜尋(包括國際變化):

  • AOL
  • Ask
  • Bing
  • Google
  • Yahoo!

說明

下列程式碼說明如何取得任何支援搜尋引擎的搜尋反向連結。 在此例中,假設有使用者從加拿大(Google)搜尋詞「homes」。 www.google.ca此程式碼將協助您擷取這些搜尋詞,並傳送至Audience Manager。

基本程式碼

用於取得搜尋反向連結的基本程式碼(例如google.com)如下所示:

var search_referrer = DIL.tools.getSearchReferrer();

列出的搜尋引擎代碼範例

在此案例中,假設使用者從Google加拿大(www.google.ca)搜尋詞「homes」。 請注意程式碼如何將所需的c_參數前置於搜尋引擎(c_se)和搜尋詞(c_st)。 c_ 是必 要的 前置修正,可將這些變數識別為Audience Manager的客戶定義變數。


var adobe_dil = DIL.create({partner:"partner name"}); 
var search_referrer = DIL.tools.getSearchReferrer(); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

未列出的搜尋引擎代碼範例

在此案例中,假設使用者從dogpile.com搜尋詞「homes」。 由於預設不支援Dogpile,因此您可以設定DIL來識別此搜尋引擎,並將搜尋詞傳回Audience Manager。 您的程式碼看起來可能類似下列:


var adobe_dil = DIL.create({partner:"partner name"}); 
var search_referrer = DIL.tools.getSearchReferrer(document.referrer, {  
    hostPattern:/dogpile\./, 
    queryParam:"q" 
}); 
 
if (search_referrer && search_referrer.valid) { 
  adobe_dil.api.signals({ 
    c_se : se.name, 
    c_st : se.keywords 
  }).submit(); 
}

將鍵值映射到其他鍵

將鍵值對的值關聯到另一個鍵。

說明

在鍵值對中,附加在鍵上的c_前置詞將信號標識為客戶定義資料。 客戶定義的資料用於定位在事件呼叫中傳入資料的特定網站。 不過,有時您會想要在Audience Manager帳戶的所有屬性中提供這項資訊。 若要這麼做,請將c_金鑰值配對中的值對應至平台層級金鑰。 平台層級金鑰的前置詞為d_,並讓該訊號可用於您帳戶中所有屬性的定位。

例如,您從特定網站收集郵遞區號資料,但想要將其定位至您的所有Audience Manager屬性。 若要在平台層級提供郵遞區號,您可以對應客戶定義的郵遞區號金鑰(例如c_zip)到平台定義的索引鍵,如下所示。

程式碼範例

您的程式碼看起來可能類似下列:

var adobe_dil = DIL.create({ 
    partner : "adobe", 
    mappings : { 
        c_zip : 'd_zip', 
        d_key2 : 'h_dil_key2' 
    } 
}); 
adobe_dil.api.signals({c_zip : '10010'}).submit(); 
// Request will look like /event?c_zip=10010&d_zip=10010

Google標籤管理器(GTM)中的流量DIL

使用GTM標籤設定並提供DIL。

此程式假設您有Google Tag Manager帳戶、該產品的一些工作知識,以及您的Audience Manager dil.js檔案。

要傳輸GTM中的dil.js檔案:

  1. 建立新容器或開啟現有容器。

  2. 新增標籤至容器。

  3. 開啟標籤以進行編輯,並:

    • 命名標籤。
    • 從​Tag Type​下拉式清單中選取​Custom HTML Tag
    • 在HTML欄位中,將DIL程式碼(程式庫+自訂程式碼)置於指令碼標籤<script>DIL code</script>中。
    • 按一下 Save.
  4. 發佈容器。

  5. 產生容器標籤代碼,並將其置於庫存中。

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now