Création d’offres JSON

Créez des offres JSON dans la bibliothèque d’Offres dans Adobe Target pour les utiliser dans le compositeur d’expérience d’après les formulaires.

Les offres JSON peuvent être utilisées dans des activités basées sur des formulaires, dans lesquelles l’activation des cas d’utilisation où la décision de Target est requise pour envoyer une offre au format JSON à des fins de consommation dans SPA cadre ou des intégrations côté serveur.

Considérations relatives à JSON

Tenez compte des informations suivantes lorsque vous utilisez les offres JSON :

Les offres JSON sont actuellement disponibles uniquement pour les activités Test A/B et Ciblage d’expérience (XT).
Les offres JSON ne peuvent être utilisées que dans les activités basées sur un formulaire.
L’offre JSON peut être extraite directement via l’API côté serveur, le kit SDK mobile ou le kit SDK NodeJS.
Dans le navigateur, les offres JSON peuvent désormais être extraites UNIQUEMENT via at.js 1.2.3 (ou version supérieure) et getOffer() en filtrant les actions via l’action setJson.
Les offres JSON sont diffusées sous forme d’objets JSON natifs plutôt que de chaînes. Les consommateurs de ces objets ne doivent plus traiter ces objets en tant que chaînes et les convertir en objets JSON.
Contrairement aux autres offres (par exemple, les offres HTML), les offres JSON ne sont pas appliquées automatiquement parce qu’il s’agit d’offres non visuelles. Les développeurs doivent écrire du code pour obtenir explicitement l’offre au moyen de la fonction getOffer().
Les offres JSON ne sont pas prises en charge si vous utilisez mbox.js.

Créer une offre JSON

Cliquez sur Offres > Offres de code.
Cliquez sur Créer > Offre JSON.
Saisissez le nom de l’offre.
Saisissez ou copiez votre code JSON dans la zone Code.
Cliquez sur Enregistrer.

Exemple JSON

Les offres JSON ne sont prises en charge que dans les activités créées à l’aide du compositeur d’expérience d’après les formulaires. À l’heure actuelle, les offres JSON peuvent uniquement être utilisées par le biais d’appels d’API directs.

Voici un exemple :

adobe.target.getOffer({ 
  mbox: "some-mbox", 
  success: function(actions) { 
    console.log('Success', actions); 
  }, 
  error: function(status, error) { 
    console.log('Error', status, error); 
  } 
});

Les actions transmises au rappel de succès constituent un tableau d’objets. En supposant que nous ayons une seule offre JSON, ce tableau contient les éléments suivants :

{ 
  "demo": {"a": 1, "b": 2} 
}

Le tableau des actions aura la structure suivante :

[ 
 { 
   action: "setJson", 
   content: [{ 
     "demo": {"a": 1, "b": 2} 
   }] 
 }  
]

Pour extraire l’offre JSON, vous effectuez une itération au moyen d’actions et recherchez l’action avec l’action setJson, puis une itération au travers du tableau de contenu.

Cas d'utilisation

Supposons que l’offre JSON suivante soit diffusée sur votre page web :

{ 
    "_id": "5a65d24d8fafc966921e9169", 
    "index": 0, 
    "guid": "7c006504-c6f7-468d-a46f-f72531ea454c", 
    "isActive": true, 
    "balance": "$2,075.06", 
    "picture": "https://placehold.it/32x32", 
    "tags": [ 
      "esse", 
      "commodo", 
      "excepteur", 
    ], 
    "friends": [ 
      { 
        "id": 0, 
        "name": "Carla Lyons" 
      }, 
      { 
        "id": 1, 
        "name": "Ollie Mooney" 
      }, 
    ], 
    "greeting": "Hello, Stephenson Fernandez! You have 4 unread messages.", 
    "favoriteFruit": "strawberry" 
}

Le code suivant indique comment accéder à l’attribut « greeting » :

adobe.target.getOffer({   
  "mbox": "name_of_mbox", 
  "params": {}, 
  "success": function(offer) {           
        console.log(offer[0].content[0].greeting); 
  },   
  "error": function(status, error) {           
      console.log('Error', status, error); 
  } 
});