規則集
任何符合下列規則集的 新區段或編輯的 區段定義都將 不再使用 串流或邊緣區段進行評估。 相反地,將會使用批次區段來評估這些區段。
- 時間超過24小時的單一事件
- 使用過去3天內檢視過網頁的所有設定檔啟用對象。
- 沒有時間範圍的單一事件
- 使用所有檢視了網頁的設定檔來啟用對象。
時間段
為了使用串流細分評估對象,它 必須 限制在24小時時間範圍內。
在串流對象中包含批次資料
在此更新之前,您可以建立結合批次和串流資料來源的串流對象定義。 不過,透過最新更新,使用批次和串流資料來源建立對象時,將會使用批次細分進行評估。
如果您需要使用符合更新後規則集的串流或邊緣細分來評估區段定義,您需要明確建立批次和串流規則集,並使用區段區段將它們合併。 此批次規則集 必須 以設定檔結構描述為基礎。
例如,假設您有兩個對象,其中一個對象容納設定檔結構描述資料,另一個則容納體驗事件結構描述資料:
e3be6d7f-1727-401f-a41e-c296b45f607a
9e1646bb-57ff-4309-ba59-17d6c5bab6a1
如果您想在串流對象中使用批次元件,必須使用區段參考批次對象。
因此,將兩個對象結合在一起的規則集範例如下所示:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
將使用串流細分來評估產生的對象**,因為它透過參考批次對象元件來運用批次對象的成員資格。
不過,如果您想要結合兩個對象與事件資料,您 無法 只結合這兩個事件。 您需要建立兩個對象,然後建立另一個使用inSegment
來參照這兩個對象的對象。
例如,假設您有兩個對象,這兩個對象都會容納體驗事件結構描述資料:
e3be6d7f-1727-401f-a41e-c296b45f607a
9e1646bb-57ff-4309-ba59-17d6c5bab6a1
在此情況下,您需要建立第三個對象,如下所示:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
合併原則
任何符合串流或邊緣分段 資格的 新或已編輯 區段定義,都必須 位於「Edge上的'a5'5c用」合併原則上。
如果沒有作用中的合併原則集,您需要設定您的合併原則,並將它設定為在Edge上作用中。
串流細分是近乎即時評估Adobe Experience Platform中的受眾,同時專注於資料豐富度的能力。
有了串流區隔,當串流資料進入Experience Platform時,對象資格就會立即生效,無需排程及執行區隔工作。 這可讓您在資料傳入Experience Platform時評估資料,讓對象成員資格自動保持在最新狀態。
合格的規則集
如果規則集符合下表所列的任何條件,就符合串流區段的資格。
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

homeAddress.country.equals("US", false)

workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

workAddress.country.equals("US", false) and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("directMarketing.emailClicked", false)) WHEN(today), C1: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(today)])

在下列情況下,區段定義將 不 適用於串流分段:
- 區段定義包含Adobe Audience Manager (AAM)區段或特徵。
- 區段定義包括多個實體(多實體查詢)。
- 區段定義包含單一事件和
inSegment
事件的組合。- 例如,在單一規則集中鏈結下列專案:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)])
。
- 例如,在單一規則集中鏈結下列專案:
- 區段定義會使用「忽略年份」作為其時間限制的一部分。
請注意下列適用於串流細分查詢的准則:
- 回顧期間限製為 一天。
- 事件之間必須有嚴格的時間排序條件 且。
- 支援至少具有一個否定事件的查詢。 不過,整個事件 不可 為否定。
如果區段定義經過修改,使其不再符合串流區段的條件,則區段定義會自動從「串流」切換為「批次」。
此外,區段取消資格(類似於區段資格)會即時發生。 因此,如果對象不再符合區段的資格,則會立即取消資格。 例如,如果區段定義要求「過去三小時內購買紅鞋子的所有使用者」,三小時後,所有最初符合區段定義資格的設定檔都將不合格。
合併對象
若要合併來自批次和串流來源的資料,您必須將批次和串流元件分隔為個別的對象。
設定檔屬性和體驗事件
例如,我們考慮以下兩個範例對象:
e3be6d7f-1727-401f-a41e-c296b45f607a
9e1646bb-57ff-4309-ba59-17d6c5bab6a1
如果您想在串流對象中使用批次元件,必須使用區段參考批次對象。
因此,將兩個對象結合在一起的規則集範例如下所示:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
將使用串流細分來評估產生的對象**,因為它透過參考批次對象元件來運用批次對象的成員資格。
多個體驗事件
如果您想要結合多個對象與事件資料,您 不能 只結合這些事件。 您必須為每個事件建立對象,然後建立另一個使用inSegment
來參照所有對象的對象。
例如,假設您有兩個對象,這兩個對象都會容納體驗事件結構描述資料:
7deb246a-49b4-4687-95f9-6316df049948
9e1646bb-57ff-4309-ba59-17d6c5bab6a1
在此情況下,您需要建立第三個對象,如下所示:
inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
API格式
POST /segment/definitions
要求
curl -X POST https://platform.adobe.io/data/core/ups/segment/definitions
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-d '{
"name": "People in the USA",
"description: "An audience that looks for people who live in the USA",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "homeAddress.country = \"US\""
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": true
},
"synchronous": {
"enabled": false
}
},
"schema": {
"name": "_xdm.context.profile"
}
}'
回應
成功的回應會傳回HTTP狀態200以及您新建立區段定義的詳細資料。
{
"id": "4afe34ae-8c98-4513-8a1d-67ccaa54bc05",
"schema": {
"name": "_xdm.context.profile"
},
"profileInstanceId": "ups",
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
"sandboxName": "prod",
"type": "production",
"default": true
},
"name": "People in the USA",
"description": "An audience that looks for people who live in the USA",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "homeAddress.country = \"US\""
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": true
},
"synchronous": {
"enabled": false
}
},
"dataGovernancePolicy": {
"excludeOptOut": true
},
"creationTime": 0,
"updateEpoch": 1579292094,
"updateTime": 1579292094000
}
在區段定義端點指南中找到有關使用此端點的詳細資訊。
擷取對象
您可以使用Segmentation Service API或透過UI中的對象入口網站,擷取使用串流細分評估的所有對象。
向/segment/definitions
端點發出GET要求,以擷取使用組織內串流細分評估的所有區段定義清單。
API格式
您必須在要求路徑中包含查詢引數evaluationInfo.synchronous.enabled=true
,以擷取使用串流細分評估的區段定義。
GET /segment/definitions?evaluationInfo.continuous.enabled=true
要求
curl -X GET 'https://platform.adobe.io/data/core/ups/segment/definitions?evaluationInfo.continuous.enabled=true' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
回應
成功的回應會傳回HTTP狀態200,其中包含貴組織中已啟用串流細分的區段定義陣列。
{
"segments": [
{
"id": "15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"ttlInDays": 30,
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "",
"sandboxName": "",
"type": "production",
"default": true
},
"name": " People who are NOT on their homepage ",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = false"
},
"evaluationInfo": {
"batch": {
"enabled": false
},
"continuous": {
"enabled": true
},
"synchronous": {
"enabled": false
}
},
"creationTime": 1572029711000,
"updateEpoch": 1572029712000,
"updateTime": 1572029712000
},
{
"id": "f15063cb-2da8-4851-a2e2-bf59ddd2f004",
"schema": {
"name": "_xdm.context.profile"
},
"ttlInDays": 30,
"imsOrgId": "{ORG_ID}",
"sandbox": {
"sandboxId": "",
"sandboxName": "",
"type": "production",
"default": true
},
"name": "Homepage_continuous",
"description": "People who are on their homepage - continuous",
"expression": {
"type": "PQL",
"format": "pql/text",
"value": "select var1 from xEvent where var1._experience.analytics.endUser.firstWeb.webPageDetails.isHomePage = true"
},
"evaluationInfo": {
"batch": {
"enabled": true
},
"continuous": {
"enabled": true
},
"synchronous": {
"enabled": false
}
},
"creationTime": 1572021085000,
"updateEpoch": 1572021086000,
"updateTime": 1572021086000
}
],
"page": {
"totalCount": 2,
"totalPages": 1,
"sortField": "creationTime",
"sort": "desc",
"pageSize": 2,
"limit": 100
},
"link": {}
}
在區段定義端點指南中找到有關傳回的區段定義的詳細資訊。
您可以使用Audience Portal中的篩選條件,擷取貴組織內針對串流細分啟用的所有對象。 選取
在可用的篩選器內,移至 更新頻率 並選取串流。 使用此篩選器會顯示貴組織中使用串流細分評估的所有對象。
若要進一步瞭解如何在Experience Platform中檢視對象,請參閱對象入口網站指南。
客群詳細資料
您可以在對象入口網站中選取串流區隔,以檢視使用串流區隔評估的特定對象詳細資料。
在Audience Portal上選取對象後,對象詳細資訊頁面就會顯示。 這會顯示對象的相關資訊,包括對象詳細資訊的摘要、一段時間內合格設定檔的數量,以及對象已啟用的目的地。
針對已啟用串流的對象,會顯示 設定檔特定時段 卡片,其中顯示合格的總數以及新對象更新的量度。
根據此對象的批次和串流評估,合格總計 量度代表合格對象的總數。
新對象已更新 量度以折線圖表示,該折線圖顯示透過串流細分而發生的對象人數變化。 您可以調整下拉式清單以顯示過去24小時、上週或過去30天。
如需對象詳細資料的詳細資訊,請參閱對象入口網站概觀。
後續步驟
本指南說明串流啟用區段定義如何在Adobe Experience Platform上運作,以及如何監視串流啟用區段定義。
若要進一步瞭解如何使用Adobe Experience Platform使用者介面,請參閱分段使用手冊。
如需有關串流區段的常見問題,請參閱常見問題🔗的串流區段區段。