This repository contains the Button integration for the mParticle Apple SDK.

Adding the integration

Add the kit dependency to your app's Podfile or Cartfile:

pod 'mParticle-Button', '~> 8.0'

github "mparticle-integrations/mparticle-apple-integration-button" ~> 8.0

Follow the mParticle iOS SDK quick-start, then rebuild and launch your app, and verify that you see "Included kits: { Button }" 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.

Deep-linking

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;
}

Documentation

Button integration

License

Apache License 2.0