Singularは、Google AdsのApp Conversion APIとのサーバー間統合により、Google Adsキャンペーンをトラッキングします：

• お客様のGoogle広告キャンペーンによるすべてのインストールとリエンゲージメントを追跡します。
• クリックスルーとビュースルーの両方のアトリビューション

この統合では、Google Adsで生成される各アプリ固有のリンクIDを使用します。リンクIDがSingularで設定されると、Singularはすべてのインストール、セッション、設定されたアプリ内コンバージョンイベントをGoogleに送信し始めます。

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

Google Adsキャンペーンに関連するコンバージョンやイベントのトラッキングを開始するには、まずGoogle Adsアカウントでコンバージョンアクションを設定 する必要があります。

Google Ads Attribution Integrationをご覧ください：イベントのインポート方法をご覧ください。

次に、Google広告キャンペーンを設定し、開始します。オプションの詳細と設定方法については、Googleの指示に従ってください。

アトリビューションがトラッキングされると、Google AdsキャンペーンがSingularのレポーティングインターフェースに表示されます。

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

Google広告の「コンバージョン」は、Singularではインストールと リエンゲージメントの両方を指すことに注意してください。

また、Google Adsとすべてのサードパーティの間には、Google Adsのドキュメントで説明されているように、固有の不一致があります。

2020年1月より、検索へのインストールに対するアプリキャンペーンはGoogle Adsによってアトリビュートされなくなったため、ユーザーレベルのレポートには表示されません。詳しくはGoogleのアナウンスをご覧ください。

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

SingularをGoogleと統合すると、フィードを利用したGoogleキャンペーンで自動的にディファードディープリンクが有効になります。

Google Adsが報告するアプリのコンバージョンには、決定論的なソースとモデル化されたソースの両方が混在している可能性があります。モデル化されたコンバージョンがキャンペーンにどのような影響を与えるかについては、Googleのドキュメントをご覧ください。

モデル化されたコンバージョンは単一の特定の広告インタラクションに結びつかないため、GoogleはSingularやGoogleのApp Attribution Partnersに対応する決定論的なレスポンスを提供することができません。そのため、Googleと3Pの間でコンバージョンが食い違う可能性があります。

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

グーグルが広告を配信する際、自動タグ付けが有効な場合は「ID」も付加されます：

• Gbraid（iOS）：Gbraid（iOS）：iOS14.5以上のクリックに付加される識別子
• Gclid（Android、iOS）：GoogleクリックID

これらの広告がディープリンク可能な場合、ユーザーがアプリにディープリンクされると、Singular SDK/S2S統合によってIDが取得されます。Singularは利用可能なIDをGoogleに転送し、Singular内でリエンゲージメントとしてレポートされます。gbraid "の場合、これらのリエンゲージメントアトリビューションの粒度は小さくなります。"gbraid "ベースのリエンゲージメントアトリビューションには以下のようなものがあります：

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

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

Singularのユーザーレベルのログでは、エンゲージドビューのコンバージョンは、Googleに帰属するコンバージョン/イベントデータの "パススルー "フィールドの"interaction_type" = "engagement "で報告されます。

集計レポートでは、エンゲージビューのコンバージョンは「コンバージョンタイプ」=「クリックスルー」でレポートされます。

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

対象

• App Tracking Transparency（ATT）を拒否したiOS 14.5以上のユーザー
• 欧州経済地域（EEA）のAndroidユーザー

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

• クリックスルー
• インストール
• 確率的なアトリビューション（Singular のユーザーレベルのレポートでのみ利用可能な内訳）

iOS統合コンバージョン測定は、イベントデータを使用したオンデバイス測定を使用し、Singular SDK（またはS2S API）の更新と同様にGoogleのODM SDKを統合する必要があります。

1. これら3つのオプションのいずれかを使用して、イベントデータを使用したGoogleのオンデバイス測定（ODM SDK）を統合します：

   Google Analytics for FirebaseSwift Package ManagerCocoapods

   Googleのガイドを参照

   1. Xcodeで、File > Add Packagesに移動します。
   2. 表示されるプロンプトで、GoogleAdsOnDeviceConversionGitHub リポジトリを入力します: https://github.com/googleads/google-ads-on-device-conversion-ios-sdk
   3. 完了後、Xcodeはパッケージの依存関係を解決し、バックグラウンドでダウンロードを開始します。

   1. Podfileに、GoogleAdsOnDeviceConversionポッドを追加します。
      

      pod 'GoogleAdsOnDeviceConversion'

   2. 実行

      pod install --repo-update

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

   Singular SDK (Native)Singular SDK (Unity)Singular SDK (Flutter, React-Native, Cordova)Singular S2S API

   • ネイティブ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. アプリの初回起動直後にデバイス情報を取得する
      
      スウィフト

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

      
      
      重要：

      • このステップは非同期操作なので、それが完了する前に Session イベントを送るのを控える必要があるかもしれません。
      • odm_infoを収集し、アプリのストレージと共有する。この値は"odm_info "パラメータを通してSingularのS2S APIに渡される。
      • エラーが発生した場合は、エラーを収集する。この値は "odm_error"パラメータを通してSingularのS2S APIに渡される。
      • なお、setFirstLaunchTimeで渡される日付のタイムスタンプは、"utime"パラメータ経由でSingularのS2S APIに渡されるインストールのタイムスタンプと大きく異なるものであってはならない。
   2. デバイス情報をSingularのS2S APIに渡す
      
      アプリのインストールセッション（install=true）ごとに、 Singular S2S /launchエンドポイントにODM情報とODMエラーを含める。

いつ、どのようにEEAユーザーの同意シグナルを収集するかは、ユーザーのプライバシーに関するあなたのビジネスとアプリの要件に準拠する必要があります。あなたのアプリが社内のプライバシーポリシーやGDPR、ePrivacy Directive、Digital Markets Actなどのプライバシー規制をどのように遵守する必要があるか理解するために、あなたのビジネスの法律顧問に相談してください。

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

• ユーザーの同意シグナルは、ユーザーが明示的にオプトインまたはオプトアウトした場合にのみ設定されます。ユーザーが選択しなかった場合、LDSを未設定のままにすることを推奨します。ユーザー同意シグナルの不在は重要かもしれない。
• ユーザーの同意シグナルは、一般的にアプリ体験中の「Privacy Choices（プライバシー選択）」または「Privacy Settings（プライバシー設定）」で収集されます。
• 可能であれば、アプリの同意プロンプトのデザインや戦略にもよりますが、Singularや他のSDKができるだけ早い段階でユーザーの同意シグナルを収集できるように、アプリフローの早い段階でプライバシープロンプトを表示しましょう。
  
  

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

SingularのLDS（Limit Data Sharing）は、アプリ開発者が各ユーザーの同意シグナルをSingularに渡すことを可能にする機能です。LDSはユーザーごとに設定され、SDKの初期化前または初期化後に設定できます。LDSはSingularのユーザープライバシーポストバックで使用され、Googleのような特定のパートナーに渡されます。

"Supporting User Privacy Choices with Limit Data Sharing FAQ"を参照してください。

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

2024年3月から

ユーザー同意にオプトアウトしているEEAユーザーの場合：

• Google広告キャンペーンへのユーザーレベルのアトリビューションはSingularでは利用できなくなります。 Google はこれらのアトリビューションを MMP に報告できなくなります。
• Google Adsはこれらのユーザーのコンバージョンをモデル化し、SingularがGoogle Adsデータコネクターから取得する集約されたネットワークメトリクスに反映されます。
• Google Adsはこのユーザーデータを広告目的で使用することはできません。

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

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