adobe.target.getOffer(options)

Dernière mise à jour : 20 juillet 2024
  • Rubriques :

Créé pour :

  • Développeur

Cette fonction déclenche une requête pour obtenir une offre Target.

Utilisez avec adobe.target.applyOffer() pour traiter la réponse ou utilisez votre propre gestion de succès. Le paramètre options est obligatoire et possède la structure suivante :

CléTypeRequisDescription
mboxChaîneOuiNom de mbox
paramsObjetNon

Paramètres mbox. Objet de paires clé-valeur qui possède la structure suivante :

{ "param1": "value1", "param2": "value2"}

successFonctionOui

Rappel à exécuter lors de l’obtention d’une réponse du serveur. La fonction de rappel de succès reçoit un seul paramètre qui représente un tableau des objets d’offre. Voici un exemple de rappel de succès :

function handleSuccess(response){......}

Pour plus d’informations, voir les réponses ci-dessous.

errorFonctionOui

Rappel à exécuter lors d’une erreur. Quelques cas sont considérés comme des erreurs :

  • Le code d’état HTTP est différent de 200 OK.
  • La réponse ne peut pas être analysée. Par exemple, le code JSON a été mal créé ou du code HTML a été utilisé à la place de JSON.
  • La réponse contient la clé error. Par exemple, une exception a été levée à la périphérie car une demande n’a pas pu être correctement traitée. Un message d’erreur peut être généré lorsqu’une mbox est bloquée et qu’il est impossible de récupérer le contenu correspondant, etc. La fonction de rappel d’erreur reçoit deux paramètres : status et error. Voici un exemple de rappel d’erreur : function handleError(status, error){......}

Pour plus d’informations, voir les réponses d’erreur ci-dessous.

timeoutNombreNon

Délai d’attente exprimé en secondes. Si cette valeur n’est pas spécifiée, le délai d’attente par défaut d’at.js est utilisé.

Le délai d’expiration par défaut peut être défini à partir de l’interface utilisateur Target sous Administration > Implementation.

Exemples

Ajout de paramètres avec getOffer() et utilisation de applyOffer() pour la gestion de succès :

adobe.target.getOffer({
  "mbox": "target-global-mbox",
  "params": {
     "a": 1,
     "b": 2
  },
  "success": function(offer) {
        adobe.target.applyOffer( {
           "mbox": "target-global-mbox",
           "offer": offer
        } );
  },
  "error": function(status, error) {
      console.log('Error', status, error);
  }
});

Ajout de paramètres et de paramètres de profil avec getOffer() et utilisation de applyOffer() pour la gestion de succès :

adobe.target.getOffer({
  "mbox": "target-global-mbox",
  "params": {
     "a": 1,
     "b": 2,
     "profile.age": 27,
     "profile.gender": "male"
  },
  "success": function(offer) {
        adobe.target.applyOffer( {
           "mbox": "target-global-mbox",
           "offer": offer
        } );
  },
  "error": function(status, error) {
      console.log('Error', status, error);
  }
});

Utilisation d’un délai d’expiration personnalisé et d’une gestion de succès personnalisée avec getOffer() :

« YOUR_OWN_CUSTOM_HANDLING_FUNCTION » est un espace réservé pour une fonction définie par le client.

adobe.target.getOffer({
  "mbox": "target-global-mbox",
  "success": function(offer) {
    YOUR_OWN_CUSTOM_HANDLING_FUNCTION(offer);
  },
  "error": function(status, error) {
    console.log('Error', status, error);
  },
  "timeout": 2000
});