User Signals API

As of DT Exchange iOS SDK version 8.4.3, publishers can submit first-party data (user signals) such as The Trade Desk UID2 tokens and LiveRamp envelopes. Submitting user signals provides DT with deeper insights into user behavior and publisher-specific metrics so that we can better target ads to your users and increase fill rates. Additionally, if you are mediating DT Exchange, implementation of User Signals remains the same, no matter which mediation platform you use.

To submit user signals:

1. Ensure that you have integrated the latest DT Exchange Android SDK. For the latest version, see Integrating the iOS SDK.
2. For each user signal you want to submit, send the data as key-value pairs in the setExtraData method within the InneractiveAdManager.

• This method must be called after the SDK init, but before initiating an ad request or creating a bidding token.
• To pass multiple user signals, call the method once for every data point you wish to send.
• Calling the setExtraData method with a key that has already been sent overwrites the previous value associated with that key.

Method Signature

Objective-C

- (void)setExtraDataForKey:(nonnull NSString *)key
                     value:(nullable NSString *)value
NS_SWIFT_NAME(setExtraData(key:value:));

User Signals

Submit any of the following user signals as key-value pairs in the setExtraData method. The maximum value you can send is 512 characters. To delete a value previously set for a key, specify nil.

KEY	VALUE
UID2	UID2.0 token from The Trade Desk.
LRE	LiveRamp envelope. Do not submit the LiveRamp ID.

Example

Swift

// Passing the first parameter
IASDKCore.sharedInstance().setExtraData(key: "UID2", value: "UID2.0_access_token")

// Passing the second parameter
IASDKCore.sharedInstance().setExtraData(key: "LRE", value: "LiveRamp_envelope")

// Removing a custom parameter
IASDKCore.sharedInstance().setExtraData(key: "UID2", value: nil)

Objective-C