DocumentationGenStudioGuide d’extensibilité

Marketo pour GenStudio

Dernière mise à jour : 11 avril 2026

Créé pour :

  • Developer

Les organisations qui utilisent Marketo Engage et GenStudio for Performance Marketing dans la même organisation IMS peuvent installer l’application Marketo for GenStudio à partir de Adobe Exchange. Une fois que l’administrateur système a validé l’application et terminé le déploiement, les auteurs peuvent choisir des modèles Marketo lors de la création d’expériences d’e-mail dans GenStudio, en regard des modèles téléchargés directement dans Content.

Cette rubrique est destinée aux administrateurs qui installent l’application, collectent les informations d’identification de Marketo et déploient l’application dans Exchange. Pour connaître le fonctionnement de la syntaxe des modèles AJO et Marketo avec GenStudio, voir Modèles AJO et Marketo.

Conditions préalables

  • Marketo Engage doit être configuré dans l’organisation dans laquelle vous déployez l’extension.
  • Les utilisateurs qui déploient l’application ont besoin de informations d’identification. Pour créer et récupérer ces informations d’identification, vous devez disposer d’un accès d’administrateur de produit ​​(la zone Admin doit être disponible lorsque vous ouvrez Marketo).

Installation de l’application à partir d’Adobe Exchange

https://video.tv.adobe.com/v/3483313?captions=fre_fr&learn=on
  1. Ouvrez 🔗 puis accédez à Experience Cloud.
  2. Ouvrez la liste Marketo for GenStudio.
    Liste de Marketo for GenStudio sur Adobe Exchange {width="75%"}
  3. Sélectionnez Gratuit pour demander l’application pour votre organisation.
  4. Une fois que votre organisation a révisé et approuvé la demande, continuez avec Obtention des informations d’identification Marketo et ​ Déploiement de l’application à partir d’Exchange.

Obtention des informations d’identification Marketo

Vous utilisez les informations d’identification de votre instance ​​(et non de Adobe Developer Console). Collectez les informations d’identification suivantes en suivant les étapes ci-dessous avant de procéder au déploiement dans Exchange.

NOTE
Pour générer et récupérer les informations d’identification Marketo, vous devez disposer d’un accès d’administrateur de produit Marketo. Dans le cas contraire, l’onglet Administrateur n’est pas visible dans Marketo.

Créer un utilisateur API uniquement (facultatif si vous réutilisez un utilisateur API existant)

  1. Dans Marketo, accédez à Admin.
    Onglet Administrateur ​ {width="80%"}
  2. Sous Sécurité, ouvrez Utilisateurs et rôles et accédez à l’onglet Rôles.
  3. Créez un nouveau rôle ou modifiez un rôle existant, en y ajoutant les autorisations suivantes : API Access et Access Design Studio.
  4. Pour un nouvel utilisateur d’API, cliquez sur Créer un utilisateur d’API uniquement (utilisez un e-mail unique pour chaque utilisateur d’API).
  5. Cochez la case correspondant aux rôles et affectez le nouveau rôle que vous avez créé. Si vous souhaitez déjà utiliser un utilisateur d’API, passez à Créer ou sélectionner un service LaunchPoint.

Utilisateurs et rôles avec des rôles d’utilisateur et d’API uniquement {width="80%"}

Créer ou sélectionner un service LaunchPoint

  1. Dans Admin, sous Intégration, ouvrez LaunchPoint.
  2. Cliquez sur Créer pour créer un service (ou utiliser un service personnalisé existant).
    Service personnalisé LaunchPoint {width="80%"}
  3. Pour votre service, cliquez sur Afficher les détails et copiez les ID client et Secret client. Vous les entrerez dans Adobe Exchange Configuration.

Notez l’URL de base de l’API REST Marketo

  1. Dans Admin, sous Intégration, ouvrez Web Services.
  2. Recherchez le point d’entrée API REST. Copiez uniquement l’URL de base (hôte), dans le https://###-XXX-###.mktorest.com de formulaire. N’incluez ​​de segments de chemin tels que /rest ou /identity. Cette valeur est unique par instance Marketo.

URL de base du point d’entrée de l’API REST des services web {width="80%"}

Vous aurez également besoin de l’URL d’identité demandée par votre écran de déploiement Exchange, ainsi que de l’URL de base REST et de l’ID client et du secret client de LaunchPoint.

Déployer l’application à partir d’Exchange

Pour rendre l’extension disponible dans GenStudio, déployez l’application à partir d’Adobe Exchange.

  1. Revenez à 🔗.
  2. Sélectionnez Gérer et ouvrez l’application Marketo for GenStudio (par exemple sous Applications App Builder ou les applications gérées de votre organisation).
  3. Sous Environnements, choisissez un environnement existant dans la liste déroulante ou sélectionnez Ajouter un environnement pour en créer un.
  4. Ouvrez Configuration pour l’environnement sélectionné.
  5. Saisissez l’ID client et le Secret client à partir de LaunchPoint, l’URL d’identité Marketo Engage et l’URL de base de l’API REST Marketo Engage (l’hôte de base à partir de Web Services) pour l’URL d’identité Marketo Engage ​et l’URL de base de l’API REST Marketo Engage.
  6. Cliquez sur Déployer. Lorsque le déploiement réussit, l’action devient Annuler le déploiement.

Mettre à jour la configuration

Pour modifier les valeurs de configuration d’un environnement, commencez par Annuler le déploiement, mettez à jour les champs, puis Déployer.

Configuration de Workspace (facultatif)

Vous pouvez ignorer cette étape si vous envisagez d’utiliser l’espace de travail par défaut. Par défaut, les champs Workspace ID et Taille de page de la liste des modèles sont préconfigurés.

Cependant, si vous devez récupérer des modèles à partir d’un autre espace de travail :

  1. Dans Marketo, accédez à Admin → Sécurité → Espaces de travail et partitions.
  2. La colonne Workspace ID est masquée par défaut. Pour l’activer, cliquez avec le bouton droit de la souris sur la ligne d’en-tête (où les noms des colonnes sont affichés).
  3. Sélectionnez Colonnes.
  4. Activez ID à partir de la liste.
    Espaces de travail et partitions avec la colonne Workspace ID activée {width="80%"}

Une fois visible, utilisez l’identifiant Workspace approprié pour votre configuration.

Accès aux modèles Marketo dans GenStudio

Une fois Marketo for GenStudio installé et configuré, un onglet Modèles Marketo s’affiche lorsque vous créez une expérience E-mail dans GenStudio. Utilisez cet onglet pour parcourir les modèles à partir de Marketo Engage.

IMPORTANT
Créez des e-mails sous le flux d’expérience e-mail standard dans GenStudio for Performance Marketing. Cette intégration ne prend PAS en charge les e-mails créés avec la nouvelle expérience de l'éditeur d'e-mail.

Configuration d’Exchange avec des informations d’identification Marketo {width="80%"}

Dépannage

L’onglet Modèles Marketo n’est pas visible

  • Vérifiez que l’application est approuvée dans Exchange et que l’environnement est déployé avec un ID client, un secret client et des URL de base Marketo valides.
  • Demandez à votre administrateur de vérifier que l’accès Administrateur de produit a été utilisé lors de la création des informations d’identification.

Modèles non chargés

  • Rechargez la page ou déconnectez-vous et reconnectez-vous à GenStudio.
  • Dans le panneau des outils de développement du navigateur Réseau, recherchez les appels d’API ayant échoué vers votre instance Marketo et vérifiez que l’URL de base REST correspond à Services web dans Marketo (aucun chemin supplémentaire après l’hôte).

Erreur « Aucun modèle trouvé »

Si l’extension s’installe correctement et que l’onglet Modèles Marketo est visible mais affiche « Aucun modèle trouvé », le problème peut être dû au fait que l’application a dépassé les limites de taille lors du rendu des modèles, ce qui entraîne un blocage.
Pour résoudre ce problème :

  1. Annulez le déploiement de l’application à partir d’Exchange.
  2. Réduisez la taille de la page de la liste de modèles (par exemple, définissez-la sur 1 ou 2).
  3. Redéployez l’application.
recommendation-more-help
genstudio-for-performance-marketing-help-extensibility