This repository contains the Iterable integration for the mParticle Apple SDK.
-
Add the kit dependency to your app's Podfile or Cartfile, or add using SPM:
pod 'mParticle-Iterable', '~> 8'
OR
github "mparticle-integrations/mparticle-apple-integration-iterable" ~> 8.0
OR
https://github.com/mparticle-integrations/mparticle-apple-integration-iterable
Add as a standard SPM package.
-
Follow the mParticle iOS SDK quick-start, then rebuild and launch your app, and verify that you see
"Included kits: { Iterable }"
in your Xcode console
(This requires your mParticle log level to be at least Debug)
- Reference mParticle's integration docs below to enable the integration.
Set the property onAttributionComplete:
on MParticleOptions
when initializing the mParticle SDK. A copy of your block will be invoked to provide the respective information:
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
MParticleOptions *options = [MParticleOptions optionsWithKey:@"<<Your app key>>" secret:@"<<Your app secret>>"];
options.onAttributionComplete = ^void (MPAttributionResult *_Nullable attributionResult, NSError * _Nullable error) {
if (error) {
NSLog(@"Attribution fetching for kitCode=%@ failed with error=%@", error.userInfo[mParticleKitInstanceKey], error);
return;
}
NSLog(@"Attribution fetching for kitCode=%@ completed with linkInfo: %@", attributionResult.kitCode, attributionResult.linkInfo);
}
[[MParticle sharedInstance] startWithOptions:options];
return YES;
}
A copy of your block will be passed an attributionResult containing a linkInfo dictionary with the following data. Use the IterableDestinationURLKey
to navigate to your desired location within the app.
{
"IterableDestinationURLKey" : "<the destination url>",
"IterableClickedURLKey" : "<the clicked url>"
}