Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

Verity Verity™ provides brand safety and contextual classification data for partner video platforms such as IRIS.TV and JW Player.

For the purposes of pre-bid targeting or creating video PMPs, DSPs/SSPs can get classification data for video assets on these platforms directly from Verity. A DSP Verity™. DSPs/SSPs can use the unique identifier assigned by the partner platform (such as the IRIS IDpublisher (content_id) to identify a video asset, without access to the video URL.

Verity Verity™ refers to the unique partner platform content identifier for a video as the partnercontent_id.

The integration works as follows:

The partner video platform (such as IRIS.TV)

:

    • Initiates a video classification request to Verity, specifying the video’s URL and partner_id (in this case the IRIS ID).

    • Verity maps the video URL and partner_id to a Verity uuid and analyzes the video.

    • Verity responds to IRIS.TV with the video URL, partner_id, uuid, and classification.

    A DSP partner (such as MediaMath)DSP/SSP partners:

    • Initiates a classification request to VerityVerity™, specifying a video’s partnercontent_id (in this case the IRIS ID).

    • Verity Verity™ checks for the partnercontent_id.

    • If data is available, Verity Verity™ returns the correct video classification to the DSP/SSP.

Important: Contact verity-support@gumgum.com to find out more about enabling the usage of partnercontent_id for video classification.

Video Classification Endpoint for

partner

content_id

The Verity Verity™ video analysis retrieval endpoint is:

GET /video/classification/{partnercontent_id}

Verity API processes HTTP GET requests for video classification data. The video is identified by a partnercontent_id, which is a unique persistent identifier assigned by a video platform (such as an IRIS ID)publisher.

Example Video Request

This example walks through retrieving classification data for a video available in the IRIS.TV Contextual Marketplace. The video’s partnercontent_id is an IRIS ID of iris_12345.

Example GET Request

Submit a GET request to /video/classification/{partnercontent_id}, for example:

curl -X GET "https://verity-api.gumgum.com/video/classification/iris_12345" -H "accept'Accept: application/" json' -H "x-api-key: <YOUR_API_KEY_HERE>"

Note: The API Key you specify must include support for partnercontent_id usage.

Example JSON Response

If video classification data is available, the Verity API returns a JSON response with Content-Type: application/json; charset=UTF-8.

The data payload includes the JSON classification results detailing the complete brand safety, keyword, and categorization analysis data for the video.  For example:

Code Block
languagejson
{
  "uuid": "668e9d0e-a909-5ea0-9017-80c983a8db2c",
  "url": "https://vod-progressive.net/...filename=pexels-karolina-grabowska-5644289.mp4",
  "data": {
    "processedAt": "2021-05-21T16:47:35.352Z",
    "expiresAt": "2022-05-16T16:47:35.352Z",
    "languageCode": "en",
    "iab": {
      "v2": [
        {
          "id": "52",
          "category": "Business and Finance",
          "score": 0.95
        }
      ]
    },
    "keywords": [
      "black friday sale"
    ],
    "safe": true,
    "threats": [],
    "sentiments": [
      {
        "sentiment": "neutral",
        "score": 1
      },
      {
        "sentiment": "negative",
        "score": 0
      },
      {
        "sentiment": "positive",
        "score": 0
      }
    ],
    "segments": [
      {
        "id": "a708990d-c2d2-483d-9a48-3c8f9ec4aa01",
        "name": "test-segment"
      }
    ]
  }
}

See JSON Response for details about the classification data included in the response.

More Information