データ収集を管理する

Appleのプライバシーマニフェスト

トラッキングデータとは？

Appleは「トラッキングデータ」を、アプリ内でエンドユーザーやデバイスについて収集され、サードパーティのデータ（ターゲット広告など）やデータブローカーにリンクされたデータと定義しています。完全な定義と例については、Apple: Trackingを参照してください。

デフォルトでは、Braze SDKはトラッキングデータを収集しません。ただし、Braze SDKの設定によっては、アプリのプライバシーマニフェストにBraze固有のデータを記載する必要がある場合があります。

プライバシーマニフェストとは？

プライバシーマニフェストは、アプリとサードパーティSDKがデータを収集する理由と、そのデータ収集方法を説明するXcodeプロジェクト内のファイルです。データをトラッキングするサードパーティSDKには、それぞれ独自のプライバシーマニフェストが必要です。アプリのプライバシーレポートを作成すると、これらのプライバシーマニフェストファイルは自動的に1つのレポートに集約されます。

APIトラッキングデータドメイン

iOS 17.2以降、AppleはエンドユーザーがAd Tracking Transparency (ATT) プロンプトを受け入れるまで、アプリ内で宣言されたすべてのトラッキングエンドポイントをブロックします。Brazeはトラッキングデータをルーティングするためのトラッキングエンドポイントを提供しており、トラッキング以外のファーストパーティデータは元のエンドポイントにルーティングすることもできます。

Brazeのトラッキングデータを宣言する

前提条件

この機能を実装するには、以下のBraze SDKバージョンが必要です。

ステップ1：現在のポリシーを確認する

Braze SDKの現在のデータ収集ポリシーを法務チームと確認し、アプリがAppleの定義に従ってトラッキングデータを収集しているかどうかを判断してください。トラッキングデータを収集していない場合は、現時点でBraze SDKのプライバシーマニフェストをカスタマイズする必要はありません。Braze SDKのデータ収集ポリシーの詳細については、SDKデータ収集を参照してください。

ステップ2：プライバシーマニフェストを作成する

まず、XcodeプロジェクトでPrivacyInfo.xcprivacyファイルを検索して、プライバシーマニフェストがすでに存在するかどうかを確認します。すでにこのファイルがある場合は、次のステップに進んでください。ない場合は、Apple: Create a privacy manifestを参照してください。

ステップ3：エンドポイントをプライバシーマニフェストに追加する

XcodeプロジェクトでアプリのPrivacyInfo.xcprivacyファイルを開き、テーブルを右クリックしてRaw Keys and Valuesにチェックを入れます。

App Privacy ConfigurationでNSPrivacyTrackingを選択し、値をYESに設定します。

App Privacy ConfigurationでNSPrivacyTrackingDomainsを選択します。ドメイン配列に新しい要素を追加し、その値を、以前にAppDelegateに追加したエンドポイントにsdk-trackingプレフィックスを付けたものに設定します。

ステップ4：トラッキングデータを宣言する

次にAppDelegate.swiftを開き、静的または動的トラッキングリストを作成して、宣言する各トラッキングプロパティをリストします。Appleはエンドユーザーが ATTプロンプトを受け入れるまでこれらのプロパティをブロックするため、あなたと法務チームがトラッキングと見なすプロパティのみをリストしてください。以下に例を示します。

• 静的な例
• 動的な例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
import UIKit
import BrazeKit

@main
class AppDelegate: UIResponder, UIApplicationDelegate {

  static var braze: Braze? = nil

  func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
  ) -> Bool {
    let configuration = Braze.Configuration(apiKey: brazeApiKey, endpoint: brazeEndpoint)
    // Declare which types of data you wish to collect for user tracking.
    configuration.api.trackingPropertyAllowList = [
      .dateOfBirth,
      .customEvent(["event-1"]),
      .customAttribute(["attribute-1", "attribute-2"])
    ]
    let braze = Braze(configuration: configuration)
    AppDelegate.braze = braze
    return true
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
func applicationDidBecomeActive(_ application: UIApplication) {
  // Request and check your user's tracking authorization status.
  ATTrackingManager.requestTrackingAuthorization { status in
    // Let Braze know whether user data is allowed to be collected for tracking.
    let enableAdTracking = status == .authorized
    AppDelegate.braze?.set(adTrackingEnabled: enableAdTracking)

    // Add the `.firstName` and `.lastName` properties, while removing the `.everything` configuration.
    AppDelegate.braze.updateTrackingAllowList(
      adding: [.firstName, .lastName],
      removing: [.everything]
    )
  }
}

ステップ5：無限リトライループを防止する

SDKが無限リトライループに入るのを防ぐため、set(adTrackingEnabled: enableAdTracking)メソッドを使用してATT権限を処理します。メソッド内のadTrackingEnabledプロパティは、以下のように処理する必要があります。

1
2
3
4
5
6
7
8
func applicationDidBecomeActive(_ application: UIApplication) {
    // Request and check your user's tracking authorization status.
    ATTrackingManager.requestTrackingAuthorization { status in
      // Let Braze know whether user data is allowed to be collected for tracking.
      let enableAdTracking = status == .authorized
      AppDelegate.braze?.set(adTrackingEnabled: enableAdTracking)
    }
}

データトラッキングを無効にする

Swift SDKのデータトラッキングアクティビティを無効にするには、Brazeインスタンスのenabledプロパティをfalseに設定します。enabledをfalseに設定すると、Braze SDKはパブリックAPIへの呼び出しをすべて無視します。また、SDKはネットワークリクエストやイベント処理など、進行中のすべてのアクションもキャンセルします。

以前に保存したデータを消去する

wipeData()メソッドを使用すると、ユーザーのデバイスにローカルに保存されたSDKデータを完全に消去できます。

Braze Swiftバージョン7.0.0以降では、SDKとwipeData()メソッドがデバイスIDのUUIDをランダムに生成します。ただし、useUUIDAsDeviceIdがfalseに設定されている場合、または Swift SDKバージョン5.7.0以前を使用している場合は、/users/deleteへのPOSTリクエストも行う必要があります。これは、IDFV（Identifier for Vendors）がそのユーザーのデバイスIDとして自動的に使用されるためです。

手動プッシュ連携を使用していて、アプリがwipeData()を呼び出した後、同じアプリ実行中にSDKを再度有効にする場合は、registerForRemoteNotifications()を再度呼び出して、Brazeが更新されたデバイストークンを受信できるようにしてください。詳細については、プッシュ通知の設定を参照してください。

データトラッキングを再開する

データ収集を再開するには、enabledをtrueに設定します。ただし、以前に消去されたデータは復元されないことに注意してください。

IDFVの収集

Braze iOS SDKの以前のバージョンでは、IDFV（Identifier for Vendor）フィールドがユーザーのデバイスIDとして自動的に収集されていました。Swift SDK v5.7.0以降、IDFVフィールドはオプションで無効にできるようになり、代わりにBrazeがランダムなUUIDをデバイスIDとして設定するようになりました。Swift SDK v7.0.0以降、IDFVフィールドはデフォルトでは収集されず、代わりにUUIDがデバイスIDとして設定されます。

useUUIDAsDeviceId機能は、デバイスIDをUUIDとして設定するようSwift SDKを構成します。従来、iOS SDKではAppleが生成したIDFV値と同じデバイスIDが割り当てられていました。iOSアプリでこの機能がデフォルトで有効になっている場合、SDKを介して作成されたすべての新規ユーザーにUUIDと同じデバイスIDが割り当てられます。

それでもIDFVを別途収集したい場合は、set(identifierforvendor:)を使用できます。

考慮事項

SDKバージョン

Swift SDK v7.0.0+でuseUUIDAsDeviceIdが有効（デフォルト）の場合、新規作成されたすべてのユーザーにはランダムなデバイスIDが割り当てられます。既存のユーザーは同じデバイスID値を保持します（IDFVである場合もあります）。

この機能が有効でない場合、デバイスには引き続き作成時にIDFVが割り当てられます。

ダウンストリーム

テクノロジーパートナー: この機能を有効にすると、BrazeデバイスIDからIDFV値を取得するテクノロジーパートナーは、このデータにアクセスできなくなります。パートナー連携にデバイスから得られるIDFV値が必要な場合は、この機能をfalseに設定することを推奨します。

Currents: useUUIDAsDeviceIdをtrueに設定すると、Currentsで送信されるデバイスIDはIDFV値と等しくなくなります。

よくある質問

この変更はBrazeの既存ユーザーに影響しますか？

いいえ。この機能を有効にしても、Brazeのユーザーデータは上書きされません。新しいUUIDデバイスIDは、新しいデバイスまたはwipedata()が呼び出された場合にのみ作成されます。

この機能をオンにした後にオフにすることはできますか？

はい、この機能は自由にオンとオフを切り替えることができます。以前に保存されたデバイスIDは上書きされません。

Brazeを介してIDFV値を別の場所で収集することはできますか？

はい、オプションでSwift SDKを使用してIDFVを収集することもできます（収集はデフォルトでは無効です）。