ステップ 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 に渡します。
import FirebaseAnalytics // ... // If you're using an email address.... Analytics.initiateOnDeviceConversionMeasurement(emailAddress: "example@gmail.com") // If you're using a phone number.... Analytics.initiateOnDeviceConversionMeasurement(phoneNumber: "+15555555555")
Objective-C
FirebaseAnalytics
モジュールをインポートし、initiateOnDeviceConversionMeasurementWithEmailAddress:
API にメールアドレスを、initiateOnDeviceConversionMeasurementWithPhoneNumber:
API に電話番号を渡します。
@import FirebaseAnalytics; // ... // If you're using an email address.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"]; // If you're using a phone number.... [FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];
Unity
Firebase.Analytics
名前空間をインポートし、InitiateOnDeviceConversionMeasurementWithEmailAddress()
API にメールアドレスを、InitiateOnDeviceConversionMeasurementWithPhoneNumber()
API に電話番号を渡します。
using Firebase.Analytics; // ... // If you're using an email address.... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithEmailAddress("example@gmail.com"); // If you're using a phone number.... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithPhoneNumber("+15555555555");
ハッシュ化されたメールアドレスまたは電話番号を使用する
API は、SHA256 でハッシュ化されたメールアドレスと電話番号を受け付けます。SDK を呼び出す前にコードでハッシュ化を行うことで、ユーザーのデータを管理できます。
ハッシュ化された認証情報を使用するには、住所と番号を正規化し、SHA256 でハッシュ化してから、API を呼び出します。
メールアドレスと電話番号を正規化する
メールアドレスの場合、Google Analytics API は、SHA256 が適用される前に特定の正規化が実行されることを前提としています。そのため、次の手順に沿ってデータを正規化します。
メールアドレス全体を小文字に変換します。
メールアドレスの末尾がドメイン @googlemail.com の場合は、@googlemail.com ドメインを @gmail.com に置き換えます。
ドメイン @gmail.com で終わるアドレスの場合(前の手順で変更されたアドレスを含む):
ユーザー名部分からすべてのピリオドを削除します。
ユーザー名部分を次のように置き換えます。
- 文字 I、i、数字 1 は文字 l に置き換えます
- 数字の 0 はアルファベットの o に置き換えます
- 2 桁目の数字を文字 z に置き換えます。
- 数字の 5 は文字の s に置き換えます
たとえば、正規化後:
an.email.user0125@googlemail.com
がanemalluserolzs@gmail.com
になるCAPSUSER0125@provider.net
がcapsuser0125@provider.net
になる
電話番号の場合、SHA256 でハッシュ化する前に、番号がすでに E.164 形式(先頭に +、国コードに 1 ~ 3 桁、加入者番号に最大 12 桁)になっている必要があります。
ハッシュ化された SHA256 メールアドレスまたは電話番号は、16 進数文字列ではなく、32 バイトの長さにする必要があります。
ハッシュ化された認証情報を使用して API を呼び出す
Swift
FirebaseAnalytics
モジュールをインポートし、メールアドレスまたは電話番号を initiateOnDeviceConversionMeasurement()
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 に渡します。
@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 に渡します。
using Firebase.Analytics; // ... // If you're using an email address.... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedEmailAddress(hashedEmailAddress); // If you're using a phone number.... FirebaseAnalytics.InitiateOnDeviceConversionMeasurementWithHashedPhoneNumber(hashedPhoneNumber);
インテグレーションを検証する
デバッグモードを有効にします。測定開始 API を呼び出した後、Xcode デバッグ コンソールに次のようなログメッセージが表示されることを確認します。
[FirebaseAnalytics][I-ACS023225] Initiated on-device conversion measurement
デバッグモードを有効にして -DebugOnDeviceConversionMeasurement
起動引数を含めた場合、initiateOnDeviceConversionMeasurement()
API を呼び出すと、マッチングがシミュレートされます。
[FirebaseAnalytics][I-ACS023229] On-device conversion measurement found a match
Google Analytics を統合する ステップ 2: ステップ 4: 一般的な問題のトラブルシューティングと処理を行う