このガイドでは、Google Ads API を使用して作成できるさまざまなタイプのコンバージョン アクションの一覧と、それらが Google 広告のウェブ インターフェースにどのようにマッピングされるかについて説明します。
適切なコンバージョン アクションの種類を選択する
統合に適したコンバージョン アクション タイプと設定ガイドを選択するには、次の決定パスを使用します。
コンバージョン イベントはどこで発生しますか?
- オフライン(オフィス、店舗、電話など): ステップ 2 に進みます。
- ウェブサイトで直接(ウェブサイトでの購入、申し込み、フォームの送信など): ステップ 3 に進みます。
- モバイルアプリ内: ステップ 4 に進みます。
- 広告から直接発信された電話: 広告からの通話(
AD_CALL)(CallAssetを使用)を使用します。 - Google の位置情報に基づくサービス(Google マップでのルート検索、通話、クリックなど): ローカル アクションのコンバージョン(
GOOGLE_HOSTED)をご覧ください。
オフライン コンバージョン:
電話ですか?
はい: 使用する
通話コンバージョンのインポート(
UPLOAD_CALLS): 通話の結果をトラッキングします。
実店舗での販売ですか?
はい: 使用する
ウェブサイトへのアクセスから発生したオフライン販売または見込み顧客の進展ですか?
- はい: Data Manager API を使用してリードの拡張コンバージョンを使用します(推奨)。または、既存の Google Ads API 統合については、オフライン クリック コンバージョンを管理するをご覧ください。(注: 2026 年 6 月 15 日以降、
UploadClickConversionsを使用したクリック コンバージョンのアップロードは、以前にオフライン クリック コンバージョンをアップロードしたことがあるデベロッパー トークンに制限されます)。
- はい: Data Manager API を使用してリードの拡張コンバージョンを使用します(推奨)。または、既存の Google Ads API 統合については、オフライン クリック コンバージョンを管理するをご覧ください。(注: 2026 年 6 月 15 日以降、
オンライン(ウェブサイト)コンバージョン:
- ページの読み込み(購入、領収書)とユーザーのクリックのどちらをトラッキングしますか?
- はい: タグスニペットを
WEBPAGEまたはWEBPAGE_ONCLICKに設定して、ウェブサイト コンバージョンを使用します。
- はい: タグスニペットを
ウェブサイトに掲載された電話番号への問い合わせをトラッキングしますか?
実際の通話時間をトラッキングする
はい: 使用する
ウェブサイトからの通話(
WEBSITE_CALL)。動的な Google 広告専用転送電話番号とタグ イベント スニペットを使用します。いいえ(モバイルサイトのボタンやリンクのクリックのみをトラッキングする)使用
- ページの読み込み(購入、領収書)とユーザーのクリックのどちらをトラッキングしますか?
モバイルアプリ コンバージョン:
- Google Play ストアからのインストールや購入をトラッキングするだけで十分ですか?
- はい: アプリ コンバージョン(
GOOGLE_PLAY_DOWNLOADまたはGOOGLE_PLAY_IN_APP_PURCHASE)を使用します。
- はい: アプリ コンバージョン(
Google アナリティクス(GA4)またはサードパーティのアプリ解析を使用して、 アプリ内ユーザー行動をトラッキングしていますか?
はい: 使用する
Firebase とサードパーティ製アプリ解析(
FIREBASE_*またはTHIRD_PARTY_*コンバージョン アクションを有効にする)。
- Google Play ストアからのインストールや購入をトラッキングするだけで十分ですか?
オフライン コンバージョン
オフライン コンバージョンを使用すると、オフィス、店舗、電話など、オフライン環境で発生したコンバージョン イベントをトラッキングできます。
次の表に、Google 広告ウェブ インターフェースの各ソースで使用する同等の ConversionActionType API パラメータと、特定のコンバージョン アクション タイプごとのドキュメントへのリンクを示します。
| コンバージョン アクションの種類 | コピー元の Google 広告 | API 設定ガイド |
|---|---|---|
UPLOAD_CLICKS |
クリックに起因するコンバージョンとリードの拡張コンバージョンをトラッキングする | Data Manager API を使用する(推奨)か、既存の Google Ads API 統合についてはオフライン クリック コンバージョンを管理するをご覧ください。 |
UPLOAD_CALLS |
電話での問い合わせによるコンバージョンをトラッキング | 通話コンバージョンのインポート ガイド |
STORE_SALES |
店舗販売のコンバージョンをトラッキングする | 詳しくは、店舗販売: レポート機能付きのコンバージョン アクションにインポートするをご覧ください。 |
オンライン(ウェブサイト)コンバージョン
ウェブサイト コンバージョンを使用すると、オンライン販売、リンクのクリック、ページビュー、登録など、ウェブサイトでのアクションをトラッキングできます。
ウェブサイトでのコンバージョンをトラッキングするには、ConversionActionType を WEBPAGE に設定した ConversionAction を作成し、タグと呼ばれるコード スニペットをウェブサイトのコンバージョン ページに追加する必要があります。
ConversionAction には、いくつかのタイプのウェブサイト コンバージョンが含まれています。API 内では、ConversionAction の tag_snippets フィールドにリストされている各 TagSnippet の type フィールドによって区別されます。
TagSnippet は、コンバージョン アクションをトラッキングするためにウェブサイトに含める必要があるトラッキング コードを提供します。ウェブサイトと電話番号のクリックのコンバージョンには、と が必要です。は、コンバージョン アクション(購入確認ページやリードフォームの送信ページなど)を示すウェブページに配置する必要があります。は、ウェブサイトのすべてのページにインストールする必要があります。event_snippetglobal_site_tagこれらの属性はどちらも ConversionActionService で取得できます。ページにタグを設定する方法について詳しくは、ヘルプセンターをご覧ください。
次の表に、Google 広告ウェブ インターフェースの各ソースに対応する API パラメータを示します。
| トラッキング コードの種類 | コピー元の Google 広告 |
|---|---|
WEBPAGE |
ウェブサイト、ウェブサイト(Google アナリティクス(GA4)) |
WEBPAGE_ONCLICK |
ウェブサイト、ウェブサイト(Google アナリティクス(GA4)) |
CLICK_TO_CALL |
電話番号のクリック数 |
アプリ コンバージョン
アプリ コンバージョンを使用すると、Google Play ストアからのモバイルアプリのインストールやアプリ内購入をトラッキングできます。
次の表に、Google 広告ウェブ インターフェースの各ソースに対応する ConversionActionType API パラメータを示します。
| コンバージョン アクションの種類 | コピー元の Google 広告 |
|---|---|
GOOGLE_PLAY_DOWNLOAD |
Google Play > インストール |
GOOGLE_PLAY_IN_APP_PURCHASE |
Google Play > アプリ内購入 |
Google アナリティクス 4 プロパティまたはサードパーティ製アプリ解析を使用して他のモバイルアプリのアクションをトラッキングするには、その他のコンバージョン アクション タイプをご覧ください。
通話コンバージョン
電話コンバージョン トラッキングを使用すると、広告経由の通話、ウェブサイトに掲載された電話番号への問い合わせ、モバイルサイトでの電話番号のクリックをトラッキングできます。
次の表に、Google 広告ウェブ インターフェースの各ソースに対応する ConversionActionType API パラメータを示します。
| コンバージョン アクションの種類 | コピー元の Google 広告 |
|---|---|
AD_CALL |
電話番号表示オプションを使用した広告や電話専用広告でのコール コンバージョン |
WEBSITE_CALL |
ウェブサイトに掲載した電話番号への問い合わせ |
CLICK_TO_CALL |
モバイルサイト上で電話番号をクリックします。 |
AD_CALL
AD_CALL コンバージョン アクションは、Google 広告のウェブ インターフェースに広告からの通話コンバージョンとして表示されます。AD_CALL コンバージョン アクションを作成したら、CallAsset を作成するときに call_conversion_action フィールドでそのリソース名を指定します。電話番号アセットを使用すると、広告に電話番号を直接表示できます。
通話時間が指定した時間を超えた場合、通話はコンバージョンとしてレポートされます。カウントされます。
WEBSITE_CALL
WEBSITE_CALL コンバージョン アクションは、Google 広告のウェブ インターフェースでウェブサイトからの通話コンバージョンとして表示されます。
AD_CALL とは異なり、このトラッカーでは、ウェブサイトに event_snippet と global_site_tag を追加して、ウェブサイトに掲載されている電話番号のコール トラッキング用の動的な Google 広告専用転送電話番号を取得する必要があります。また、電話番号アセットをセットアップし、
顧客、キャンペーン、または広告グループの単位でリンクします。
CLICK_TO_CALL
CLICK_TO_CALL コンバージョン アクションは、Google 広告のウェブ インターフェースで、モバイルサイト上の電話番号のクリック コンバージョンとして表示されます。
CLICK_TO_CALL タイプは、実際の通話をトラッキングしないという点で AD_CALL タイプとは異なります。代わりに、CLICK_TO_CALL では、モバイル デバイスからの電話番号のクリックのみがトラッキングされます。これは、Google 広告専用転送電話番号を使用して通話をトラッキングできない場合に便利です。
拡張コンバージョン
拡張コンバージョンを使用すると、メールアドレス、氏名、自宅の住所、電話番号などのファーストパーティのコンバージョン データを既存のコンバージョン タグに追加して、コンバージョンの測定の精度を向上させることができます。
次の表に、各拡張コンバージョン タイプに使用する同等の API パラメータを示します。
| コンバージョン アクションの種類 | 拡張コンバージョンの種類 | API 設定ガイド |
|---|---|---|
UPLOAD_CLICKS |
リードの拡張コンバージョン
ウェブサイトで獲得した見込み顧客やウェブサイトにアクセスしたユーザーから発生したオフライン取引の測定を改善できます。 |
Data Manager API(推奨)を使用するか、既存の Google Ads API 統合についてはオフライン クリック コンバージョンを管理するをご覧ください。 |
WEBPAGE |
拡張コンバージョン(ウェブ向け)
オンライン コンバージョンの測定を改善できます。 |
API 設定ガイド |
その他のコンバージョン アクション タイプ
Google Ads API では、レポートで追加のコンバージョン アクション タイプを使用できますが、これらのアクションの作成や変更が制限または禁止される場合があります。GoogleAdsService を使用して、コンバージョン アクションとそのタイプをクエリできます。
SELECT
conversion_action.id,
conversion_action.name,
conversion_action.type,
conversion_action.origin,
conversion_action.category,
conversion_action.status
FROM conversion_action
SKAdNetwork コンバージョン
iOS アプリ キャンペーンを運用し、SKAdNetwork を実装している場合は、次のリソースを使用して、Customer レベルと Campaign レベルで Google に提供された SKAdNetwork データにアクセスできます。
| レポートの項目 | 説明 |
|---|---|
metrics.sk_ad_network_installs |
Apple によって報告されたインストール数。この指標は、segments.sk_ad_network_conversion_value と日付関連のセグメントの組み合わせでのみ分割できます。 |
metrics.sk_ad_network_total_conversions |
コンバージョンの合計数。インストールや、Apple から報告されたその他のタイプのコンバージョンが含まれます。この指標は、SKAdNetwork 関連のセグメントと日付関連のセグメントでのみ分割できます。 |
segments.sk_ad_network_ad_event_type |
特定のコンバージョンで発生したイベントの種類。 |
segments.sk_ad_network_attribution_credit |
特定のコンバージョンにアトリビューションがどのように割り当てられるか。 |
segments.sk_ad_network_fine_conversion_value |
Apple から報告されたコンバージョンの値。このセグメントは、 Apple が |
segments.sk_ad_network_coarse_conversion_value |
個々のコンバージョンの粗い値。 |
segments.sk_ad_network_postback_sequence_index |
特定のコンバージョンにおけるポストバックの順序。 |
segments.sk_ad_network_source_app.sk_ad_network_source_app_id |
iOS Store Kit Ad Network のインストールを促す広告が掲載されたアプリの ID。 |
segments.sk_ad_network_source_domain |
iOS Store Kit Ad Network のインストールを促す広告が掲載されたウェブサイト。null 値は、このセグメントが該当しない(iOS 以外のキャンペーンなど)か、Apple から送信されたポストバックに存在しなかったことを意味します。 |
segments.sk_ad_network_source_type |
iOS Store Kit Ad Network のインストールを促す広告が掲載されたソースタイプ。null 値は、このセグメントが該当なし(iOS 以外のキャンペーンなど)か、Apple から送信されたポストバックに参照元ドメインと参照元アプリのどちらも存在しなかったことを意味します。 |
segments.sk_ad_network_user_type |
特定のコンバージョンを発生させたユーザーのタイプ。 |
segments.sk_ad_network_redistributed_fine_conversion_value |
このセグメントのコンバージョン値には、コンバージョン値に再分配された null 値が含まれます。このセグメントは、Apple から返された測定済みの詳細なコンバージョン値と、Google の推定 null 値の合計を表します。 |
segments.sk_ad_network_version |
使用された iOS Store Kit 広告ネットワーク API のバージョン。 |
Google アナリティクス
リンクされた Google アナリティクスのプロパティからのコンバージョンには、次の type 値のいずれかが含まれます。
GA4 プロパティのコンバージョン:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
GA4 プロパティ ID、プロパティ名、イベント名は、
google_analytics_4_settingsフィールドから取得することもできます。
GA4 プロパティのコンバージョンには、次の変更を加えることができます。
- GA4 プロパティから Google 広告アカウントにコンバージョンをインポートするには、
statusフィールドをHIDDENからENABLEDに変更します。 primary_for_goalフィールドとcategoryフィールドを変更して、Google 広告の入札とレポートにどのように影響するかを指定します。nameまたはvalue_settingsを更新します。removeオペレーションを使用して、Google 広告アカウントからコンバージョンを削除します。
インポートされた GA4 コンバージョンの他の属性、またはインポートされたユニバーサル アナリティクス コンバージョンの属性を変更しようとすると、MUTATE_NOT_ALLOWED エラーが発生します。これらの変更は、Google 広告の管理画面でのみ行うことができます。
Firebase とサードパーティ製アプリ解析
サードパーティ製アプリ解析または Firebase のコンバージョンをインポートするには、ConversionActionService の mutate メソッドを使用して、ConversionAction の status を HIDDEN から ENABLED に変更します。これらのコンバージョン アクションでは、app_id の更新はサポートされていません。
FIREBASE_ANDROID_APP_AD_IMPRESSIONFIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_IOS_APP_AD_IMPRESSIONFIREBASE_IOS_FIRST_OPENFIREBASE_IOS_IN_APP_PURCHASEFIREBASE_IOS_CUSTOMTHIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOMTHIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPENTHIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASETHIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM
店舗販売: レポート機能付きのコンバージョン アクションにインポート
Google Ads API を使用して STORE_SALES または STORE_SALES_DIRECT_UPLOAD コンバージョン アクションを作成することはできませんが、API は店舗販売取引のインポートをサポートしています。
STORE_SALESSTORE_SALES_DIRECT_UPLOAD
ローカル アクションのコンバージョン
Google 広告では、ユーザーが広告を操作した後に Google の場所ベースのプロダクトやサービス(Google マップなど)で行ったアクションをトラッキングするために、ローカル アクションのコンバージョンが自動的に作成されます。
Google Ads API では、すべてのローカル アクションのコンバージョンは、次のフィールド値を持つ読み取り専用の ConversionAction リソースです。
次の表に示すように、name(アカウントの言語にローカライズ)フィールドと category フィールドで、ローカル アクションのコンバージョンを識別します。ローカル アクション - ウェブサイトの訪問とローカル アクション - メニューの表示は、どちらも PAGE_VIEW カテゴリを使用し、レポートでは conversion_action.name または conversion_action.id で区別されます。
| Google 広告のコンバージョン アクション名 | ConversionAction.category フィールド |
説明 |
|---|---|---|
| 通話ボタンをクリック | CONTACT |
Google の場所ベースの広告やサービスで通話ボタンがクリックされる。 |
| ローカル アクション - 経路 | GET_DIRECTIONS |
Google の場所ベースの広告やサービスでルート案内ボタンがクリックされる。 |
| ローカル アクション - ウェブサイトの訪問 | PAGE_VIEW |
Google の場所ベースの広告やサービスで、ウェブサイトへのリンクがクリックされることを指します。 |
| ローカル アクション - メニューの表示 | PAGE_VIEW |
Google の場所ベースの広告やサービスで、メニューへのリンクがクリックされることを指します。 |
| ローカル アクション - 注文 | BEGIN_CHECKOUT |
Google の場所ベースの広告やサービスで [注文] ボタンがクリックされる。 |
| ローカル アクション - その他のエンゲージメント | ENGAGEMENT |
Google の場所ベースの広告やサービスで、トラッキング対象となっているその他の行動(場所の共有や保存など)が発生することを指します。 |
デフォルトでは、すべての GOOGLE_HOSTED コンバージョン目標は入札不可(biddable は false)です。入札を有効にできるのは、次のローカル アクション目標のみです。
- ローカル アクション - 経路(
categoryはGET_DIRECTIONS、originはGOOGLE_HOSTED):- アカウント単位:
GET_DIRECTIONSカテゴリとGOOGLE_HOSTED起点のCustomerConversionGoalリソースでbiddableフィールドをtrueに設定するか、コンバージョン アクションをCustomConversionGoalに含めます。 - キャンペーン単位(P-MAX キャンペーン、検索キャンペーン、ショッピング キャンペーンのみ):
GET_DIRECTIONSカテゴリとGOOGLE_HOSTEDオリジンのCampaignConversionGoalリソースで、biddableフィールドをtrueに設定します。
- アカウント単位:
- 通話ボタンのクリック数(
categoryはCONTACT、originはGOOGLE_HOSTED):- キャンペーン単位(P-MAX キャンペーンのみ):
CONTACTカテゴリとGOOGLE_HOSTEDオリジンのCampaignConversionGoalリソースで、biddableフィールドをtrueに設定します。この目標では、CustomerConversionGoalを使用したアカウント単位の入札はサポートされていません。
- キャンペーン単位(P-MAX キャンペーンのみ):
他のすべての GOOGLE_HOSTED カテゴリ(PAGE_VIEW、BEGIN_CHECKOUT、ENGAGEMENT)は入札不可です。詳細については、コンバージョン目標をご覧ください。
読み取り専用のコンバージョン アクション タイプ
次のコンバージョン アクション タイプは、Google Ads API では読み取り専用であり、レポート作成のために提供されています。
ANDROID_APP_PRE_REGISTRATIONANDROID_INSTALLS_ALL_OTHER_APPSFLOODLIGHT_ACTIONFLOODLIGHT_TRANSACTIONGOOGLE_HOSTEDLEAD_FORM_SUBMITSALESFORCESEARCH_ADS_360SMART_CAMPAIGN_AD_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_CLICKS_TO_CALLSMART_CAMPAIGN_MAP_DIRECTIONSSMART_CAMPAIGN_TRACKED_CALLSSTORE_VISITSWEBPAGE_CODELESS
不明
Google 広告アカウントに他のタイプのコンバージョン アクションが含まれている場合、クエリとレポートで、ConversionAction.type が UNKNOWN であるコンバージョン アクションが返されることがあります。API はこれらのコンバージョン アクションの管理をサポートしていませんが、metrics.conversions や metrics.conversions_value などの主要なコンバージョン指標の完全な結果を提供するために、レポートでそれらを返します。