Set SKAdNetwork

Note:

This feature is available for iOS 14 or later.
To use this feature, you need to add the StoreKit.framework to your project.

1. Update Conversion Values

Conversion values are used to track user actions within the SKAdNetwork. You can map 64 conditions to conversion values ranging from 0 to 63 and send this integer value to the SKAdNetwork during user installation. This information helps you understand how users interact with your app in the initial days after installation.

You can update the conversion value using the "updateConversionValue" method. This method includes Apple's updateConversionValue method to receive the updated conversion values.

Function 1

- (void)updatePostbackConversionValue:(NSInteger)conversionValue completionHandler:(void (^)(NSError *error))completion;

Parameters:

Parameter Name	Parameter Meaning	Parameter Type	Mandatory
conversionValue	A conversion value ≥0 and ≤63. You can assign it to a specific install. It will help you understand the value of the user without identifying the user's personal information.	NSInteger	Yes
completion	Used to catch and handle the callbacks. Set this value to nil if you don't provide a handler.	Block	No

Sample Code

[[SolarEngineSDK sharedInstance] updatePostbackConversionValue:1 completionHandler:^(NSError * _Nonnull error) {
       NSLog(@"completionHandler = %@",error);
}];

Function 2

- (void)updatePostbackConversionValue:(NSInteger)fineValue
                          coarseValue:(NSString *)coarseValue
                    completionHandler:(void (^)(NSError *error))completion;

Parameters:

Parameter Name	Parameter Meaning	Parameter Type	Mandatory
fineValue	A conversion value ≥0 and ≤63. You can assign it to a specific install. It will help you understand the value of the user without identifying the user's personal information.	NSInteger	Yes
coarseValue	SKAdNetworkCoarseConversionValue. If the app's install volume is insufficient and does not meet the privacy threshold, the function is enabled. The following options are supported: SKAdNetworkCoarseConversionValueHigh SKAdNetworkCoarseConversionValueLow SKAdNetworkCoarseConversionValueMedium	NSString	Yes
completion	Used to catch and handle the callbacks. Set this value to nil if you don't provide a handler.	Block	No

Sample Code

if (@available(iOS 16.0, *)) {
          [[SolarEngineSDK sharedInstance] updatePostbackConversionValue:10 coarseValue:SKAdNetworkCoarseConversionValueHigh completionHandler:^(NSError * _Nonnull error) {
                NSLog(@"completionHandler = %@",error);
         }];
}

Function 3

- (void)updatePostbackConversionValue:(NSInteger)fineValue
                          coarseValue:(NSString *)coarseValue
                           lockWindow:(BOOL)lockWindow
                    completionHandler:(void (^)(NSError *error))completion;

Parameters:

Parameter Name	Parameter Meaning	Parameter Type	Mandatory
fineValue	A conversion value ≥0 and ≤63. You can assign it to a specific install. It will help you understand the value of the user without identifying the user's personal information.	NSInteger	Yes
coarseValue	SKAdNetworkCoarseConversionValue. If the app's install volume is insufficient and does not meet the privacy threshold, the function is enabled. The following options are supported: SKAdNetworkCoarseConversionValueHigh SKAdNetworkCoarseConversionValueLow SKAdNetworkCoarseConversionValueMedium	NSString	Yes
lockWindow	Whether to send callbacks within the conversion window. YES: send callbacks before the conversion window ends. NO: (default)	BOOL	Yes
completion	Used to catch and handle the callbacks. Send nil if you don't provide a handler.	Block	No

Sample Code

if (@available(iOS 16.0, *)) {
          [[SolarEngineSDK sharedInstance] updatePostbackConversionValue:10 coarseValue:SKAdNetworkCoarseConversionValueHigh lockWindow:YES completionHandler:^(NSError * _Nonnull error) {
                NSLog(@"completionHandler = %@",error);
         }];
}

2. Set Install Callback

It is required to define the SolarEngine SDK as the receiver of SKAdNetwork callbacks.

In Xcode, navigate to the project navigator and select the Info.plist file.
Click the "+" button in the "Property" list editor and press the Enter key.
Enter "NSAdvertisingAttributionReportEndpoint".
From the popup menu in the "Type" column, select "String".
Enter https://detailroi.com .

Set User Property

Event Report Timing

Last modified: 2024-12-03Powered by

Outline