(コンバージョンAPI）Google広告オフラインコンバージョンAPI

フォローする
Avatar
Jonathan Chen
Updated
ドキュメント
ウェブ、PC、コンソールイベントのコンバージョンポストバックは、Singularのウェブ、PC、コンソールゲームのアトリビューションにアクセスできるSingularのお客様のみご利用いただけます。

SingularとGoogle Ads Offline Conversions API（別名uploadClickConversions）の統合により、広告主はSingularがアトリビューションしたGoogle AdsのクリックコンバージョンをGoogleに送信することができます。 この統合は、Singularのウェブ、PC、コンソールの測定でサポートされています。 Singularのモバイル測定とGoogle Adsの統合については、ヘルプセンターの記事をご覧ください。

Google Ads Offline Conversions API統合の設定方法

  1. Singularと統合されたウェブ、PC、またはコンソールアプリがあることを確認します。
  2. Singular > Attribution > Partner Configurationに進みます。
  3. "Add a Partner"をクリックし、"Google Ads Offline Conversions API (S2S)"と入力して選択します。
  4. Singularを承認するユーザーを追加または選択します。
  5. ダイアログで、設定するアプリとアプリサイト（プラットフォーム）を選択します。この統合でサポートされているのはウェブ、PC、コンソールアプリのみです。
  6. カスタマーID」にGoogle AdsのカスタマーIDを入力します。顧客IDはGoogle広告のダッシュボードの右上にあります。ハイフンは不要です。

    複数のGoogle Adsアカウントでアプリのキャンペーンを実施している場合、マネージャー（MCC）アカウントを使用したクロスアカウントのコンバージョントラッキングでは、マネージャー（MCC）アカウントの「顧客ID」を使用する必要があります。MCCアカウントの設定方法については、Googleのヘルプセンターの記事をご覧ください。
  7. PCおよびコンソールアプリのみ：Google広告アカウントで、「インストール」用のコンバージョンアクションを作成します。作成した「インストールコンバージョンアクションID」をコピー＆ペーストします。
  8. Google Adsアカウントで、送信したいその他のイベントのコンバージョンアクションを作成し、各イベントを対応する「コンバージョンアクションID」にマッピングします。
  9. 保存」をクリックして完了です。

よくある質問

Google Ads Conversions API用のコンバージョンアクションを作成する方法を教えてください。
  1. "新規コンバージョンアクション"をクリックします。


  2. "インポート"を選択


  3. APIまたはアップロードを使用した手動インポート" ->"クリックからのコンバージョンを追跡"を選択する

    注：MCCアカウントでは、「APIまたはアップロードを使用した手動インポート」オプションが表示されない場合があります。この場合は、"その他のデータソースまたはCRM"、"クリックからのコンバージョンを追跡する"、"このステップをスキップして、後でデータソースを設定する"を選択して、コンバージョンアクションの作成を続行してください。

  4. Googleのプロンプトに従ってコンバージョンの詳細を設定します。完了したら「作成して続行」をクリックします。

  5. コンバージョン目標"ページに戻り、先ほど作成したコンバージョンアクションを見つけ、クリックして詳細を表示します。


  6. コンバージョンアクションの"詳細"ページで、URLパラメータ"ctId="から"コンバージョンアクションID"をコピーします。



  7. コンバージョンアクションID"の入力を求められたら、この"コンバージョンアクションID"をSingularパートナー設定に貼り付けます。
Google Ads Conversions API用のコンバージョンアクションを作成するには？
  1. 作成 >"新規コンバージョンアクション"をクリック


  2. まだ選択されていない場合は、[Conversions offline] > [Continue] を選択します。
  3. オフラインコンバージョンをまだ設定していない場合、この画面が表示されることがあります。このステップをスキップして、後でデータソースをセットアップする"を選択します。
  4. 測定したい標準コンバージョンアクションを選択します。
  5. このカテゴリにイベントを追加]>[オフラインデータソース]をクリックします。
重要アプリインストールコンバージョンアクションは、この統合では使用しないでください。コンバージョンオフラインコンバージョンアクションのいずれかを使用して、ウェブからアプリインストールへの新しいコンバージョンアクションを作成する必要があります。
  1. 追加したコンバージョンアクションの横にある[設定]をクリックします。
  2. コンバージョンアクションの名前を希望するコンバージョンアクション名に変更し、コンバージョンアクションの設定を更新して、このイベントで希望する測定と最適化の目標に合わせます。次に、保存をクリックします。
  3. Save and Continue（保存して続行）をクリックします。
  4. 完了をクリックする
  5. これで、サマリー画面にコンバージョンアクションが表示されます。コンバージョンソースは"ウェブサイト（クリックからのインポート）"でなければなりません。完全なセットアップが完了し、Singularが属性付きイベントをGoogleに送信し始めるまで、ステータスが非アクティブであることは通常です。
  6. コンバージョンアクションをクリックし、URLブラウザのアドレスバーからctld値をコピーします
  7. SingularのGoogle Adsウェブイベントパートナー設定にctld値を追加する
SingularはオフラインコンバージョンAPIを通してどのようなデータを送信しますか？
パラメータ 詳細
gclid, gbraid (coming soon), wbraid (coming soon)
  • 自動的に渡される
hashed email
  • オプション
  • ハッシュされたEメールは、Singular instrumented event属性"ehash"として渡される。
  • ハッシュ化されたEメール値は正規化され、SHA 256ハッシュ化されている必要があります。
hashed phone number
  • オプション
  • ハッシュ化された電話番号は、Singular instrumented event attribute"phashE164" として渡される。
  • ハッシュ化された電話番号は、E164で正規化され、SHA 256でハッシュ化されていなければならない。
USER_PERMISSION_DENIED"でポストバックが失敗している。

このエラーは、認証されたユーザーが設定されたMCCアカウントに対する権限を持っていない場合に発生します。

このエラーを解決するには、Google Adsのアカウントにアクセスし、Singularの承認済みユーザーが設定されたMCCアカウントに対するフルパーミッションを持っていることを確認してください。

ポストバックが"CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS" で失敗しています。

このエラーは、Googleの拡張コンバージョン処理規約に同意していない場合に発生します。

このエラーを修正するには、Google Adsアカウントにアクセスし、サイドメニューから「設定」に入り、「目標」の下にある「コンバージョン」画面を選択し、以下のようにリードの強化コンバージョンをオンにしてください：

詳しくは、Google Adsのドキュメントをご覧ください。

Google Ads Offline Conversions APIの制限は何ですか？
  • クリックコンバージョンにのみ対応しています。
  • モデリングはサポートされていません。
Google Ads Offline Conversions API でモバイルイベントはサポートされていますか？
  • Google OCI ポストバックは、Singular のモバイルウェブからアプリへのアトリビューションフロー（例：Google 広告クリック → Singular Web SDK を使用した広告主所有のランディングページ → Singular モバイルウェブからアプリへのクリック → インストール）を使用する場合にのみ、モバイルアプリサイトにアプリイベントを送信するように設定する必要があります。
  • Google ウェブキャンペーンで広告クリックからストアへの直接のフローが利用されている場合（例：Google 広告クリック → アプリストア）、代わりにGoogle Ads ウェブ統合を使用してください。
  • このインテグレーションは、標準的なモバイルアプリのインストールやリターゲティングキャンペーンには使用しないでください。モバイルキャンペーンにはGoogle広告モバイルアプリキャンペーン統合をご利用ください。