ステップ 1: 関連する iOS バージョンの SKAdNetwork ポストバックを登録する
詳しくは、Apple のドキュメントをご覧ください。Firebase 向け Google アナリティクス SDK をお使いの場合、アプリに代わってこの SDK により自動的に登録されるため、このステップはスキップできます。
ステップ 2: SKAdNetwork ポストバックを受け取ってデコードしていることを確認する
詳しくは、Apple のドキュメントをご覧ください。SKAdNetwork エンドポイントをまだセットアップしていない場合は、Apple のドキュメントに沿ってセットアップしてください。
Google 認定の App Attribution Partner（AAP）または社内ソリューションを使ってエンドポイントをすでにセットアップしている場合は、ステップ 3 に進んでください。この手順では、Measurement Protocol を使用して結果を Google アナリティクスに転送するプロセスが説明されています。
ステップ 3: Measurement Protocol を使って、ポストバックの結果を Google アナリティクスに転送する
Measurement Protocol を介して、次のスキーマ（codelab の例を参照）を使用してカスタム campaign_details イベントを Google アナリティクスに送信します。
Google アナリティクス 4 に SKAdNetwork Measurement Protocol を実装する
リクエスト単位のパラメータ
| パラメータ | 詳細 |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {受信した SKAN ポストバックのタイムスタンプ} |
|
| app_instance_id: {...} |
必須。乱数の一意の文字列を生成します。この ID 文字列がコンバージョン モデリングで使われると、このデータは破棄され、実際のアプリ インスタンス ID が使用されます。 |
GA イベント
| イベント | 詳細 |
| campaign_details | カスタム イベント。 |
GA パラメータ（既存）
| パラメータ | 詳細 |
| source: {source} |
これらのパラメータは、手動タグ設定で使用されます。Google アナリティクス 4 のレポートは、Google アナリティクス 4 のデフォルトのチャネル グループを使って構成されているため、この構成をガイドとして、各パラメータを分類することをおすすめします。これらのパラメータ（Google 以外のすべてのポストバック用）を送信します。 例: Facebook のポストバック:
Google ポストバックでは、プロパティの Google 広告との統合に基づいてキャンペーンがデコードされます。そのため、Google ポストバックでは上記のパラメータは省略可能です。その場合、Google アナリティクス 4 プロパティを、Google 広告の広告アカウントにリンクする必要があります。 注: Google アナリティクス 4 には、Google 以外のものも含め、すべての SKAdNetwork ポストバックを送信してください。 |
| medium: {medium} | |
| term: {term}（省略可） | |
| content: {content}（省略可） | |
| campaign_id: {campaign_id} | SKAdNetwork ポストバックの値。 |
| campaign: {campaign}（省略可）ただし、指定しない場合は（未設定）と表示されます。 |
Google 広告の広告キャンペーンの場合、Google アナリティクスと Google 広告のリンクに基づき、ID をデコードしてキャンペーン名が入力され、参照元とメディアのパラメータが更新されます。アカウントがリンクされていない場合は、Google のキャンペーン ID はデコードされず、指定した参照元とメディアのパラメータが使用されます。 Google 広告以外のキャンペーンの場合、ご自身でキャンペーン名をデコードして指定できます。不明な場合は、SKAdNetwork の campaign_id をコピーできます。 注: 指定しない場合、（未設定）と表示されます。 |
| source_platform: “apple_skan” | 重要: この文字列は正確に指定する（大文字小文字を区別し、「_」を含める）必要があります。 |
| app_id: {app_id} |
SKAdNetwork ポストバックの値。これは App Bundle ID になります。 |
| transaction_id: {transaction_id} | SKAdNetwork ポストバックの値。 |
新しい必須パラメータ
注: これらの新しいパラメータは Google アナリティクス 4 管理画面でセットアップできます。ただし、Google アナリティクス 4 管理画面でのセットアップは必須ではありません。これらのパラメータに基づく特定のカスタム ディメンション レポートを表示する場合は、Google アナリティクス 4 に登録する必要があります。
| パラメータ | 詳細 |
| version: {version} | SKAdNetwork ポストバックの値。 |
| conversion_value: {conversion_value} | SKAdNetwork ポストバックの値。 |
| fidelity_type: {fidelity_type} | SKAdNetwork ポストバックの値。 |
| attribution_signature: {attribution_signature} |
SKAdNetwork ポストバックの値。 注: これはセキュリティ機能です。SKAdNetwork のポストバックには暗号署名が行われます。 |
| redownload: {redownload} | SKAdNetwork ポストバックの値。 |
| source_app_id: {source_app_id} |
SKAdNetwork ポストバックの値。 注: インストールにつながった広告クリックが行われたアプリの ID です。 |
| Did_win: {did_win} |
SKAdNetwork ポストバックの値。 注: 広告主様は第一位（winning）のポストバックのみを受け取ります。一方でアドテックは第一位のポストバックと第二位（runner-up） / アシスト（assists）のポストバックを受け取ります。
|
|
ad_network_id: {ad_network_id} ここで、{ad_network_id} はポストバックの値を表します。 |
SKAdNetwork ポストバックの値。 広告が表示された広告ネットワークが表示されます。これは「参照元」トラフィック ディメンションでも有用な情報です。 |
ステップ 4: マーケティング プラットフォームのヒットを受信していることを確認する
campaign_details イベントは、Google アナリティクスには直接表示されません。代わりに、SKAdNetwork のポストバックがイベントに変換され、first_open キーイベントとイベント レポートに統合されます。ディメンションの参照元プラットフォーム（参照元プラットフォーム = SKAN）を追加すると、セグメントに分割できます。
ヒットが送信されていることを確認するには、別のイベント名（campaign_details_skan_test）を使用して campaign_details イベントを複製し、テストイベントをログに記録することをおすすめします。その後、Google アナリティクス 4 のリアルタイム レポートにテストイベントが表示されることを確認します。テストイベントとパラメータを登録すると、リアルタイム レポートに加えてアドホック レポートにも表示されます。
- SKAdNetwork のすべてのポストバックをレポートに含めるには、各イベントを
campaign.detailsイベントとして送信することに加え、前述のように重複するイベントとパラメータを登録する必要があります。その場合は、SKAdNetwork のポストバックは引き続きcampaign.detailsイベントを使って送信する必要があります。そうしないと、Google アナリティクスで認識されず、コンバージョン モデリングが行なわれないため、iOS のfirst_openレポートが改善されません。 - SKAdNetwork のポストバックは、Google アナリティクスでコンバージョン モデリングとレポートに利用できるよう、受信後 4 日以内に送信する必要があります。
一般的な確認手順について詳しくは、こちらをご覧ください。