DocumentationJourney OptimizerGuide de Journey Optimizer

Surfaces d’expérience basée sur du code

Dernière mise à jour : 2 juin 2025
  • Rubriques :
  • Expériences basées sur code
  • Configuration de canal

Créé pour :

  • Expérimenté
  • Administration

Qu’est-ce qu’une surface ?

Une surface d’expérience basée sur du code est toute entité conçue pour une interaction utilisateur ou utilisatrice ou système, identifiée de manière unique par un URI. La surface est spécifiée dans l’implémentation de l’application et doit correspondre à celle référencée dans votre configuration de canal d’expérience basée sur du code.

Une surface peut être considérée comme un conteneur à n’importe quel niveau de hiérarchie ayant une entité (point de contact) qui existe.

  • Il peut s’agir d’une page web, d’une application mobile, d’une appli de bureau, d’un emplacement de contenu spécifique au sein d’une entité plus grande (par exemple, une div) ou d’un modèle d’affichage non standard (par exemple, un kiosque ou une bannière d’application de bureau).

  • Elle peut également s’étendre à des éléments spécifiques de conteneurs de contenu à des fins de non-affichage ou d’affichage abstrait (par exemple, des objets blob JSON fournis à des services).

  • Il peut également s’agir d’une surface de caractères génériques qui correspond à diverses définitions de surface client (par exemple, un emplacement d’image principale sur chaque page de votre site web peut se traduire en un URI de surface comme : web://mondomaine.com/*#image_principale).

REMARQUE
Lorsque plusieurs actions d’expérience basées sur du code s’exécutent sur la même surface, le score de priorité de la campagne ou du parcours détermine ce qui est diffusé à l’utilisateur final s’il remplit les critères de plusieurs actions. En savoir plus sur les scores de priorité

Identifiant de surface

Un URI de surface sert d’identifiant précis pointant vers des éléments ou des composants de l’interface d’utilisation distincts au sein d’une application. Fondamentalement, un URI de surface est composé de plusieurs sections :

  1. Type  : web, application mobile, ATM, kiosque, tvcd, service, etc.
  2. Propriété  : URL de page ou bundle d’applications.
  3. Conteneur  : emplacement sur l’activité page/application.

Les tableaux ci-dessous répertorient quelques exemples de définition d’URI de surface pour divers appareils.

Web et mobile

Type
URI
Description
Web
web://domain.com/path/page.html#element
Représente un élément individuel dans une page spécifique d’un domaine spécifique, où un élément peut être un libellé comme dans les exemples suivants : hero_banner, top_nav, menu, pied de page, etc.
Application iOS
mobileapp://com.vendor.bundle/activity#element
Représente un élément spécifique dans une activité application native, tel qu’un bouton ou un autre élément de vue.
Application Android
mobileapp://com.vendor.bundle/#element
Représente un élément spécifique dans une application native.

Autres types d’appareils

Type
URI
Description
Bureau
desktop://com.vendor.bundle/#element
Représente un élément spécifique dans une application, tel qu’un bouton, un menu, une bannière principale, etc.
Application TV
tvcd://com.vendor.bundle/#element
Représente un élément spécifique dans un identifiant de bundle spécifique à l’application d’un appareil connecté à la télévision ou à la télévision intelligente.
Service
service://servicename/#element
Représente un processus côté serveur ou une autre entité manuelle.
Kiosque
kiosk://location/screen#element
Exemple de types de surfaces supplémentaires potentiels pouvant être ajoutés facilement.
ATM
atm://location/screen#element
Exemple de types de surfaces supplémentaires potentiels pouvant être ajoutés facilement.

Surfaces de caractères génériques

Type
URI
Description
Caractère générique web
wildcard:web://domain.com/*#element
Surface de caractères génériques : représente un élément individuel dans chacune des pages sous un domaine spécifique.
Caractère générique web
wildcard:web://*domain.com/*#element
Surface de caractères génériques : représente un élément individuel dans chacune des pages sous tous les domaines se terminant par « domain.com ».

Composition d’URI

Dans Journey Optimizer, le canal d’expérience basé sur du code prend en charge deux types d’implémentations clientes :

  • Basé sur le Adobe Experience Platform Web SDK pour vos sites web, ou sur le Adobe Experience Platform Mobile SDK pour vos applications mobiles ;
  • Côté serveur ou hybride à l’aide des API du serveur AEP Edge Network.
NOTE
Pour en savoir plus sur les conditions préalables à la mise en œuvre, consultez cette section.

À l’aide d’expériences basées sur du code, vous pouvez modifier du contenu dans des emplacements granulaires , identifiés de manière unique par Journey Optimizer à l’aide d’URI de surface.

Ces URI de surface sont composés et gérés en fonction de la méthode d’implémentation :

  • SDK web/mobile  : votre développeur ou développeuse web/mobile doit définir ces emplacements granulaires sous la forme de chaînes simples, car le SDK web/mobile est capable de composer automatiquement l’URI de surface en fonction de l’URL/de l’identifiant d’application actuels et de la chaîne d’emplacement.

  • API Edge Network  : le développeur ou la développeuse d’applications/de pages doit définir des URI de surface complets qui incluent le chemin complet et l’emplacement où le contenu sera utilisé, car des URI complets sont requis pour ce type d’implémentation.

C’est ainsi que, lors de la création d’une configuration de canal d’expérience basée sur du code, vous avez deux manières de spécifier la surface en fonction de la plateforme sélectionnée :

  • Pour les plateformes Web, iOS et Android, vous devez saisir l’URL/l’identifiant de l’application et un emplacement ou un chemin pour composer la surface. En savoir plus sur la configuration des expériences basées sur du code pour les plateformes web et mobile

  • Si la plateforme est Autre, vous devez saisir l’URI de surface complet, comme dans les exemples ci-dessus. En savoir plus sur la configuration d’expériences basées sur du code pour les autres plateformes

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76