Display ads

Create a new display ad

Changed on

Generates a tag to be fired when DAI exposures occur.

post/measurement/campaigns/{campaign_id}/display_ads

Request

  • Base URL
    https://api.magellan.ai/v2
  • URL
    https://api.magellan.ai/v2/measurement/campaigns/{campaign_id}/display_ads
  • Auth
    API key in header Authorization

Path parameters

campaign_idstring required
Example:0123456789abcdef

Request body

echostring

Example request

{
  "measurementDisplayAd": {
    "name": "The Pod Show - Mid-Roll",
    "uid": "ad-123-456",
    "cohortsAttributes": [
      {
        "cohortName": "Creative",
        "subCohortName": "Holiday 30s"
      }
    ],
    "flightsAttributes": [
      {
        "id": 123,
        "startDate": "2024-03-01",
        "endDate": "2024-03-31",
        "expectedImpressions": 100,
        "cpm": 10,
        "uid": "qtr-1-flight-1"
      }
    ]
  }
}

Response

OK

echostring

Example response

{
  "measurementDisplayAd": {
    "id": "0123456789abcdef",
    "name": "The Pod Show - Mid-Roll",
    "uid": "ad-123-456",
    "cohorts": [
      {
        "cohortName": "Creative",
        "subCohortName": "Holiday 30s"
      }
    ],
    "campaign": {
      "id": "0123456789abcdef",
      "name": "Brand Campaign Q2",
      "startDate": "2024-03-01",
      "endDate": "2024-03-01",
      "customEvents": [
        {
          "id": 1,
          "label": "Signup",
          "pattern": "example.com/sign_up"
        }
      ],
      "pixel": {
        "id": "0123456789abcdef",
        "name": "Attribution Pixel",
        "brand": {
          "crmBrandId": "brand_0123456789abcdef",
          "name": "ACME Corp., Inc.",
          "domain": "acme.com"
        }
      }
    },
    "meta": {
      "pagination": {
        "currentPage": 1,
        "totalPages": 3,
        "count": 25
      }
    }
  }
}

Changes

    • breaking

      added to the //// request property allOf list

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the media type application/json for the response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property ////////////// to the response with the status

    • info

      added the optional property ////////////// to the response with the status