DocumentationTarget Developer Guide

Getting Started with the Adobe Target Delivery API

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Developer

A Target Delivery API call looks like this:

curl -X POST \
  'https://`clientCode`.tt.omtrdc.net/rest/v1/delivery?client=`clientCode`&sessionId=d359234570e04f14e1faeeba02d6ab9914e' \
  -H 'Content-Type: application/json' \
  -H 'cache-control: no-cache' \
  -d '{
      "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" : "homepage",
            "index" : 1
          }
        ]
      }
    }'

The clientCode can be retrieved from the Target UI by navigating to Administration > Implementation.

Before making a Target Delivery API call, follow these steps to ensure a response contains the relevant experience to show end users:

  1. Create a Target activity (A/B, XT, AP or Recommendations) using the Form-Based Composer or the Visual Experience Composer.
  2. Use the Delivery API to get a response for the mboxes used in the Target activity created in Step 2.
  3. Present the experience to the visitor.
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3