Prise en main pour les développeurs get-started-developers
En tant que développeur ou développeuse, vous êtes responsable de la mise en œuvre et de l’intégration d’Adobe Journey Optimizer dans vos applications et systèmes. Vous pouvez commencer à utiliser Adobe Journey Optimizer une fois que l’administrateur ou administratrice système et l’ingénieur ou ingénieure de données vous ont accordé l’accès et ont préparé votre environnement.
Votre rôle dans l’écosystème Journey Optimizer
Tandis les autres membres de l’équipe configurent Journey Optimizer par le biais de l’interface d’utilisation, vous pouvez vous concentrer sur les éléments suivants :
- Implémentation de SDK dans des applications mobiles et web
- Envoi d’événements à partir de vos applications pour déclencher des parcours
- Création de points d’entrée d’API que Journey Optimizer peut appeler via des actions personnalisées
- Intégration de Journey Optimizer à vos systèmes et infrastructures existants
- Test et débogage de vos implémentations
Votre ingénieur ou ingénieure de données s’occupe des schémas de données, des configurations d’événement et des sources de données. Votre administrateur ou administratrice configure les autorisations et les configurations de canaux. Les responsables marketing conçoivent les parcours et le contenu utilisé dans vos implémentations.
Ce guide décrit les étapes techniques de base de mise en œuvre pour commencer à utiliser Journey Optimizer. Que vous créiez des applications mobiles, des expériences web ou des intégrations d’API, suivez les sections ci-dessous pour configurer votre implémentation.
Conditions préalables prerequisites
Avant de commencer votre implémentation, vérifiez que vous disposez des éléments suivants :
* Maîtrise des API RESTful et de JSON
* Connaissance de la programmation asynchrone et des architectures basées sur les événements
* Connaissance de l’architecture d’applications de votre organisation
* Environnement de développement avec accès à la base de code de votre application
* Outils de test tels que Postman pour le test des API
* Outils de développement de navigateur ou outils de débogage pour mobile
* Schémas XDM et définitions d’événement fournis par votre ingénieur ou ingénieure de données
* Exigences et cas pratiques fournis par vos responsables marketing
Comprendre les bases techniques technical-foundation
Avant d’aborder plus en détail l’implémentation, familiarisez-vous avec les concepts techniques de base :
-
Intégration d’Adobe Experience Platform : Journey Optimizer est intégré nativement dans Adobe Experience Platform. Comprendre l’architecture sous-jacente vous aidera à créer des implémentations plus efficaces. En savoir plus sur le fonctionnement de Journey Optimizer.
-
Modèles de données XDM : Journey Optimizer utilise le modèle de données d’expérience (XDM) pour structurer les données d’événement et de profil. En tant que développeur ou développeuse, vous devez comprendre comment envoyer des données conformes aux schémas configurés par votre ingénieur ou ingénieure de données. Découvrez les schémas XDM.
-
Authentification et sécurité : toutes les implémentations nécessitent une authentification appropriée. Découvrez comment configurer l’authentification pour les SDK et les API. En savoir plus sur l’authentification des API.
Configurer les intégrations aux applications mobiles mobile-integration
Configurer le SDK mobile Adobe Experience Platform
Pour activer les notifications push, les messages in-app et d’autres fonctionnalités mobiles, intégrez le SDK mobile Adobe Experience Platform à vos applications mobiles.
-
Installer et configurer le SDK mobile : consultez la documentation du SDK mobile Adobe Experience Platform pour commencer à intégrer le SDK.
-
Créer une propriété mobile : configurez une propriété mobile dans Adobe Experience Platform Data Collection. Découvrez comment créer et configurer une propriété mobile.
-
Configurer les notifications push :
- Pour les applications iOS : enregistrez votre application auprès de l’APNs (service de notification push Apple). En savoir plus dans la documentation Apple.
- Pour les applications Android : configurez Firebase Cloud Messaging pour votre application Android. En savoir plus dans la documentation Google.
-
Tester votre intégration mobile : utilisez le workflow de démarrage rapide de l’intégration mobile pour configurer et tester rapidement votre configuration mobile.
Les étapes détaillées pour configurer les notifications push sont disponibles sur cette page.
Implémenter des expériences basées sur du code (SDK mobile)
Pour la personnalisation d’applications mobiles natives à l’aide d’expériences basées sur du code :
- Suivez ce tutoriel pour l’implémentation du SDK mobile.
- Examinez les exemples d’implémentation pour iOS et Android.
Implémenter les expériences Web web-implementation
Configurer le SDK Web Adobe Experience Platform
Pour les implémentations web, le SDK Web est votre principal point d’intégration :
-
Installer le SDK Web : suivez le guide d’implémentation du SDK Web pour installer le SDK sur votre site Web.
-
Configurer les flux de données : créez et configurez un train de données dans Adobe Experience Platform Data Collection avec Journey Optimizer activé. En savoir plus dans la documentation sur les trains de données.
-
Activer les notifications push web (facultatif) : configurez la propriété pushNotifications dans votre configuration du SDK Web et utilisez la commande sendPushSubscription pour enregistrer les abonnements push.
Implémenter des expériences basées sur du code (SDK Web)
Les expériences basées sur du code vous permettent de personnaliser n’importe quel point de contact numérique :
-
Choisissez votre méthode d’implémentation : côté client, côté serveur ou hybride. Examinez les exemples d’implémentation pour chaque approche.
-
Définir des surfaces : identifiez les emplacements dans votre application où vous souhaitez diffuser du contenu personnalisé. En savoir plus sur la configuration de surface.
-
Implémenter le rendu du contenu : utilisez le SDK Web pour récupérer et appliquer le contenu de personnalisation. Consultez les tutoriels d’implémentation basée sur du code.
-
Envoyer des événements d’affichage et d’interaction : effectuez un suivi du moment où le contenu est affiché et du moment où les utilisateurs et les utilisatrices interagissent avec celui-ci, pour l’analyse et l’optimisation.
Explorez des exemples d’implémentation sur GitHub pour voir les expériences basées sur du code en action.
En savoir plus sur la prise en main des expériences basées sur du code.
Implémenter le streaming d’événements event-streaming
Envoyer des événements pour déclencher des parcours
En tant que développeur ou développeuse, vous implémentez le code pour envoyer des événements qui déclenchent des parcours. Votre ingénieur ou ingénieure de données configure les schémas et les définitions d’événement dans Journey Optimizer.
-
Connaître la payload d’événement : contactez l’ingénieur ou l’ingénieure de données pour obtenir le schéma d’événement et la structure de payload requise. La payload doit être conforme au schéma XDM configuré. Découvrez les exigences relatives au schéma d’événement.
-
Implémenter le streaming d’événements : envoyez des événements à Adobe Experience Platform à l’aide des API d’ingestion en streaming. Découvrez les étapes pour envoyer des événements.
-
Gérer les types d’événement :
- Événements unitaires : implémentez l’envoi d’événements pour des actions spécifiques à une personne (par exemple, clic sur un bouton, achat complété).
- Événements métier : envoyez des événements métier (par exemple, des mises à jour d’inventaire, des modifications de prix).
-
Tester la diffusion d’événement : vérifiez que les événements sont correctement reçus et déclenchez les parcours comme prévu. Découvrez la résolution des problèmes liés aux événements.
Exemple d’implémentation pour envoyer un événement via une API :
POST https://{DATACOLLECTION_ENDPOINT}/collection/{DATASTREAM_ID}
Content-Type: application/json
{
"header": {
"datasetId": "{DATASET_ID}",
"imsOrgId": "{ORG_ID}",
"source": {
"name": "Web SDK"
}
},
"body": {
"xdmMeta": {
"schemaRef": {
"id": "{SCHEMA_ID}"
}
},
"xdmEntity": {
"_id": "unique-event-id",
"eventType": "purchase",
"timestamp": "2024-01-01T12:00:00Z",
// ... your event data
}
}
}
En savoir plus sur l’utilisation d’événements de parcours.
Développer des points d’entrée d’actions personnalisées custom-actions
Les actions personnalisées permettent aux parcours d’appeler vos API. En tant que développeur ou développeuse, vous allez créer les points d’entrée d’API appelés par les actions personnalisées :
-
Créer votre point d’entrée d’API : créez des points d’entrée d’API RESTful que Journey Optimizer appellera lors de l’exécution du parcours. Votre point d’entrée doit :
- Accepter des payloads JSON
- Authentifier les requêtes (OAuth, clé d’API ou JWT)
- Traiter les requêtes dans des délais appropriés
- Renvoyer les réponses au format attendu
-
Comprendre les fonctionnalités des actions personnalisées : les actions personnalisées peuvent se connecter à des systèmes tiers tels qu’Epsilon, Slack, Firebase, ou à vos propres services. En savoir plus sur les actions personnalisées.
-
Utiliser les configurations d’actions : votre administrateur ou administratrice ou votre ingénieur ou ingénieure de données configure l’action personnalisée dans Journey Optimizer en définissant l’URL du point d’entrée d’API, la méthode d’authentification et les paramètres. Vous devez leur fournir les spécifications de votre API. Découvrez la configuration des actions personnalisées.
-
Renvoyer des données activables : concevez votre API afin qu’elle renvoie des données pouvant être utilisées dans les étapes de parcours postérieures. Découvrez les réponses aux actions.
-
Implémenter une limitation de débit : assurez-vous que vos points d’entrée peuvent gérer le volume attendu. Journey Optimizer applique une limite de 5 000 appels/seconde, mais votre système doit pouvoir la supporter. Découvrez le capping et la limitation.
Exemple de cas d’utilisation : écriture d’événements de parcours dans Experience Platform à l’aide d’actions personnalisées.
Utiliser des API Journey Optimizer apis
Journey Optimizer fournit des API REST complètes pour un accès par programmation :
-
Comprendre les fonctionnalités des API : les API Journey Optimizer vous permettent de créer, lire, mettre à jour et supprimer diverses ressources par programmation. Découvrez les API Adobe Journey Optimizer.
-
Authentification : suivez ce tutoriel pour configurer l’authentification des API à l’aide d’Adobe Developer Console.
-
Explorer les références d’API : parcourez la documentation complète des API et essayez les API directement dans la référence des API Adobe Journey Optimizer.
-
Campagnes déclenchées par API : créez des messages transactionnels avec des campagnes déclenchées par API. Pour les scénarios à volume élevé (jusqu’à 5 000 TPS), explorez le mode à débit élevé (nécessite une licence de module complémentaire).
-
API de gestion des décisions : utilisez des API spécialisées pour la gestion des offres et la prise de décisions. Pour plus d’informations, consultez le guide des API de gestion des décisions.
Test et débogage testing
-
Débogage de l’implémentation du SDK : utilisez Adobe Experience Platform Assurance pour inspecter les événements du SDK, valider la collecte des données et résoudre les problèmes d’intégration en temps réel. En savoir plus sur Assurance.
-
Tester la diffusion des événements : vérifiez que les événements de votre application sont correctement reçus par Adobe Experience Platform et déclenchez les parcours comme prévu. Surveillez l’ingestion des événements et validez la structure de la payload.
-
Valider les intégrations d’API : testez vos points d’entrée d’actions personnalisées pour vous assurer qu’ils gèrent correctement les requêtes Journey Optimizer, répondent dans les limites des délais d’expiration et renvoient les formats de données attendus.
-
Utiliser le mode test avec des profils de test : contactez votre ingénieur ou ingénieure de données pour obtenir l’accès aux profils de test, puis validez votre implémentation à l’aide du mode de test de parcours. Découvrez comment tester des parcours.
-
Surveiller les journaux du SDK : activez la journalisation du débogage dans votre implémentation du SDK pour résoudre les problèmes lors du développement :
- SDK mobile : activez la journalisation pour afficher les événements du SDK et les appels d’API.
- SDK Web : utilisez la console du navigateur pour surveiller l’activité du SDK.
-
Vérifier la configuration du train de données : vérifiez que votre train de données est correctement configuré pour envoyer des données à Journey Optimizer. Vérifiez que les événements sont acheminés via le train de données vers les destinations correctes.
-
Interroger les données de parcours pour analyse : utilisez des requêtes SQL vers le lac de données pour analyser les événements d’étapes de parcours, résoudre les problèmes, et surveiller les performances des actions personnalisées. Explorez les exemples de requêtes pour l’analyse de parcours, notamment :
- Suivi des entrées et des sorties des profils et raisons des rejets
- Mesures de performances des actions personnalisées (latence, débit, erreurs)
- Diffusion des événements et modèles d’erreurs
- États des instances de parcours
Rubriques de développement avancées advanced-topics
Utilisation des données contextuelles et enrichissement
- Effectuer une itération de tableaux : utilisez la syntaxe Handlebars pour afficher dans les messages des listes dynamiques à partir d’événements, de réponses d’actions personnalisées et de recherches dans des jeux de données. Découvrez l’itération de données contextuelles.
- Recherche dans les jeux de données : implémentez des recherches dans les jeux de données pour enrichir les données de parcours à partir de jeux de données Adobe Experience Platform. Collaborez avec votre ingénieur ou ingénieure de données pour la configuration. Découvrez la recherche dans les jeux de données.
Appliquer le consentement et la gouvernance
Implémentez des politiques de gouvernance des données et de consentement dans vos intégrations :
- Gouvernance des données : appliquez des politiques d’utilisation des données aux actions personnalisées. En savoir plus sur la gouvernance des données.
- Gestion du consentement : gérez les préférences de consentement des clientes et des clients dans vos implémentations. En savoir plus sur le consentement.
Optimisation et bonnes pratiques
- Capping et limitation : prenez connaissance des limites de débit et implémentez une limitation appropriée. Découvrez les systèmes externes.
- Optimisation des parcours : suivez les bonnes pratiques pour l’optimisation des parcours.
- Gestion des erreurs : implémentez une gestion des erreurs robuste. Consultez les codes d’erreur et les guides de résolution des problèmes.
Ressources supplémentaires additional-resources
- Developer Console : accédez à Adobe Developer Console pour créer des intégrations et gérer les informations d’identification des API.
- Exemple de code : explorez les exemples d’implémentation sur GitHub.
- Tutoriels vidéo : apprenez grâce à des tutoriels pratiques sur Experience League.
- Communauté de développement : entrez en contact avec d’autres développeurs et développeuses et obtenez de l’aide sur les forums de la communauté Adobe.
Collaboration entre les rôles next-steps
Votre travail d’implémentation est lié aux autres membres de l’équipe :
Collaborez avec les ingénieurs et ingénieures de données sur les configurations de données et d’événements :
-
Obtenez les schémas XDM et les structures d’événement que vous devez implémenter.
-
Identifiez les événements que vous devez envoyer et leur format de payload requis.
-
Alignez-vous sur les exigences en matière de collecte de données et les normes de qualité des données.
-
Testez conjointement la diffusion des événements et l’ingestion des données.
Collaborez avec les administrateurs et les administratrices sur les accès et les configurations :
-
Fournissez les spécifications des API pour les actions personnalisées qu’ils vont configurer.
-
Demandez les autorisations nécessaires et les informations d’identification des API.
-
Coordonnez-vous sur les exigences de configuration des canaux (par exemple, les certificats push).
-
Alignez les environnements de test et la stratégie de sandbox.
Collaborez avec les responsables marketing sur les exigences et les tests des parcours :
-
Identifiez les interactions utilisateur qui doivent déclencher des événements.
-
Implémenter le suivi des performances du contenu et de l’interaction client
-
Tester les parcours avec vos fonctionnalités implémentées
-
Résolvez les problèmes liés à la diffusion ou à la personnalisation des messages.
Commencer l’implémentation
Vous souhaitez commencer à créer ? Sélectionnez votre premier domaine d’implémentation dans les sections ci-dessus :
- Application mobile ? Commencez par l’Intégration du SDK mobile.
- Site web ? Commencez par la Configuration du SDK Web.
- Intégration d’API ? Passez directement à Utiliser des API.
- Système personnalisé ? Consultez les Actions personnalisées.
Chaque section comprend des liens vers une documentation technique détaillée, des exemples de code et des tutoriels pour vous guider dans votre implémentation.