Recording conversions for advertisers
The Rokt SDK for iOS can be executed to record conversion events that occur within your app.
#
Before you beginEnsure that the Rokt iOS SDK has already been integrated into your application following the steps listed here.
#
Executing the Rokt SDK for iOSExecute the Rokt SDK for iOS in your desired ViewController
and add all appropriate consumer attributes. The example code below uses ViewDidLoad
to display a Rokt overlay placement.
note
The Rokt SDK for iOS is also used to integrate Rokt placements into partner applications. There are optional callbacks available in the SDK when displaying Rokt placements. However, as this guide is specifically referring to recording conversion events, these callbacks do not need to be taken into consideration.
Your app dictates which customer attributes are integrated with Rokt. You can find more information on the available data fields on the conversion attributes page. You can include additional attributes to your integration by adding lines of code to the attributes
section of the example code below.
- Swift
- Objective-C
import Rokt_Widget
class OrderConfirmationViewController: UIViewController { ... // call this function when the placement needs to be shown func showWidget() { let attributes = ["email": "j.smith@example.com", "firstname": "Jenny", "lastname": "Smith", "mobile": "(555)867-5309", "postcode": "90210", "country": "US"]
Rokt.execute(viewName: "RoktExperience", attributes: attributes, onLoad: { // Optional callback for when the Rokt placement loads }, onUnLoad: { // Optional callback for when the Rokt placement unloads }, onShouldShowLoadingIndicator: { // Optional callback to show a loading indicator }, onShouldHideLoadingIndicator: { // Optional callback to hide a loading indicator }) }}
#import <Rokt_Widget/Rokt_Widget-Swift.h>...
// call this function when placement needs to be shown- (void)showWidget { NSDictionary *attributes = @{ @"email" : @"j.smith@example.com", @"firstname": @"Jenny", @"lastname": @"Smith", @"mobile": @"(555)867-5309", @"postcode": @"90210", @"country": @"US" }; [Rokt executeWithViewName:@"RoktExperience" attributes:attributes placements:nil onLoad:^{ // Optional callback for when the Rokt placement loads } onUnLoad:^{ // Optional callback for when the Rokt placement unloads } onShouldShowLoadingIndicator:^{ // Optional callback to show a loading indicator } onShouldHideLoadingIndicator:^{ // Optional callback to hide a loading indicator } onEmbeddedSizeChange:^(NSString *selectedPlacement, CGFloat widgetHeight) { // Does not required for Full screen overlay }];}