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

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

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

API の呼び出し

ステップ 1 で同意したメールアドレスまたは電話番号を使用して、Conversion Measurement API を呼び出します。これは、ユーザーのデバイスから個人情報が流出することなく、広告のコンバージョン測定に使用されます。

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

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

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

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")

@import FirebaseAnalytics;

// ...
// If you're using an email address....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithEmailAddress:@"example@gmail.com"];
// If you're using a phone number....
[FIRAnalytics initiateOnDeviceConversionMeasurementWithPhoneNumber:@"+15555555555"];

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 が適用される前に特定の正規化が実行されていることを前提としています。そのため、次の手順に沿ってデータを正規化してください。

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

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

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

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

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

      • 文字 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 桁）になっている必要があります。

ハッシュ化された認証情報を使用して 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)

@import FirebaseAnalytics;

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

using Firebase.Analytics;

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

Xcode デバッグログで確認する（省略可）

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

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

Firebase 9.6.0 以降では、デバッグモードを有効にして -DebugOnDeviceConversionMeasurement 起動引数を含めると、initiateOnDeviceConversionMeasurement() API を呼び出すとマッチがシミュレートされます。

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

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