Show Menu
主題×

欄位參考

欄位參考可附加至事件或欄位群組。 唯一有意義的資訊是欄位名稱及其路徑。
如果您在欄位中使用特殊字元,則需使用雙引號或簡單引號。 以下是需要引號的案例:
  • 場以數字字元開頭
  • 欄位開頭為"-"字元
  • 欄位包含下列項目以外的其他項目: a- z , A- z- Z,- 0- -9, -,- __ ,-
例如,若您的欄位是 3h : #{OpenWeather.weatherData.rain.'3h'} > 0
// event field
@{<event name>.<XDM path to the field>}
@{LobbyBeacon.endUserIDs._experience.emailid.id}

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

在運算式中,事件欄位被引用為"@",資料來源欄位被引用為"#"。
語法顏色用於以視覺方式區分事件欄位(綠色)和欄位群組(藍色)。
欄位參考的預設值
預設值可與欄位名稱關聯。 語法如下:
// event field
@{<event name>.<XDM path to the field>, defaultValue: <default value expression>}
@{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"}

欄位的類型和預設值必須相同。 例如,@{LobbyBeacon.endUserIDs。_experience.emailid.id, defaultValue :2}將無效,因為預設值是整數,而預期值應為字串。
系列中欄位的參考
系列中定義的元素會使用特定函式all、first和last來參考。 For more information, see 收集管理功能 .
例如:
@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all()

映射中定義的欄位的引用
為了檢索映射中的元素,我們使用帶有給定鍵的輸入函式。 例如,根據所選的命名空間定義事件的索引鍵時,會使用它。 請參閱選擇命名空間。 For more information, see 選取命名空間 .
@{MyEvent.identityMap.entry('Email').first().id}

在此運算式中,我們會取得事件「IdentityMap」欄位的「電子郵件」索引鍵項目。 「電子郵件」項目是系列,我們會從中取用第一個元素中的「id」,使用「first()」。 For more information, see 收集管理功能 .
資料來源的參數值(資料來源動態值)
如果您從外部資料來源選取需要呼叫參數的欄位,右側會出現新標籤,讓您指定此參數。 參見 關於進階運算式編輯器
對於更複雜的使用案例,如果您想將資料來源的參數包含在主運算式中,則可使用關鍵字參數來定義其 。 參數可以是任何有效的運算式,即使是來自其他資料來源,也包含其他參數。
當您在運算式中定義參數值時,右側的標籤會消失。
使用下列語法:
#{<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: @{Profile.address.localisation}}}
#{Weather.main.temperature, params: {localisation: #{GPSLocalisation.main.coordinates, params: {city: @{Profile.address.city}}}}}