その他の SDK のカスタマイズ

Braze ログレベル

Braze iOS SDK のデフォルトのログレベルは最小 (次の表では 8) です。このレベルでは、ほとんどのロギングが抑制されるため、本番リリースのアプリケーションで機密情報がログに記録されることはありません。

次の使用可能なログレベルのリストを参照してください。

ログレベル

詳細なログ記録

ログレベルは、使用可能な任意の値に構成できます。ただし、ログレベルを verbose または 0 に設定すると、統合に関する問題のデバッグに非常に役立ちます。このレベルは開発環境のみを対象としており、リリースされたアプリケーションでは設定しないでください。詳細なログ記録では、追加のユーザー情報や新しいユーザー情報が Braze に送信されることはありません。

ログレベルの設定

ログレベルはコンパイル時または実行時に割り当てることができます。

• compile time
• runtime

1
2
3
4
5
<key>Braze</key>
<dict>
  <key>LogLevel</key>
  <string>0</string>
</dict>

1
2
3
4
5
6
NSMutableDictionary *appboyOptions = [NSMutableDictionary dictionary];
appboyOptions[ABKLogLevelKey] = @(0);
[Appboy startWithApiKey:@"YOUR-API-KEY"
          inApplication:application
      withLaunchOptions:launchOptions
      withAppboyOptions:appboyOptions];

1
2
3
4
let appboyOptions: [AnyHashable: Any] = [
  ABKLogLevelKey : 0
]
Appboy.start(withApiKey: "YOUR-API-KEY", in:application, withLaunchOptions:launchOptions, withAppboyOptions:appboyOptions)

オプションの IDFV 収集 - Swift

Braze iOS Swift SDK の以前のバージョンでは、IDFV （ベンダーの識別子) フィールドがユーザーのデバイス ID として自動的に収集されました。

Swift SDK v5.7.0 以降では、IDFV フィールドをオプションで無効にすることができ、代わりに Braze はランダムな UUID をデバイス ID として設定します。詳細については、「IDFV の収集」を参照してください。

オプションの IDFA 収集

IDFA 収集は Braze SDK 内ではオプションであり、デフォルトでは無効になっています。IDFA 収集は、インストールアトリビューション統合を利用する場合にのみ Braze 内で必要になります。IDFA を保存することを選択した場合は、無料で保存されるため、追加の開発作業を行わずに、リリース後すぐにこれらのオプションを利用できます。

そのため、次の基準のいずれかを満たしている場合は、引き続き IDFA を収集することをお勧めします。

• アプリのインストールが以前に配信された広告に起因している
• アプリケーション内のアクションが以前に配信された広告に起因している

iOS 14.5 アプリトラッキングの透明性

Apple は、IDFA を収集するためにユーザーに許可プロンプトを通じてオプトインすることを要求しています。

IDFA を収集するには、ABKIDFADelegate プロトコルを実装するだけでなく、アプリケーションでは、アプリトラッキングの透過性フレームワークで Apple の ATTrackingManager を使用してユーザーから承認を要求する必要があります。詳細については、Apple のユーザー プライバシーに関する記事を参照してください。

アプリトラッキングの透明性承認のプロンプトには、識別子の使用法を説明する Info.plist エントリが必要です。

1
2
<key>NSUserTrackingUsageDescription</key>
<string>To retarget ads and build a global profile to better serve you things you would like.</string>

IDFA 収集の実装

IDFA 収集を実装するには、次の手順に従います。

ステップ1:ABKIDFADelegate を実装する

ABKIDFADelegate プロトコルに準拠したクラスを作成します。

• objective-c
• swift

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
#import "IDFADelegate.h"
#import <AdSupport/ASIdentifierManager.h>
#import <AppTrackingTransparency/AppTrackingTransparency.h>

@implementation IDFADelegate

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

- (BOOL)isAdvertisingTrackingEnabledOrATTAuthorized {
  if (@available(iOS 14, *)) {
    return [ATTrackingManager trackingAuthorizationStatus] == ATTrackingManagerAuthorizationStatusAuthorized;
  }
  return [[ASIdentifierManager sharedManager] isAdvertisingTrackingEnabled];
}

@end

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import Appboy_iOS_SDK
import AdSupport
import AppTrackingTransparency

class IDFADelegate: NSObject, ABKIDFADelegate {
   func advertisingIdentifierString() -> String {
    return ASIdentifierManager.shared().advertisingIdentifier.uuidString
  }

  func isAdvertisingTrackingEnabledOrATTAuthorized() -> Bool {
    if #available(iOS 14, *) {
      return ATTrackingManager.trackingAuthorizationStatus ==  ATTrackingManager.AuthorizationStatus.authorized
    }
    return ASIdentifierManager.shared().isAdvertisingTrackingEnabled
  }
}

ステップ2:Braze の初期化中にデリゲートを設定する

startWithApiKey:inApplication:withAppboyOptions: に渡された appboyOptions 辞書で、ABKIDFADelegateKey キーを ABKIDFADelegate 準拠クラスのインスタンスに設定します。

iOS SDKのおおよそのサイズ

iOS SDK フレームワークファイルのおおよそのサイズは 30 MB、.ipa (アプリ ファイルへの追加) のおおよそのサイズは 1 MB ～ 2 MB です。

Brazeは、アプリのサイズ設定に関する Apple の推奨事項に従って、SDK が .ipa のサイズに与える影響を観察することで、iOS SDK のサイズを測定します。アプリケーションに追加される iOS SDK のサイズを計算する場合は、「アプリサイズレポートの取得」に従って、Braze iOS SDK を統合する前と後の .ipa のサイズの違いを比較することをお勧めします。アプリの縮小サイズレポートからサイズを比較する場合は、縮小された .ipa ファイルのアプリサイズを確認することもお勧めします。ユニバーサル .ipa ファイルは、App Store からダウンロードしてユーザーのデバイスにインストールしたバイナリーよりも大きくなるためです。