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

Sur cette page : implémentez les SDK, le streaming 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 exploiter des données en direct.

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

Le SDK mobile est un ensemble de bibliothèques que vous incorporez directement à votre application iOS ou Android. Il sert de couche de communication entre votre application et Adobe Experience Platform : il identifie les utilisateurs et les utilisatrices, 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 le SDK, Journey Optimizer n’a aucune visibilité sur ce que font les utilisateurs et les utilisatrices de votre application et ne dispose d’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 du 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 à publier une nouvelle version de l’application. Utilisez le SDK mobile pour récupérer et afficher 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 du contenu :

Implémenter les expériences Web web-implementation

Configurer le SDK Web Adobe Experience Platform

Le SDK web (alloy.js) est une bibliothèque JavaScript unique qui remplace la grande variété de balises Adobe dont votre site pourrait avoir besoin autrement. Il collecte des données comportementales, les diffuse vers Adobe Experience Platform par le biais d’un train 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 et visiteuses, 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 spécialistes marketing contrôlent entièrement la disposition, les expériences basées sur du code vous donnent une maîtrise totale de 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 : une personne 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 Streaming Ingestion 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 ou ingénieure de données. Veillez à vous coordonner avec cette personne 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 métier sous-jacente et assurez-vous qu’elle peut gérer le volume d’appels généré par Journey Optimizer. Votre administrateur ou administratrice enregistre ensuite le point d’entrée dans Journey Optimizer afin que les équipes marketing 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 se fait pas nécessairement via l’interface d’utilisation de Journey Optimizer. Vous devrez parfois 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 par programme aux principales fonctionnalités de la plateforme. Tous les appels utilisent l’authentification de serveur à serveur OAuth ; l’ancienne méthode JWT n’est plus utilisée.

Test et débogage testing

Avant de terminer 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 fonctionnent dans des conditions réalistes 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 détaillée du SDK jusqu’aux tests 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 mise en œuvre 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 de lignes 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 ou une cliente 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 s’appliquer à vos actions personnalisées et à vos recherches de jeux de données, et pas seulement bloquer les actions dans l’interface d’utilisation.

Optimisation et bonnes pratiques

Les mises en œuvre 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 : comprendre les limites de taux avant de les atteindre, éviter les pièges de conception de parcours courants qui peuvent entraîner la perte silencieuse de profils et créer une gestion des erreurs pour assurer un fonctionnement dégradé plutôt que provoquer un échec sans explication.

Appel des API REST Journey Optimizer rest-apis

Outre la mise en œuvre de SDK et du streaming d’événements, vous pouvez également piloter Journey Optimizer par programme à 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 de Journey Optimizer.

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 Interactive Message Execution. 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 Capping et Throttling protègent ces systèmes contre la surcharge. Le plafonnement 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 Capping · Utiliser l’API Capping · Utiliser l’API Throttling

Autres API REST more-rest-apis

Au-delà des messages et du capping, 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 des campagnes orchestrées. Utilisez-les lorsque vous devez automatiser des opérations qui nécessiteraient autrement des étapes manuelles dans l’interface d’utilisation, 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.

| Valider les jeux de données et déclencher l’exécution de campagnes orchestrées | Validation des jeux de données · Déclencheur · Activer les jeux de données |

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 à Prise en main