Singular は、Google Ads の App Conversion APIとのセルフアトリビューション型のサーバー間連携を介して Google Ads キャンペーンをトラッキングします。これには次のものが含まれます：

• いずれかの Google Ads キャンペーンによって獲得されたすべてのインストールとリエンゲージメントのトラッキング
• クリックスルーアトリビューションとビュースルーアトリビューションの両方

この連携では、Google Ads で生成され各アプリ固有の Link ID を使用します。Link ID が Singular で設定されると、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 の「Campaign ID」、「Campaign Name」、「Sub Campaign ID」、「Sub Ad Network」にマッピングされます。

Google Ads における「conversions」は、Singular におけるインストールとリエンゲージメントの両方を指す点にご注意ください。

さらに、Google Ads のドキュメントに記載されているとおり、Google Ads とすべてのサードパーティの間には本質的な不一致があります。

2020 年 1 月より、検索向けの App Campaigns for Installs は Google Ads によってアトリビューションされなくなったため、ユーザーレベルのレポートには表示されません。詳細については、Google のお知らせをご覧ください。

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

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

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

モデル化されたコンバージョンは特定の単一の広告インタラクションに紐づかないため、Google は対応する確定的なレスポンスを Singular や Google の App Attribution Partner のいずれにも提供できません。これにより、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
• キャンペーン名

engaged view (エンゲージ ビュー) とは、10 秒を超えて視聴された動画広告のユーザーインプレッションです。エンゲージ ビューは、Google と Singular のレポートではクリックスルーアトリビューションとしてカウントされます。

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

集計レポートでは、エンゲージ ビューのコンバージョンは次のように報告されます："conversion type" = "click-through"。

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

対象となるのは次のとおりです：

• App Tracking Transparency (ATT) を拒否した iOS 14.5 以降のユーザー
• 欧州経済領域 (EEA) の Android ユーザー、および Android で広告のパーソナライズ設定をオプトアウトしたユーザー。
• ICM はキッズアプリでもサポートされています。

Google Ads の Integrated Conversion Measurement は、クリックスルーのインストール測定のみをサポートしています。

Integrated Conversion Measurement のアトリビューションは、Singular では次のように報告されます：

• クリックスルー
• インストール
• 確率的 (probabilistic) としてアトリビューション (内訳は Singular のユーザーレベルレポートでのみ利用可能)
• Sub Network Type は利用できません
• Sub Campaign ID (Google Ads の広告グループ ID) は利用できません

iOS Integrated Conversion Measurement は、イベントデータを使用したオンデバイス測定を使用し、Google の ODM SDK の連携と、Singular SDK (または S2S API) のアップデートが必要です。

1. 次の 3 つのオプションのいずれかを使用して、Google のイベントデータを使用したオンデバイス測定 (ODM SDK) を連携します：

   Google Analytics for Firebase Swift Package Manager Cocoapods

   参照：Google のガイド

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

   1. Podfile に GoogleAdsOnDeviceConversion pod を追加します。

      pod 'GoogleAdsOnDeviceConversion'

   2. 次を実行します：

      pod install --repo-update

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

   iOS SDK Unity SDK Flutter, React Native, Cordova REST S2S API

   • ネイティブ SDK 最小バージョン 12.8.1
   • 「-ObjC 」を、アプリターゲットの「Other Linker Flags 」に必ず追加してください

   • Singular SDK の初期化時に enableOdmWithTimeoutInterval 設定オプションを SingularConfig に追加して、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

   • Singular が ODM 情報を収集できるようにするには、Enable ODM With Timeout Interval 設定オプションを SingularSDKObject に追加します。
     
     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
   • 「-ObjC 」を、アプリターゲットの「Other Linker Flags 」に必ず追加してください

   • Singular SDK の初期化時に enableOdmWithTimeoutInterval 設定オプションを SingularConfig に追加して、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.
      }];

      重要：

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

EEA ユーザーのユーザー同意シグナルをいつ、どのように収集するかは、ユーザープライバシーに関する自社の要件およびアプリの要件に従う必要があります。GDPR、e プライバシー指令、デジタル市場法などの社内プライバシーポリシーやプライバシー規制に、自社のアプリがどのように準拠する必要があるかについては、自社の法律顧問にご相談ください。

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

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

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

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

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

Singular のデータ共有の制限 (Limit Data Sharing、LDS) は、アプリ開発者が各ユーザーのユーザー同意シグナルを Singular に渡すことができる機能です。LDS はユーザーごとに設定され、SDK の初期化前または初期化後に設定できます。LDS は Singular の User Privacy Postbacks で使用され、Google などの特定のパートナーに渡されます。これらのパートナーは、自社のデータ慣行に準拠するために LDS を使用します。

「データ共有の制限でユーザーのプライバシー選択をサポートする FAQ」をご覧ください。

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

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

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

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

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