Leveraging RampID

By providing LiveRamp envelope to BidMachine, publishers can boost monetization while staying compliant with privacy standards. BidMachine collaborates with LiveRamp and uses the LiveRamp Authenticated Traffic Solution (ATS) API.

For more information on LiveRamp's Authenticated Traffic Solution and how it works, refer to this page

How to submit data:

Note that BidMachine only accept LiveRamp envelopes.

Learn more about the identity envelope link

To participate, please follow these steps:

1. Establish a contract and integration with LiveRamp.
2. Currently, the BidMachine SDK supports passing a publishe's LiveRamp envelope as an external ID within the SDK. So you need to generate envelope using ATS and pass it to BidMachine SDK.

Passing in an external LiveRamp envelope value to BidMachine SDK:

Java

public String exampleEnvelopeString = "AY3SYJlFDI1RqsMv9gZOjOab6hGuwWKmbE4K70Z-Zex27DD6M9U0Jg";

public TargetingParams createTargetingParams(String exampleEnvelopeString) {
    List<ExternalUserId> externalUserIdList = new ArrayList<>();
    externalUserIdList.add(new ExternalUserId("liveramp.com", exampleEnvelopeString));
    TargetingParams targetingParams = new TargetingParams();
    targetingParams.setExternalUserIds(externalUserIdList);
    return targetingParams;
}

Kotlin

val exampleEnvelopeString = "AY3SYJlFDI1RqsMv9gZOjOab6hGuwWKmbE4K70Z-Zex27DD6M9U0Jg"

fun createTargetingParams(exampleEnvelopeString: String): TargetingParams {
    return TargetingParams().apply {
        setExternalUserIds(listOf(ExternalUserId("liveramp.com", exampleEnvelopeString)))
    }
}

Swift

import BidMachine

let exampleEnvelopeString = "AY3SYJlFDI1RqsMv9gZOjOab6hGuwWKmbE4K70Z-Zex27DD6M9U0Jg"

BidMachineSdk.shared.targetingInfo.populate {
    $0.appendExternalId("liveramp.com", exampleEnvelopeString)
}

Objective-C

#import <BidMachine/BidMachine.h>

NSString* exampleEnvelopeString = @"AY3SYJlFDI1RqsMv9gZOjOab6hGuwWKmbE4K70Z-Zex27DD6M9U0Jg";

[BidMachineSdk.shared.targetingInfo populate:^(id<BidMachineTargetingInfoBuilderProtocol> builder) {
    [builder appendExternalId:@"liveramp.com" :exampleEnvelopeString];
}];