Skip to content

Integration guide ​

This guide is intended for publishers who wish to monetize their iOS application using Marto SDK. The first crucial step in leveraging ads and generating revenue through your app is integrating the Marto SDK

Prerequisites ​

Xcode 26 or higher

Target iOS 13.0 or higher

Import SDK ​

Swift Package Manager ​

To add a package dependency to your project, follow these steps:

1.In Xcode, install the Marto SDK Swift Package by navigating to File > Add Package Dependencies....

2.In the prompt that appears, search for the Marto SDK Swift Package GitHub repository:

http
https://github.com/martosdk/Marto-swift-package-manager.git

3.Select the version of the Marto SDK Swift Package you want to use. For new projects, we recommend using the Up to Next Major Version.

4.Enable the -ObjC flag in Xcode: click on your project settings, go to Build Settings, search for Other Linker Flags and add -ObjC.

CocoaPods ​

To integrate the Marto SDK through CocoaPods:

1.Add the following line to your Podfile:

http
pod 'MartoSDK'

2.Run the following on the command line:

http
pod install --repo-update

Initialize the SDK ​

After you have successfully installed the SDK, you must initialize it.

Call the MartoADSDK start API using the appId

objc
#import <MartoSDK/CTADSDK.h>

// Initialize the SDK
[[CTADSDK sharedInstance] start:@"<your_app_id>" completion:^{
}];
swift
import MartoSDK

// Initialize the SDK
CTADSDK.sharedInstance().start("<your_app_id>") {
}

Set UserID ​

Set the UserID before the init request, to make sure you avoid any data loses, related to the user.

objc
[CTADSDK sharedInstance].userid = @"<your-user-id>";
swift
CTADSDK.sharedInstance().userid = "<your-user-id>"

Request App Tracking Transparency authorization ​

To display the App Tracking Transparency authorization request for accessing the IDFA, update your Info.plist to add the NSUserTrackingUsageDescription key with a custom message describing your usage. Here is an example description text:

http
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

att

The usage description appears in the App Tracking Transparency dialog:

att

To present the authorization request, call requestTrackingAuthorizationWithCompletionHandler:. We recommend waiting for the completion callback prior to loading ads so that if the user grants the App Tracking Transparency permission, the Marto SDK can use the IDFA in ad requests.

objc
if (@available(iOS 14, *))
{
    [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    }];
}
swift
if #available(iOS 14, *) 
{
	ATTrackingManager.requestTrackingAuthorization(completionHandler: {status in
    })
}

For more information about the possible status values, see ATTrackingManager.AuthorizationStatus.