Sur cette page : découvrez comment les administrateurs configurent les intégrations de navigation qui permettent aux spécialistes marketing de rechercher, de parcourir et de sélectionner des éléments à partir d’API externes directement dans l’expérience de création, et comment les lier aux intégrations standard.
Outre les intégrations standard, vous pouvez créer des intégrations Navigation. Une intégration de navigation permet aux marketeurs de rechercher, de parcourir et de paginer les éléments renvoyés par une API externe, puis de sélectionner un élément spécifique directement dans l’expérience de création au lieu de saisir manuellement une valeur de paramètre.
Création d’une intégration de navigation create-browsing
En tant qu’administrateur, vous pouvez créer une intégration de navigation à partir de l’onglet Navigation de la configuration Intégrations, en suivant les mêmes instructions étape par étape que pour les intégrations standard.
Une fois les informations d’intégration fournies, configurez les paramètres spécifiques à la navigation suivants :
-
Dans le menu Configuration des éléments, choisissez le Chemin d’accès aux éléments où se trouve la liste des éléments.
-
Dans la liste déroulante Configuration de la recherche, Activer la recherche et sélectionnez le paramètre qui transporte la requête de recherche, puis fournissez une description aux spécialistes du marketing.
-
Dans le menu Configuration de la pagination, activez Pagination et choisissez un type de pagination :
accordion Offset Configurez les champs suivants pour configurer la pagination Décalage :
-
Chemin total : indiquez le chemin d’accès au nombre total de résultats dans le corps de la réponse.
-
Paramètre de décalage : spécifiez le paramètre de requête qui indique le nombre d’éléments à ignorer.
-
Paramètre de limite : spécifiez le paramètre de requête qui indique le nombre d’éléments à renvoyer.
-
Taille de la page : définissez le nombre d’éléments à demander par page.
accordion Page Configurez les champs suivants pour configurer la pagination Page :
-
Chemin total : indiquez le chemin d’accès au nombre total de résultats dans le corps de la réponse.
-
Paramètre de page : spécifiez le paramètre de requête qui indique le numéro de page.
-
Paramètre de taille de page : spécifiez le paramètre de requête qui indique le nombre d’éléments par page.
-
Taille de la page : définissez le nombre d’éléments à demander par page.
-
La première page est : indiquez si la première page de la séquence est numérotée 0 ou 1.
-
Chemin d’accès au nombre total de pages : indiquez le chemin d’accès au nombre total de pages dans le corps de la réponse. Facultatif si vous avez indiqué le chemin d’accès au nombre total.
accordion Curseur Configurez les champs suivants pour configurer la pagination curseur :
-
Chemin total : indiquez le chemin d’accès au nombre total de résultats dans le corps de la réponse.
-
Paramètre de curseur : spécifiez le paramètre de requête qui porte la valeur du curseur.
-
Paramètre de limite : spécifiez le paramètre de requête qui indique le nombre d’éléments à renvoyer.
-
Taille de la page : définissez le nombre d’éléments à demander par page.
-
Source du curseur suivant : sélectionnez l’emplacement de lecture de la valeur du curseur suivant dans la réponse.
-
Chemin d’accès suivant du curseur : indiquez le chemin d’accès à la valeur de curseur suivante dans le corps de la réponse.
-
-
Dans le menu Rendu, choisissez la manière dont les éléments s’affichent pour les marketeurs :
accordion Tableau Pour chaque colonne, choisissez le Libellé et le Chemin des données. Si vous le souhaitez, sélectionnez Mappage rapide pour ajouter plusieurs champs en tant que colonnes à la fois.
Vous pouvez réorganiser les colonnes selon vos besoins ou sélectionner
accordion Liste Renseignez les détails suivants :
- Chemin du Principal : renseignez la clé de données pour le libellé principal de chaque élément.
- Chemin Secondaire : spécifiez la clé de données pour le sous-titre.
- Chemin d’accès à la balise : spécifiez la clé de données du badge de balise.
accordion Avatar Renseignez les détails suivants :
- Chemin d’accès au nom : spécifiez la clé de données pour le nom d’affichage affiché sous l’avatar.
- Chemin de l’image : spécifiez la clé de données pour l’URL de l’image d’avatar.
- Chemin d’accès de la description : indiquez la clé de données pour le sous-titre affiché sous le nom.
-
Cliquez sur Tester la navigation pour prévisualiser le comportement de la recherche et de la pagination à l’aide des paramètres configurés.
-
Enregistrez l’intégration Navigation, puis cliquez sur Publier et Activer.
Liaison d’une intégration de navigation à une intégration standard use-Browsing
Une fois l’intégration de navigation créée, vous pouvez la lier à un paramètre sur une intégration standard afin que les spécialistes marketing puissent sélectionner des valeurs via le sélecteur de navigation au lieu de les saisir manuellement.
-
Lors de la configuration d’un paramètre sur une intégration Standard, activez Navigation.
-
Sélectionnez le lien Intégration de navigation à .
-
Enregistrez et publiez l’intégration Standard.
Sélection d’éléments lors de la création select-Browsing-items
Lorsqu’un paramètre est lié à une intégration Navigation, les marketeurs peuvent sélectionner sa valeur à partir d’un sélecteur dans l’éditeur de messages ou de parcours, plutôt que de la saisir manuellement.
-
Accédez au contenu de votre campagne et cliquez sur Ajouter une personnalisation dans le champ Composants Texte ou HTML.
En savoir plus sur les composants
-
Accédez à la section Intégrations et cliquez sur Ouvrir les intégrations pour afficher toutes les intégrations actives.
-
Sélectionnez une intégration.
-
Recherchez et parcourez la liste paginée des éléments renvoyés par l’intégration de navigation, puis sélectionnez une entité et confirmez votre sélection.
La valeur Chemin de référence correspondante est alors automatiquement insérée dans le paramètre d’intégration.
-
Cliquez sur Enregistrer.
Voir aussi
Vidéo pratique how-to
Regardez la vidéo ci-dessous pour découvrir comment configurer une intégration de navigation pour une API externe et la lier à une intégration standard, afin que les spécialistes marketing puissent rechercher, parcourir et sélectionner des éléments dans l’éditeur de Adobe Journey Optimizer sans saisir manuellement de valeurs.
This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.
For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.
- TL;DR: Configure a Browsing integration and link it to a Standard integration parameter so marketers can search, browse, and select items returned by an external API during authoring.
Intents:
- Configure the items path, search query parameter, and pagination for a Browsing integration.
- Choose how items are displayed to marketers.
- Preview search and pagination behavior with Test browsing.
- Link a Browsing integration to a Standard integration parameter.
- Select an item during authoring and insert its Reference path value into the integration parameter.
Glossary:
- Browsing integration: An integration that lets marketers search, browse, and paginate through items returned by an external API, then select a specific item directly in the authoring experience. (product-specific)
- Items path: The path where the list of items is located. (product-specific)
- Offset parameter: The request parameter that indicates the number of items to skip. (product-specific)
- Page parameter: The request parameter that indicates the page number. (product-specific)
- Cursor parameter: The request parameter that carries the cursor value. (product-specific)
- Reference path: The value corresponding to the selected entity that is automatically inserted into the integration parameter. (product-specific)
- Test browsing: A preview of search and pagination behavior with the configured settings. (product-specific)
Guardrails:
- Browsing integrations are created by an administrator from the Browsing tab of the Integrations configuration.
- When a parameter is linked to a Browsing integration, marketers can pick its value from a selector in the message or journey editor, rather than typing it manually.
- In Page pagination, First page is selects whether the first page is numbered 0 or 1; Total pages path is optional if the total count path is provided.
Terminology:
- Canonical name: Browsing integration.
- Do not confuse: Offset parameter indicates the number of items to skip; Page parameter indicates the page number; Cursor parameter carries the cursor value.
- Do not confuse: Page size sets the number of items to request per page; Page size parameter specifies the request parameter that indicates the number of items per page in Page pagination.
FAQ:
- Q: Which pagination types can I choose? Offset, Page, or Cursor.
- Q: How can items be displayed to marketers? The Render menu provides Table, List, and Avatar.
- Q: What does Test browsing preview? Test browsing previews the search and pagination behavior with the configured settings.
- Q: How does a Browsing integration let marketers select a Standard integration parameter value? Link the Browsing integration to the parameter on the Standard integration so marketers can select values through the Browsing selector instead of entering them manually.
- Q: What value is inserted after an entity is selected and the selection is confirmed? The corresponding Reference path value is automatically inserted into the integration parameter.
Personas:
- marketer: Can search, browse, and select items from an external API during authoring, instead of entering values manually. Can select Add personalization, open integrations, select an integration, then search, browse, and select an entity to confirm. The page states that the corresponding Reference path value is then automatically inserted into the integration parameter. Where: “Select items during authoring”.
Onboarding:
- Level: Beginner
- First minimal step: Access your campaign content and select Add personalization from your Text or HTML Components.
- Success check: The corresponding Reference path value is then automatically inserted into the integration parameter.
- Previous: Link a Browsing integration to a parameter on a Standard integration: Create Standard integrations (integrations/integrations-create.md)
- Next: Learn more about the Text or HTML components used for personalization: Use Email Designer content components (email/content-components.md); Troubleshoot issues with Browsing or Standard integrations: Frequently asked questions about Integrations (integrations/vendor-integration-faq.md)