ステップ 3: Google アナリティクスを使用してデバイス上でのコンバージョン測定を開始する
はじめに: iOS 広告のコンバージョンを測定する |
ステップ 1:サインイン エクスペリエンスを実装する |
ステップ 2: Google アナリティクスを統合する |
ステップ 3: Google アナリティクスを使用してデバイス上でのコンバージョン測定を開始する |
ステップ 4:一般的な問題のトラブルシューティングと対処 |
ユーザーのメール アドレスと電話番号を収集できるようになり、アプリに Firebase 向け Google アナリティクス SDK が組み込まれたので、この 2 つを使用してコンバージョンの測定を開始できます。
APIを呼び出す
ステップ 1 で同意したメール アドレスまたは電話番号を使用してコンバージョン測定 API を呼び出します。この API は、個人を特定できる情報がユーザーのデバイスから流出することなく、広告のコンバージョン測定に使用されます。
測定を開始するには 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")
目的-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"];
団結
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
anemlluserolzs@gmail.com
になります CAPSUSER0125@provider.net
capsuser0125@provider.net
になります
電話番号の場合、SHA256 でハッシュする前に、番号はすでに E.164 形式になっている必要があります (つまり、+ がプレフィックスとして付いており、国番号は 1 ~ 3 桁、加入者番号は最大 12 桁)。
ハッシュされた認証情報を使用して 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)
目的-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];
団結
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 デバッグ ログで検証する (オプション)
デバッグ モードを有効にした場合は、測定開始 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
ステップ 2 : Google Analytics の統合ステップ 4 : 一般的な問題のトラブルシューティングと処理