This document helps you set up Samsung DSP as an integrated partner with this MMP.
The credit attribution process requires you to define the click/impression tracker within the MMP platform by using macros/parameters that will be interpreted by Samsung DSP. After adding the tracking link to the Creative, you need to create a conversion group to retrieve the postback data for generating reports.
Here are the types of campaigns this MMP can be used for:
- Mobile - Mobile: This campaign type focuses on mobile advertising, where the attributed event takes place within a mobile app.
- TV - TV: With this campaign type, you can leverage TV advertising, targeting attributed events within a TV app.
- TV - Mobile (Cross-Device): This campaign type allows you to run TV advertising campaigns across multiple devices, including TV apps, mobile apps, and web platforms.
Currently, Adjust does not offer support for TV-TV links that are automatically generated within their platform. To address this, we kindly ask you to create a TV-Mobile (Cross-Device) link and reach out to your Account Manager, also known as the Admin, for further guidance on the configuration process.
Set up in AppsFlyer
-
Add Samsung as an integrated partner by following the procedure described in this section.
- Go to Configuration > Active Integrations.
- Select Samsung DSP. The Samsung partner integration page displays.
- Go to the Integration tab.
- Turn on Activate partner.
- Turn on View-through attribution.
-
In the Default postback section, make sure to select This partner only for each event name.
-
Set up the window time frame for the in-app events postback. See this section for more information.
-
Click on +Add Event to add in-app events. You can find more information about this in this section or contact the Appsflyer’s team to help you with the mapping.
- In the Mapped to partner event drop-down list, select As is.
- While not mandatory, in the For Users drop-down list, select All media sources, including organic if you want to use Smart Audiences or Lift reporting in Samsung DSP.
-
Confirm your changes by clicking on Save Integration.
Define the attribution links
- Click on the Attribution link tab.
- Select Use a single-platform link for TV-TV or Mobile-Mobile campaign types. Select OneLink for TV - Mobile (Cross-Device) campaign type.
- Click on +Add parameter to add the following:
| Parameter Name | Value | Description | Use Case (Campaign type) |
|---|---|---|---|
| c | __CAMPAIGN_NAME__ | Campaign name in Samsung DSP | All |
| af_adset__ | __FLIGHT_NAME__ | Flight name in Samsung DSP | All |
| af_ad__ | __CREATIVE_NAME__ | Creative name in Samsung DSP | All |
| af_siteid_ | __PUBLISHER_ID__ | Publisher ID in Samsung DSP | All |
| af_c_id | __CAMPAIGN_ID__ | Campaign ID in Samsung DSP | All |
| af_adset_id | __FLIGHT_ID__ | Flight ID in Samsung DSP | All |
| af_ad_id | __CREATIVE_ID__ | Creative ID in Samsung DSP | All |
| samsungdsp_creativegroupid | __CREATIVE_GROUP_ID__ | Creative Group ID in Samsung DSP | All |
| samsungdsp_impression | __TXN_ID__ | Auction ID | All |
| cost_type | __COST_TYPE__ | The bid cost type (e.g. CPM) | All |
| cost_amount | __COST_AMOUNT__ | The bid cost (e.g. the $1) | All |
| cost_currency | __COST_CURRENCY__ | The bid cost currency (e.g. USD) | All |
| sha1_advertising_id | __GAID_ID_SHA1__ | Hashed Google Advertising ID | All |
| af_ip | __IP__ | The device’s IP | All |
| af_ua | __USER_AGENT__ | The device’s user agent | All |
| af_lang | __LANGUAGE__ | The device’s language | All |
| exchange_bid_request_id | __EXCHANGE_BID_REQUEST_ID__ | The SSP/exchange bid request ID | All |
| samsungdsp_click_id= | 1 | All | |
| adgroup | __FLIGHT_ID__ | Flight ID in Samsung DSP | All |
| samsungdsp_flightid | __FLIGHT_ID__ | Flight ID in Samsung DSP | All |
| samsungdsp_bid_request_id | __BID_REQUEST_ID__ | The bid request ID for this impression unique to a single bid request | All |
| samsungdsp_impression_id | __SPOT_ID__ | The spot ID for the impression unique to a single spot within a bid request | All |
| external_device_id | DEVICE_UID | The unique ID of the device | TV-TV |
| gps_adid_lower_sha1 | __GAID_ID_SHA1__ | Hashed Google Advertising ID | Mobile-Mobile |
| ip_address | __IP__ | IP Address of the Device | All |
- Please ensure that the Retargeting settings toggle is set to OFF. Retargeting is currently not supported on Samsung DSP and may skew the number of installs reported.
- Set the maximum time from click to install in the Click-Through Attribution section, and the maximum time from impression to install in the View-Through Attribution section. See this page for more information about lookback window.
- Click Save attribution link to be able to copy the link for both click-through and view-through (impression) attribution.
Do not change or add any additional parameters to the click-based or impression-based tracker links, as this can cause tracking and reporting issues. Simply copy the links as-is from the UI.
Examples of tracking links from Adjust
TV-Mobile (Cross-Device)
Impression
https://impressions.onelink.me/{template_id}?pid=samsungdsp_int&c=__CAMPAIGN_NAME__&af_siteid=__PUBLISHER_ID__&af_adset=__FLIGHT_NAME__&af_ad=__CREATIVE_NAME__&af_c_id=__CAMPAIGN_ID__&af_adset_id=__FLIGHT_ID__&af_ad_id=__CREATIVE_ID__&af_viewthrough_lookback=24h&samsungdsp_creativegroupid=__CREATIVE_GROUP_ID__&samsungdsp_impression=__TXN_ID__&cost_type=__COST_TYPE__&cost_amount=__COST_AMOUNT__&cost_currency=__COST_CURRENCY__&af_ip=__IP__&af_ua=__USER_AGENT__&af_lang=__LANGUAGE__&samsungdsp_click=1&exchange_bid_request_id=__EXCHANGE_BID_REQUEST_ID__&bid_request_id=__BID_REQUEST_ID__&impression_id=__SPOT_ID__
Click
There is no click tracker for AppsFlyer CTV - Mobile use case.
TV-TV
Impression
https://engagements.appsflyer.com/v1.0/s2s/impression/app/tizen/{app_id}?af_media_source=samsungdsp_int&af_campaign_id=__CAMPAIGN_ID__&af_adset_id=__FLIGHT_ID__&af_ad_id=__CREATIVE_ID__&af_lookback_window=24h&af_request_id=__TXN_ID__&af_device_id_value=__DEVICE_UID__&af_device_id_type=tifa&af_ip=__IP__&exchange_bid_request_id=__EXCHANGE_BID_REQUEST_ID__&bid_request_id=__BID_REQUEST_ID__&impression_id=__SPOT_ID__
Click
https://engagements.appsflyer.com/v1.0/s2s/click/app/tizen/{app_id}?af_media_source=samsungdsp_int&af_campaign_id=__CAMPAIGN_ID__&af_adset_id=__FLIGHT_ID__&af_ad_id=__CREATIVE_ID__&af_lookback_window=7d&af_request_id=__TXN_ID__&af_device_id_value=__DEVICE_UID__&af_device_id_type=tifa&af_ip=__IP__&exchange_bid_request_id=__EXCHANGE_BID_REQUEST_ID__&bid_request_id=__BID_REQUEST_ID__&impression_id=__SPOT_ID__
Mobile-Mobile
Impression
https://impression.appsflyer.com/{app_id}?pid=samsungdsp_int&c=__CAMPAIGN_NAME__&af_siteid=__PUBLISHER_ID__&af_adset=__FLIGHT_NAME__&af_ad=__CREATIVE_NAME__&af_c_id=__CAMPAIGN_ID__&af_adset_id=__FLIGHT_ID__&af_ad_id=__CREATIVE_ID__&af_viewthrough_lookback=24h&samsungdsp_creativegroupid=__CREATIVE_GROUP_ID__&samsungdsp_impression=__TXN_ID__&cost_type=__COST_TYPE__&cost_amount=__COST_AMOUNT__&cost_currency=__COST_CURRENCY__&sha1_advertising_id=__GAID_ID_SHA1__&af_ip=__IP__&af_ua=__USER_AGENT__&af_lang=__LANGUAGE__&samsungdsp_click=1&exchange_bid_request_id=__EXCHANGE_BID_REQUEST_ID__&bid_request_id=__BID_REQUEST_ID__&impression_id=__SPOT_ID__
Click
TBD
Grant access
These steps provide access to the Samsung Ads team to view the campaign results.
-
Click on the Permissions tab.
-
Follow the steps described in this section:
- Enter Samsung DSP team members’ emails to add them as ad network team member.
- Except for Use ad spend ingestion, please enable other permissions.
Set up in Samsung DSP
For AppsFlyer Integration, the name of the events must match the value under Partner event identifier under the AppsFlyer In-App events postback section.
- In the left menu, click on the Creative icon .
- In the Creative Listing page, you can create an Ad Server VAST URL creative by following this procedure, OR click on the Actions button (three dot) of the existing creative and select Edit to add the tracking URLs.
- Under the Vast URL Creative section, click on +Add to enable the fields.
- Paste the attribution links (i.e., Impression and Click tracker URLs) obtained from the MMP into the appropriate field.
Monitor Performance
To track the conversion data (i.e., attributed data) from the MMP, you need to:
- Create and attach a conversion group to the flight containing the creative with MMP tracking links for impression and clicks. See Conversion Group for more information.
- Create an Interactive Delivery report by adding the following dimensions and metrics. See Delivery for more details.
| Type | Name | Description |
|---|---|---|
| Dimension | Conversion Group | The name of the conversion group. |
| Dimension | Conversion Segment | When it comes to MMP conversions, this will be filled with the event names that are sent by the MMP. |
| Dimension | Conversion Type | This will display the event names as MMP_IN_APP, MMP_REVENUE, or MMP_INSTALL |
| Metric | Conv. Click Through | The number of click-through conversions. |
| Metric | Conv. View Through | The number of view-through conversions. |
| Metric | Conversions | The total number of conversions. This equals to the sum of the previous two metrics. |
| Metric | Conversions CTR | Click-through conversion rate. |
| Metric | Conversions VTR | View-through conversion rate. |
| Metric | Spend to Revenue Ratio | Advertiser Spend / Conversion Revenue, otherwise known as RoaS. |
These metrics are updated on an hourly basis within Samsung DSP, providing you with a nearly real-time perspective on the performance of your campaigns. This offers unique insights into campaign performance so that you can develop optimization strategies that align with your goals.
In addition to the standard campaign metrics and dimensions, you can calculate various other metrics, such as:
- The Cost Per Install (CPI) by dividing Advertiser Spend by Install Conversions.
- The Cost Per in-app event (sessions, video starts, etc.) by dividing Advertiser Spend by In-App Conversions.
- The Return On Ad Spend (ROAS) by measuring in-app revenue against advertiser spend, and conversion rates.
Furthermore, you can analyze these events in a highly detailed manner, breaking them down by campaign, creative, inventory source or type, TV-Plus channel, and more. This level of granularity allows for a deeper understanding of performance drivers and facilitates targeted optimizations.