Configurer votre expérience basée sur le code code-based-configuration

Avant de créer votre expérience, vous devez créer une configuration d’expérience basée sur du code dans laquelle vous allez définir où le contenu sera diffusé et utilisé dans votre application.

Une configuration d’expérience basée sur du code doit référencer la surface, qui est essentiellement l’emplacement où vous souhaitez effectuer le rendu de vos modifications. Selon la plateforme sélectionnée, vous devez saisir un emplacement/chemin ou l’URI complet de la surface. En savoir plus

Création d’une configuration d’expérience basée sur du code create-code-based-configuration

Pour créer une configuration de canal d’expérience basée sur du code, procédez comme suit :

  1. Accédez au menu Canaux  >  Paramètres généraux  >  Configurations des canaux, puis cliquez sur Créer une configuration des canaux.

  2. Saisissez un nom et une description (facultatif) pour la configuration.

    note note
    NOTE
    Les noms doivent commencer par une lettre (A-Z). Ils ne peuvent contenir que des caractères alphanumériques. Vous pouvez également utiliser le trait de soulignement _, le point. et le trait d'union -.
  3. Pour attribuer des libellés d’utilisation des données personnalisés ou de base à la configuration, vous pouvez sélectionner Gérer l’accès. En savoir plus sur le contrôle d’accès au niveau de l’objet (OLAC)

  4. Sélectionnez une Action marketing ou plusieurs pour associer des politiques de consentement aux messages utilisant cette configuration. Toutes les politiques de consentement associées à cette action marketing sont utilisées afin de respecter les préférences de vos clientes et clients. En savoir plus

  5. Sélectionnez le canal Expérience basée sur du code.

  6. Sélectionnez la plateforme pour laquelle l’expérience basée sur du code sera appliquée :

    note note
    NOTE
    Vous pouvez sélectionner plusieurs plateformes. Lorsque vous sélectionnez plusieurs plateformes, le contenu est diffusé sur toutes les pages ou applications sélectionnées.
  7. Sélectionnez le format attendu par l’application à cet emplacement spécifique. Cela sera utilisé lors de la création de l’expérience basée sur du code dans les campagnes et les parcours.

  8. Cliquez sur Envoyer pour enregistrer vos modifications.

Vous pouvez maintenant sélectionner cette configuration lors de la création d’une expérience basée sur du code dans vos campagnes et vos parcours.

NOTE
Votre équipe d’implémentation d’application est chargée d’effectuer des appels d’API ou de SDK explicites pour récupérer du contenu pour les surfaces définies dans la configuration d’expérience basée sur du code sélectionnée. Pour en savoir plus sur les différentes implémentations clientes, consultez cette section.

Plateformes web web

Pour définir les paramètres de configuration de l’expérience basée sur du code pour les plateformes web, procédez comme suit.

  1. Sélectionnez l’une des options suivantes :

    • Page unique - Si vous souhaitez appliquer les modifications exclusivement à une seule page, saisissez une URL de page.

    • Règle de correspondance de pages - Pour cibler plusieurs URL correspondant à la même règle, créez une ou plusieurs règles. En savoir plus

      Par exemple, si vous souhaitez modifier des éléments qui s’affichent sur toutes les pages de produits pour femmes de votre site web Luma, sélectionnez Domaine > Commence par > luma et Page > Contient > women.

  2. Les conditions suivantes s’appliquent à l’URL de prévisualisation :

    • Si une URL de page unique est saisie, cette URL sera utilisée pour la prévisualisation. Il n’y a pas besoin de saisir une autre URL.

    • Si une règle de correspondance de pages est sélectionnée, vous devez saisir une URL de création et de prévisualisation par défaut qui sera utilisée pour prévisualiser l’expérience dans le navigateur. En savoir plus

  3. Le champ Emplacement sur la page spécifie la destination exacte à l’intérieur de la page à laquelle vous souhaitez que les personnes accèdent. Il peut s’agir d’une section spécifique sur une page dans la structure de navigation du site, telle que « bannière-produit » ou « rail-produit ».

Plateformes mobiles (iOS et Android) mobile

Pour définir les paramètres de configuration d’expérience basée sur du code pour les plateformes mobiles, procédez comme suit.

  1. Saisissez votre ID d’application. Cela permet une identification et une configuration précises dans l’environnement opérationnel de l’application et garantit une intégration et une fonctionnalité transparentes.

  2. Indiquez l’emplacement ou le chemin d’accès dans l’application. Ce champ indique la destination exacte dans l’application à laquelle les personnes doivent accéder. Il peut s’agir d’une section spécifique sur une page dans la structure de navigation de l’application, telle que « bannière-produit » ou « rail-produit ».

  3. Renseignez le champ URL de prévisualisation pour activer les prévisualisations sur l’appareil. Cette URL informe le service de prévisualisation de l’URL spécifique à utiliser lors du déclenchement d’une prévisualisation sur un appareil. En savoir plus

    L’URL de prévisualisation est un lien profond configuré par le développeur ou la développeuse dans votre application. Cela garantit que toutes les URL correspondant au modèle de lien profond s’ouvriront dans l’application plutôt que dans un navigateur web mobile. Contactez le développeur ou la développeuse pour obtenir le schéma de lien profond configuré pour votre application.

Les ressources suivantes peuvent vous aider à configurer des liens profonds pour l’implémentation de votre application.
NOTE
Si vous rencontrez des problèmes lors de la prévisualisation de l’expérience, reportez-vous à cette documentation.

Autres plateformes other

Pour définir les paramètres de configuration d’expérience basée sur du code pour d’autres plateformes (telles que les consoles vidéo, les appareils connectés à la télévision, les téléviseurs intelligents, les kiosques, les distributeurs automatiques de billets, les assistants vocaux, les appareils IoT, etc.), procédez comme suit.

  1. Sélectionnez Autre comme plateforme si votre implémentation n’est pas destinée au Web, à iOS ou à Android, ou si vous devez cibler des URI spécifiques.

  2. Saisissez l’URI de surface. Un URI de surface est un identifiant unique correspondant à l’entité dans laquelle vous souhaitez diffuser votre expérience. En savoir plus

    note caution
    CAUTION
    Veillez à saisir un URI de surface correspondant à celui utilisé dans votre propre mise en œuvre. Sinon, les modifications ne seront pas diffusées.
  3. Ajoutez un autre URI de surface si nécessaire. Vous pouvez ajouter jusqu’à 10 URI.

    note note
    NOTE
    Lors de l’ajout de plusieurs URI, le contenu est diffusé vers tous les composants répertoriés.

Qu’est-ce qu’une surface ? surface-definition

Une surface d’expérience basée sur du code est toute entité conçue pour l’interaction de la personne ou du système, qui est 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 la configuration des canaux 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).

Lors de la création d’une configuration de canaux 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 un emplacement ou chemin pour composer la surface.

  • Si la plateforme est Autre, vous devez saisir l’URI de surface complet, comme dans les exemples ci-dessous.

Un URI de surface sert d’identifiant précis orientant 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 ».
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76