Import et utilisation d’audiences externes

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.

Commencer

Ce tutoriel nécessite une compréhension pratique des différents services Adobe Experience Platform 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.

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 du guide sur l’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 comme identifiant d’une personne autre que l’autre.

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 tout d’abord Schémas dans la barre de navigation de gauche, puis 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.

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

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.

Après avoir marqué le champ _id comme identité principale, sélectionnez le titre du schéma, suivi du bouton d’activation/désactivation Profile. Sélectionnez Activer pour activer le schéma pour Real-Time Customer Profile.

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 du guide d’utilisation du jeu de données. Vous devez suivre l’option Créer un jeu de données à partir du schéma , à l’aide du schéma que vous avez créé précédemment.

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

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 du guide d’interface utilisateur de téléchargement de fichier local générique. Pour obtenir la liste complète des sources disponibles avec lesquelles vous pouvez utiliser les données d’ingestion, veuillez lire la 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 du tutoriel sur l’API ou du 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, consultez le tutoriel sur la diffusion en continu de données d’enregistrement.

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

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 l’onglet Audiences dans la section Champs .

É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, consultez 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 tout d’abord Schémas dans la barre de navigation de gauche, puis 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.

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 Segment Membership Details, suivi de Ajouter des groupes de champs.

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

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 du guide d’utilisation du jeu de données. Vous devez suivre l’option Créer un jeu de données à partir du schéma , à l’aide du schéma que vous avez créé précédemment.

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

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 du guide d’interface utilisateur de téléchargement de fichier local générique. Pour obtenir la liste complète des sources disponibles avec lesquelles vous pouvez utiliser les données d’ingestion, veuillez lire la 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 du tutoriel sur l’API ou du 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, consultez le tutoriel sur la diffusion en continu de données d’enregistrement.

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