User Signals API

As of DT Exchange iOS SDK version 8.4.3, publishers can submit first-party data in a flexible key-value pair format, providing deeper insights into user behavior and publisher-specific metrics.

To pass the custom parameters, use the setExtraData method within the IASDKCore shared instance.

This method must be called after the SDK init, but before initiating an ad request or creating a bidding token.

Method Signature

Objective-C

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

Implementation Details

key

String. The name of the targeting parameter. Use the following case-sensitive values:

• UID2: Identifier from The Trade Desk.

• LRE: LiveRamp envelope. Note this is not the LiveRamp ID.

value

String. Specify one of the following values:

• The data associated with the key. Max length: 512 characters.

• nil: deletes the value previously set for the key.

Usage Example

To pass multiple custom parameters, call the method once for every data point you wish to register.

Calling the method with a key that has already been set overwrites the previous value associated with that key.

Swift

// Passing the first parameter
IASDKCore.sharedInstance().setExtraData(key: "key1", value: "value1")

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

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

Objective-C