Guide d’évaluation d’audience flexible

AVAILABILITY
L’évaluation flexible des audiences est uniquement disponible sur les instances d’Experience Platform s’exécutant sur Microsoft Azure. Pour en savoir plus sur l’infrastructure Experience Platform prise en charge, consultez la présentation multi-cloud d’Experience Platform.
En outre, l’évaluation d’audience flexible est uniquement disponible avec Real-Time CDP B2C Edition.

L’évaluation d’audience flexible vous permet d’exécuter une tâche de segmentation par lots à la demande. Grâce à une évaluation d’audience flexible, vous pouvez exécuter des lancements de campagne ad hoc, des communications juste à temps ou d’autres activités sensibles au facteur temps.

Mécanismes de sécurisation guardrails

Lorsque vous exécutez l’évaluation d’audience flexible, gardez à l’esprit les conditions suivantes :

  • Vous pouvez uniquement utiliser l’évaluation d’audience flexible deux fois par jour et par sandbox. Cette limite est réinitialisée à minuit (UTC).
  • Vous disposez d’un maximum de 50 exécutions d’évaluation d’audience flexibles par an par sandbox de production.
  • Vous disposez d’un maximum de 100 exécutions d’évaluation d’audience flexibles par an par sandbox de développement.
  • Toutes les audiences doivent ont une origine de « Segmentation Service ».
  • Toutes les audiences doivent doivent être évaluées à l’aide de la segmentation par lots.
  • Toutes les audiences doivent doivent être basées sur les personnes.
  • Vous pouvez uniquement sélectionner un maximum de 20 audiences par exécution d’évaluation d’audience flexible.
NOTE
Vous pouvez acheter des exécutions d’évaluation d’audience flexibles supplémentaires par an. Pour plus d’informations, contactez l’Assistance clientèle d’Adobe.

Accès access

Pour utiliser l’évaluation d’audience flexible, vous devez disposer des autorisations suivantes :

  • Évaluer le segment par rapport à une audience sous la section Profile Management .

Pour plus d’informations sur le contrôle d’accès en fonction du rôle, consultez la présentation du contrôle d’accès.

Exécution de l’évaluation d’audience flexible

Vous pouvez exécuter une évaluation d’audience flexible à l’aide des API ou de l’interface utilisateur d’Experience Platform.

API Experience Platform

Pour exécuter une évaluation d’audience flexible dans les API Experience Platform, vous devez créer une tâche de segmentation contenant les identifiants de toutes les définitions de segment (audiences) que vous souhaitez évaluer.

note note
NOTE
Vous pouvez uniquement ajouter un maximum de 20 identifiants de définition de segment par appel API de tâche de segmentation.

Vous pouvez créer une tâche de segmentation en adressant une requête POST au point d’entrée /segment/jobs et en incluant les identifiants des définitions de segment dans le corps de la requête.

accordion
Exemple de requête pour créer une tâche de segmentation
code language-shell
curl -X POST https://platform.adobe.io/data/core/ups/segment/jobs \
 -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 '[
    {
        "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e"
    },
    {
        "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85"
    }
 ]'
table 0-row-2 1-row-2
Propriété Description
segmentId Identifiant de la définition de segment que vous souhaitez évaluer. Ces définitions de segment peuvent appartenir à différentes politiques de fusion.

Une réponse réussie renvoie un état HTTP 200 avec des informations sur la tâche de segmentation que vous venez de créer.

accordion
Exemple de réponse lors de la création d’une tâche de segmentation.
code language-json
{
    "id": "b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "profileInstanceId": "ups",
    "source": "api",
    "status": "PROCESSING",
    "batchId": "678f53bc-e21d-4c47-a7ec-5ad0064f8e4c",
    "computeJobId": 8811,
    "computeGatewayJobId": "9ea97b25-a0f5-410e-ae87-b2d85e58f399",
    "segments": [
        {
            "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e",
            "segment": {
                "id": "7863c010-e092-41c8-ae5e-9e533186752e",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        },
        {
            "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85",
            "segment": {
                "id": "07d39471-05d1-4083-a310-d96978fd7c85",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        }
    ],
    "metrics": {
        "totalTime": {
            "startTimeInMs": 1573203617195,
            "endTimeInMs": 1573204395655,
            "totalTimeInMs": 778460
        },
        "profileSegmentationTime": {
            "startTimeInMs": 1573204266727,
            "endTimeInMs": 1573204395655,
            "totalTimeInMs": 128928
        },
        "segmentedProfileCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":1033
        },
        "segmentedProfileByNamespaceCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":{
                "tenantiduserobjid":1033,
                "campaign_profile_mscom_mkt_prod2":1033
            }
        },
        "segmentedProfileByStatusCounter":{
            "7863c010-e092-41c8-ae5e-9e533186752e":{
                "exited":144646,
                "realized":2056
            }
        },
        "totalProfiles":13146432,
        "totalProfilesByMergePolicy":{
            "25c548a0-ca7f-4dcd-81d5-997642f178b9":13146432
        }
    },
    "requestId": "4e538382-dbd8-449e-988a-4ac639ebe72b-1573203600264",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "properties": {
        "scheduleId": "4e538382-dbd8-449e-988a-4ac639ebe72b",
        "runId": "e6c1308d-0d4b-4246-b2eb-43697b50a149"
    },
    "_links": {
        "cancel": {
            "href": "/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
            "method": "DELETE"
        },
        "checkStatus": {
            "href": "/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
            "method": "GET"
        }
    },
    "updateTime": 1573204395000,
    "creationTime": 1573203600535,
    "updateEpoch": 1573204395
}

Après avoir créé la tâche de segmentation, vous pouvez vérifier son statut en adressant une requête GET au point d’entrée /segment/jobs, en fournissant l’identifiant de votre nouvelle tâche de segmentation dans le chemin d’accès de la requête.

accordion
Exemple de requête pour récupérer une tâche de segmentation
code language-shell
curl -X GET https://platform.adobe.io/data/core/ups/segment/jobs/b31aed3d-b3b1-4613-98c6-7d3846e8d48f \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'

Une réponse réussie renvoie un état HTTP 200 avec des informations détaillées sur la tâche de segmentation spécifiée.

accordion
Exemple de réponse pour récupérer une tâche de segmentation.
code language-json
{
    "id": "b31aed3d-b3b1-4613-98c6-7d3846e8d48f",
    "imsOrgId": "{ORG_ID}",
    "sandbox": {
        "sandboxId": "28e74200-e3de-11e9-8f5d-7f27416c5f0d",
        "sandboxName": "prod",
        "type": "production",
        "default": true
    },
    "profileInstanceId": "ups",
    "source": "api",
    "status": "SUCCEEDED",
    "batchId": "678f53bc-e21d-4c47-a7ec-5ad0064f8e4c",
    "computeJobId": 8811,
    "computeGatewayJobId": "9ea97b25-a0f5-410e-ae87-b2d85e58f399",
    "segments": [
        {
            "segmentId": "7863c010-e092-41c8-ae5e-9e533186752e",
            "segment": {
                "id": "7863c010-e092-41c8-ae5e-9e533186752e",
                "expression": {
                    "type": "PQL",
                    "format": "pql/text",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        },
        {
            "segmentId": "07d39471-05d1-4083-a310-d96978fd7c85",
            "segment": {
                "id": "07d39471-05d1-4083-a310-d96978fd7c85",
                "expression": {
                    "type": "PQL",
                    "format": "pql/json",
                    "value": "workAddress.country = \"US\""
                },
                "mergePolicyId": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                "mergePolicy": {
                    "id": "25c548a0-ca7f-4dcd-81d5-997642f178b9",
                    "version": 1
                }
            }
        }
    ],
    "metrics": {
        "totalTime": {
            "startTimeInMs": 1579304313411
        },
        "profileSegmentationTime": {}
    },
    "requestId": "4e538382-dbd8-449e-988a-4ac639ebe72b-1573203600264",
    "schema": {
        "name": "_xdm.context.profile"
    },
    "_links": {
        "cancel": {
            "href": "/segment/jobs/d3b4a50d-dfea-43eb-9fca-557ea53771fd",
            "method": "DELETE"
        },
        "checkStatus": {
            "href": "/segment/jobs/d3b4a50d-dfea-43eb-9fca-557ea53771fd",
            "method": "GET"
        }
    },
    "updateTime": 1579304339000,
    "creationTime": 1579304260897,
    "updateEpoch": 1579304339
}
Interface utilisateur Experience Platform

Pour exécuter une évaluation d’audience flexible dans l’interface utilisateur d’Experience Platform, sélectionnez Audiences dans la section Clients.

Le bouton Audiences de la section Clients est mis en surbrillance. Audience Portal pour les profils client s’affiche.

Le Portail d’audiences s’affiche, affichant une liste de toutes les audiences de personnes pour l’organisation. Dans Audience Portal, vous pouvez choisir les audiences à évaluer et sélectionner Évaluer l’audience.

Les audiences pour lesquelles vous souhaitez utiliser l’évaluation d’audience flexible sont sélectionnées.

La fenêtre contextuelle Évaluer les audiences à la demande s’affiche. Elle répertorie les audiences qui seront évaluées avec la tâche de segmentation à la demande. Si une audience ne peut pas être évaluée à la demande, elle sera automatiquement supprimée de la tâche d’évaluation. Vérifiez que les audiences répertoriées sont celles que vous souhaitez évaluer.

Les audiences qui peuvent être évaluées à l’aide de l’évaluation d’audience flexible s’affichent.

Une fois les audiences correctes répertoriées, vous pouvez poursuivre la requête et l’évaluation d’audience flexible commencera. Vous pouvez consulter le statut de cette évaluation d’audience dans la vue suivi des tâches d’évaluation.

note note
NOTE
Le statut de la tâche de segmentation peut être indiqué comme dans l’état « En file d’attente » dans le tableau de bord de surveillance. Vous pouvez afficher l’état le plus à jour de la tâche de segmentation en adressant une requête GET au point d’entrée /segment/jobs, en fournissant l’identifiant de la tâche de segmentation dans le chemin d’accès de la requête. Vous trouverez plus d’informations sur l’utilisation de ce point d’entrée dans l’onglet API .
Si vous exécutez l’évaluation d’audience flexible et souhaitez qu’elle active l’audience vers une destination, vous devez vous assurer que la fréquence est définie sur Après l’évaluation du segment. L’exécution de l’évaluation d’audience flexible sur des audiences déjà définies pour être activées après l’évaluation des segments active les audiences dès que la tâche d’évaluation d’audience flexible se termine, indépendamment des tâches d’activation quotidiennes précédentes.

Vidéo video

La vidéo suivante montre comment accéder à l’évaluation d’audience flexible et l’utiliser dans Experience Platform.

Questions fréquentes faq

La section suivante répertorie les questions fréquentes relatives à l’évaluation flexible des audiences.

Quand puis-je activer une audience à l’aide de l’évaluation d’audience flexible ?

Réponse
Vous pouvez activer une audience à l’aide de l’évaluation d’audience flexible immédiatement après sa création.

Combien de temps dure l’évaluation d’audience flexible ?

Réponse
Un traitement d’évaluation d’audience flexible peut prendre jusqu’à quatre heures.

Puis-je exécuter la planification avec une évaluation d’audience flexible ?

Réponse
Non, la planification n’est pas disponible pour une évaluation d’audience flexible.

Dois-je exécuter une tâche d’exportation supplémentaire lors de l’utilisation de l’évaluation d’audience flexible ?

Réponse
Non, la tâche d’exportation est automatiquement exécutée une fois la tâche de segmentation correspondante terminée.

Quels services puis-je utiliser pour les audiences évaluées avec l’évaluation d’audience flexible ?

Réponse
Vous pouvez utiliser des audiences dans tous les services en aval, y compris les destinations et les parcours Adobe Journey Optimizer.

Quand les limites d’évaluation d’audience flexibles sont-elles réinitialisées ?

Réponse
La limite quotidienne est réinitialisée à minuit (UTC). La limite annuelle est réinitialisée à la date anniversaire de votre contrat.

Quels types d’audiences sont pris en charge avec l’évaluation d’audience flexible ?

Réponse
Seules les audiences ayant l’origine Segmentation Service sont prises en charge pour une évaluation d’audience flexible. D’autres audiences, telles que les compositions, le chargement personnalisé ou la Distiller de données, ne sont pas prises en charge pour l’évaluation d’audience flexible.

Quelles exécutions contribuent au nombre d’exécutions d’évaluation d’audience flexible ?

Réponse
Les exécutions d’évaluation d’audience flexibles créées à l’aide de l’API ou de l’interface utilisateur sont comptabilisées jusqu’à la limite maximale. Cependant, l’exécution quotidienne de la tâche de segmentation par lots qui s’exécute de nuit ne contribue pas à cette limite.

Dois-je évaluer toutes les audiences dépendantes lors de l’évaluation de l’audience principale avec une évaluation d’audience flexible ?

Réponse
Non. L’évaluation d’audience flexible évalue automatiquement toutes les audiences dépendantes. Par exemple, si l’audience A dépend de l’audience B, vous n’avez qu’à évaluer l’audience B. L’évaluation d’audience flexible évaluera automatiquement l’audience A, puis l’audience B.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871