Comportement d’exportation de profils selon les types de destinations
Il existe plusieurs types de destinations dans Experience Platform, comme illustré dans le diagramme ci-dessous. Ces destinations ont des schémas d’exportation légèrement différents en ce qui concerne les éléments qui déclenchent une exportation de destination et ce qui est inclus dans une exportation, comme décrit dans les sections ci-dessous.
Agrégation des messages dans les destinations de diffusion en continu
Avant de passer à des informations spécifiques par type de destination, il est important de comprendre le concept d’agrégation des messages pour destinations de diffusion en continu.
Les destinations Experience Platform exportent les données vers des intégrations basées sur les API sous la forme d’appels HTTPS. Une fois que le service de destinations est informé par d’autres services en amont que les profils ont été mis à jour suite à l’ingestion par lots, à l’ingestion par streaming, à la segmentation par lots, à la segmentation par streaming ou aux modifications des graphiques d’identité, les données sont exportées et envoyées vers les destinations de streaming.
Les profils sont agrégés en messages HTTPS avant d’être envoyés aux points de terminaison de l’API de destination.
Prenez par exemple la destination Facebook avec une politique d’agrégation configurable. Dans ce cas, les données sont envoyées de manière agrégée, où le service de destinations récupère toutes les données entrantes du service de profil en amont et les agrège par l’une des méthodes suivantes, avant de les distribuer à Facebook :
- Nombre d’enregistrements (maximum 10 000) ou
- Intervalle de la fenêtre temporelle (300 secondes)
Les seuils ci-dessus qui sont les premiers atteints déclenchent une exportation vers Facebook. Ainsi, dans le tableau de bord Facebook Custom Audiences, vous pouvez voir des audiences provenant d’Experience Platform par incréments de 10 000 enregistrements. Vous pouvez voir 10 000 enregistrements toutes les 2 à 3 minutes, car les données sont traitées et agrégées plus rapidement que l’intervalle d’exportation de 300 secondes, et sont envoyées plus rapidement, soit environ toutes les 2 à 3 minutes jusqu’à ce que tous les enregistrements aient été traités. S’il n’y a pas suffisamment d’enregistrements pour constituer un lot de 10 000, le nombre d’enregistrements actuels est envoyé tel quel lorsque le seuil de la fenêtre de délai est atteint, de sorte que vous pouvez également voir des lots plus petits envoyés à Facebook.
Prenons un autre exemple, la destination de l’API HTTP, qui a une politique d’agrégation de meilleurs effots, avec maxUsersPerRequest: 10. Cela signifie qu’un maximum de dix profils seront agrégés avant qu’un appel HTTP ne soit déclenché vers cette destination, mais Experience Platform tente d’envoyer des profils vers la destination dès que le service de destinations reçoit des informations de réévaluation mises à jour d’un service en amont.
La politique d’agrégation est configurable et les développeurs de destination peuvent décider comment la configurer pour respecter au mieux les limites de taux des points d’entrée de l’API en aval. Obtenez des informations supplémentaires sur la politique d’agrégation dans la documentation de Destination SDK.
Destinations d’exportation de profils de streaming (entreprise) streaming-profile-destinations
Les destinations d’entreprise dans Experience Platform sont Amazon Kinesis, Azure Event Hubs et l’API HTTP.
Experience Platform optimise le comportement d’export de profils vers votre destination d’entreprise afin d’exporter uniquement des données vers le point d’entrée de votre API lorsque des mises à jour pertinentes d’un profil ont eu lieu suite à l’éligibilité d’une audience ou à d’autres événements importants. Les profils sont exportés vers votre destination dans les situations suivantes :
- La mise à jour du profil a été déterminée par une modification de l’appartenance à une audience pour au moins une des audiences mappées à la destination. Par exemple, le profil est éligible à l’une des audiences mappées à la destination ou a quitté l’une de ces audiences.
- La mise à jour du profil a été déterminée par une modification dans le mappage d’identités. Par exemple, une nouvelle identité a été ajoutée dans l’attribut de mappage d’identités à un profil qui était déjà éligible à l’une des audiences mappées à la destination.
- La mise à jour du profil a été déterminée par une modification des attributs pour au moins un des attributs mappés à la destination. Par exemple, l’un des attributs mappés à la destination dans l’étape de mappage est ajouté à un profil.
Dans tous les cas décrits ci-dessus, seuls les profils pour lesquels des mises à jour pertinentes se sont produites sont exportés vers votre destination. Par exemple, si une audience mappée au flux de destination comporte cent membres et que cinq nouveaux profils sont éligibles à ce segment, l’exportation vers votre destination est incrémentielle et inclut uniquement les cinq nouveaux profils.
Notez que tous les attributs mappés sont exportés pour un profil, quel que soit l’emplacement des modifications. Ainsi, dans l’exemple ci-dessus, tous les attributs mappés pour ces cinq nouveaux profils seront exportés même si les attributs eux-mêmes restent inchangés.
Ce qui détermine une exportation de données et ce qui est inclus dans l’exportation.
Concernant les données exportées pour un profil donné, il est important de comprendre les deux concepts différents entre ce qui détermine l’exportation de données vers votre destination d’entreprise et quelles données sont incluses dans l’exportation.
- Les attributs et audiences mappés servent de repère pour un export de destination. Cela signifie que si une audience mappée change d’état (de
nullàrealizedou derealizedàexiting) ou qu’un attribut mappé est mis à jour, une destination est exportée. - Comme les identités ne peuvent actuellement pas être mappées aux destinations d’entreprise, les modifications d’identité sur un profil donné déterminent également les exportations de destination.
- Toute modification pour un attribut est considérée comme une mise à jour, qu’il s’agisse ou non de la même valeur. Cela signifie qu’une réécriture sur un attribut est considérée comme une modification, même si la valeur elle-même n’a pas changé.
- L’objet
segmentMembershipinclut l’audience mappée dans le flux de données d’activation, pour lequel le statut du profil a changé suite à un événement d’éligibilité ou de sortie d’audience. Notez que d’autres audiences non mappées pour lesquelles le profil est éligible peuvent faire partie de l’export de destination, si ces audiences appartiennent à la même politique de fusion que l’audience mappée dans le flux de données d’activation. - Toutes les identités dans l’objet
identityMapsont également incluses (Experience Platform ne prend actuellement pas en charge le mappage d’identités dans la destination d’entreprise). - Seuls les attributs mappés sont inclus dans l’exportation de destination.
Prenons l’exemple d’un flux de données vers une destination HTTP dans lequel trois audiences sont sélectionnées et quatre attributs sont mappés à la destination.
Une exportation de profil vers la destination peut être déterminée par un profil éligible ou sortant de l’un des trois segments mappés. Toutefois, au cours de l’exportation des données, dans l’objet segmentMembership, d’autres audiences non mappées peuvent apparaître si ce profil spécifique en est membre et s’ils partagent la même politique de fusion que l’audience qui a déclenché l’exportation. Si un profil est qualifié pour l’audience Client ou cliente avec des voitures DeLorean, mais qu’il est également membre des segments Film « Retour vers le futur » visionné et Fans de science-fiction, alors ces deux autres audiences seront aussi présentes dans l’objet segmentMembership de l’exportation des données, même si elles ne sont pas mappées dans le flux de données, si celles-ci partagent la même politique de fusion que le segment Client ou cliente avec des voitures DeLorean.
Du point de vue des attributs de profil, toute modification apportée aux quatre attributs mappés ci-dessus déterminera une exportation de destination et chacun de ces quatre attributs mappés et présents sur le profil sera présent dans l’exportation des données.
Destinations basées sur les API de streaming streaming-api-based-destinations
Le comportement d’exportation des profils pour les destinations de streaming telles que Facebook, Trade Desk et d’autres intégrations basées sur les API est très similaire au comportement décrit ci-dessus pour les destinations d’entreprise.
Les destinations appartenant aux catégories sociales et publicitaires du catalogue sont des exemples de destinations de streaming.
Experience Platform optimise le comportement d’exportation des profils vers votre destination de streaming afin d’exporter les données vers les destinations basées sur les API de streaming uniquement quand des mises à jour importantes d’un profil se sont produites à la suite d’une qualification d’audience ou d’autres événements significatifs. Les profils sont exportés vers votre destination dans les situations suivantes :
- La mise à jour du profil a été déterminée par une modification de l’appartenance à une audience pour au moins une des audiences mappées à la destination. Par exemple, le profil est éligible à l’une des audiences mappées à la destination ou a quitté l’une de ces audiences.
- La mise à jour du profil a été déterminée par une modification du mappage d’identités pour un espace de noms d’identité marqué pour l’exportation pour cette instance de destination. Par exemple, une nouvelle identité a été ajoutée dans l’attribut de mappage d’identités à un profil qui était déjà éligible à l’une des audiences mappées à la destination.
- La mise à jour du profil a été déterminée par une modification des attributs pour au moins un des attributs mappés à la destination. Par exemple, l’un des attributs mappés à la destination dans l’étape de mappage est ajouté à un profil.
- Modifications du consentement pour un profil lorsque l’application automatisée du consentement est configurée et qu’un profil choisit de s’y opposer. L’application automatisée du consentement envoie un événement de sortie d’audience à la destination, afin que le profil ne soit inclus dans aucun ciblage à la destination.
Dans tous les cas décrits ci-dessus, seuls les profils pour lesquels des mises à jour pertinentes se sont produites sont exportés vers votre destination. Par exemple, si une audience mappée au flux de destination comporte cent membres et que cinq nouveaux profils sont éligibles à ce segment, l’exportation vers votre destination est incrémentielle et inclut uniquement les cinq nouveaux profils.
Notez que tous les attributs mappés sont exportés pour un profil, quel que soit l’emplacement des modifications. Ainsi, dans l’exemple ci-dessus, tous les attributs mappés pour ces cinq nouveaux profils seront exportés même si les attributs eux-mêmes restent inchangés.
Ce qui détermine une exportation de données et ce qui est inclus dans l’exportation.
Concernant les données exportées pour un profil donné, il est important de comprendre les deux concepts différents entre ce qui détermine l’exportation de données vers votre destination d’API de streaming et les données incluses dans l’exportation.
- Les attributs et audiences mappés servent de repère pour un export de destination. Cela signifie que si une audience mappée change de statut (de
nullàrealizedou derealizedàexiting) ou qu’un attribut mappé est mis à jour, une destination est exportée. - La modification du mappage d’identités correspond à une identité ajoutée/supprimée pour le graphique d’identités du profil, pour les espaces de noms d’identité mappés pour l’exportation.
- La modification d’un attribut correspond à toute mise à jour de l’attribut, pour les attributs mappés à la destination.
- Les audiences qui sont mappées à la destination et qui ont été modifiées seront incluses dans l’objet
segmentMembership. Dans certains scénarios, ils peuvent être exportés à l’aide de plusieurs appels. En outre, dans certains scénarios, certaines audiences qui n’ont pas été modifiées peuvent également être incluses dans l’appel. Dans tous les cas, seules les audiences mappées sont exportées. - Toutes les identités des espaces de noms qui sont mappés à la destination dans l’objet
identityMapsont également inclus. - Seuls les attributs mappés sont inclus dans l’exportation de destination.
Prenons l’exemple de ce flux de données vers une destination de streaming où trois audiences sont sélectionnées dans le flux de données.
Une exportation de profil vers la destination peut être déterminée par un profil éligible ou sortant de l’un des trois segments mappés. Si un profil est qualifié pour le segment Client avec des voitures DeLorean, cela déclenche une exportation. Les autres audiences (Ville - Dallas et Site de base actif) pourraient également être exportées si l’audience est présente dans le profil avec l’un des statuts possibles (realized ou exited). Les audiences non mappées (comme Fans de science-fiction) ne sont pas exportées.
Du point de vue des attributs de profil, toute modification des trois attributs mappés ci-dessus déterminera une exportation de destination.
Destinations de lot (basées sur des fichiers) file-based-destinations
Lors de l’exportation de profils vers des destinations basées sur des fichiers dans Experience Platform, vous pouvez utiliser trois types de plannings (répertoriés ci-dessous) et deux options d’exportation de fichiers (fichiers complets ou incrémentiels). Tous ces paramètres sont définis au niveau de l’audience, même lorsque plusieurs audiences sont mappées à un seul flux de données de destination.
- Exports planifiés : configurez une destination, ajoutez un ou plusieurs segments, puis choisissez si vous souhaitez exporter des fichiers complets ou incrémentiels. Sélectionnez ensuite une heure précise chaque jour ou plusieurs fois par jour à laquelle les fichiers doivent être exportés. Par exemple, une heure d’export de 17 heures signifie que les profils qualifiés pour l’audience seront exportés à 17 heures.
- Après l’évaluation du segment : l’export est déclenché immédiatement après l’exécution du traitement d’évaluation d’audience quotidien. Cela signifie que les numéros de profil exportés dans le fichier sont aussi proches que possible de la dernière population évaluée du segment.
- Exports à la demande (exporter le fichier maintenant) : en fonction du dernier traitement d’évaluation d’audience, un fichier complet est exporté une fois, en plus des exports régulièrement planifiés.
Dans l’une des situations d’exportation ci-dessus, les fichiers exportés incluent les profils qualifiés pour l’exportation, ainsi que les colonnes que vous avez sélectionnées en tant qu’attributs XDM pour l’exportation.
Exportations de fichiers incrémentiels incremental-file-exports
Toutes les mises à jour d’un profil n’entraînent pas l’inclusion de celui-ci dans les exportations de fichiers incrémentiels. Par exemple, si un attribut a été ajouté à un profil ou supprimé de celui-ci, le profil n’est pas inclus dans l’exportation. Seuls les profils pour lesquels l’attribut segmentMembership a changé seront inclus dans les fichiers exportés. En d’autres termes, ce n’est que si le profil fait partie de l’audience ou est supprimé de celle-ci qu’il est inclus dans les exports de fichiers incrémentiels.
De même, si une nouvelle identité (nouvelle adresse e-mail, nouveau numéro de téléphone, nouvel ECID, etc.) est ajoutée à un profil dans le graphique d’identité, cela ne représente pas une raison d’inclure le profil dans une nouvelle exportation de fichiers incrémentiels.
Si une nouvelle audience est ajoutée à un mappage de destination, cela n’a aucune incidence sur les qualifications et les exportations d’un autre segment. Les plannings d’export sont configurés individuellement par audience et les fichiers sont exportés séparément pour chaque segment, même si les audiences ont été ajoutées au même flux de données de destination.
Par exemple, dans le paramètre d’export illustré ci-dessous, dans lequel une audience exporte des mises à jour de fichiers incrémentiels, notez les circonstances suivantes selon lesquelles un profil est inclus ou non dans un export de fichiers incrémentiels :
- Un profil est inclus dans une exportation de fichiers incrémentiels qu’il remplisse ou pas les critères pour le segment.
- Un profil n’est pas inclus dans une exportation de fichiers incrémentiels lorsqu’un nouveau numéro de téléphone est ajouté au graphique d’identité.
- Un profil n’est pas inclus dans une exportation de fichiers incrémentiels lorsque la valeur de l’un des champs XDM mappés, comme
xdm: loyalty.points,xdm: loyalty.tier,xdm: personalEmail.addressest mise à jour sur un profil. - Lorsque le champ XDM
segmentMembership.statusest mappé dans le workflow d’activation de destination, les profils qui sortent de l’audience sont également inclus dans les fichiers incrémentiels exportés, avec un statutexited.
Ce qui détermine une exportation de données et ce qui est inclus dans l’exportation.
Selon les informations de la section ci-dessus, le comportement d’exportation de profils vers les destinations basées sur des fichiers peut être résumé comme suit :
Exportations de fichiers complets
La totalité de la population active de l’audience est exportée tous les jours.
- Le planning d’exportation défini dans l’interface utilisateur ou l’API et l’action de l’utilisateur (qui sélectionne Exporter le fichier maintenant dans l’IU ou qui utilise l’API d’activation ad hoc) déterminent le début d’une exportation de destinations.
Exportations de fichiers incrémentiels
Dans le premier export de fichiers, après avoir configuré le workflow d’activation, la population intégrale de l’audience est exportée. Lors des exportations suivantes, seuls les profils modifiés sont exportés.
- Le planning d’exportation défini dans l’interface utilisateur ou l’API détermine le début d’une exportation de destination.
- Toute modification de l’appartenance à une audience d’un profil, qu’elle remplisse les critères pour le segment ou non, rend un profil éligible à l’inclusion dans les exports incrémentiels. Les modifications des attributs ou des mappages d’identités d’un profil ne qualifient pas un profil pour qu’il soit inclus dans les exportations incrémentielles.
Les profils pour lesquels l’appartenance à une audience a changé, ainsi que les informations les plus récentes pour chaque attribut XDM sélectionné pour l’export.
Les profils à l’état de sortie sont inclus dans les exportations de destination si le champ XDM segmentMembership.status est sélectionné à l’étape de mappage.
Étapes suivantes next-steps
Après avoir lu ce document, vous savez maintenant à quoi vous attendre dans les exportations de profils vers des destinations en flux continu, d’entreprise et basées sur des fichiers.
Vous pouvez ensuite découvrir comment les identités sont gérées dans le workflow d’activation.