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

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


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

ステップ 1: <ph type="x-smartling-placeholder"></ph> ログイン エクスペリエンスを実装する

<ph type="x-smartling-placeholder"></ph> ステップ 2: Google Analytics を統合する

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

ステップ 4: <ph type="x-smartling-placeholder"></ph> 一般的な問題のトラブルシューティングと対応


ユーザーのイベントを収集してメールアドレスと電話番号が含められていても、アプリに Google Analytics for Firebase SDK を使用する場合は、この 2 つを使用して開始できます。 役立ちます

API の呼び出し

同意を得たメールアドレスまたは電話番号を使って、Conversion Measurement API を呼び出す ステップ 1 の番号が割り当てられます。この数値は広告のコンバージョン測定に使用されます。 個人情報をユーザーのデバイスから外部に送信できないようにする。

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

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

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

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"];

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 でハッシュ化されたメールアドレスと電話番号を受け入れます。マイページ コード内でハッシュ化を実行してユーザーのデータの管理を維持できます 呼び出すことができます

ハッシュされた認証情報を使用するには、アドレスと数値を正規化し、 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」になります

電話番号については、あらかじめ E.164 形式(つまり 先頭に +、国コードは 1 ~ 3 桁、登録者番号は最大 12 桁) SHA256 でハッシュ化します。

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

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)

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];

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

Xcode デバッグログで確認する(省略可)

デバッグモードを有効にした場合は、Innovation Measurement API を呼び出した後で、 Xcode デバッグに次のようなログ メッセージが表示されることを確認します。 console:

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

Firebase 9.6.0 以降では、デバッグモードを有効にして -DebugOnDeviceConversionMeasurement の launch 引数を指定し、 initiateOnDeviceConversionMeasurement() API は一致をシミュレートします。

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




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