このガイドでは、Google Ads API を使用して作成できるさまざまなタイプのコンバージョン アクションのリストと、それらが Google 広告のウェブ インターフェースにどのように対応しているかについて説明します。
オフライン コンバージョン
オフライン コンバージョンを使用すると、オフィス、 店舗拠点、電話など、オフラインで発生したコンバージョン イベントを トラッキングできます。
次の表は、Google 広告のウェブ インターフェースにおけるコンバージョンの「発生元」にそれぞれ対応する
ConversionActionType
API パラメータと、各コンバージョン アクション タイプのドキュメントへのリンクを示したものです。
| コンバージョン アクション タイプ | Google 広告の発生元 | API 設定ガイド |
|---|---|---|
UPLOAD_CLICKS |
クリックに起因するコンバージョンとリードの拡張コンバージョンをトラッキングする | Data Manager API を使用する |
UPLOAD_CALLS |
電話での問い合わせによるコンバージョンをトラッキングする | 通話コンバージョンのインポート ガイド |
STORE_SALES |
店舗販売コンバージョンをトラッキングする | 店舗販売コンバージョンのインポート ガイド |
オンライン（ウェブサイト）コンバージョン
ウェブサイト コンバージョンを使用すると、オンライン販売、リンクのクリック、ページビュー、登録など、ウェブサイトでの行動をトラッキングできます。
ウェブサイトでのコンバージョンをトラッキングするには、
ConversionAction
を作成し、
ConversionActionType
を WEBPAGE に設定して、タグ
と呼ばれるコード スニペットをウェブサイトのコンバージョン ページに追加する必要があります。
ConversionAction には、いくつかの
タイプのウェブサイト コンバージョンが含まれています。API 内では、
ConversionAction の
tag_snippets フィールドにリストされている各
TagSnippet の
type フィールドで区別されます。
TagSnippet は、コンバージョン アクションをトラッキングするためにウェブサイトに含める必要があるトラッキング コードを提供します。[ウェブサイト] と [電話番号のクリック数] に対応するコンバージョンをトラッキングするには、コンバージョン アクションの発生を示すウェブページ（購入手続き確認ページやリードフォーム送信ページなど）に
`event_snippet`event_snippetを設置し、ウェブサイトのすべてのページに
`global_site_tag`global_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
An
AD_CALL
コンバージョン アクションは、Google 広告
のウェブ インターフェースで [Calls from
ads] コンバージョンとして表示されます。AD_CALL コンバージョン アクションを作成したら、その
リソース名を call_conversion_action フィールドで指定します。
CallAsset電話番号
アセットを使用すると、広告に
電話番号を直接表示できます。
通話が指定した時間より長く続いた場合、通話はコンバージョンとしてレポートされます。 カウントされます。
WEBSITE_CALL
A
WEBSITE_CALL
コンバージョン アクションは、
Google 広告のウェブ インターフェースで [ウェブサイトからの通話] コンバージョンとして表示されます。
AD_CALL とは異なり、このトラッカーでは、ウェブサイトに記載の電話番号への通話をトラッキングするため動的に割り当てられる Google 広告専用転送電話番号を取得するために、event_snippet
と global_site_tag をウェブサイトに追加する必要があります。また、電話番号アセットを設定し、顧客単位、
キャンペーン単位、または広告グループ単位でリンクする必要があります。
CLICK_TO_CALL
A CLICK_TO_CALL
コンバージョン アクションは、Google 広告のウェブ インターフェースで [Clicks on your number on your mobile
website] コンバージョンとして表示されます。
CLICK_TO_CALL
タイプは、電話（通話）そのものをトラッキングするわけではない点で
AD_CALL
タイプと異なります。CLICK_TO_CALL でトラッキングされるのは、モバイル デバイスでの電話番号のクリックです。電話そのものをトラッキングする Google 広告専用転送電話番号を利用できない場合に役立ちます。
拡張コンバージョン
拡張コンバージョンを使用すると、既存のコンバージョン タグにメールアドレス、氏名、自宅の住所、電話番号などのファーストパーティのコンバージョン データを追加することで、コンバージョンの測定の精度を高めることができます。
次の表は、各 拡張コンバージョン タイプに使用する API パラメータを示したものです。
| コンバージョン アクション タイプ | 拡張コンバージョン タイプ | API 設定ガイド |
|---|---|---|
UPLOAD_CLICKS |
リードの拡張コンバージョン
ウェブサイトで獲得した見込み顧客やウェブサイトにアクセスしたユーザーから発生したオフライン取引の測定を改善できます。 |
Data Manager API を使用する |
WEBPAGE |
拡張コンバージョン（ウェブ向け）
オンライン コンバージョンの測定を改善できます。 |
API 設定ガイド |
その他のコンバージョン アクション タイプ
Google Ads API を使用すると、レポートで追加のタイプのコンバージョン アクションを利用できますが、これらのアクションの作成や変更が制限または禁止される場合があります。
SKAdNetwork コンバージョン
iOS アプリ キャンペーンを実施し、SKAdNetworkを実装している場合は、次のリソースを使用して、Google に提供された SKAdNetwork データに Customer レベルと Campaign レベルでアクセスできます。
| レポートの項目 | 説明 |
|---|---|
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 SKAdNetwork のインストールを促す広告が表示されたアプリ ID。 |
segments.sk_ad_network_source_domain |
iOS SKAdNetwork のインストールを促す広告が表示されたウェブサイト 。null 値は、このセグメントが適用できない（iOS 以外のキャンペーンなど）か、Apple から送信されたポストバックに存在しなかったことを意味します。 |
segments.sk_ad_network_source_type |
iOS SKAdNetwork のインストールを促す広告が表示されたソースタイプ 。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 SKAdNetwork API のバージョン。 |
Google アナリティクス
リンクされた Google アナリティクスのプロパティからのコンバージョンには、次のいずれかの
type 値があります。
GA4 プロパティのコンバージョン:
GOOGLE_ANALYTICS_4_CUSTOMGOOGLE_ANALYTICS_4_PURCHASE
GA4 プロパティ ID、プロパティ名、イベント名は、 the
google_analytics_4_settingsフィールドから取得することもできます。
GA4 プロパティのコンバージョンには、次の変更を加えることができます。
statusフィールドをHIDDENからENABLEDに変更して、GA4 プロパティから Google 広告アカウントにコンバージョンをインポートします。primary_for_goalフィールドとcategoryフィールドを変更して、Google 広告の入札とレポートにどのように影響するかを 指定します。nameまたはvalue_settingsを更新します。removeオペレーションを使用して、Google 広告アカウントからコンバージョンを削除します。
インポートされた GA4 コンバージョンの他の属性、またはインポートされたユニバーサル アナリティクス コンバージョンの任意の属性を変更しようとすると、MUTATE_NOT_ALLOWED エラーが発生します。 これらの変更は、Google 広告の管理画面でのみ行うことができます。
Firebase とサードパーティ製アプリのアプリ解析
第三者のアプリ分析または Firebase コンバージョンをインポートするには、status のConversionAction を HIDDEN から ENABLED に変更します。mutateConversionActionServiceこれらの
コンバージョン アクションでは、
app_id の更新はサポートされていません。
FIREBASE_ANDROID_FIRST_OPENFIREBASE_ANDROID_IN_APP_PURCHASEFIREBASE_ANDROID_CUSTOMFIREBASE_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 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 などです。