Getting Started with the Adobe Target Delivery API

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.

Postman Collection

Postman is an application that makes it easy to fire API calls. This Postman collection contains sample Delivery API calls.

On this page