ガイド

コンバージョンデータ

編集を提案する

このガイドでは、iOS SDKでコンバージョンデータを取得する方法と、使用例を紹介しています。

始める前に

コンバージョンデータを取得するには、まずSDKを実装する必要があります。

iOS SDKでのコンバージョンデータの取得

#import "AppDelegate.h"
#import <AppsFlyerLib/AppsFlyerLib.h>

@interface AppDelegate ()
@end
@implementation AppDelegate
    // ...
    -(void)onConversionDataSuccess:(NSDictionary*) installData {
    // Invoked when conversion data resolution succeeds
}
-(void)onConversionDataFail:(NSError *) error {
    // Invoked when conversion data resolution fails
    NSLog(@"%@",error);
}
// ...
@end

import UIKit
import AppsFlyerLib
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    // ..
}

extension AppDelegate: AppsFlyerLibDelegate {

    func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
        // Invoked when conversion data resolution succeeds
    }

    func onConversionDataFail(_ error: Error!) {
        // Invoked when conversion data resolution fails
    }
}

onConversionDataSuccess

onConversionDataSuccess is implemented in AppsFlyerLibDelegate.
The onConversionDataSuccess method is invoked whenever:

  • ユーザーがアプリを起動
  • ユーザーがアプリをフォアグラウンドに移動

When invoked, onConversionDataSuccess returns a NSDictionary (called installData in the example) that contains attribution data for that install. installData is cached the first time onConversionDataSuccess is called and will be identical on consecutive calls.

onConversionDataFail

onConversionDataFail is implemented in AppsFlyerLibDelegate.
If for whatever reason the SDK fails to fetch the conversion data, onConversionDataFail is invoked.

計測データへのアクセス

You can get the conversion type by checking the value of af_status in onConversionDataSuccess's payload. It can be one of the following values:

  • Organic
  • Non-organic

例

以下に実装例を示します。

#import "AppDelegate.h"
#import <AppsFlyerLib/AppsFlyerLib.h>
#import <UserNotifications/UserNotifications.h>
@interface AppDelegate ()
@end
@implementation AppDelegate
    // ...
-(void)onConversionDataSuccess:(NSDictionary*) installData {
    // Business logic for Non-organic install scenario is invoked
    id status = [installData objectForKey:@"af_status"];
    if([status isEqualToString:@"Non-organic"]) {
        id sourceID = [installData objectForKey:@"media_source"];
        id campaign = [installData objectForKey:@"campaign"];
        NSLog(@"This is a Non-organic install. Media source: %@  Campaign: %@",sourceID,campaign);
    }

    else if([status isEqualToString:@"Organic"]) {
        // Business logic for Organic install scenario is invoked
        NSLog(@"This is an Organic install.");
    }

}
-(void)onConversionDataFail:(NSError *) error {
    NSLog(@"%@",error);
}
// ...
@end

import UIKit
import AppsFlyerLib
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, AppsFlyerLibDelegate {
    // ...
}

extension AppDelegate: AppsFlyerLibDelegate {

    func onConversionDataSuccess(_ installData: [AnyHashable: Any]) {
        if let status = installData["af_status"] as? String {
            if (status == "Non-organic") {
                // Business logic for Non-organic install scenario is invoked
                if let sourceID = installData["media_source"],
                let campaign = installData["campaign"] {
                    print("This is a Non-organic install. Media source: \(sourceID)  Campaign: \(campaign)")
                }
            }
            else {
                // Business logic for organic install scenario is invoked
            }
        }
    }

    func onConversionDataFail(_ error: Error!) {
        // Logic for when conversion data resolution fails
        if let err = error{
            print(err)
        }
    }
}

Githubリンク

ディファードディープリンク（従来の方法）

When the app is opened via deferred deep linking, onConversionDataSuccess's payload returns deep linking data, as well as attribution data.

更新済 4か月前