Handbuch zur Streaming-Segmentierung
Erstellt für:
- Benutzende
NOTEEignungsaktualisierungen
IMPORTANTRegelsatz
Alle neuen oder bearbeiteten Segmentdefinitionen, die den folgenden Regelsätzen entsprechen werden nicht mehr Streaming- oder Edge-Segmentierung ausgewertet. Stattdessen werden sie mithilfe der Batch-Segmentierung ausgewertet.
- Ein einzelnes Ereignis mit einem Zeitfenster von mehr als 24 Stunden
- Aktivieren Sie eine Zielgruppe mit allen Profilen, die sich eine Web-Seite in den letzten 3 Tagen angesehen haben.
- Ein einzelnes Ereignis ohne Zeitfenster
- Aktivieren Sie eine Zielgruppe mit allen Profilen, die eine Web-Seite angesehen haben.
Zeitfenster
Um eine Zielgruppe mit Streaming-Segmentierung auszuwerten muss sie einem Zeitfenster von 24 Stunden eingeschränkt sein.
Einschließen von Batch-Daten in Streaming-Zielgruppen
Vor diesem Update konnten Sie eine Definition für Streaming-Zielgruppen erstellen, die sowohl Batch- als auch Streaming-Datenquellen kombinierte. Mit der neuesten Aktualisierung wird jedoch die Erstellung einer Zielgruppe mit sowohl Batch- als auch Streaming-Datenquellen mithilfe der Batch-Segmentierung ausgewertet.
Wenn Sie eine Segmentdefinition mit Streaming- oder Edge-Segmentierung auswerten müssen, die dem aktualisierten Regelsatz entspricht, müssen Sie explizit einen Batch und einen Streaming-Regelsatz erstellen und sie mithilfe von Segmenten kombinieren. Dieser Batch Regelsatz auf einem Profilschema basieren.
Angenommen, Sie haben zwei Zielgruppen, von denen eine die Profilschemadaten und die andere die Ereignisschemadaten enthält:
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1Wenn Sie die Batch-Komponente in Ihrer Streaming-Zielgruppe verwenden möchten, müssen Sie einen Verweis auf die Batch-Zielgruppe anhand des Segments von Segmenten erstellen.
Ein Beispielregelsatz, der die beiden Zielgruppen kombiniert, würde also wie folgt aussehen:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
Die resultierende Zielgruppe wird mithilfe der Streaming-Segmentierung ausgewertet, da sie die Zugehörigkeit der Batch-Zielgruppe durch Verweis auf die Komponente für die Batch-Zielgruppe nutzt.
Wenn Sie jedoch zwei Zielgruppen mit Ereignisdaten kombinieren möchten, Sie die beiden Ereignisse nicht kombinieren. Sie müssen beide Zielgruppen erstellen und dann eine weitere Zielgruppe erstellen, die inSegment verwendet, um auf diese beiden Zielgruppen zu verweisen.
Angenommen, Sie haben zwei Zielgruppen, wobei beide Zielgruppen Erlebnisereignis-Schemadaten enthalten:
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1In diesem Fall müssten Sie wie folgt eine dritte Zielgruppe erstellen:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
Zusammenführungsrichtlinie
Alle neuen oder bearbeiteten Segmentdefinitionen, die für Streaming oder Edge-Segmentierung qualifiziert müssen in der Zusammenführungsrichtlinie „Active on Edge" festgelegt sein.
Wenn kein aktiver Zusammenführungsrichtliniensatz festgelegt ist, müssen Sie Zusammenführungsrichtlinie konfigurieren und sie so einstellen, dass sie im Randbereich aktiv ist.
Streaming-Segmentierung bedeutet, dass Zielgruppen in Adobe Experience Platform nahezu in Echtzeit ausgewertet werden können, während der Schwerpunkt auf die Relevanz der Daten gelegt wird.
Im Rahmen der Streaming-Segmentierung erfolgt jetzt eine Zielgruppen-Qualifizierung, wenn Streaming-Daten in Experience Platform aufgenommen werden. So wird die Notwendigkeit verringert, Segmentierungsaufträge zu planen und auszuführen. Auf diese Weise können Sie Daten auswerten, während sie an Experience Platform übergeben werden, sodass die Zielgruppenzugehörigkeit automatisch auf dem neuesten Stand gehalten wird.
Mögliche Regelsätze
IMPORTANTEin Regelsatz ist für die Streaming-Segmentierung geeignet, wenn er eines der in der folgenden Tabelle aufgeführten Kriterien erfüllt.
NOTECHAIN(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)])
Eine Segmentdefinition ist nicht für die Streaming-Segmentierung in den folgenden Szenarien geeignet:
- Die Segmentdefinition umfasst Segmente oder Merkmale aus Adobe Audience Manager (AAM).
- Die Segmentdefinition umfasst mehrere Entitäten (Abfragen mit mehreren Entitäten).
- Die Segmentdefinition umfasst eine Kombination aus einem einzelnen Ereignis und einem
inSegment-Ereignis.- Beispielsweise das Verketten von Folgendem in einem einzigen Regelsatz:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false)) WHEN(<= 24 hours before now)]).
- Beispielsweise das Verketten von Folgendem in einem einzigen Regelsatz:
- Die Segmentdefinition verwendet „Jahr ignorieren“ als Teil ihrer Zeitbeschränkungen.
Beachten Sie die folgenden Richtlinien, die für Streaming-Segmentierungsabfragen gelten:
- Das Lookback-Fenster ist auf einen Tag beschränkt.
- Es muss eine strikte Bedingung für die zeitliche Reihenfolge zwischen den Ereignissen vorhanden sein.
- Abfragen mit mindestens einem negierten Ereignis werden unterstützt. Das gesamte Ereignis kann jedoch keine Negation sein.
Wenn eine Segmentdefinition geändert wird, sodass sie die Kriterien für die Streaming-Segmentierung nicht mehr erfüllt, wird die Segmentdefinition automatisch von „Streaming“ zu „Batch“ geändert.
Darüber hinaus erfolgt die Aufhebung der Segmentqualifikation, ähnlich wie die Segmentqualifikation selbst, in Echtzeit. Wenn sich eine Zielgruppe nicht mehr für ein Segment qualifiziert, wird deren Qualifikation daher sofort aufgehoben. Wenn in der Segmentdefinition beispielsweise nach „Alle Benutzenden, die in den letzten drei Stunden rote Schuhe gekauft haben“ gefragt wird, wird die Qualifikation nach drei Stunden für alle Profile, die sich ursprünglich für die Segmentdefinition qualifiziert haben, aufgehoben.
Kombinieren von Audiences
Um Daten aus Batch- und Streaming-Quellen zu kombinieren, müssen Sie die Batch- und Streaming-Komponenten in separate Zielgruppen aufteilen.
Profilattribut und Erlebnisereignis
Berücksichtigen wir beispielsweise die beiden folgenden Beispielzielgruppen:
e3be6d7f-1727-401f-a41e-c296b45f607a9e1646bb-57ff-4309-ba59-17d6c5bab6a1Wenn Sie die Batch-Komponente in Ihrer Streaming-Zielgruppe verwenden möchten, müssen Sie einen Verweis auf die Batch-Zielgruppe anhand des Segments von Segmenten erstellen.
Ein Beispielregelsatz, der die beiden Zielgruppen kombiniert, würde also wie folgt aussehen:
inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])
Die resultierende Zielgruppe wird mithilfe der Streaming-Segmentierung ausgewertet, da sie die Zugehörigkeit der Batch-Zielgruppe durch Verweis auf die Komponente für die Batch-Zielgruppe nutzt.
Mehrere Erlebnisereignisse
Wenn Sie mehrere Zielgruppen mit Ereignisdaten kombinieren möchten, Sie die Ereignisse nicht kombinieren. Sie müssen für jedes Ereignis eine Zielgruppe erstellen und dann eine andere Zielgruppe erstellen, die inSegment verwendet, um auf alle Zielgruppen zu verweisen.
Angenommen, Sie haben zwei Zielgruppen, wobei beide Zielgruppen Erlebnisereignis-Schemadaten enthalten:
7deb246a-49b4-4687-95f9-6316df0499489e1646bb-57ff-4309-ba59-17d6c5bab6a1In diesem Fall müssten Sie wie folgt eine dritte Zielgruppe erstellen:
inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")
Zielgruppe erstellen
Sie können eine Zielgruppe erstellen, die mithilfe der Streaming-Segmentierung ausgewertet wird, entweder mithilfe der Segmentierungs-Service-API oder über das Zielgruppenportal in der Benutzeroberfläche.
Eine Segmentdefinition kann für Streaming aktiviert werden, wenn sie mit einem der geeigneten Regelsätze“.
API-Format
POST /segment/definitions
Anfrage
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"
}
}'
Antwort
Eine erfolgreiche Antwort gibt den HTTP-Status 200 mit Details zur neu erstellten Segmentdefinition zurück.
{
"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
}
Weitere Informationen zur Verwendung dieses Endpunkts finden Sie im Handbuch zum Segmentdefinitionenendpunkt.
Wählen Sie in Audience Portal Zielgruppe erstellen aus.
Ein Popup wird angezeigt. Wählen Sie Regeln erstellen, um in Segment Builder zu gelangen.
Erstellen Sie in Segment Builder eine Segmentdefinition, die einem der ( Regelsätze). Wenn die Segmentdefinition für die Streaming-Segmentierung geeignet ist, können Sie "" die Auswertungsmethode auswählen.
Weitere Informationen zum Erstellen von Segmentdefinitionen finden Sie im Segment Builder-Handbuch
Abrufen von Zielgruppen
Sie können alle Zielgruppen abrufen, die mithilfe der Streaming-Segmentierung ausgewertet werden, indem Sie entweder die Segmentierungs-Service-API oder das Zielgruppenportal in der Benutzeroberfläche verwenden.
Rufen Sie eine Liste aller Segmentdefinitionen ab, die mithilfe der Streaming-Segmentierung in Ihrer Organisation ausgewertet werden, indem Sie eine GET-Anfrage an den /segment/definitions-Endpunkt stellen.
API-Format
Sie müssen den Abfrageparameter evaluationInfo.synchronous.enabled=true in den Anfragepfad aufnehmen, um Segmentdefinitionen abzurufen, die mithilfe der Streaming-Segmentierung bewertet wurden.
GET /segment/definitions?evaluationInfo.continuous.enabled=true
Anfrage
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}'
Antwort
Bei einer erfolgreichen Antwort wird der HTTP-Status 200 mit einem Array von Segmentdefinitionen in Ihrer Organisation zurückgegeben, die für die Streaming-Segmentierung aktiviert sind.
{
"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": {}
}
Detailliertere Informationen zur zurückgegebenen Segmentdefinition finden Sie im Handbuch zum Segmentdefinitionenendpunkt.
Sie können alle Zielgruppen abrufen, die für die Streaming-Segmentierung innerhalb Ihrer Organisation aktiviert sind, indem Sie in Audience Portal Filter verwenden. Wählen Sie das
Gehen Sie in den verfügbaren Filtern zu Aktualisierungshäufigkeit und wählen Sie "Streaming aus. Mit diesem Filter werden alle Zielgruppen in Ihrer Organisation angezeigt, die mithilfe der Streaming-Segmentierung ausgewertet werden.
Weitere Informationen zum Anzeigen von Zielgruppen in Experience Platform finden Sie im Handbuch für Zielgruppenportale.
Zielgruppendetails
Sie können Details zu einer bestimmten Zielgruppe anzeigen, die mithilfe der Streaming-Segmentierung bewertet wurde, indem Sie sie im Zielgruppenportal auswählen.
Nach Auswahl einer Zielgruppe in Audience Portal wird die Seite mit den Zielgruppendetails angezeigt. Dadurch werden Informationen zur Zielgruppe angezeigt, einschließlich einer Zusammenfassung der Zielgruppendetails, der Anzahl der qualifizierten Profile im Zeitverlauf sowie der Ziele, für die die Zielgruppe aktiviert wurde.
Bei für Streaming aktivierten Zielgruppen wird die Karte Profile im Zeitverlauf angezeigt, die die Gesamtzahl der qualifizierten und die neuen aktualisierten Metriken der Zielgruppe anzeigt.
Die Gesamtzahl der Qualifizierten stellt die Gesamtzahl der qualifizierten Zielgruppen basierend auf Batch- und Streaming-Auswertungen für diese Zielgruppe dar.
Die Metrik Neue Zielgruppe aktualisiert wird durch ein Liniendiagramm dargestellt, das die Änderung der Zielgruppengröße durch die Streaming-Segmentierung anzeigt. Sie können das Dropdown-Menü so anpassen, dass die letzten 24 Stunden, die letzte Woche oder die letzten 30 Tage angezeigt werden.
Weitere Informationen zu Zielgruppendetails finden Sie im Abschnitt Zielgruppenportal - Übersicht.
Nächste Schritte
In diesem Handbuch wird erläutert, wie für Streaming aktivierte Segmentdefinitionen in Adobe Experience Platform funktionieren und wie für Streaming aktivierte Segmentdefinitionen überwacht werden.
Weitere Informationen zur Verwendung der Benutzeroberfläche von Adobe Experience Platform finden Sie im Benutzerhandbuch zur Segmentierung.
Häufig gestellte Fragen zur Streaming-Segmentierung finden Sie im Abschnitt Streaming-Segmentierung“ der häufig gestellten.