The OneTrust SDK retrieves an object that contains all the data needed to present a UI to a user to collect consent for the SDKs used in your application. The data returned is determined by the configurations made in the OneTrust Admin console.

Update the SDK Keys

1. Navigate to the file where you will update SDK keys and values.
   1. Xamarin.iOS - Navigate to AppDelegate.cs
   2. Xamarin.Android - Navigate to MainActivity.cs
   3. Xamarin Forms - Navigate to OneTrustContentView.xaml.cs
2. Look for the comment ENTER YOUR ONETRUST SDK KEYS HERE
3. Update the values for each Required key
4. Update the values for each non-Required key based on your use case

SDK Keys

Override Geolocation

If you would like to explicitly set the Geolocation of the use instead of using OneTrust's computed Geolocation value, set the countryCodeOverride and regionCodeOverride values accordingly.

static string countryCodeOverride = "US";
static string regionCodeOverride = "CA";

Override Data Subject Identifier

The SDK has a setting that will send Consent Receipts to the OneTrust application for reporting, metrics, and dashboards. By default, the OneTrust SDK will generate it's own random identifier to index this consent receipt.

This setting will allow you to override the default random identifier with one that your developers can provide. This can be done before initialization or after initialization.

Before Initialization

// Update the "identifier" key in the OneTrustContentView.xaml.cs file
static string identifier = "myUserId";

After Initialization

// Set the property on the CMPSDK shared object
CMPSDK.sharedInstance.dataSubjectID = "myUserId";

Xamarin Forms Only

Embed the OneTrust Content Viewer

1. Identify the .xaml file in your application where you intend to display OneTrust UI content.
2. Paste the following code snippet to that .xaml file:

<!-- ONETRUST CONTENT VIEWER START-->
<Frame x:Name="OneTrustContentFrame" HasShadow="true" CornerRadius="8" Padding="0"
RelativeLayout.YConstraint="{Binding OneTrustContentFrameYConstraint}"
RelativeLayout.WidthConstraint="{ConstraintExpression Constant=0, Factor=1, Property=Width, Type=RelativeToParent}"
RelativeLayout.HeightConstraint="{Binding OneTrustContentFrameHeightConstraint}"> 
  <Grid>
    <OneTrust:OneTrustContentView x:Name="OneTrustContentViewer" />
  </Grid> 
</Frame>
<!-- ONETRUST CONTENT VIEWER END-->

Note: The only required entry in the code snippet above is <OneTrust:OneTrustContentView x:Name="OneTrustContentViewer" />.

Your team can decide to modify the <Frame> and <Grid> elements as needed. We provide them to make the styling look a little nicer.

Configure OneTrust UI Event Handlers

Once you've added the content <Frame> above, you will then need to configure a set of UI event handlers in the code behind (.cs file) in order for the application to show/hide OneTrust views and build out the application logic.

UI Events

Recommendation: See the OTSDK-UI / MainPageViewModel.cs file in the sample app for example event handlers of the above events. It's important to read through this file, study it, and understand how to apply it to your specific use case. The application developer has a lot of control on how to go about with the rest of the implementation.

Run Application

1. Once completed on the steps above, run the Xamarin application.
2. Look at the console for any errors
3. Confirm the SDK has loaded properly. You will see !!! OT SDK READY !!! in the console log if everything configured correctly and the SDK loaded properly.
4. Once confirmed, proceed to Displaying User Interfaces section for more detail on showing Banner and Preference Center views.