— Send an ad ID (IDFA)

Usage

KARTE SDKによる広告ID（IDFA）の送信を有効にしたい場合は、本記事を参考に実装をしてください。

なおSDKには広告IDを直接取得する機能はありません。
そのためアプリケーション側に広告IDを取得する処理を実装する必要があります。

🚧
広告IDの送信について
There are some precautions for sending the advertising ID.
Before implementing the sending process, Here See the article.

Advance preparation

AdSupport.framework をビルドターゲットに追加してください。

implementation

Delegateを実装する
SDK が提供する IDFADelegate を実装します。
ここでは例として AppDelegate に実装する形で進めます。

import AdSupport
import KarteCore
import AppTrackingTransparency

...

extension AppDelegate: IDFADelegate {
  var isAdvertisingTrackingEnabled: Bool {
    if #available(iOS 14, *) {
        return ATTrackingManager.trackingAuthorizationStatus == .authorized
    } else {
        return ASIdentifierManager.shared().isAdvertisingTrackingEnabled
    }
  }
    
  var advertisingIdentifierString: String? {
    return ASIdentifierManager.shared().advertisingIdentifier.uuidString
  }
}

#import "AppDelegate.h"
#import <AdSupport/AdSupport.h>
#import <AppTrackingTransparency/AppTrackingTransparency.h>
@import KarteCore;

@interface AppDelegate () <KRTIDFADelegate>
@end

@implementation AppDelegate
 
...
  
- (BOOL)isAdvertisingTrackingEnabled {
    if (@available(iOS 14.0, *)) {
        return ATTrackingManager.trackingAuthorizationStatus == ATTrackingManagerAuthorizationStatusAuthorized;
    } else {
        return [[ASIdentifierManager sharedManager] isAdvertisingTrackingEnabled];
    }
}

- (NSString *)advertisingIdentifierString {
    return [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
}

@end

Initialize SDK
Specify the initialization option to initialize the SDK.

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  let configuration = Configuration { (configuration) in
    configuration.idfaDelegate = self
  }
  KarteApp.setup(appKey: "アプリケーションキー", configuration: configuration)
  ...
}

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  KRTConfiguration *configuration = [KRTConfiguration configWithConfigurator:^(KRTConfiguration * _Nonnull configuration) {
    [configuration setIdfaDelegate:self];
  }];
  [KRTApp setupWithAppKey:@"アプリケーションキー" configuration:configuration];
  ...
}

確認

任意のイベントの app_info.system_info.idfa フィールドに値が含まれていれば、正しく実装されております。

詳細な確認方法については、イベント画面についてをご覧ください。

Updated over 1 year ago

日本語

English