文件Audience ManagerAudience Manager 使用手冊

DIL工具

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
WARNING
自2023年7月起，Adobe已停止開發Data Integration Library (DIL)和DIL擴充功能。
現有客戶可以繼續使用其DIL實作。 不過，Adobe在此點之後不會開發DIL。 建議客戶針對Experience PlatformWeb SDK的長期資料收集策略進行評估。
如果客戶希望在2023年7月之後實作新的資料收集整合，則應改用Experience PlatformWeb SDK。

說明DIL.tools名稱空間中的方法。 這些公用程式功能可協助您執行特定工作。

getSearchReferrer

傳回用來存取目前頁面的搜尋字詞。

getSearchReferrer的目的

在DIL中，getSearchReferrer會傳回用來存取您的網站的搜尋結果（名稱和關鍵字）。 您可以將特定搜尋字詞傳入此函式，或讓此函式依預設針對document.referrer搜尋支援的搜尋引擎（ AOL、Ask、Bing、Google和Yahoo）。

函式簽章

函式簽章： DIL.tools.getSearchReferrer(uri, initConfig)

函式引數

getSearchReferrer接受：

  • {string}： （選擇性） ​包含搜尋URL的字串（如果未定義，則使用document.referrer）。
  • {object}： （選擇性） ​包含hostPattern、queryParam或queryPattern之組態的物件。

並傳回：

  • {object}包含有效名稱和關鍵字的物件。

範例

搜尋類型
說明
程式碼範例
預設搜尋
傳回AOL、Ask、Bing、Google和Yahoo搜尋引擎所使用的關鍵字搜尋辭彙。
var results = DIL.tools.getSearchReferrer();
傳入自訂URL
根據自訂URL傳回搜尋反向連結。
var results = DIL.tools.getSearchReferrer("https://www.ehow.com/search.aspx?q=adobe+rules");
比對URL主機名稱與自訂規則運算式
傳入自訂規則運算式，以符合反向連結URL的主機名稱。
var results = DIL.tools.getSearchReferrer("https://www.ehow.com/ search.aspx?q=adobe+rules",{    hostPattern:/ehow\./,    queryParam:"p" });
比對搜尋模式與自訂規則運算式
傳入自訂規則運算式以執行自訂搜尋。
var results = DIL.tools.getSearchReferrer("https://www.ehow.com/search.aspx?q=adobe+rules, {    hostPattern:/ehow\./,    search_pattern:/[&\?]p=([^&]+/ });

decomposeURI

將統一資源識別碼( URI)拆解成其組成元件： hash、host、href、pathname、protocol、search和uriParams。

函式簽章： DIL.tools.decomposeURI

函式引數

decomposeURI接受：

  • uri {string}： （選擇性） ​包含URI的字串。 若未指定，則預設為document.location.href。

並傳回：

  • {object}：包含有效名稱和關鍵字的物件。

程式碼範例

var uriData = DIL.tools.decomposeURI('https://www.adobe.com/?arg1=123&arg2=456#am');
{
  hash : "#am",
  host : "www.adobe.com",
  hostname : "www.adobe.com",
  href : "https://www.adobe.com/?arg1=123&arg2=456#am",
  pathname : "",
  protocol : "https:",
  search : "?arg1=123&arg2=456",
  uriParams : {
    arg1 : "123",
    arg2 : "456"
  }
}

getMetaTags

搜尋在網頁的中繼標籤中定義的特定內容，並在物件中傳回該資料。

函式簽章

函式簽章： DIL.tools.getMetaTags( 1 or more parameters)

函式引數

getMetaTags接受要搜尋的一或多個名稱引數（字串型別）。 它會傳回由索引鍵值配對組成的物件。

程式碼範例


var dataLib = DIL.create({
     partner: 'partnerName',
     containerNSID: containerNSID
});

dataLib.api.signals(DIL.tools.getMetaTags('application', 'keywords',  'description'), 'c_').submit();


var dataLib = DIL.create({
     partner: `partnerName',
     containerNSID: containerNSID
});

dataLib.api.signals(DIL.tools.getMetaTags('application','keywords', 'description'), 'c_').submit();
recommendation-more-help
de293fbf-b489-49b0-8daa-51ed303af695