設定檔屬性

描述檔屬性為訪客專屬的參數。這些屬性儲存於訪客的描述檔中,以提供可用於活動的訪客資訊。

使用者描述檔包含網頁訪客的人口統計和行為資訊,例如年齡、性別、購買的產品、上次瀏覽時間等,讓Target用來個人化其為訪客提供的內容。

當訪客瀏覽您的網站或返回另一個作業時,可使用描述檔中儲存的描述檔屬性來定位內容或記錄區段篩選資訊。

要設定配置檔案屬性,請執行以下操作:

  1. 按一下「觀眾 > 描述檔指令碼」。

    設定檔指令碼標籤

  2. 按一下​建立指令碼

    建立設定檔指令碼對話方塊

    可用的設定檔屬性類型如下:

    參數類型 說明
    mbox 建立 mbox 時透過頁面程式碼直接傳遞。請參閱傳遞參數至全域 mbox
    ​注意: Target 具有每個 mbox 呼叫 50 個獨特設定檔屬性的限制。如果您需要傳遞超過 50 個設定檔屬性至 Target,則可以使用 設定檔更新 API 方法來傳遞它們。如需詳細資訊,請參閱Adobe Target API檔案](http://developers.adobetarget.com/api/#updating-profiles)中的[描述檔更新。
    描述檔 直接以 JavaScript 程式碼片段定義。其可儲存諸如客戶總花費金額等執行總數,並透過每個 mbox 請求來執行。請參閱以下的設定檔指令碼屬性。

設定檔指令碼屬性

以相關聯的 JavaScript 程式碼片段定義設定檔指令碼屬性。

您可以使用設定檔指令碼來跨多次造訪擷取訪客屬性。設定檔指令碼是 Target 內使用一種伺服器端 JavaScript 來定義的程式碼片段。例如,您可以使用設定檔指令碼來記錄訪客有多頻繁造訪您的網站,以及上次何時造訪。

設定檔指令碼與設定檔參數不同。設定檔參數使用 Target 的 mbox 程式碼實作來擷取訪客的相關資訊。

建立設定檔指令碼

在 介面的「對象」Target標籤下可以使用設定檔指令碼。

若要新增新的設定檔指令碼,請按一下​「設定檔指令碼」​索引標籤、「建立指令碼」,然後撰寫您的指令碼。

若要複製現有的描述檔指令碼,請從描述檔指令碼清單中,將滑鼠指標暫留在所要的指令碼上,然後按一下​複製​圖示:copy icon

然後您可以編輯對象以建立類似的對象。

建立設定檔指令碼對話方塊

設定檔指令碼會針對每個位置請求,執行設定檔屬性「捕捉器」。收到位置請求時,Target 會決定應執行的活動,並顯示適合該活動及該體驗的內容、追蹤活動成功與否,並且執行任何相關的設定檔指令碼。這可讓您追蹤有關瀏覽的資訊,例如訪客的位置、一天中的時間、訪客瀏覽網站的次數、訪客之前是否曾購買過等。 這些資訊會接著加到該訪客的描述檔中,以便您更有效追蹤訪客在您網站上的活動。

設定檔指令碼屬性會將 user. 標籤插入在屬性名稱前。例如:

if (mbox.name == 'Track_Interest') { 
    if (profile.get('model') == "A5" &&; profile.get('subcat') == "KS6") { 
        return (user.get('A5KS6') || 0) + 1; 
    } 
}

請記住下列資訊:

  • 在程式碼中使用 user.get('parameterName') ') 來參照設定檔指令碼屬性 (包括本身)
  • 儲存下次執行此指令碼時 (下一個 mbox 請求時) 可存取包含 user.setLocal('variable_name', 'value') ') 的變數。參考包含 user.getLocal('variable_name') ') 的變數。這對您想要參考上次請求的日期與時間的情況下非常有用。
  • 參數和值區分大小寫。請符合活動或測試期間所收到參數與值的大小寫。
  • 如需更多 JavaScript 語法,請參閱以下「指令碼設定檔參數的 JavaScript 參考資料」一節。
  • 停用指令碼後,參數仍會保留在描述檔中。 如果使用者的設定檔已包含用於活動對象的參數,則該活動將符合該使用者的資格。
  • 配置檔案指令碼在活動中使用時無法刪除。
  • 不建議在另一個描述檔指令碼中建立使用一個描述檔指令碼結果的相依描述檔指令碼。 不保證描述檔指令碼的執行順序。

檢視設定檔指令碼資訊卡

您可以檢視設定檔指令碼資訊快顯卡,這類似選件資訊卡片。您可以透過設定檔指令碼資訊卡,檢視參考特定設定檔指令碼的活動,及其他實用中繼資料。

例如,藉由將游標移至「設定檔指令碼清單」(「對象 > 設定檔指令碼」) 上的設定檔指令碼,然後按一下「資訊」圖示,即可存取以下設定檔指令碼資訊卡。

「指令碼資訊」索引標籤包含下列資訊: 名稱、狀態、Token 類型、指令碼 ID、變更記錄,以及說明。

設定檔指令碼資訊卡

「指令碼使用方式」索引標籤會列出參照所選取設定檔指令碼的活動 (及其工作區)。

設定檔指令碼資訊卡 > 指令碼使用方式標籤

注意

「指令碼使用方式」索引標籤在以下情況不會顯示參照所選取設定檔指令碼的活動:

  • 活動處於「草稿」狀態。
  • 活動中使用的內容或選件使用指令碼變數 (活動中的內嵌選件或「選件」資料庫中的選件)。

Target 在某些情況下會停用設定檔指令碼

Target 在特定情況下自動停用描述檔指令碼,例如執行時間太長或指令太多。

設定檔指令碼停用時,Target UI 中的設定檔指令碼旁邊會出現黃色警示圖示,如下所示:

暫留時,會出現有關錯誤的詳細資料,如下所示:

系統停用設定檔指令碼的常見原因包括:

  • 參照了未定義的變數。
  • 參照了無效的值。這通常起因於沒有適當驗證所參照的 URL 值和使用者輸入的其他資料。
  • 使用了太多 JavaScript 指令。Target 具有每個指令碼 2,000 個 JavaScript 指示的限制,但這無法僅透過手動讀取 JavaScript 來計算。例如,Rhino 將所有函數呼叫和「新的」呼叫視為 100 個指示。這表示對任何函式的任何呼叫都會使用100個指令。 此外,任何輸入資料的大小,例如 URL 值,皆可能影響指示計數。
  • 請注意下節最佳做法中醒目提示的項目。

最佳實務

下列準則主要是為了協助您撰寫儘可能不會出錯或失敗的簡化描述檔指令檔,透過撰寫適當失效的程式碼處理指令碼,而無須強迫系統或指令碼暫停。這些準則是最佳實務的結果,經證明最有執行效率。您可以套用這些準則並搭配由 Rhino 開發社群所擬的原則與建議。

  • 將當前指令碼值設定為用戶指令碼中的本地變數,將故障切換設定為空字串。

  • 藉由確保本地變數不是空白字串來驗證此變數。

  • 使用字串型控制函式與規則運算式。

  • 使用限制迴圈與開放端或 while 迴圈。

  • 請勿超過 1,300 個字元或 50 個迴圈反覆。

  • 請勿超過 2,000 個 JavaScript 指令。Target 具有每個指令碼 2,000 個 JavaScript 指示的限制,但這無法僅透過手動讀取 JavaScript 來計算。例如,Rhino 將所有函數呼叫和「新的」呼叫視為 100 個指示。此外,任何輸入資料的大小,例如 URL 值,皆可能影響指示計數。

  • 不僅要注意指令碼效能,還要注意所有指令碼的綜合效能。我們建議的最佳作法是總共少於 5,000 條指示。計算指令數目並不明顯,但需要注意的是,超過2,000個指令的指令碼會自動停用。 作用中描述檔指令碼的數目不應超過300個。 每個指令碼都會與每個單一mbox呼叫一起執行。 視需要執行多個指令碼。

  • 在規則運算式中,開頭幾乎永遠不需要有點星號 (例如: /.*match//a|.*b/)。規則運算式搜尋會從字串中的所有位置開始 (除非受到 ^ 限制),因此已假設點星號。如果此類規則運算式符合長度足夠的輸入資料 (可能至少有數百個字元),指令碼執行可能會中斷。

  • 如果全部失敗,將指令碼包覆在 try/catch 中。

  • 下列建議可協助您限制描述檔指令碼的複雜性。 描述檔指令碼可執行有限數量的指令。

    作為最佳做法:

    • 盡可能精簡描述檔指令碼。
    • 避免使用規則運算式,或僅使用非常簡單的規則運算式。 即使是簡單的運算式,也需要許多指示來評估。
    • 避免遞回。
    • 描述檔指令碼應先經過效能測試,再新增至Target。 所有描述檔指令碼會在每個mbox請求上執行。 如果描述檔指令碼未正確執行,mbox請求的執行時間會較長。 這可能會影響流量和轉換。
    • 如果描述檔指令碼太複雜,請考慮改用回應Token
  • 如需詳細資訊,請參閱JS Rhino引擎檔案:https://www.mozilla.org/rhino/doc.html

偵錯設定檔指令碼

以下方法可用於偵錯設定檔指令碼:

注意

使用設定檔指令碼中的 console.log 將不會輸出設定檔值,因為設定檔指令碼執行伺服器端。

  • 新增設定檔指令碼作為回應 Token 以偵錯設定檔指令碼:

    在Target中,按一下「管理」,按一下「回應Token」],然後啟用您要除錯的描述檔指令碼。[

    每當您使用 Target 為網站載入頁面時,Target 的部分回應將包含您提供之設定檔指令碼的值,如下所示:

  • 使用 mboxTrace 偵錯工具以偵錯設定檔指令碼。

    此方法需要授權Token,您可以在除錯工具區段中按一下「管理」「>>「實施」「]>[​產生授權Token」,以產生此授權Token。

    然後,將這兩個參數加入「?」後的頁面 URL: mboxTrace=window&authorization=YOURTOKEN

    這比回應 Token 更具參考價值,因為您可獲得設定檔執行前和執行後的快照。它也會顯示所有可用的設定檔。

設定檔指令碼常見問題集

是否能夠使用設定檔指令碼從資料層中的頁面擷取資訊?

由於設定檔指令碼於伺服器端執行,因此其無法直接讀取頁面。必須透過 mbox 要求或其他將資料傳入 Target 的方法傳遞資料。將資料傳入 Target 後,設定檔指令碼即可將資料讀取為 mbox 參數或設定檔參數。

指令碼設定檔參數的 JavaScript 參考資料

必須具備簡單的Javascript知識,才能有效使用指令碼描述檔
參數。 本節可做為快速參考資料,只需要幾分鐘,就能讓您提高使用此功能的效率。

您可以在 mbox/設定檔標籤下找到指令碼設定檔參數。您可以撰寫傳回任何 Javascript 類型 (字串、整數、陣列等) 的 Javascript 程式。

指令碼設定檔參數範例

名稱: user.recency

var dayInMillis = 3600 * 24 * 1000;
if (mbox.name == 'orderThankyouPage') {
    user.setLocal('lastPurchaseTime', new Date().getTime());
}
var lastPurchaseTime = user.getLocal('lastPurchaseTime');
if (lastPurchaseTime) {
    return ((new Date()).getTime() - lastPurchaseTime) / dayInMillis;
}

建立一個日的變數 (以毫秒為測量單位)。如果 mbox 名稱為 orderThankyouPage,請設定名為 lastPurchaseTime 的本機 (隱藏) 的使用者設定檔屬性,以取得目前日期和時間的值。系統會讀取上次購買時間的值,而如果有定義的值,則會傳回已超過自上次購買時間以來的時間,然後除以一天的毫秒數 (這會產生自上次購買以來的天數)。

名稱: user.frequency

var frequency = user.get('frequency') || 0;
if (mbox.name == 'orderThankyouPage') {
    return frequency + 1;
}

建立名為frequency的變數,將其初始化為上一個值或0(如果沒有上一個值)。 如果 mbox 名稱為 orderThankyouPage,則會傳回遞增的值。

名稱: user.monetaryValue

var monetaryValue = user.get('monetaryValue') || 0;
if (mbox.name == 'orderThankyouPage') {
    return monetaryValue + parseInt(mbox.param('orderTotal'));
}

建立稱為 monetaryValue 的變數,查詢指定訪客目前的值 (或如果沒有先前的值,則設為 0)。如果 mbox 名稱為 orderThankyouPage,系統會將先前的值與傳遞給 mbox 的 orderTotal 參數的值相加,以傳回新貨幣值。

名稱: adobeQA

if (page.param("adobeQA"))
     return page.param("adobeQA");
else if (page.param("adobeqa"))
     return page.param("adobeqa");
else if (mbox.param("adobeQA"))
     return mbox.param("adobeQA");

建立名為adobeQA的變數以跟蹤活動QA的用戶。

物件和方法

指令碼設定檔參數可參考下列屬性和方法:

物件或方法 詳細資料
page.url 目前的 URL。
page.protocol 用於頁面的通訊協定 (http 或 https)。
page.domain 目前的 URL 網域 (第一個正斜線之前的所有內容)。例如,http://www.acme.com/categories/men_jeans?color=blu e&size=small 中的 www.acme.com
page.query 目前頁面的查詢字串。‘?’ 之後的所有內容。例如,http://www.acme.com/categories/mens_jeans?color=blue&size=small 中的 blue&size=small
page.param(‘<par_name>’) <par_name> 指示之參數的值。如果您目前的 URL 是 Google 的搜尋頁面,而您已經輸入 page.param('hl'),則就 URL http://www.google.com/search?hl=en& q=what+is+asdf&btnG=Google+Search 而言會得到「en」。
page.referrer 上述同一組作業適用於轉介者和登陸 (亦即,referrer.url 將會是轉介者的 URL 位址)。
landing.url, landing.protocol, landing.query, 和 landing.param 與頁面的該項目類似,但適用於登陸頁面。
mbox.name 使用中的 mbox 名稱。
mbox.param(‘<par_name>’) 根據使用中 mbox 的指定名稱的 mbox 參數。
profile.get(‘<par_name>’) 根據 <par_name> 名稱之由用戶端建立的使用者設定檔參數。例如,如果使用者設定名為「性別」的設定檔參數,可使用「profile.gender」擷取此值。傳回為目前訪客設定的「profile.<par_name>」的值;如果沒有設定任何值,則會傳回 null。請注意,profile.get(<par_name>)是限定函式調用。
user.get(‘<par_name>’) 傳回為目前訪客設定的「user.<par_name>」的值;如果沒有設定任何值,則會傳回 null。
user.categoryAffinity 傳回最佳類別的名稱。
user.categoryAffinities 傳回具有最佳類別的陣列。
user.isFirstSession 如果這是訪客的第一個工作階段,則會傳回 true。
user.browser 傳回 HTTP 標頭中的使用者代理程式。舉例來說,您可以建立只將目標鎖定於 Safari 使用者的運算式目標: if (user.browser != null && user.browser.indexOf('Safari') != -1) { return true; }

常見運算子

所有標準 JavaScript 運算子皆存在且可供使用。JavaScript 運算子可用於字串和數字 (以及其他資料類型)。快速簡短說明:

運算元 說明
== 代表相等。當兩側運算元相等時,則為 true。
!= 代表不相等。當兩側運算元不相等時,則為 true。
< 代表左側的變數小於右側的變數。如果變數相等,則將評估為 false。
> 代表左側的變數大於右側的變數。如果變數相等,則將評估為 false。
<= < 相同,但如果變數相等,則會評估為 true。
>= > 相同,但如果變數相等,則會評估為 true。
&& 邏輯上,「AND」左側和右側的運算式,只有在兩側皆為 true 時,才會是 true (否則則為 false)。
|| 邏輯上,「OR」左側和右側的運算式,只有在其中一側為 true 時,才會是 true (否則則為 false)。
// 檢查來源是否包含目標布林值包含的所有元素 (陣列來源、陣列目標)。
// 會從目標擷取子字串 (對應 regexp),然後將其解碼 Array/*String*/ decode(String encoding, String regexp, String target)
此功能也支援使用常數字串值、分組 (condition1 || condition2) && condition3,以及規則運算式 (/[^a-z]$/.test(landing.referring.url)

訓練影片:描述檔指令碼教學課程標章

此影片包含使用和建立設定檔指令碼的相關資訊。

  • 解釋什麼是設定檔指令碼
  • 解釋設定檔指令碼和設定檔參數有何不同
  • 建立簡單的設定檔指令碼
  • 使用「可用 Token」功能表來存取可用的選項
  • 啟用和停用設定檔指令碼

本頁內容

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