チュートリアル: iOS 広告のコンバージョンを測定する

ステップ 3: Google Analytics を使用してオンデバイス コンバージョン測定を開始する

はじめに: iOS 広告コンバージョンを測定する

ステップ 1: ログイン エクスペリエンスを実装する

ステップ 2: Google Analytics を統合する

ステップ 3: Google Analytics を使用してオンデバイス コンバージョン測定を開始する

ステップ 4: 一般的な問題のトラブルシューティングと対処

ユーザーのメールアドレスと電話番号を収集できるようになり、アプリに Firebase SDK の Google Analytics が設定されたので、この 2 つを使用してコンバージョンの測定を開始できます。

API の呼び出し

ステップ 1 で取得した同意済みのメールアドレスまたは電話番号を使用してコンバージョン測定 API を呼び出します。この API は広告のコンバージョン測定に使用され、個人を特定できる情報がユーザーのデバイスから漏洩することはありません。

測定を開始するには、次の 2 つの方法があります。

• 認証情報を使用する
• ハッシュ化された認証情報を使用する

メールアドレスまたは電話番号を使用する

Swift

FirebaseAnalytics モジュールをインポートし、メールアドレスまたは電話番号を initiateOnDeviceConversionMeasurement() API に渡します。

注: initiateOnDeviceConversionMeasurement(emailAddress:) メソッドと initiateOnDeviceConversionMeasurement(phoneNumber:) メソッドは順番に呼び出すことができますが、ユーザーごとに報告できるのは 1 つの一致のみです。いずれかの API で一致が見つかった場合、後続の API 呼び出しは事実上無視されます。

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "[e-mail]")
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "[phone]")

Objective-C

FirebaseAnalytics モジュールをインポートし、initiateOnDeviceConversionMeasurementWithEmailAddress: API にメールアドレスを、initiateOnDeviceConversionMeasurementWithPhoneNumber: API に電話番号を渡します。

注: initiateOnDeviceConversionMeasurementWithEmailAddress: メソッドと initiateOnDeviceConversionMeasurementWithPhoneNumber: メソッドは順番に呼び出すことができますが、ユーザーごとに報告できるのは 1 つの一致のみです。いずれかの API で一致が見つかった場合、後続の API 呼び出しは事実上無視されます。

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"[e-mail]"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"[phone]"];

Unity

Firebase.Analytics 名前空間をインポートし、InitiateOnDeviceConversionMeasurementWithEmailAddress() API にメールアドレスを、InitiateOnDeviceConversionMeasurementWithPhoneNumber() API に電話番号を渡します。

注: InitiateOnDeviceConversionMeasurementWithEmailAddress() メソッドと InitiateOnDeviceConversionMeasurementWithPhoneNumber() メソッドは順番に呼び出すことができますが、ユーザーごとに報告できるのは 1 つの一致のみです。いずれかの API で一致が見つかった場合、後続の API 呼び出しは事実上無視されます。

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("[e-mail]");
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("[phone]");

注: ベスト プラクティスは、インストールごとに 1 回、ログインの直後に API を呼び出すことです。

重要: ユーザーのメールアドレスまたは電話番号の登録の直後にアプリ内でのアクションやイベントが発生する場合は、デバイス上のコンバージョン測定の開始とイベントのロギングの間に短い遅延を実装することを検討してください。

ハッシュ化されたメールアドレスまたは電話番号を使用する

API は、SHA256 でハッシュ化されたメールアドレスと電話番号を受け付けます。SDK を呼び出す前にコードでハッシュ化を行うことで、ユーザーのデータを管理できます。

ハッシュ化された認証情報を使用するには、住所と番号を正規化し、SHA256 でハッシュ化してから、API を呼び出します。

メールアドレスと電話番号を正規化する

メールアドレスの場合、Google Analytics API は、SHA256 が適用される前に特定の正規化が実行されることを前提としています。そのため、次の手順に沿ってデータを正規化します。

1. メールアドレス全体を小文字に変換します。

2. メールアドレスの末尾がドメイン @googlemail.com の場合は、@googlemail.com ドメインを @gmail.com に置き換えます。

3. ドメイン @gmail.com で終わるアドレスの場合（前の手順で変更されたアドレスを含む）:

   1. ユーザー名部分からすべてのピリオドを削除します。

   2. ユーザー名部分を次のように置き換えます。

      • 文字 I、i、数字 1 は文字 l に置き換えます
      • 数字の 0 はアルファベットの o に置き換えます
      • 2 桁目の数字を文字 z に置き換えます。
      • 数字の 5 は文字の s に置き換えます

たとえば、正規化後:

• [e-mail] が [e-mail] になる
• [e-mail] が [e-mail] になる

電話番号の場合、SHA256 でハッシュ化する前に、番号がすでに E.164 形式（先頭に +、国コードに 1 ～ 3 桁、加入者番号に最大 12 桁）になっている必要があります。

ハッシュ化された SHA256 メールアドレスまたは電話番号は、16 進数文字列ではなく、32 バイトの長さにする必要があります。

ハッシュ化された認証情報を使用して API を呼び出す

Swift

FirebaseAnalytics モジュールをインポートし、メールアドレスまたは電話番号を initiateOnDeviceConversionMeasurement() API に渡します。

注: initiateOnDeviceConversionMeasurement(hashedEmailAddress:) メソッドと initiateOnDeviceConversionMeasurement(hashedPhoneNumber:) メソッドは順番に呼び出すことができますが、ユーザーごとに報告できる一致は 1 つだけです。いずれかの API で一致が見つかった場合、後続の API 呼び出しは事実上無視されます。

import FirebaseAnalytics

// ...
// If you're using an email address....
Analytics.initiateOnDeviceConversionMeasurement(hashedEmailAddress: hashedEmailAddress)
// If you're using a phone number....
Analytics.initiateOnDeviceConversionMeasurement(hashedPhoneNumber: hashedPhoneNumber)

Objective-C

FirebaseAnalytics モジュールをインポートし、メールアドレスを initiateOnDeviceConversionMeasurementWithHashedEmailAddress: API に、電話番号を initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: API に渡します。

注: initiateOnDeviceConversionMeasurementWithHashedEmailAddress: メソッドと initiateOnDeviceConversionMeasurementWithHashedPhoneNumber: メソッドは順番に呼び出すことができますが、ユーザーごとに報告できる一致は 1 つだけです。いずれかの API で一致が見つかった場合、後続の API 呼び出しは事実上無視されます。

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedEmailAddress:hashedEmailAddress];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithHashedPhoneNumber:hashedPhoneNumber];

Unity

Firebase.Analytics 名前空間をインポートし、メールアドレスを InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() API に、電話番号を InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() API に渡します。

注: InitiateOnDeviceConversionMeasurementWithHashedEmailAddress() メソッドと InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber() メソッドは順番に呼び出すことができますが、ユーザーごとに報告できる一致は 1 つだけです。いずれかの API で一致が見つかった場合、後続の API 呼び出しは事実上無視されます。

using Firebase.Analytics;

// ...
// If you're using an email address....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress);
// If you're using a phone number....
FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);

注: ベスト プラクティスは、インストールごとに 1 回、ログインの直後に API を呼び出すことです。

重要: ユーザーのメールアドレスまたは電話番号の登録の直後にアプリ内でのアクションやイベントが発生する場合は、デバイス上のコンバージョン測定の開始とイベントのロギングの間に短い遅延を実装することを検討してください。

インテグレーションを検証する

デバッグモードを有効にします。測定開始 API を呼び出した後、Xcode デバッグ コンソールに次のようなログメッセージが表示されることを確認します。

[FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement

デバッグモードを有効にして -DebugOnDeviceConversionMeasurement 起動引数を含めた場合、initiateOnDeviceConversionMeasurement() API を呼び出すと、マッチングがシミュレートされます。

[FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match

---

ステップ 2: Google Analytics を統合する ステップ 4: 一般的な問題のトラブルシューティングと処理を行う

---