Singularは、Google AdsのアプリコンバージョンAPIとのサーバー間連携による自己アトリビューション機能を通じて、Google Adsキャンペーンを追跡します。これには以下が含まれます：

• Google Adsキャンペーンによって誘導されたすべてのインストールおよび再エンゲージメントの追跡
• クリックスルーおよびビュースルーの両方のアトリビューション

この連携では、Google Adsで生成され、アプリごとに一意の「リンクID」を使用します。SingularでリンクIDの設定が完了すると、Singularはすべてのインストール、セッション、および設定済みのアプリ内コンバージョンイベントをGoogleに送信し始めます。

Googleから返されるアトリビューションされたクリック情報を使用し、Singularはラストタッチアトリビューションを実行（Singularのアトリビューションプロセスを参照）し、Google Adsダッシュボードで受け取るのと同じ詳細なキャンペーン情報に基づいて、キャンペーンのパフォーマンスに関するレポートを提供します。

Google Ads キャンペーンに関連するコンバージョンやイベントのトラッキングを開始するには、まず Google Ads アカウントにアクセスし、コンバージョンアクション（イベントのインポートとも呼ばれます）を設定する必要があります。

詳細な手順については、「Google Ads アトリビューション連携：イベントのインポート方法」をご覧ください 。

次に、Google Ads キャンペーンの設定と開始を行います。利用可能なオプションや設定方法の詳細については、Google の手順に従ってください。

アトリビューションの追跡が開始されると、Google AdsキャンペーンがSingularのレポート画面に表示されます。

Singularは、クリック経由およびビュー経由のインストールおよび再エンゲージメントについて、アトリビューションされたGoogle Adsアプリキャンペーンデータのレポート機能をサポートしています。現在、利用可能なデータには、GoogleキャンペーンID、 キャンペーン名、広告グループIDに加え、 Googleチャネル（YouTube、ディスプレイ、検索）が含まれます 。これらのデータは、Singular内でそれぞれ「キャンペーンID」、「キャンペーン名」、「サブキャンペーンID」、「サブ広告ネットワーク」としてマッピングされます。

なお、Google Adsにおける「コンバージョン」は、Singularではインストールと再エンゲージメントの両方を指します。

また、Google Adsのドキュメントに記載されている通り、Google Adsとすべてのサードパーティ間には固有の不一致が存在します。

2020年1月より、「検索向けアプリインストールキャンペーン」のアトリビューションはGoogle Adsによって行われなくなったため、ユーザーレベルのレポートには表示されません。詳細については、Googleの発表をご覧ください。 

Singular SDKの実装に、ディープリンクおよびディファード・ディープリンクのサポートが含まれていることを確認してください。 

実装が完了すると、フィードを利用するGoogleキャンペーンにおいて、SingularとGoogleの連携によりディファード・ディープリンクが自動的に有効になります。

Google Adsで報告されるアプリコンバージョンには、確定的なソースとモデル化されたソースの両方が含まれている場合があります。モデル化されたコンバージョンがキャンペーンに与える影響については、Googleのドキュメントをご確認ください。

モデル化されたコンバージョンは特定の広告インタラクションに紐づかないため、GoogleはSingularやGoogleのアプリアトリビューションパートナーに対していかなる決定論的な応答も提供できません。これにより、Googleとサードパーティ（3P）間で報告されるコンバージョン数に差異が生じる可能性があります。

オプトアウトしたユーザーのアプリアクティビティは、広告IDがゼロに設定された状態でGoogleに報告されるため、Googleは個人を特定できる情報を一切受け取りません。 

Googleが広告を配信する際、自動タグ付けが有効になっている場合は、以下の「ID」も付加されます：

• Gbraid(iOS): iOS 14.5 以降のクリックに付加される識別子
• Gclid(Android、iOS): GoogleクリックID

これらの広告がディープリンク対応の場合、ユーザーがアプリにディープリンクで遷移した際に、Singular SDK/S2S統合によってIDが取得されます。Singularは利用可能なIDをGoogleに転送し、これらはSingular内で再エンゲージメントとして自己アトリビューション報告されます。「gbraid」の場合、これらの再エンゲージメントアトリビューションの粒度は低くなります。「gbraid」に基づく再エンゲージメントアトリビューションには以下の特徴があります：

• キャンペーンID
• キャンペーン名

エンゲージドビューとは、10秒以上継続した動画広告のユーザーインプレッションのことです。エンゲージドビューは、GoogleおよびSingularのレポートにおいて、クリックスルーアトリビューションとしてカウントされます。

Singularのユーザーレベルログでは、Googleにアトリビューションされたコンバージョン/イベントデータの「passthrough」フィールドにおいて、「interaction_type」=「engagement」としてエンゲージドビューによるコンバージョンが報告されます。

集計レポートでは、エンゲージドビューによるコンバージョンは「conversion type」=「click-through」として報告されます。

Googleの統合コンバージョン測定は、サードパーティのアプリアトリビューションパートナーのインターフェースにおいて、Googleアプリキャンペーンに対して、よりリアルタイムで包括的かつ正確なアトリビューションを提供します。この機能は、イベントデータを使用したデバイス上のコンバージョン測定などの革新的な技術を取り入れ、ユーザーのプライバシーを損なうことなく測定精度を向上させます。その結果、ユーザーレベルの識別子が欠落している場合でも、イベントレベルのインサイトを得ることができます。

対象範囲：

• App Tracking Transparency（ATT）を拒否したiOS 14.5以降のユーザー
• 欧州経済領域（EEA）のAndroidユーザー、およびAndroidで広告のパーソナライズ設定をオプトアウトしたユーザー

Google Adsの統合コンバージョン測定は、クリックからインストールまでの測定のみをサポートしています。

統合コンバージョン測定のアトリビューションは、Singularにおいて以下のようにレポートされます

• クリック経由
• インストール
• 確率論的アトリビューションとして（内訳はSingularのユーザーレベルレポートでのみ確認可能）

iOS統合コンバージョン測定は、イベントデータを使用したデバイス内測定を利用しており、GoogleのODM SDKの統合に加え、Singular SDK（またはS2S API）の更新が必要です。

1. 以下の3つの方法のいずれかを使用して、イベントデータを利用したGoogleのオンデバイス測定（ODM SDK）を統合してください：

   Google Analytics for FirebaseSwift Package ManagerCocoapods

   Googleのガイドを参照

   1. Xcodeで、「ファイル」＞「パッケージを追加」を選択します。
   2. 表示されるプロンプトに、GoogleAdsOnDeviceConversionGitHubリポジトリを入力します：https://github.com/googleads/google-ads-on-device-conversion-ios-sdk
   3. 完了すると、Xcodeはパッケージの依存関係を解決し、バックグラウンドでダウンロードを開始します。

   1. PodfileにGoogleAdsOnDeviceConversionpodを追加します。

      pod 'GoogleAdsOnDeviceConversion'

   2. 実行

      pod install --repo-update

2. Singular SDK または S2S API の実装を更新

   iOS SDKUnity SDKFlutter, React-Native, CordovaREST S2S API

   • Native SDK の最小バージョンは12.8.1です。
   • アプリターゲットの「Other Linker Flags」に「-ObjC」を追加してください

   • Singular SDK を初期化する際に、SingularConfigにenableOdmWithTimeoutInterval設定オプションを追加し、Singular が ODM 情報を収集できるようにします。
     
     enableOdmWithTimeoutInterval には、 秒単位のタイムアウト値を設定します 。タイムアウト値は 5 秒に設定することを推奨します。このタイムアウト値は、インストール後の初回起動時に、Singular SDK が ODM SDK からの ODM 情報を待機するために初期化を遅延させる最大時間を設定します。

     重要：ODM SDKからのODM情報を待機するプロセスは、SingularディープリンクコールバックハンドラーなどのSingular SDKコールバックを遅延させます。そのため、ディープリンクの処理が遅れる可能性があります

     
     Swift:

     config.enableOdmWithTimeoutInterval = 5

     Objective-C:

     config.enableOdmWithTimeoutInterval = 5;

   • Unity SDK 最小バージョンv5.5.0

   • SingularSDKObjectに「Enable ODM With Timeout Interval」設定オプションを追加することで、SingularによるODM情報の収集を有効にします。
     
     「Enable ODM With Timeout Interval」は 秒単位のタイムアウト値で設定します 。タイムアウト値は5秒に設定することを推奨します。このタイムアウト値は、インストール後の初回起動時に、Singular SDKがODM SDKからのODM情報を待機するために初期化を遅延させる最大時間を設定します。

     重要：ODM SDKからのODM情報を待機するプロセスは、SingularディープリンクコールバックハンドラーなどのSingular SDKコールバックを遅延させます。そのため、ディープリンクの処理が遅れる可能性があります

     
     

   • Flutter SDK の最小バージョンv1.8.0
   • React-Native SDK の最小バージョンv3.9.0
   • Cordova SDK の最小バージョンv1.8.0
   • アプリターゲットの「Other Linker Flags」に「-ObjC」を追加してください

   • Singular SDK の初期化時にSingularConfigにenableOdmWithTimeoutInterval設定オプションを追加し、Singular が ODM 情報を収集できるようにします。
     
     enableOdmWithTimeoutInterval には、 秒単位のタイムアウト値を設定します 。タイムアウト値は 5 秒に設定することを推奨します。このタイムアウト値は、インストール後の初回起動時に、Singular SDK が ODM SDK からの ODM 情報を待機するために初期化を遅延させる最大時間を設定します。

     重要：ODM SDKからのODM情報を待機するプロセスは、SingularディープリンクコールバックハンドラーなどのSingular SDKコールバックを遅延させます。そのため、ディープリンクの処理が遅れる可能性があります

     config.enableOdmWithTimeoutInterval = 5

   1. アプリ初回起動直後にデバイス情報を取得する
      
      Swift:

      import GoogleAdsOnDeviceConversion
      
      // Set the time when the app was first launched.
      ConversionManager.sharedInstance.setFirstLaunchTime(Date())
      
      // Fetch the conversion info.
      ConversionManager.sharedInstance.fetchAggregateConversionInfo(for: .installation)
      { aggregateConversionInfo, error in
         guard error == nil else { return }
         guard let info = aggregateConversionInfo else {
            // Troubleshoot:
            // 1. Check that the Date passed to setFirstLaunchTime() was when the app
            //    first launched.
            // 2. Check that your app is running in an approved region.
            return
         }
         guard info.count  0 else { return }
      
         print("Conversion info \(info)")
         // Use info as the value in the odm_info query parameter in
         // the App Conversion API detailed in Step 6.
         // For example, if info is "abcdEfadGdaf", then odm_info=abcdEfadGdaf.
      }

      
      Objective-C:

      @import GoogleAdsOnDeviceConversion;
      
      // Set the time when the app was first launched.
      [[ODCConversionManager sharedInstance] setFirstLaunchTime:[NSDate date]];
      
      // Fetch the conversion info.
      [[ODCConversionManager sharedInstance]
         fetchAggregateConversionInfoForInteraction:ODCInteractionTypeInstallation
         completion:^(NSString * _Nullable aggregateConversionInfo,
                      NSError * _Nullable error) {
         if (error) {
            return;
         }
         if (aggregateConversionInfo.length == 0) {
            // Troubleshoot:
            // 1. Check that the NSDate passed to setFirstLaunchTime() was when the app
            //    first launched.
            // 2. Check that your app is running in an approved region.
            return;
         }
        
         NSLog(@"Conversion info %@", aggregateConversionInfo);
         // Use aggregateConversionInfo as the value in the odm_info query parameter in
         // the App Conversion API detailed in Step 6.
         // For example, if aggregateConversionInfo is "abcdEfadGdaf",
         // then odm_info=abcdEfadGdaf.
      }];

      重要:

      • このステップは非同期処理であるため、完了するまではセッションイベントの送信を控える必要がある場合があります。
      • odm_infoを取得し、アプリのストレージに保存して、最初のセッションに追加できるようにします。この値は、「odm_info」パラメータを介して Singular の S2S API に渡されます
      • エラーが発生した場合は、エラー情報を収集してください。この値は、「odm_error」パラメータを介してSingularのS2S APIに渡されます
      • setFirstLaunchTimeで渡される日付タイムスタンプは、SingularのS2S APIに「utime」パラメータ経由で渡されるインストールタイムスタンプと大きく異ならないようにしてください。
   2. SingularのS2S APIへのオンデバイス情報の送信
      
      すべてのアプリインストールセッション（install=true）について、 Singular S2S /launchエンドポイントに ODM 情報と ODM エラーを含めてください。

EEAユーザーに対する同意シグナルの収集時期および方法は、貴社およびアプリのユーザープライバシーに関する要件に従う必要があります。アプリが内部のプライバシーポリシーや、GDPR、eプライバシー指令、デジタル市場法などのプライバシー規制にどのように準拠すべきかについては、貴社の法務担当者に相談してください。

ユーザー同意シグナルを収集する場合、一般的に以下のことが推奨されます：

• ユーザー同意シグナルは、ユーザーが明示的にオプトインまたはオプトアウトした場合にのみ設定してください。ユーザーが選択を行わなかった場合は、LDSを設定しないままにしておくことを推奨します。ユーザーシグナルが存在しないこと自体が重要な意味を持つ場合があります。
• ユーザー同意シグナルは、通常、アプリ利用中の「プライバシー設定」や「プライバシー選択」画面で収集されます。
• 可能であれば、またアプリの同意プロンプトの設計や戦略に応じて、アプリフローの早い段階でプライバシーに関するプロンプトを表示し、Singularやその他のSDKがユーザー同意シグナルを可能な限り早期に収集できるようにしてください
   

貴社が、EEAユーザーに対するEUのプライバシー規制がアプリに適用されると判断した場合：アプリがこれらのユーザーに提示する同意プロンプトに基づき、Singular SDK/S2Sの「データ共有の制限」機能を実装してください。

 

貴社が、EUのプライバシー規制がアプリに適用されないと判断した場合、SingularでEEAユーザーの同意シグナルをオプトアウトできます。パートナー設定の「ユーザープライバシー」セクションにある「EEAオプトアウト」オプションにチェックを入れてください。このオプションを選択すると、GoogleはLDSおよびユーザーの同意シグナルを使用しません。


 

• このオプションを使用する場合、EEAユーザー向けのLDS実装は必須ではありません
• このオプションは、Googleの3月のアップデートが適用される前に有効化できます

Singularのデータ共有制限（LDS）は、アプリ開発者が各ユーザーの同意シグナルをSingularに送信できるようにする機能です。LDSはユーザーごとに設定され、SDKの初期化の前後に設定可能です。LDSはSingularのユーザープライバシーポストバックで使用され、Googleなどの特定のパートナーに送信されます。パートナーはこれを利用して、自社のデータ取り扱い方針に準拠します。

「データ共有制限によるユーザープライバシーの選択のサポートに関するFAQ」を参照

Googleは、必要なユーザー同意シグナルをサポートする同意管理プラットフォーム（CMP）をリストアップしています。これらのCMPのいずれかを使用している場合、ユーザー同意シグナルを抽出し、SingularのLimitDataSharing機能を通じて送信することができます。 

ユーザー同意のオプトアウトを選択したEEAユーザーの場合：

• Singularでは、Google Adsキャンペーンに対するユーザーレベルの帰属分析が利用できなくなります。Googleはこれらの帰属データをMMPに報告できなくなります
• Google Adsはこれらのユーザーに対してコンバージョンを推定し、その推定値はSingularがGoogle Adsデータコネクタから取得する集計ネットワーク指標に反映されます。
• Google Adsは、これらのユーザーのデータを広告目的で使用することはできません

ユーザー同意にオプトインしたEEAユーザーの場合：

• Google Ads キャンペーンへのユーザーレベルのアトリビューションが可能となります
• Google Adsは、このデータを広告目的で使用します