Import et utilisation d’audiences externes

IMPORTANT
Cette documentation contient des informations provenant d’une version précédente de la documentation Audiences. Elle est donc obsolète.

Adobe Experience Platform prend en charge la possibilité d’importer une audience externe, qui peut ensuite être utilisée comme composants pour une nouvelle audience. Ce document fournit un tutoriel sur la configuration de l’Experience Platform pour importer et utiliser des audiences externes.

Prise en main

Ce tutoriel nécessite une compréhension pratique des différentes Adobe Experience Platform services impliqués dans la création d’audiences. Avant de commencer ce tutoriel, veuillez consulter la documentation relative aux services suivants :

Audiences et définitions de segment

Avant de commencer à importer et utiliser des audiences externes, il est important de comprendre la différence entre les audiences et les définitions de segment.

Les audiences se rapportent au groupe de profils vers lequel vous essayez de filtrer. Lors de l’utilisation de définitions de segment, vous pouvez créer une audience en créant une définition de segment qui filtre vos profils sur le sous-ensemble qui répond aux critères de qualification du segment.

Les définitions de segment incluent des informations telles que le nom, la description, l’expression (le cas échéant), la date de création, la date de dernière modification et un identifiant. L’ID lie les métadonnées du segment aux profils individuels qui répondent à la qualification du segment et qui font partie de l’audience résultante.

Audiences
Définition de segment
Groupe de profils que vous essayez de trouver. Lorsque vous utilisez des définitions de segment, cela signifie que ce sera le groupe de profils qui répondent à la qualification du segment.
Groupe de règles utilisé pour segmenter l’audience que vous recherchez.

Création d’un espace de noms d’identité pour l’audience externe

La première étape de l’utilisation d’audiences externes consiste à créer un espace de noms d’identité. Les espaces de noms d’identité permettent à Platform d’associer l’origine d’une audience.

Pour créer un espace de noms d’identité, suivez les instructions de la section guide d’espace de noms d’identité. Lors de la création de votre espace de noms d’identité, ajoutez les détails sources à l’espace de noms d’identité et marquez son Type as a Identifiant de non-personne.

L’identifiant de non-personne est mis en surbrillance dans le modal Créer un espace de noms d’identité .

Création d’un schéma pour les métadonnées de segment

Après avoir créé un espace de noms d’identité, vous devez créer un nouveau schéma pour le segment que vous allez créer.

Pour commencer à composer un schéma, sélectionnez d’abord Schémas sur la barre de navigation de gauche, suivie de la fonction Créer un schéma dans le coin supérieur droit de l’espace de travail des schémas. À partir de là, sélectionnez Parcourir pour afficher une sélection complète des types de schémas disponibles.

Les options Créer un schéma et Parcourir sont mises en surbrillance.

Puisque vous créez une définition de segment, qui est une classe prédéfinie, sélectionnez Utiliser la classe existante. Maintenant, sélectionnez le Définition de segment , suivie de Attribuer une classe.

La classe de définition de segment est mise en surbrillance.

Maintenant que votre schéma a été créé, vous devez spécifier le champ qui contiendra l’identifiant du segment. Ce champ doit être marqué comme identité principale et affecté aux espaces de noms que vous avez précédemment créés.

Les cases à cocher permettant de marquer le champ sélectionné comme identité principale sont mises en surbrillance dans l’éditeur de schémas.

Après avoir marqué la variable _id champ comme identité principale, sélectionnez le titre du schéma, suivi du bouton à bascule intitulé Profil. Sélectionner Activer pour activer le schéma pour Real-Time Customer Profile.

La bascule permettant d’activer le schéma pour Profile est mise en surbrillance dans l’éditeur de schémas.

Désormais, ce schéma est activé pour Profile, l’identification principale étant affectée à l’espace de noms d’identité non-personne que vous avez créé. Par conséquent, cela signifie que les métadonnées de segment importées dans Platform à l’aide de ce schéma seront ingérées dans Profile sans être fusionnées avec d’autres données de profil liées aux personnes.

Création d’un jeu de données pour le schéma

Après avoir configuré le schéma, vous devez créer un jeu de données pour les métadonnées de segment.

Pour créer un jeu de données, suivez les instructions de la section guide d’utilisation des jeux de données. Vous devez suivre le Création d’un jeu de données à partir d’un schéma , à l’aide du schéma que vous avez créé précédemment.

Le schéma sur lequel vous souhaitez baser votre jeu de données est mis en surbrillance.

Après avoir créé le jeu de données, continuez à suivre les instructions de la section guide d’utilisation des jeux de données pour activer ce jeu de données pour Real-time Customer Profile.

Le bouton d’activation du schéma pour Profile est mis en surbrillance dans la page d’activité du jeu de données .

Configuration et importation des données d’audience

Une fois le jeu de données activé, les données peuvent désormais être envoyées vers Platform soit par le biais de l’interface utilisateur, soit à l’aide des API Experience Platform. Vous pouvez ingérer ces données par le biais d’une connexion par lots ou en continu.

Ingestion de données à l’aide d’une connexion par lots

Pour créer une connexion par lots, vous pouvez suivre les instructions de la section guide de l’interface utilisateur de chargement de fichier local. Pour obtenir la liste complète des sources disponibles avec lesquelles vous pouvez utiliser l’ingestion de données, veuillez lire le présentation des sources.

Ingestion de données à l’aide d’une connexion en continu

Pour créer une connexion en continu, vous pouvez suivre les instructions de la section Tutoriel sur l’API ou le Tutoriel sur l’interface utilisateur.

Une fois que vous avez créé votre connexion en continu, vous avez accès à votre point de terminaison de diffusion en continu unique auquel vous pouvez envoyer vos données. Pour savoir comment envoyer des données à ces points de terminaison, veuillez lire le tutoriel sur la diffusion en continu de données d’enregistrement.

Le point de terminaison de la connexion en continu est mis en surbrillance dans la page des détails de la source.

Structure des métadonnées d’audience

Après avoir créé une connexion, vous pouvez désormais ingérer vos données vers Platform.

Vous trouverez ci-dessous un exemple des métadonnées de la payload d’audience externe :

{
    "header": {
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "imsOrgId": "{ORG_ID}",
        "datasetId": "{DATASET_ID}",
        "source": {
            "name": "Sample External Audience"
        }
    },
    "body": {
        "xdmMeta": {
            "schemaRef": {
                "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
                "contentType": "application/vnd.adobe.xed-full+json;version=1"
            }
        },
        "xdmEntity": {
            "_id": "{SEGMENT_ID}",
            "description": "Sample description",
            "identityMap": {
                "{IDENTITY_NAMESPACE}": [{
                    "id": "{}"
                }]
            },
            "segmentName" : "{SEGMENT_NAME}",
            "segmentStatus": "ACTIVE",
            "version": "1.0"
        }
    }
}
Propriété
Description
schemaRef
Le schéma must se rapportent au schéma créé précédemment pour les métadonnées du segment.
datasetId
Identifiant du jeu de données must se rapportent au jeu de données créé précédemment pour le schéma que vous venez de créer.
xdmEntity._id
L’ID must se rapportent au même identifiant de segment que celui que vous utilisez comme audience externe.
xdmEntity.identityMap
Cette section must contiennent le libellé d’identité utilisé lors de la création de l’espace de noms créé précédemment.
{IDENTITY_NAMESPACE}
Il s’agit du libellé de l’espace de noms d’identité créé précédemment. Par exemple, si vous appelez votre espace de noms d’identité "externalAudience", vous l’utilisez comme clé du tableau .
segmentName
Nom du segment par lequel vous souhaitez que l’audience externe soit segmentée.

Création de segments à l’aide d’audiences importées

Une fois les audiences importées configurées, elles peuvent être utilisées dans le cadre du processus de segmentation. Pour rechercher des audiences externes, accédez au créateur de segments, puis sélectionnez Audiences dans le Champs .

Le sélecteur d’audiences externes du créateur de segments est mis en surbrillance.

Étapes suivantes

Maintenant que vous pouvez utiliser des audiences externes dans vos segments, vous pouvez utiliser le créateur de segments pour créer des segments. Pour savoir comment créer des segments, veuillez lire le tutoriel sur la création de segments.

Annexe

Outre l’utilisation de métadonnées d’audience externe importées et leur utilisation pour créer des segments, vous pouvez importer des appartenances de segment externes dans Platform.

Configuration d’un schéma de destination d’adhésion à un segment externe

Pour commencer à composer un schéma, sélectionnez d’abord Schémas sur la barre de navigation de gauche, suivie de la fonction Créer un schéma dans le coin supérieur droit de l’espace de travail des schémas. À partir de là, sélectionnez XDM Individual Profile.

La zone XDM Individual Profile est mise en surbrillance.

Maintenant que le schéma a été créé, vous devez ajouter le groupe de champs d’appartenance au segment dans le cadre du schéma. Pour ce faire, sélectionnez Détails de l’adhésion au segment, suivie de Ajouter des groupes de champs.

Le groupe de champs Détails de l’appartenance au segment est mis en surbrillance.

De plus, assurez-vous que le schéma est marqué pour Profil. Pour ce faire, vous devez marquer un champ comme identité principale.

La bascule permettant d’activer le schéma pour Profile est mise en surbrillance dans l’éditeur de schémas.

Configuration du jeu de données

Après avoir créé votre schéma, vous devez créer un jeu de données.

Pour créer un jeu de données, suivez les instructions de la section guide d’utilisation des jeux de données. Vous devez suivre le Création d’un jeu de données à partir d’un schéma , à l’aide du schéma que vous avez créé précédemment.

Le schéma que vous utilisez pour créer la base de données est mis en surbrillance.

Après avoir créé le jeu de données, continuez à suivre les instructions de la section guide d’utilisation des jeux de données pour activer ce jeu de données pour Real-time Customer Profile.

Le bouton d’activation du schéma pour Profile est mis en surbrillance dans le workflow de création de jeux de données .

Configurer et importer des données d’appartenance à une audience externe

Une fois le jeu de données activé, les données peuvent désormais être envoyées vers Platform soit par le biais de l’interface utilisateur, soit à l’aide des API Experience Platform. Vous pouvez ingérer ces données par le biais d’une connexion par lots ou en continu.

Ingestion de données à l’aide d’une connexion par lots

Pour créer une connexion par lots, vous pouvez suivre les instructions de la section guide de l’interface utilisateur de chargement de fichier local. Pour obtenir la liste complète des sources disponibles avec lesquelles vous pouvez utiliser l’ingestion de données, veuillez lire le présentation des sources.

Ingestion de données à l’aide d’une connexion en continu

Pour créer une connexion en continu, vous pouvez suivre les instructions de la section Tutoriel sur l’API ou le Tutoriel sur l’interface utilisateur.

Une fois que vous avez créé votre connexion en continu, vous avez accès à votre point de terminaison de diffusion en continu unique auquel vous pouvez envoyer vos données. Pour savoir comment envoyer des données à ces points de terminaison, veuillez lire le tutoriel sur la diffusion en continu de données d’enregistrement.

Le point de terminaison de la connexion en continu est mis en surbrillance dans la page des détails de la source.

Structure de l’adhésion au segment

Après avoir créé une connexion, vous pouvez désormais ingérer vos données vers Platform.

Vous trouverez ci-dessous un exemple de payload de l’appartenance à une audience externe :

{
    "header": {
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
            "contentType": "application/vnd.adobe.xed-full+json;version=1"
        },
        "imsOrgId": "{ORG_ID}",
        "datasetId": "{DATASET_ID}",
        "source": {
            "name": "Sample External Audience Membership"
        }
    },
    "body": {
        "xdmMeta": {
            "schemaRef": {
                "id": "https://ns.adobe.com/{TENANT_ID}/schemas/{SCHEMA_ID}",
                "contentType": "application/vnd.adobe.xed-full+json;version=1"
            }
        },
        "xdmEntity": {
            "_id": "{UNIQUE_ID}",
            "description": "Sample description",
            "{TENANT_NAME}": {
                "identities": {
                    "{SCHEMA_IDENTITY}": "sample-id"
                }
            },
            "personId" : "sample-name",
            "segmentMembership": {
                "{IDENTITY_NAMESPACE}": {
                    "{EXTERNAL_IDENTITY}": {
                        "status": "realized",
                        "lastQualificationTime": "2022-03-14T:00:00:00Z"
                    }
                }
            }
        }
    }
}
Propriété
Description
schemaRef
Le schéma must reportez-vous au schéma créé précédemment pour les données d’adhésion au segment.
datasetId
Identifiant du jeu de données must reportez-vous au jeu de données créé précédemment pour le schéma d’adhésion que vous venez de créer.
xdmEntity._id
Identifiant approprié utilisé pour identifier de manière unique l’enregistrement dans le jeu de données.
{TENANT_NAME}.identities
Cette section est utilisée pour connecter le groupe de champs des identités personnalisées aux utilisateurs que vous avez précédemment importés.
segmentMembership.{IDENTITY_NAMESPACE}
Il s’agit du libellé de l’espace de noms d’identité personnalisée créé précédemment. Par exemple, si vous appelez votre espace de noms d’identité "externalAudience", vous l’utilisez comme clé du tableau .
NOTE
Par défaut, les appartenances à une audience externe sont supprimées au bout de 30 jours. Pour empêcher la suppression et la conserver pendant plus de 30 jours, utilisez la variable validUntil lors de l’ingestion de vos données d’audience. Pour plus d'informations sur ce champ, veuillez lire le guide sur Groupes de champs de schéma Détails de l’appartenance aux segments.
recommendation-more-help
770bc05d-534a-48a7-9f07-017ec1e14871