DIL工具

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}(選擇性) ​包含hostPatternqueryParamqueryPattern之組態的物件。

並傳回:

  • {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)拆解成其組成元件: hashhosthrefpathnameprotocolsearchuriParams

函式簽章: 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