DocumentationGuide du développeur de Target

adobe.target.applyOffers(options) - at.js 2.x

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

Créé pour :

  • Développeur

Cette fonction vous permet d’appliquer plusieurs offres récupérées par adobe.target.getOffers().

REMARQUE
Cette fonction a été introduite avec at.js 2.x. Cette fonction n’est pas disponible pour at.js version 1.x.
CléTypeObligatoire ?Description
selectorChaîneNonÉlément HTML ou sélecteur CSS utilisé pour identifier l’élément HTML dans lequel Target doit placer le contenu de l’offre. Si aucun sélecteur n’est fourni, Target suppose que l’élément d’HTML à utiliser est un HEAD HTML.
RéponseObjetOuiObjet réponse de getOffers().
Voir Requêtes ci-dessous.

Réponse

REMARQUE
Pour plus d’informations sur les types acceptables pour tous les champs répertoriés ci-dessous, consultez la documentation de l’API de diffusion .
Nom du champDescription
réponse > prérécupérer > vues > options > contenuNotez que le contenu de l’« option » n’est pas bien défini et dépend directement de la structure du type/modèle d’option.
réponse > prérécupérer > vues > options > typeType d’option. Reflète le type de champ « contenu ». Le type pris en charge est Actions.
réponse > prérécupérer > vues > étatJeton d’état d’affichage opaque qui doit être transféré avec une notification d’affichage pour la vue
réponse > prérécupérer > vues > options > jetonsderéponseContient le mappage de responseTokens qui a été collecté lorsque l’option actuelle était en cours de traitement.
réponse > prérécupérer > vues > analytics > charge utileAnalytics charge utile pour l’intégration côté client qui doit être envoyée à Analytics une fois la vue appliquée.
réponse > prérécupérer > vues > traceObjet contenant toutes les données de suivi pour l’appel de prérécupération par affichage.
L’objet trace comprend également une version pour la trace.
L’objet trace comprend également des détails sur la vue actuelle.
réponse > prérécupérer > vues > options > jetonDévénementLa journalisation d’événements est effectuée par option. Pour chaque option appliquée, le jeton d’événement correspondant doit être ajouté à la liste des jetons de notification. Notez qu’une vue est composée de plusieurs options. Si toutes les options ont été appliquées et affichées, toutes eventTokens doivent être incluses dans la notification.
réponse > prérécupérer > vues > nomNom d’affichage lisible.
réponse > prérécupérer > vues > mesuresMesures de création de rapports qui doivent être regardées, puis notifiées Target. Actuellement, il suffit de cliquer sur Mesure pour afficher la mesure. Si un clic sur l’élément se produit, les informations appropriées eventTokens doivent être collectées et une notification doit être envoyée.
réponse > prérécupérer > vues > cléClé ou empreinte digitale qui identifie la vue.
réponse > prérécupérer > vues > idID de la vue.
réponse > notifications > idIdentifiant de notification.
réponse > notifications > événements > typeType de notification, du clic ou de l’affichage.
réponse > notifications > événements > traceTrace de l’événement de notification.
réponse > notifications > événements > jetonJeton envoyé avec l’événement de notification.
réponse > notifications > événements > horodatageHorodatage envoyé avec l’événement de notification.
réponse > notifications > événements > erreurCodeSi la notification a échoué, le code indique la raison de l’échec.
réponse > notifications > événementsÉvénements consignés ou non répertoriés pour la notification actuelle.
réponse > notificationsIndique les notifications enregistrées ou non.
réponse > exécuter > mbox > mbox > traceObjet contenant toutes les données de suivi pour la requête de mbox individuelle.
réponse > exécuter > mbox > mbox > jetons de réponseContient le mappage responseTokens pour l’exécution spécifique de la requête de mbox.
réponse > exécuter > mbox > mbox > option > contenuNotez que le contenu de l’« option » n’est pas bien défini et dépend directement de la structure du type/modèle d’option.
réponse > exécuter > mbox > mbox > option > typeType d’option. Reflète le type de champ « contenu ». Les types pris en charge sont les suivants : html, redirect, JSON et dynamique.
réponse > exécuter > mbox > mbox > optionsOption de réponse.
réponse > exécuter > mbox > mbox > mesures > eventtokenJeton d’événement de clic.
réponse > exécuter > mbox > mbox > mesures > type"click"
réponse > exécuter > mbox > mbox > mesuresContient la liste des mesures clickThrough.
réponse > exécuter > mbox > mbox > mboxNom de la mbox.
réponse > exécuter > mbox > mbox > indexIndique que la réponse est destinée à la mbox avec cet index de la requête.
réponse > exécuter > mbox > mbox > analytics > chargeAnalytics charge utile pour l’intégration côté client qui doit être envoyée à Analytics une fois la mbox appliquée. (Voir la section Campagnes compatibles avec A4T).
réponse > exécuter > mboxListe des mbox exécutées.
réponse > exécuter > pageLoad > options > contenuNotez que le contenu de l’« option » n’est pas bien défini et dépend directement de la structure du type/modèle d’option.
réponse > exécuter > pageLoad > options > typeType d’option. Reflète le type de champ « contenu ». Les types pris en charge sont : html, rediriger, JSON, dynamique et actions.
réponse > exécuter > pageLoad > optionsOptions qui ne sont pas regroupées par affichage (target-global-mbox + options issues d’activités dont les vues ne sont pas regroupées par affichage).
réponse > exécuter > pageLoad > mesuresCliquez sur les mesures qui n’ont pas été définies pour appartenir à une vue spécifique.
réponse > exécuter > pageLoad > suiviObjet contenant toutes les données de suivi pour la requête pageLoad.
réponse > exécuter > pageLoad > analytics > chargeAnalytics charge utile pour l’intégration côté client qui doit être envoyée à Analytics après l’application du contenu de chargement de page. (Voir la section Campagnes compatibles avec A4T).

Exemple d'appel applyOffers()

adobe.target.applyOffers({response:{
  "execute": {
    "pageLoad": {
      "options": [{
        "type": "html",
        "content": "page-load"
      },
      {
        "type": "actions",
        "content": [{
          "type": "setHtml",
          "content": "<h1>Container 1</h1>",
          "selector": "#container1",
          "cssSelector": "#container1"
        },
        {
          "type": "setHtml",
          "content": "<h3>Container 3</h3>",
          "selector": "#container3",
          "cssSelector": "#container3"
        }]
      }],


      "metrics": [{
        "type": "click",
        "selector": "#container1",
        "eventToken": "page-load-click-metric"
      }]
    }
  }
}});

Exemples d’appels de chaîne de promesse avec getOffers() et applyOffers(), car ces fonctions sont basées sur la promesse

adobe.target.getOffers({...})
.then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));

Pour plus d’exemples sur l’utilisation de getOffers(), reportez-vous à la documentation de getOffers

Exemple de requête de chargement de page

adobe.target.getOffers({
    request: {
        execute: {
            pageLoad: {}
        }
    }
}).
then(response => adobe.target.applyOffers({ response: response }))
.then(() => console.log("Success"))
.catch(error => console.log("Error", error));
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3