Set up connected TV campaigns on Samsung TV

With Adjust's partnership with Samsung, you can add your Adjust tracker URL to creatives you serve in Samsung TV campaigns. This lets you measure the success of your CTV campaigns and their role in driving mobile app installs.

Before you begin

Here's what you need to know before getting started.

Helpful information

  • Adjust is an approved vendor for Samsung Ads. This means that representatives from Samsung handle the implementation of your creatives and Adjust trackers in the Samsung platform.

Create a connected TV tracker in Adjust

To create an Adjust connected TV tracker, follow these steps.

  1. Find your app and select your app options caret (^).
  2. Select Tracker URLs.
  3. Select the Connected TV Trackers tab.
  4. Select NEW TRACKER.
  5. Enter a tracker name.
  6. Select Samsung from the network dropdown menu.
  7. Select Campaign Structure, and update the campaign structure parameters to map to your preferred Samsung macros.
    • Check the full list of available Samsung network macros you can use.
    • Before setting up your campaign parameter mappings, always consult your Samsung representative.
  8. Select APPLY.
  9. Optional: Customize the attribution window.
  10. Select CREATE.
  11. Finally, append the following parameter-value pairs to your tracker URL to support probabilistic impression tracking.
ParameterValue
ip_address__IP__
s2s1

This is an example Samsung connected TV tracker with optional network macros mapped to Adjust campaign parameters, and the necessary impression-tracking parameters appended.

https://view.adjust.com/impression/abc123?campaign=__CAMPAIGN_ID__&creative=__CREATIVE_ID__&ip_address=__IP__&s2s=1

Next steps

Samsung Ads is a managed service. This means that you do not need to manually upload your creatives to the platform or add Adjust trackers to creatives yourself.

Once you have created your connected TV tracker URL in the Adjust dashboard, reach out to your Samsung Ads representative. You can send them both the tracker(s) and creative(s) you will run in your campaign, and wait for their confirmation. And that's it - you're all set!

All Samsung network macros

Network macrosFormatDescription
__ADVERTISER_ID__integerThe advertiser ID for this impression. Example: 324
__ADVERTISER_NAME_ENCODED__stringThe URL component encoded name of the advertiser for this impression. Example: "Acme%20Corp"
__APP_BUNDLE_ID__stringThe application bundle ID identifying the application from which the ad request was initiated, for in-app advertisements. Example: "com.ae.history"

This value is configured or passed to the ad exchange by the application publisher or representative for in-app advertisement traffic originating from various app platforms such as iOS, Android, Tizen TV, etc. App bundle ID values may be re-used between platforms so it is advisable to consider this value in conjunction with user-agent or detected device and/or platform type. For example, "com.ae.history" on Tizen TV may be different than "com.ae.history" on Android.
__CAMPAIGN_ID__integerThe campaign ID for this impression.
__CLICK_TRACKER_URL__stringThe click tracker URL. Example: "http://rtb.adgrx.com/clicks/INFO/"

Appending a second URL to this URL will result in AdGear counting a click for this impression and re-directing to the second URL.
__CLICK_TRACKER_URL_ENCODED__stringSame as __CLICK_TRACKER_URL__ but URL component encoded.
Example: "http%3a%2f%2frtb.adgrx.com%3a8084%2fclicks%2fINFO%2f"
__CREATIVE_ID__integerThe creative ID for this impression. Example: 234
__DEVICE_UID_TYPE__stringThe device unique ID type. Possible values are: ag_cookie, apple_ifa or google_ifa
__DEVICE_UID__stringThe device unique ID value to go along with the device unique ID type.
__FORMAT__stringThe format/size for this impression. Example: "300x250"
__FLIGHT_ID__integerThe flight ID for this impression. Example: 324
__RANDOM_NUMBER__stringA random number string typically used to construct non-cacheable URLs.
__SPOT_ID__stringThe spot ID for the impression, unique to a single spot within a bid request. Example: "5664451242760709529"

Note: A single bid request may contain multiple spots, so an impression is uniquely identified by the combination of __BID_REQUEST_ID__ and __SPOT_ID__ 
__TIMESTAMP__integerThe number of seconds elapsed since the epoch date, January 1, 1970 (UTC) at the time of the impression call. Example: 1490936822
__TXN_ID__stringThe unique ID for this impression. Example: "c0728d4e-6691-11e3-9c63-fb540000002f:5664451242760709529"

This is typically used for server-side conversion tracking. It can be passed via a click tracker to the destination page where the destination site later associates it with a transaction and reports it back to AdGear by calling a conversion tag.

Note that this is usually equal to __BID_REQUEST_ID__:__SPOT_ID__.
__TXN_ID_INT__integerNumerical version of the __TXN_ID__, useful when you need a unique integer ID for a BidRequest and Impression combo.
NOTE: This macro cannot be used for conversion attribution.
__IP__stringThe IP address of the browser/device for this impression. Example: 192.168.1.1