Diffusion unique ou par lots

Dernière mise à jour : 20 juillet 2024

Créé pour :

  • Développeur

Adobe Target Delivery API prend en charge un appel de remise unique ou par lots. Vous pouvez envoyer une requête de serveur pour du contenu pour une ou plusieurs mbox.

Pesez les coûts de performance lorsque vous décidez d’effectuer un appel unique par rapport à un appel par lot. Si vous connaissez tout le contenu qui doit être affiché pour un utilisateur, la bonne pratique consiste à récupérer le contenu de toutes les mbox avec un seul appel de diffusion par lot, afin d’éviter d’effectuer plusieurs appels de diffusion uniques.

Appel de diffusion unique

Vous pouvez récupérer une expérience à afficher à l’utilisateur pour une mbox via Adobe Target Delivery API. Notez que si vous effectuez un seul appel de diffusion, vous devez lancer un autre appel de serveur pour récupérer du contenu supplémentaire pour une mbox pour un utilisateur. Cela peut devenir très coûteux au fil du temps. Par conséquent, veillez à évaluer votre approche lors de l’utilisation d’un seul appel de l’API de diffusion.

curl -X POST \
'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=7abf6304b2714215b1fd39a870f01afc#1555632114' \
-H 'Content-Type: application/json' \
-H 'cache-control: no-cache' \
-d '
{
  "id": {
    "tntId": "abcdefghijkl00023.1_1"
  },
  "context": {
    "channel": "web",
    "browser" : {
      "host" : "demo"
    },
    "address" : {
      "url" : "http://demo.dev.tt-demo.com/demo/store/index.html"
    },
    "screen" : {
      "width" : 1200,
      "height": 1400
    }
  },
    "execute": {
    "mboxes" : [
      {
        "name" : "SummerOffer",
        "index" : 1
      }
    ]
  }
}'

Dans l’exemple d’appel de diffusion unique ci-dessus, l’expérience est récupérée pour s’afficher pour l’utilisateur avec tntId: abcdefghijkl00023.1_1 pour un mbox:SummerOffer sur le canal web. Cet appel de diffusion unique génère la réponse suivante :

{
  "status": 200,
  "requestId": "25e0cc42-3d7b-456a-8b49-af60c1fb23d9",
  "client": "demo",
  "id": {
      "tntId": "abcdefghijkl00023.1_1"
  },
  "edgeHost": "mboxedge28.tt.omtrdc.net",
  "execute": {
      "mboxes": [
          {
              "index": 1,
              "name": "SummerOffer",
              "options": [
                  {
                      "content": "<p><b>Enjoy this 15% discount on your next purchase</b></p>",
                      "type": "html",
                  }
              ]
          }
      ]
    }
}

Dans la réponse, notez que le champ content contient l’HTML qui décrit l’expérience à présenter à l’utilisateur pour le web qui correspond à la mbox SummerOffer.

Exécuter le chargement de page

Si des expériences doivent être affichées lorsqu’un chargement de page se produit dans le canal web, par exemple un test A/B des polices situées dans le pied de page ou l’en-tête, vous pouvez spécifier pageLoad dans le champ execute pour récupérer toutes les modifications à appliquer.

curl -X POST \
  'https://demo.tt.omtrdc.net/rest/v1/delivery?client=demo&sessionId=d359570e04f14e1faeeba02d6ab9914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
  "id": {
    "tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
  },
  "context": {
    "channel": "web",
    "window": {
      "width": 1819,
      "height": 842
    },
    "browser": {
      "host": "target.enablementadobe.com"
    },
    "address": {
      "url": "https://target.enablementadobe.com/react/demo/#/"
    }
  },
  "execute": {
    "pageLoad": {}
  }
}'

L’exemple d’appel ci-dessus récupère toutes les expériences pour afficher un utilisateur lors du chargement de la page https://target.enablementadobe.com/react/demo/#/.

{
      "status": 200,
      "requestId": "355ebc47-edb6-481f-aeae-ae55d71afaca",
      "client": "demo",
      "id": {
          "tntId": "84e8d0e211054f18af365d65f45e902b.28_131"
      },
      "edgeHost": "mboxedge28.tt.omtrdc.net",
      "execute": {
          "pageLoad": {
              "options": [
                  {
                      "content": [
                          {
                              "type": "setHtml",
                              "selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(1) > NAV.nav:eq(0) > DIV.container:eq(0) > DIV.nav-right:eq(0) > A.nav-item:eq(0)",
                              "cssSelector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(1) > NAV:nth-of-type(1) > DIV:nth-of-type(1) > DIV:nth-of-type(2) > A:nth-of-type(1)",
                              "content": "Modified Home"
                          }
                      ],
                      "type": "actions"
                  }
              ],
              "metrics": [
                  {
                      "type": "click",
                      "selector": "#app > DIV:nth-of-type(1) > DIV:nth-of-type(2) > SECTION.section:eq(0) > DIV.container:eq(0) > FORM.col-md-4:eq(0) > DIV.form-group:eq(0) > BUTTON.btn:eq(0)",
                      "eventToken": "QPaLjCeI9qKCBUylkRQKBg=="
                  }
              ]
          }
      }
  }

Dans le champ content , la modification qui doit être appliquée au chargement d’une page peut être récupérée. Dans l’exemple ci-dessus, notez qu’un lien sur l’en-tête doit être nommé Modified Home.