Prise en main pour les développeurs get-started-developers
En tant que développeur, vous êtes responsable de la mise en œuvre et de l’intégration des Adobe Journey Optimizer dans vos applications et systèmes. Vous pouvez commencer à utiliser Adobe Journey Optimizer une fois que l’administrateur système et l’ingénieur 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 que d’autres membres de l’équipe configurent Journey Optimizer par le biais de l’interface utilisateur, vous vous concentrerez sur :
- Mise en œuvre des SDK dans les applications mobiles et web
- Envoi d’événements depuis 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 Journey Optimizer à vos systèmes et infrastructures existants
- Test et débogage vos implémentations
Votre ingénieur de données s’occupera des schémas de données, des configurations d’événement et des sources de données. Votre administrateur configurera les autorisations et les configurations de canal. Les marketeurs concevront les parcours et le contenu qui utilisent vos implémentations.
Ce guide décrit les étapes essentielles de mise en œuvre technique 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 l’implémentation, vérifiez que vous disposez des éléments suivants :
* Compréhension des API RESTful et de JSON
* Familiarité avec la programmation asynchrone et les architectures basées sur les événements
* Connaissance de l’architecture d’application de votre organisation
* Environnement de développement avec accès à la base de code de votre application
* Outils de test tels que Postman pour les tests d’API
* Outils de développement de navigateur ou outils de débogage mobile
* schémas XDM et définitions d’événement de vos Ingénieur de données
* Exigences et cas pratiques de vos Spécialistes marketing
Comprendre les bases techniques technical-foundation
Avant de passer à la mise en œuvre, familiarisez-vous avec les concepts techniques de base :
-
Intégration de Adobe Experience Platform : Journey Optimizer est créé en mode natif sur 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, vous devez comprendre comment envoyer des données conformes aux schémas configurés par votre ingénieur de données. En savoir plus sur 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 API.
Configurer les intégrations d’applications mobiles mobile-integration
Configuration de Adobe Experience Platform Mobile SDK
Pour activer les notifications push, les messages in-app et d’autres fonctionnalités mobiles, intégrez Adobe Experience Platform Mobile SDK à vos applications mobiles.
-
Installer et configurer Mobile SDK : consultez la documentation de Adobe Experience Platform Mobile SDK pour commencer à intégrer 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 d’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 de Google.
-
Tester votre intégration mobile : utilisez le workflow de démarrage rapide de l’intégration mobile mobile pour configurer et tester rapidement votre configuration mobile.
Les étapes détaillées pour configurer les notifications push sont disponibles sur cette page .
Mise en œuvre d’expériences basées sur du code (Mobile SDK)
Pour la personnalisation des applications mobiles natives à l’aide d’expériences basées sur du code :
- Suivez ce tutoriel pour la mise en œuvre de Mobile SDK
- Examinez les exemples d’implémentation pour iOS et Android
Implémenter des expériences web web-implementation
Configurer le SDK Web Adobe Experience Platform
Pour les implémentations web, le Web SDK est votre principal point d’intégration :
-
Installation de Web SDK : suivez le Guide de mise en œuvre de Web SDK pour configurer le SDK sur votre site Web.
-
Configurer les flux de données : créez et configurez un flux de données en Adobe Experience Platform Data Collection avec Journey Optimizer activé. Pour en savoir plus, consultez la documentation sur les flux de données.
-
Activer les notifications push web (facultatif) : configurez la propriété pushNotifications dans votre configuration Web SDK et utilisez la commande sendPushSubscription pour enregistrer les abonnements push.
Implémenter des expériences basées sur du code (Web SDK)
Les expériences basées sur le 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 de 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. Voir tutoriels de mise en œuvre basés sur du code.
-
Envoyer des événements d’affichage et d’interaction : suivez le moment où le contenu est affiché et le moment où les utilisateurs et utilisatrices interagissent avec celui-ci pour les analyses et l’optimisation.
Explorez exemples d’implémentation sur GitHub pour voir en action les expériences basées sur le code.
En savoir plus sur la prise en main des expériences basées sur du code.
Implémentation de la diffusion en continu d’événements event-streaming
Envoyer des événements pour déclencher des parcours
En tant que développeur, vous implémenterez le code pour envoyer des événements qui déclenchent des parcours. Votre ingénieur de données configure les schémas et les définitions d’événement dans Journey Optimizer.
-
Présentation de la payload d’événement : contactez l’ingénieur 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 qu’ils ont configuré. Découvrez les exigences relatives au schéma d’événement.
-
Implémenter la diffusion en continu des événements : envoyez des événements à Adobe Experience Platform à l’aide des API d’ingestion en flux continu. Découvrez les étapes pour envoyer des événements.
-
Gérer les types d'événements :
- Événements unitaires : implémentez l’envoi d’événement pour les actions spécifiques à une personne (par exemple, clic sur un bouton, achèvement de l’achat)
- É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. En savoir plus sur la résolution des problèmes d’événement.
Exemple d’implémentation pour envoyer un événement via l’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éveloppement de points d’entrée d’action personnalisés custom-actions
Les actions personnalisées permettent aux parcours d’appeler vos API. En tant que développeur, 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 API : créez des points d’entrée API RESTful que Journey Optimizer appellera lors de l’exécution du parcours. Votre point d’entrée doit :
- Acceptation des payloads JSON
- Requêtes d’authentification (OAuth, clé API ou JWT)
- Traiter les demandes dans des délais impartis appropriés
- Renvoyer les réponses au format attendu
-
Comprendre les fonctionnalités d’action personnalisée : 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’action : votre administrateur ou ingénieur de données configure l’action personnalisée dans Journey Optimizer, en définissant l’URL du point d’entrée de l’API, la méthode d’authentification et les paramètres. Vous leur fournirez votre spécification d’API. En savoir plus sur la configuration d’une action personnalisée.
-
Renvoyer des données exploitables : concevez votre API pour renvoyer des données qui peuvent être utilisées dans les étapes de parcours suivantes. En savoir plus sur les réponses d’action.
-
Implémenter la 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 être résilient. En savoir plus sur le plafonnement et limitation.
Exemple de cas d’utilisation : écriture d’événements de parcours dans Experience Platform utilisation d’actions personnalisées.
Utiliser des API Journey Optimizer apis
Journey Optimizer fournit des API REST complètes pour un accès programmatique :
-
Comprendre les fonctionnalités de l’API : les API Journey Optimizer vous permettent de créer, lire, mettre à jour et supprimer diverses ressources par programmation. En savoir plus sur les API Journey Optimizer.
-
Authentification : suivez ce tutoriel pour configurer l’authentification de l’API à l’aide de Adobe Developer Console.
-
Explorer les références d’API : parcourez la documentation complète de l’API et essayez les API directement dans la référence de l’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 de volume élevé (jusqu’à 5 000 TPS), explorez le mode Débit élevé (nécessite une licence de module complémentaire).
-
API Decision Management : utilisez des API spécialisées pour la gestion des offres et la prise de décisions. Pour en savoir plus, consultez le guide de l’API Decision Management.
Tests et débogage testing
-
Implémentation de Debug SDK : utilisez Adobe Experience Platform Assurance pour inspecter les événements SDK, valider la collecte de données et résoudre les problèmes d’intégration en temps réel. En savoir plus sur Assurance.
-
Tester la diffusion d’événement : 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’action personnalisés pour vous assurer qu’ils gèrent correctement les requêtes Journey Optimizer, répondent dans les limites de délai d’expiration et renvoient les formats de données attendus.
-
Utilisation du mode test avec des profils de test : contactez votre ingénieur de données pour obtenir l’accès aux profils de test, puis validez votre implémentation à l’aide du mode test de parcours. Découvrez comment tester des parcours .
-
Surveiller les journaux SDK : activez la journalisation du débogage dans votre implémentation de SDK pour résoudre les problèmes lors du développement :
- Mobile SDK : activez la journalisation pour afficher les événements SDK et les appels API
- Web SDK : utilisez la console du navigateur pour surveiller l’activité de SDK
-
Vérifier la configuration du flux de données : vérifiez que votre flux de données est correctement configuré pour envoyer des données à Journey Optimizer. Vérifiez que les événements traversent le flux de données vers les destinations correctes.
-
Données de parcours de requête pour analyse : utilisez des requêtes SQL sur le lac de données pour analyser les événements d’étape de parcours, les problèmes de débogage et surveiller les performances des actions personnalisées. Explorez exemples de requêtes pour l’analyse de parcours notamment :
- Suivi des entrées/sorties du profil et raisons des rejets
- Mesures de performances des actions personnalisées (latence, débit, erreurs)
- Modèles de diffusion d’événements et d’erreurs
- Parcours des états d’instance
Rubriques de développement avancées advanced-topics
Utilisation des données contextuelles et de l’enrichissement
- Itérer sur des tableaux : utilisez la syntaxe Handlebars pour afficher des listes dynamiques à partir d’événements, de réponses d’action personnalisée et de recherches de jeux de données dans les messages. En savoir plus sur l’itération des données contextuelles.
- Recherche de jeu de données : implémentez des recherches de jeu de données pour enrichir les données de parcours à partir des jeux de données Adobe Experience Platform. Contactez votre ingénieur de données pour la configuration. En savoir plus sur la recherche de jeu de données.
Utilisation du consentement et de la gouvernance
Mettez en œuvre 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 clients dans vos implémentations. En savoir plus sur le consentement.
Optimisation et bonnes pratiques
- Plafonnement et limitation : comprenez les limites de débit et implémentez un ralentissement approprié. En savoir plus sur 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 guides de dépannage.
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 d’API.
- Exemple de code : explorez exemples d’implémentation sur GitHub.
- Tutoriels vidéo : apprenez grâce à des tutoriels pratiques sur Experience League.
- Communauté des développeurs : 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 croise d’autres membres de l’équipe :
Collaborez avec des ingénieurs 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 à envoyer et le format de payload requis
-
Aligner sur les exigences de collecte de données et les normes de qualité des données
-
Tester conjointement la diffusion d’événements et l’ingestion de données
Collaborez avec les administrateurs sur l’accès et les configurations :
-
Fournir les spécifications d’API pour les actions personnalisées qu’ils configureront
-
Demander les autorisations nécessaires et les informations d’identification d’API
-
Coordination des exigences de configuration des canaux (par exemple, certificats push)
-
Alignement sur les environnements de test et la stratégie Sandbox
Collaborez avec les spécialistes marketing sur les exigences et les tests de parcours :
-
Identifier les interactions utilisateur qui doivent déclencher des événements
-
Implémenter le suivi pour les performances du contenu et l’interaction client
-
Prise en charge du test des parcours avec vos fonctionnalités implémentées
-
Résolution des problèmes liés à la diffusion ou à la personnalisation des messages
Commencer l’implémentation de
Prêt à commencer la création ? Sélectionnez votre première zone d’implémentation dans les sections ci-dessus :
- Application mobile ? Commencer avec intégration de Mobile SDK
- Site Web ? Commencer par configuration de Web SDK
- Intégration de l’API ? à Utilisation des API
- Système personnalisé ? Extraction 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 la mise en œuvre.