Guide de segmentation des flux de données entrants

La segmentation en flux continu est la possibilité d’évaluer les audiences dans Adobe Experience Platform en temps quasi réel tout en se concentrant sur la richesse des données.

Avec la segmentation en flux continu, la qualification d’audience se produit désormais lorsque les données en flux continu entrent dans Experience Platform, ce qui évite d’avoir à planifier et à exécuter des tâches de segmentation. Cela vous permet d'évaluer les données au fur et à mesure qu'elles sont transmises à l'Experience Platform, ce qui permet à l'abonnement du public d'être automatiquement tenu à jour.

Ensembles de règles éligibles rulesets

Un ensemble de règles peut être segmenté en streaming s’il répond à l’un des critères décrits dans le tableau suivant.

Type de requête

Détails

Requête

Exemple

Événement unique dans une fenêtre temporelle de moins de 24 heures

Toute définition de segment qui fait référence à un seul événement entrant dans une fenêtre temporelle de moins de 24 heures.

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

Profil uniquement

Toute définition de segment qui ne fait référence qu’à un attribut de profil.

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

Événement unique avec un attribut de profil dans une fenêtre temporelle relative de moins de 24 heures

Toute définition de segment qui fait référence à un seul événement entrant, avec un ou plusieurs attributs de profil, et qui se produit dans une fenêtre temporelle relative de moins de 24 heures.

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

Événements multiples dans une fenêtre de temps relative de 24 heures

Toute définition de segment qui fait référence à plusieurs événements au cours des dernières 24 heures et (éventuellement) comporte un ou plusieurs attributs de profil.

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)])

Une définition de segment non est éligible pour la segmentation en flux continu dans les scénarios suivants :

Veuillez noter les instructions suivantes qui s’appliquent aux requêtes de segmentation en flux continu :

Si une définition de segment est modifiée de sorte qu’elle ne répond plus aux critères de la segmentation en flux continu, elle passe automatiquement de « Diffusion en flux continu » à « Lots ».

De plus, la disqualification de segment, tout comme la qualification de segment, se produit en temps réel. Par conséquent, si une audience n’est plus admissible pour être un segment, elle sera immédiatement disqualifiée. Par exemple, si la définition de segment demande « Tous les utilisateurs et utilisatrices qui ont acheté des chaussures rouges au cours des trois dernières heures », tous les profils initialement qualifiés pour la définition de segment seront disqualifiés après trois heures.

Combiner les audiences combine-audiences

Pour combiner des données provenant de sources par lots et en flux continu, vous devez séparer les composants par lots et en flux continu en audiences distinctes.

Attribut de profil et événement d’expérience profile-and-event

Par exemple, prenons en compte les deux exemples d’audiences suivants :

Si vous souhaitez utiliser le composant par lot dans votre audience de diffusion en continu, vous devez faire référence à l’audience par lot à l’aide d’un segment de segments.

Voici un exemple d’ensemble de règles qui combine les deux audiences :

inSegment("e3be6d7f-1727-401f-a41e-c296b45f607a") and
CHAIN(xEvent, timestamp, [C0: WHAT(eventType.equals("commerce.checkouts", false))
WHEN(<= 24 hours before now)])

L’audience résultante sera évaluée à l’aide de la segmentation en flux continu, car elle exploite l’appartenance de l’audience par lots en se référant au composant d’audience par lots.

Événements d’expérience multiples two-events

Si vous souhaitez combiner plusieurs audiences avec des données d'événements, vous ne pouvez pas combiner uniquement les événements. Vous devrez créer une audience pour chaque événement, puis en créer une autre qui utilise inSegment pour faire référence à tous les publics.

Par exemple, supposons que vous ayez deux audiences, avec les deux audiences abritant des données de schéma d’événement d’expérience de logement :

Dans ce cas, vous devez créer un troisième public comme suit :

inSegment("7deb246a-49b4-4687-95f9-6316df049948) and inSegment("9e1646bb-57ff-4309-ba59-17d6c5bab6a1")

Créer une audience create-audience

Vous pouvez créer une audience évaluée à l’aide de la segmentation en streaming à l’aide de l’API du service de segmentation ou via le portail d’audience dans l’interface utilisateur.

Une définition de segment peut être activée pour le streaming si elle correspond à l’un des ensembles de règles éligibles.

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"
        }
     }'

{
    "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
}

Récupérer des audiences retrieve-audiences

Vous pouvez récupérer toutes les audiences évaluées à l’aide de la segmentation en flux continu en utilisant l’API Segmentation Service ou en passant par Audience Portal dans l’interface utilisateur.

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}'

{
    "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": {}
}

Détails de l’audience audience-details

Vous pouvez afficher les détails d’une audience spécifique évaluée à l’aide de la segmentation en flux continu en la sélectionnant dans Audience Portal.

Après avoir sélectionné une audience sur Audience Portal, la page des détails de l’audience s’affiche. Elle affiche des informations sur l’audience, notamment un résumé des détails de l’audience, la quantité de profils qualifiés au fil du temps, ainsi que les destinations vers lesquelles l’audience a été activée.

Pour les audiences activées pour la diffusion en continu, la carte Profiles over time s'affiche. Elle indique le nombre total de mesures qualifiées et la nouvelle audience mise à jour.

La mesure Total qualified représente le nombre total d'audiences qualifiées, en fonction des évaluations par lots et en streaming pour cette audience.

La mesure New audience updated est représentée par un graphique linéaire qui montre la modification de la taille de l'audience via la segmentation de la diffusion en continu. Vous pouvez ajuster la liste déroulante pour afficher les 24 dernières heures, la semaine dernière ou les 30 derniers jours.

Pour plus de détails sur le public, veuillez lire la vue d'ensemble du portail Public.

Étapes suivantes

Ce guide explique comment les définitions de segments activées pour la diffusion en continu fonctionnent dans Adobe Experience Platform et comment surveiller les définitions de segments activées pour la diffusion en continu.

Pour en savoir plus sur l’utilisation de l’interface utilisateur d’Adobe Experience Platform, veuillez lire le guide d’utilisation de la segmentation.

Pour consulter la section Segmentation de la diffusion en continu des questions fréquentes sur la segmentation de la diffusion en continu, consultez la rubrique.