欄位參考 field-references

欄位參考可附加至事件或欄位群組。 唯一有意義的資訊是欄位名稱及其路徑。

如果您在欄位中使用特殊字元,則必須使用雙引號或簡單引號。 以下是需要引號的情況:

  • 欄位以數字字元開頭
  • 欄位以「 — 」字元開頭
  • 欄位包含​ a-zA-Z0-9-_​以外的任何專案

例如,如果您的欄位是​ 3h#{OpenWeather.weatherData.rain.'3h'} > 0

// event field
@event{<event name>.<XDM path to the field>}
@event{LobbyBeacon.endUserIDs._experience.emailid.id}

// field group
#{<data source name>.<field group name>.<path to the field>}
#{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address}

在運算式中,事件欄位以「@」參照,資料來源欄位以「#」參照。

語法顏色是用來在視覺上區分事件欄位(綠色)與欄位群組(藍色)。

欄位參考的預設值 default-value

預設值可與欄位名稱相關聯。 語法如下:

// event field
@event{<event name>.<XDM path to the field>, defaultValue: <default value expression>}
@event{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue: "example@adobe.com"}
// field group
#{<data source name>.<field group name>.<path to the field>, defaultValue: <default value expression>}
#{ExperiencePlatform.ProfileFieldGroup.profile.personalEmail.address, defaultValue: "example@adobe.com"}
NOTE
欄位型別和預設值必須相同。 例如,@event{LobbyBeacon.endUserIDs._experience.emailid.id, defaultValue : 2}無效,因為預設值是整數,而預期值應為字串。

範例:

// for an event 'OrderEvent' having the following payload:
{
    "orderId": "12345"
}

expression example:
- @event{OrderEvent.orderId}                                    -> "12345"
- @event{OrderEvent.producdId, defaultValue : "not specified" } -> "not specified" // default value, productId is not a field present in the payload
- @event{OrderEvent.productId}                                  -> null


// for an entity 'Profile' on datasource 'ACP' having fields person/lastName, with fetched data such as:
{
    "person": {
        "lastName":"Snow"
    },
    "emails": [
        { "email":"john.snow@winterfell.westeros" },
        { "email":"snow@thewall.westeros" }
    ]
}

expression examples:
- #{ACP.Profile.person.lastName}                 -> "Snow"
- #{ACP.Profile.emails.at(1).email}              -> "snow@thewall.westeros"
- #{ACP.Profile.person.age, defaultValue : -1}   -> -1 // default value, age is not a field present in the payload
- #{ACP.Profile.person.age}                      -> null

您可以將任何種類的運算式新增為預設值。 唯一的限制是運算式必須傳回預期的資料型別。 使用函式時,需要使用()封裝函式。

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.any.time, defaultValue : (now())}
== date("2022-02-10T00:00:00Z")

集合內欄位的參考

集合中定義的元素是使用特定函式allfirstlast參考。 如需詳細資訊,請參閱本頁面

範例:

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all()

參照地圖中定義的欄位

entry函式

為了擷取對應中的元素,我們使用具有給定索引鍵的專案函式。 例如,根據選取的名稱空間,定義事件的索引鍵時會使用它。 如需詳細資訊,請參閱此頁面

@event{MyEvent.identityMap.entry('Email').first().id}

在此運算式中,我們會取得事件之「IdentityMap」欄位的「Email」索引鍵專案。 'Email'專案是集合,我們使用'first()'從其中取得第一個元素中的'id'。 如需詳細資訊,請參閱此頁面

firstEntryKey函式

若要擷取對映的第一個專案索引鍵,請使用firstEntryKey函式。

此範例顯示如何擷取特定清單中訂閱者的第一個電子郵件地址:

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-email').subscribers.firstEntryKey()}

在此範例中,訂閱清單名為daily-email。 電子郵件地址在subscribers對應中定義為金鑰,此對應連結至訂閱清單對應。

keys函式

若要擷取對應的所有索引鍵,請使用keys函式。

此範例說明如何針對特定設定檔擷取與特定清單訂閱者相關聯的所有電子郵件地址:

#{ExperiencePlatform.Subscriptions.profile.consents.marketing.email.subscriptions.entry('daily-mail').subscribers.keys()

資料來源的引數值(資料來源動態值)

如果您從外部資料來源選取欄位,需要呼叫引數,右側會出現新索引標籤,供您指定此引數。 請參閱此頁面

對於更複雜的使用案例,如果您想將資料來源的引數納入主要運算式中,可以使用關鍵字​ params ​來定義其值。 即使來自另一個包含另一個引數的資料來源,引數也可以是任何有效的運算式。

NOTE
當您在運算式中定義引數值時,右側的標籤會消失。

使用下列語法:

#{<datasource>.<field group>.fieldName, params: {<params-1-name>: <params-1-value>, <params-2-name>: <params-2-value>}}
  • <params-1-name>:資料來源中第一個引數的確切名稱。
  • <params-1-value>:第一個引數的值。 可以是任何有效的運算式。

範例:

#{Weather.main.temperature, params: {localisation: @event{Profile.address.localisation}}}
#{Weather.main.temperature, params: {localisation: #{GPSLocalisation.main.coordinates, params: {city: @event{Profile.address.city}}}}}
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76