DocumentationWorkfrontGuide Workfront

Modules Adobe Target

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice

Dans un scénario Adobe Workfront Fusion, vous pouvez automatiser les workflows qui utilisent Adobe Target, ainsi que de le connecter à plusieurs applications et services tiers. Les modules Adobe Target vous permettent de créer, de lire, de mettre à jour ou de supprimer des enregistrements, de répertorier tous les enregistrements d’un type donné, de rechercher des enregistrements en fonction de critères que vous précisez ou d’effectuer un appel API personnalisé à l’API Adobe Target.

Si vous avez besoin d’instructions sur la création d’un scénario, voir Créer un scénario.

Pour plus d’informations sur les modules, voir Modules dans Adobe Workfront Fusion.

Conditions d’accès

Vous devez disposer des accès suivants pour utiliser les fonctionnalités de cet article :

Adobe Workfront formule*
Pro ou version supérieure
Adobe Workfront licence*
Plan, Work
Adobe Workfront Fusion licence**

Exigences de licence actuelles : aucune exigence de licence Workfront Fusion requise.

Ou

Exigences de licence héritées : Workfront Fusion for Work Automation and Integration

Produit

Conditions requises du produit actuel : si vous disposez de la formule Adobe Workfront Select ou Prime, votre entreprise doit acheter Adobe Workfront Fusion ainsi que Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article. Workfront Fusion est inclus dans la formule Workfront Ultimate.

Ou

Exigences liées aux produits hérités : votre entreprise doit acheter Adobe Workfront Fusion ainsi qu’Adobe Workfront pour utiliser la fonctionnalité décrite dans cet article.

Pour connaître la formule, le type de licence ou l’accès dont vous disposez, contactez votre équipe d’administration Workfront.

Pour plus d’informations sur les licences Adobe Workfront Fusion, voir Licences Adobe Workfront Fusion.

Conditions préalables

Avant d’utiliser le connecteur Adobe Target, vous devez vous assurer que les conditions préalables suivantes sont remplies :

  • Vous devez disposer d’un compte Adobe Target.

Créer une connexion à Adobe Target

IMPORTANT
Les connexions créées après le 3 juin 2024 nécessitent une connexion serveur à serveur Adobe Target.
  • Les connexions de compte de service existantes continueront à fonctionner jusqu’en janvier 2025. Vous devez remplacer vos connexions de compte de service par des connexions serveur à serveur Adobe Target avant janvier 2024.
  • Pour créer une connexion serveur à serveur Adobe Target, vous devez faire partie de l’équipe de développement de votre organisation. Le rôle de l’équipe de développement est défini dans Adobe Admin Console.

Pour créer une connexion pour vos modules Adobe Target :

  1. Cliquez sur Ajouter en regard de la case Connexion.

  2. Remplissez les champs suivants :

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto html-authored no-header
    Connection name Saisissez un nom pour cette connexion.
    Connection type

    Indiquez si vous créez une connexion de compte de service ou de serveur à serveur Adobe Target.

    IMPORTANT : les connexions créées après le 3 juin 2024 nécessitent une connexion serveur à serveur Adobe Target. Les connexions de compte de service existantes continueront à fonctionner jusqu’en janvier 2025. Vous devez remplacer vos connexions de compte de service par des connexions serveur à serveur Adobe Target avant janvier 2024.
    Environment Indiquez si vous vous connectez à un environnement de production ou hors production.
    Type Indiquez si vous vous connectez à un compte de service ou à un compte personnel.
    Client ID Saisissez votre ID client Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    Client Secret Saisissez votre secret client Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    Technical account ID Saisissez l’ID de votre compte technique Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    Organization ID Saisissez votre ID d’organisation Adobe. Vous pouvez le trouver dans la section Credentials details de l’Adobe Developer Console.
    Tenant

    Pour localiser votre locataire, connectez-vous à Adobe Experience Cloud, ouvrez Target, puis cliquez sur la carte Target. Utilisez la valeur de l’ID de locataire comme indiqué dans le sous-domaine de l’URL.

    Par exemple, si votre URL lors de la connexion à Adobe Target est <https://mycompany.experiencecloud.adobe.com/...> alors votre ID de locataire est « mycompany ».
    Meta Scopes Saisir ent_marketing_sdk
    Private key

    Saisissez la clé privée générée lors de la création de vos informations d’identification dans l’Adobe Developer Console.

    Pour extraire votre clé privée ou votre certificat privé, procédez comme suit :

    1. Cliquez sur Extract.

    2. Sélectionnez le type de fichier que vous extrayez.

    3. Sélectionnez le fichier contenant la clé privée ou le certificat privé.

    4. Saisissez le mot de passe du fichier.

    5. Cliquez sur Save pour extraire le fichier et revenir à la configuration de la connexion.

  3. Cliquez sur Continuer pour enregistrer la connexion et revenir au module.

Modules Adobe Target et leurs champs

Lorsque vous configurez les modules Adobe Target, Workfront Fusion affiche les champs répertoriés ci-dessous. En plus de ces derniers, des champs Adobe Target supplémentaires peuvent s’afficher, selon des facteurs tels que votre niveau d’accès dans l’application ou le service. Un titre en gras dans un module indique un champ obligatoire.

Si le bouton « Mapper » apparaît au-dessus d’un champ ou d’une fonction, vous pouvez l’utiliser pour définir des variables et des fonctions pour ce champ. Pour plus d’informations, consultez la section Mappage des informations d’un module à un autre dans Adobe Workfront Fusion.

Actions

Créer un enregistrement

Ce module d’action crée une activité AB ou XT, une offre ou une audience.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Record type

Sélectionnez le type d’enregistrement que vous souhaitez créer.

Champs d’activité XT
Name
Saisissez ou mappez un nom pour cette activité. Le nom ne peut pas dépasser 250 caractères.
Options

Pour chaque option à ajouter à l’activité, cliquez sur Add item et renseignez les champs suivants :

  • Option local ID

    Saisissez ou mappez une chaîne à utiliser pour effectuer le suivi de l’option dans les requêtes d’API.

  • Name

    Saisissez ou mappez un nom pour l’option. Le nom ne doit pas dépasser 250 caractères.

  • Offer ID

  • Sélectionnez ou mappez l’offre associée à l’option.

Locations

Pour chaque mBox à ajouter à l’activité, cliquez sur Add item et renseignez les champs suivants :

  • Audience IDs

    Pour chaque audience à ajouter au fichier mbox, cliquez sur Add item et sélectionnez l’identifiant d’audience.

  • Location local ID

    Saisissez ou mappez une chaîne à utiliser pour effectuer le suivi de l’emplacement dans les requêtes d’API.

  • Name

    Saisissez ou mappez un nom pour l’emplacement. Le nom ne doit pas dépasser 250 caractères.

Experiences

Liste des emplacements sur la page où l’offre de contenu est diffusée. Un emplacement contient les éléments suivants :

  • Experience local ID

    Saisissez ou mappez l’ID de l’expérience.

  • Name

    Saisissez ou mappez le nom de l’expérience.

  • Audience IDs

    Pour chaque audience dont vous souhaitez voir l’expérience, cliquez sur Add item et saisissez l’identifiant d’audience.

  • Visitor Percentage

    Saisissez ou mappez le pourcentage de visiteurs et visiteuses affecté à l’expérience.

Metrics
Third Party ID
Saisissez ou mappez un identifiant pour identifier cette activité. Vous pouvez choisir cet identifiant. Cet identifiant ne doit pas être identique à une autre activité et ne peut pas dépasser 250 caractères.
Starts at
Saisissez ou mappez la date et l’heure de début de l’activité au format YYYY-MM-DD hh:mm:ss.z.
Ends at
Saisissez ou mappez la date et l’heure de fin de l’activité au format YYYY-MM-DD hh:mm:ss.z.
State

Saisissez ou mappez l’état de l’activité.

  • Approved

  • Deactivated

  • Paused

  • Saved

  • Deleted

Priority
Saisissez un nombre qui définit la priorité de l’activité. Les nombres plus élevés ont une priorité plus élevée. Cette valeur doit être comprise entre 0 et 999. La valeur par défaut est 5.
Auto-allocate traffic

Activez cette option pour affecter automatiquement le trafic. L’affectation automatique envoie plus de trafic vers l’expérience la plus performante.

Sélectionnez ou mappez les critères d’évaluation selon lesquels vous souhaitez juger quelle expérience est la plus réussie.

Workspace
Saisissez ou mappez l’espace de travail auquel l’activité est associée.
Property IDs
Pour chaque propriété à ajouter à l’activité, cliquez sur Add item et sélectionnez ou mappez l’ID de la propriété.
Reporting audiences

Pour chaque audience de création de rapports à ajouter à l’activité, cliquez sur Add item et saisissez les informations suivantes :

  • Reporting Audience local ID

    Saisissez ou mappez une chaîne à utiliser pour effectuer le suivi de l’audience de création de rapports dans les requêtes d’API.

  • Audience ID

    Saisissez ou mappez le segment à utiliser dans les rapports.

  • Metric local ID

    Saisissez ou mappez une chaîne à utiliser pour effectuer le suivi de la mesure dans les requêtes d’API.

Champs d’offre
Name
Saisissez ou mappez un nom pour cette activité. Le nom ne peut pas dépasser 250 caractères.
Content
Saisissez ou mappez le contenu de l’offre qui sera présentée à l’utilisateur ou à l’utilisatrice.
Workspace
Saisissez ou mappez l’ID de l’espace de travail associé à l’offre. Si rien n’est indiqué, l’offre est associée à l’espace de travail par défaut du compte. Cette fonctionnalité s’applique uniquement aux comptes Target Premium.
Workspace
Saisissez ou mappez la date et l’heure de modification de cette offre.

Effectuer un appel d’API personnalisé

Ce module effectue un appel API personnalisé à l’API Adobe Target.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Target Base URL
Saisissez ou mappez vos URL de base Target.
Path
Saisissez un chemin relatif à {baseURL}.
Method
Sélectionnez la méthode de requête HTTP dont vous avez besoin pour configurer l’appel API. Pour plus d’informations, voir Méthodes de requête HTTP dans Adobe Workfront Fusion.
Headers

Ajoutez les en-têtes de la requête sous la forme d’un objet JSON standard.

Par exemple, {"Content-type":"application/json"}

Workfront Fusion ajoute automatiquement des en-têtes d’autorisation et des en-têtes x-api-key.

Query String
Saisissez la chaîne de requête.
Body

Ajoutez le contenu du corps de l’appel API sous la forme d’un objet JSON standard.

Note :

Lors de l’utilisation d’instructions conditionnelles telles que if dans votre fichier JSON, placez les guillemets en dehors de l’instruction conditionnelle.

Supprimer un enregistrement

Ce module d’action supprime une seule activité AB, une seule activité XT, une seule offre ou une seule audience.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Record type
Sélectionnez le type d’enregistrement que vous souhaitez supprimer.
Record ID
Saisissez ou mappez l’identifiant de l’enregistrement que vous souhaitez supprimer.

Lire un enregistrement

Ce module d’action récupère les données d’une seule activité, offre, audience, propriété ou d’un seul rapport.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Record type
Sélectionnez le type d’enregistrement à lire.
Record ID
Saisissez ou mappez l’ID de l’enregistrement à lire.

Mettre à jour un enregistrement

Ce module d’action met à jour un enregistrement dans Target.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Record type
Sélectionnez le type d’enregistrement que vous souhaitez mettre à jour.
Field names

Sélectionnez les champs que vous souhaitez mettre à jour. Les champs apparaissent en dessous.

Pour plus de détails sur les champs, voir la documentation de l’API Adobe Target.

Recherches

Obtenir des enregistrements

Ce module de recherche récupère une liste d’enregistrements du type sélectionné.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Record type
Sélectionnez le type d’enregistrement à mettre à jour.
Sort by
Pour chaque champ de tri, cliquez sur Add item, sélectionnez le champ et indiquez si les résultats renvoyés doivent être classés par ordre croissant ou décroissant.
Starts At

Saisissez la date la plus ancienne pour laquelle vous souhaitez récupérer les enregistrements.

Pour obtenir la liste des formats de date et d’heure pris en charge, consultez la section Coercition de type dans Adobe Workfront Fusion.

Ends At

Saisissez la date la plus récente pour laquelle vous souhaitez récupérer les enregistrements.

Pour obtenir la liste des formats de date et d’heure pris en charge, consultez la section Coercition de type dans Adobe Workfront Fusion.

Rechercher

Ce module de recherche permet de rechercher des activités, des offres ou des audiences en fonction des critères que vous avez spécifiés.

Connection
Pour obtenir des instructions sur la création d’une connexion à Adobe Target, voir Créer une connexion à Adobe Target dans cet article.
Record type
Sélectionnez le type d’enregistrement à mettre à jour.
Sort by
Pour chaque champ de tri, cliquez sur Add item, sélectionnez le champ et indiquez si les résultats renvoyés doivent être classés par ordre croissant ou décroissant.
Search criteria
Pour chaque règle à configurer, sélectionnez le champ, l’opérateur et la valeur. Cliquez sur Add AND rule pour créer des règles supplémentaires.
Offset

Saisissez le numéro de la première réponse que le module doit renvoyer. La première réponse renvoyée comporte un décalage de 0. Utilisez ce champ en combinaison avec le champ Maximum number of returned results pour paginer les réponses.

Par exemple, pour afficher la troisième page de réponses, lorsque chaque page contient dix réponses, réglez Offset sur 20 et le Maximum number of returned de résultats sur 10.

Limit

Saisissez ou mappez le nombre maximal d’enregistrements que le module doit renvoyer pour chaque cycle d’exécution du scénario. Utilisez ce champ conjointement au champ Offset pour paginer les réponses.

Par exemple, pour afficher la troisième page de réponses, lorsque chaque page contient dix réponses, réglez Offset sur 20 et le Maximum number of returned de résultats sur 10.

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43