Commencer en tant que développeurs et développeuses get-started-developers

Sur cette page : Implémentez les SDK, la diffusion en continu d’événements, les points d’entrée d’actions personnalisées et les API qui connectent vos applications à Adobe Journey Optimizer afin que vos parcours puissent s’exécuter sur des données actives.

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 :

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 :

Comprendre les bases techniques technical-foundation

Avant d’aborder plus en détail l’implémentation, familiarisez-vous avec les concepts techniques de base :

Configurer les intégrations aux applications mobiles mobile-integration

Configurer le SDK mobile Adobe Experience Platform

Mobile SDK est un ensemble de bibliothèques que vous incorporez directement dans votre application iOS ou Android. Il agit comme la couche de communication entre votre application et Adobe Experience Platform : il identifie les utilisateurs, collecte des événements comportementaux et fournit des instructions à partir de Journey Optimizer, y compris des notifications push, des messages in-app et du contenu personnalisé. Sans cela, Journey Optimizer n’a aucune visibilité sur ce que font les utilisateurs de votre application et aucun moyen de les contacter.

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)

Les expériences basées sur le code vous permettent de diffuser du contenu personnalisé sur n’importe quelle surface de votre application mobile native (écrans d’intégration, pages de détails du produit, bannières intégrées et indicateurs de fonctionnalité) sans avoir à lancer de nouvelle application. Utilisez Mobile SDK pour récupérer et générer du contenu personnalisé au moment de l’exécution, ce qui permet à votre équipe de contrôler entièrement l’emplacement et la présentation :

Implémenter les expériences Web web-implementation

Configurer le SDK Web Adobe Experience Platform

Web SDK (alloy.js) est une bibliothèque JavaScript unique qui remplace l’ensemble disparate de balises Adobe distinctes dont votre site pourrait avoir besoin autrement. Il collecte des données comportementales, les diffuse vers Adobe Experience Platform par le biais d’un flux de données que vous configurez et reçoit des instructions de personnalisation en retour, le tout en un seul aller-retour réseau. Une fois en place, Journey Optimizer peut identifier les visiteurs, déclencher des parcours à partir de leurs actions et diffuser immédiatement du contenu personnalisé sur vos pages.

Implémenter des expériences basées sur du code (SDK Web)

Contrairement aux canaux visuels où les marketeurs contrôlent entièrement la mise en page, les expériences basées sur le code vous donnent une propriété totale sur la manière dont le contenu personnalisé est rendu sur la page. Journey Optimizer renvoie une payload JSON avec les données de personnalisation ; votre code décide où et comment l’afficher. Ce modèle fonctionne pour n’importe quelle surface web (bannières principales, carrousels de recommandation, classements de résultats de recherche, variantes de test A/B) sans avoir besoin d’un éditeur visuel ou d’un workflow de publication de page.

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

Les parcours s’exécutent sur des événements : un utilisateur se connecte, ajoute un article à un panier, effectue un achat et abandonne un formulaire. Votre travail consiste à émettre ces événements à partir de votre application exactement au bon moment. Chaque événement est une payload JSON structurée par XDM envoyée à l’API d’ingestion en flux continu Experience Platform ; Journey Optimizer la récupère en quelques millisecondes et achemine le profil dans n’importe quel parcours correspondant. Le schéma d’événement et la structure de la payload sont définis par votre ingénieur de données ; assurez-vous de la coordination avec eux avant de commencer le codage.

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

Lorsqu’un parcours atteint une étape d’action personnalisée, Journey Optimizer effectue un appel HTTP sortant vers une URL que vous fournissez : votre serveur principal, un CRM, une plateforme de fidélité, n’importe quel point d’entrée REST. Votre tâche consiste à créer et exposer ce point d’entrée : définissez le contrat de requête (forme de payload, méthode d’authentification, format de réponse), implémentez la logique commerciale sous-jacente et assurez-vous qu’il peut gérer le volume d’appels généré par Journey Optimizer. Votre administrateur enregistre ensuite le point d’entrée dans Journey Optimizer afin que les marketeurs puissent l’utiliser comme une étape dans leurs parcours.

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

Tout ne doit pas nécessairement se produire via l’interface utilisateur de Journey Optimizer. Parfois, vous devez déclencher une campagne à partir de votre propre serveur principal, supprimer une adresse e-mail après une demande d’accès à des informations personnelles ou synchroniser les modèles de contenu à partir d’un CMS externe. Les API REST Journey Optimizer vous donnent un accès programmatique aux principales fonctionnalités de la plateforme. Tous les appels utilisent l’authentification de serveur à serveur OAuth ; l’ancienne méthode JWT est obsolète.

Test et débogage testing

Avant la mise en œuvre, vous devez vous assurer que les événements se déclenchent au bon moment, que les parcours se déclenchent comme prévu, que les actions personnalisées se comportent avec une charge réaliste et que le contenu personnalisé s’affiche correctement. Cette section présente les outils et les techniques permettant de détecter les problèmes dès le début, depuis la journalisation de SDK de bas niveau jusqu’aux exécutions de test de parcours de bout en bout avec des profils réels.

Rubriques de développement avancées advanced-topics

Une fois vos SDK, événements et API principaux en place, ces rubriques vous aident à aller plus loin : enrichir les données de parcours au moment de l’exécution sans surcharger le profil, gérer les signaux de consentement afin que les désinscriptions se propagent à chaque intégration et ajuster votre implémentation pour le débit et la fiabilité qu’exige l’échelle de production.

Utilisation des données contextuelles et enrichissement

Les parcours ont souvent besoin de plus de données que ce qui arrive dans l’événement déclencheur : un nom de produit, un niveau de fidélité, une liste d’éléments de ligne de commande. Plutôt que de précharger tout cela dans chaque profil, l’enrichissement contextuel permet à votre parcours de le rechercher au moment de l’exécution à partir des jeux de données AEP ou de le transférer à partir d’une réponse d’action personnalisée. Vos messages et conditions de branche peuvent alors référencer ces données sans qu’elles ne soient jamais stockées de manière permanente sur le profil.

Appliquer le consentement et la gouvernance

Journey Optimizer applique les politiques de gouvernance des données et de consentement au niveau de la plateforme, mais votre intégration doit également les respecter. Lorsqu’un client se désinscrit des communications marketing ou lorsqu’un libellé d’utilisation des données limite l’utilisation d’un champ, ces règles doivent se propager à travers vos actions personnalisées et vos recherches de jeux de données, et pas seulement bloquer les actions dans l’interface utilisateur.

Optimisation et bonnes pratiques

Les implémentations de Journey Optimizer de production gèrent régulièrement des millions d’événements et des milliers d’exécutions de parcours par seconde. Ces ressources vous aident à affiner votre intégration pour cette échelle : en comprenant les limites de taux avant de les atteindre, en évitant les pièges de conception de parcours courants qui font chuter silencieusement les profils et en créant une gestion des erreurs qui se dégrade de manière élégante plutôt que d’échouer de manière opaque.

Appel des API REST Journey Optimizer rest-apis

Outre l’implémentation de SDK et de la diffusion d’événements en continu, vous pouvez également piloter Journey Optimizer par programmation à partir de vos propres systèmes. La référence complète de l’API, les spécifications OpenAPI et les exemples de code se trouvent sur le portail de développement 🔗.

Exécuter des campagnes déclenchées par API api-triggered

Déclenchez des messages transactionnels ou marketing à partir d’un système externe à l’aide de l’API REST d’exécution de message interactif. Avant d’appeler le point d’entrée :

Référence d’API · Exemples de code · Utiliser des campagnes déclenchées par API

Plafonnement et limitation des points d’entrée externes capping-throttling

Lorsque des parcours appellent des systèmes externes par le biais d’actions personnalisées ou de sources de données, les API de plafonnement et de limitation protègent ces systèmes contre la surcharge. La limitation rejette les appels qui dépassent la limite configurée ; la limitation les met en file d’attente pendant 6 heures au maximum (sandbox de production, actions personnalisées uniquement).

Référence de l’API de plafonnement · Utiliser l’API de plafonnement · Utiliser l’API de limitation

Plus d’API REST more-rest-apis

Au-delà de la messagerie et de la limitation, Journey Optimizer expose des points d’entrée REST pour la gestion de suppression, le modèle de contenu, la récupération des campagnes, la relecture et l’exécution orchestrée des campagnes. Utilisez-les lorsque vous devez automatiser des opérations qui nécessiteraient autrement des étapes manuelles dans l’interface utilisateur, par exemple la suppression en masse d’adresses après une extraction de données ou la synchronisation de modèles à partir d’un pipeline de contenu externe.

Ressources supplémentaires additional-resources

Collaboration entre les rôles next-steps

Votre travail d’implémentation est lié aux autres membres de l’équipe :

Commencer l’implémentation

Vous souhaitez commencer à créer ? Sélectionnez votre premier domaine d’implémentation dans les sections ci-dessus :

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.

Autres guides de rôle other-role-guides

Retour à Présentation des rôles et des responsabilités · Retour à Commencer