DIL 使用案例和程式碼範例

上次更新: 2023-08-02
警告

自2023年7月起,Adobe已停止開發 Data Integration Library (DIL) 和 DIL 副檔名。

現有客戶可繼續使用其 DIL 實作。 不過,Adobe將不會開發 DIL 超出此點。 建議客戶評估 Experience PlatformWeb SDK 長期資料收集策略的影響。

如果客戶希望在2023年7月之後實作新的資料收集整合,則應使用 Experience PlatformWeb SDK 而非。

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

傳送資料元素以DIL進行Audience Manager

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

說明

下列程式碼會示範如何收集頁面資料,並將其傳送給Audience Manager,使用 DIL. 這些範例使用變數將資料元素儲存在平面清單或陣列中。 請記住,傳入變數為 機碼值組. 此外,請留意 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 加拿大( www.google.ca)。 此程式碼可協助您擷取這些搜尋辭彙,並將其傳送給Audience Manager。

基本程式碼

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

var search_referrer = DIL.tools.getSearchReferrer();

列出的搜尋引擎程式碼範例

在此案例中,假設使用者搜尋以下辭彙「homes」: Google 加拿大( www.google.ca)。 請注意程式碼如何加上必要字首 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();
}

未列出的搜尋引擎程式碼範例

在此案例中,假設使用者搜尋以下辭彙「homes」: dogpile.com. 因為 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 Tag Manager (GTM)中的流量DIL

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

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

若要流量 dil.js GTM中的檔案:

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

  2. 將新標籤新增至容器。

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

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

  5. 產生貨櫃標籤代碼,並放置在詳細目錄上。

此頁面上的