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 , a DSP can work directly with Verity to request existing video classification data. Important: To enable support for this feature, the DSP must contact verity-support@gumgum.comor creating video PMPs, DSPs/SSPs can get classification data for video assets directly from Verity™. DSPs/SSPs can use the unique identifier assigned by the publisher (content_id) to identify a video asset, without access to the video URL.
Verity™ refers to the unique content identifier for a video as the content_id.
The integration works as follows:
The DSP provides Verity with the video platform’s unique video identifier.
Verity checks to see if the video has already been analyzed and classification data is availableDSP/SSP partners:
Initiates a classification request to Verity™, specifying a content_id (in this case the IRIS ID).
Verity™ checks for the content_id.
If data is available,
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 content_id
for video classification.
Video Classification Endpoint for content_id
The Verity Verity™ video analysis retrieval endpoint is:
GET /video/classification/{publisherIdcontent_id}
Verity API processes HTTP GET requests for video classification data. The video is identified by a publisherId
content_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 publisherId
is an IRIS_ID of content_id
is iris_12345
.
Example GET Request
Submit a GET request to /video/classification/{publisherIdcontent_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 this feature content_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 | ||
---|---|---|
| ||
{ "uuid": "668e9d0e-a909-5ea0-9017-80c983a8db2c", "url": "https://vod-progressive.akamaized.net/exp=1621618638~acl=%2Fvimeo-prod-skyfire-std-us%2F01%2F3987%2F18%2F469935935%2F2090153996.mp4~hmac=a621155b76838fc3b5073dfdda3fbf730af5fd96d24bcbab3c25ee41dc023239/vimeo-prod-skyfire-std-us/01/3987/18/469935935/2090153996.mp4?download=1&...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 more details about the fields classification data included in the response.