DIL使用案例和程式碼範例 dil-use-cases-and-code-samples

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

傳送資料元素以DIL進行Audience Manager send-data-elements-dil

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

說明

下列程式碼示範如何收集頁面資料，並透過DIL傳送給Audience Manager。 這些範例使用變數將資料元素儲存在平面清單或陣列中。 請記住，傳入變數做為機碼值組。 此外，請記下機碼值組中機碼的前置詞c_。 此必要的字首會將資訊識別為使用者定義的資料。 在第一個範例中，您需要手動將c_附加至機碼。 在第二個範例中，DIL會自動為您執行此動作。

保持值屬性一致

傳入資料時，請記得保持值屬性相同。 例如，如果您有兩個值不同的相同索引鍵，則最後一個索引鍵 — 值組的值會優先於前面的值物件。 例如，傳入color:blue和color: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 capture-referring-url

擷取轉介URL並傳送給Audience Manager。

程式碼範例

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

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

擷取搜尋引擎型別和關鍵字搜尋詞 capture-search-engine-types

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

支援的搜尋引擎

根據預設，DIL.getSearchReferrer會辨識來自這些搜尋引擎的搜尋（包括國際變數）：

說明

下列程式碼會示範如何取得任何受支援搜尋引擎的搜尋反向連結。 在此案例中，假設使用者從Google加拿大( www.google.ca)搜尋「本位目錄」一詞。 此程式碼可協助您擷取這些搜尋辭彙，並將其傳送給Audience Manager。

基本代碼

用於取得搜尋反向連結的基本程式碼（例如，從google.com）如下所示：

var search_referrer = DIL.tools.getSearchReferrer();

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

在此案例中，假設使用者從Google加拿大( www.google.ca)搜尋「本位目錄」一詞。 請注意程式碼如何為搜尋引擎( c_se)和搜尋字詞( c_st)的必要c_引數加上前置詞。 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中搜尋「本位目錄」一詞。 因為預設不支援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();
}

將索引鍵值對應到其他索引鍵 map-key-values

將索引鍵/值組的值與另一個索引鍵建立關聯。

說明

在索引鍵/值組中，附加至索引鍵的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 traffic-dil-gtm

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

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

若要在GTM中傳輸dil.js檔案：