Targets

Targets are predefined conditions that can be applied to a Content Group with the goal of limiting the delivery of content to a specific user segment. For example, a Content Group labeled "Everyone" with no targets applied will not factor in any user demographics, whereas a Content Group for "California Only" would have a target condition that restricts the delivery of content to only users located in California.

🚧

"Core" targets

Core targets refer to all system-defined targets that are shared across all clients and that cannot be modified. The system allows you to create custom targets and applied them according to your specific use case.

Get a list of all available targets

Before you decide to create a new target, you should review the list of all the available targets the system provides. You should use the following endpoint:

GET target?client_id={client_id)

Reference: https://docs.actv8me.com/v1.2/reference/target#get_target

Attach a target to a Content Group

Once you find the target that you want to apply to your content group, you should use the following endpoint:

POST content-group/{id}/target/{target_id}

Reference: https://docs.actv8me.com/v1.2/reference/content-group#post_content-group-id-target-target-id

Create Target

In case none of the core targets meet your requirement, you should use the following endpoint to create
a new custom target:

POST target

Reference: https://docs.actv8me.com/v1.2/reference/target#post_target

Update Target

If you need to update the target information, you should use the following endpoint:

PUT target/{id}

Reference: https://docs.actv8me.com/v1.2/reference/target#put_target-id

Delete Target

To delete a custom target you should use the following endpoint:

DELETE target/{id}

Reference: https://docs.actv8me.com/v1.2/reference/target#delete_target-id

Additional Targetting tools

Aside from core and custom targets, there are two other important targeting options available to advertisers:

Regions

A Region is defined by one or more geofences and location states (US only). An admin can create Regions and applied them to Content Groups. This allows for powerful location-based targetting.

For information on the Region resource, please refer to
https://docs.actv8me.com/v1.2/reference/region

Time Markers ("timemarks")

"Timemarks" are defined as points in the timeline of media content (audio/video) where contextual content should be made available to the end-user (i.e. 15 seconds after the start of a video).

For information on the Timemarks resource, please refer to
https://docs.actv8me.com/v1.2/reference/timemark