ConversionAction

コンバージョン アクション。

JSON 表現 
{
  "resourceName": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "origin": enum (ConversionOrigin),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "countingType": enum (ConversionActionCountingType),
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "tagSnippets": [
    {
      object (TagSnippet)
    }
  ],
  "mobileAppVendor": enum (MobileAppVendor),
  "firebaseSettings": {
    object (FirebaseSettings)
  },
  "thirdPartyAppAnalyticsSettings": {
    object (ThirdPartyAppAnalyticsSettings)
  },
  "googleAnalytics4Settings": {
    object (GoogleAnalytics4Settings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "viewThroughLookbackWindowDays": string,
  "phoneCallDurationSeconds": string,
  "appId": string
}
フィールド
resourceName

string

変更不可。コンバージョン アクションのリソース名。コンバージョン アクションのリソース名の形式は次のとおりです。

customers/{customerId}/conversionActions/{conversion_action_id}
status

enum (ConversionActionStatus)

コンバージョン イベントの発生に関するこのコンバージョン アクションのステータス。
type

enum (ConversionActionType)

変更不可。このコンバージョン アクションのタイプ。
origin

enum (ConversionOrigin)

出力のみ。このコンバージョン アクションのコンバージョンの発生元。
category

enum (ConversionActionCategory)

このコンバージョン アクションについてレポートされたコンバージョンのカテゴリです。
valueSettings

object (ValueSettings)

このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。
countingType

enum (ConversionActionCountingType)

コンバージョン アクションのコンバージョン イベントをカウントする方法。
attributionModelSettings

object (AttributionModelSettings)

このコンバージョン アクションのアトリビューション モデルに関連する設定。
tagSnippets[]

object (TagSnippet)

出力のみ。コンバージョンのトラッキングに使用されるスニペット。
mobileAppVendor

enum (MobileAppVendor)

出力のみ。アプリ コンバージョン アクションのモバイルアプリ ベンダー。
firebaseSettings

object (FirebaseSettings)

出力のみ。Firebase コンバージョン タイプの Firebase 設定。
thirdPartyAppAnalyticsSettings

object (ThirdPartyAppAnalyticsSettings)

出力のみ。第三者のコンバージョンの種類に対する第三者のアプリ分析の設定。
googleAnalytics4Settings

object (GoogleAnalytics4Settings)

出力のみ。Google アナリティクス 4 のコンバージョンの種類向けの Google アナリティクス 4 の設定。
id

string (int64 format)

出力のみ。コンバージョン アクションの ID。
name

string

コンバージョン アクションの名前。

新しいコンバージョン アクションを作成する場合は、このフィールドは必須です。空にすることはできません。
primaryForGoal

boolean

コンバージョン アクションの primaryForGoal のビットが false の場合、顧客のコンバージョン目標やキャンペーンのコンバージョン目標に関係なく、すべてのキャンペーンでそのコンバージョン アクションの入札不可になります。ただし、カスタム コンバージョン目標では primaryForGoal が考慮されないため、カスタム コンバージョン目標が primaryForGoal = false のコンバージョン アクションに設定されている場合でも、そのコンバージョン アクションは入札対象になります。設定されていない場合は、デフォルトで primaryForGoal が true になります。V9 では、primaryForGoal がオプションとして宣言されていないため、「update」オペレーションで作成された後で primaryForGoal を false に設定できます。
ownerCustomer

string

出力のみ。コンバージョン アクションの所有者の顧客のリソース名。システム定義のコンバージョン アクションの場合は null。
includeInConversionsMetric

boolean

このコンバージョン アクションを「コンバージョン」指標に含めるかどうか。
clickThroughLookbackWindowDays

string (int64 format)

インタラクション（クリックなど）からコンバージョン イベントまでの最大日数。
viewThroughLookbackWindowDays

string (int64 format)

インタラクションが発生せずにインプレッションからコンバージョンが達成されるまでの最大日数。
phoneCallDurationSeconds

string (int64 format)

このコンバージョン アクションについて、コンバージョンがレポートされるまでの時間（秒単位）。

値は 0 ～ 10000 の範囲で指定する必要があります。
appId

string

アプリ コンバージョン アクションのアプリ ID。

ConversionActionStatus

コンバージョン アクションのステータス。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ENABLED コンバージョンが記録されます。
REMOVED コンバージョンは記録されません。
HIDDEN コンバージョンは記録されず、コンバージョン アクションは管理画面に表示されません。

ConversionActionType

考えられるコンバージョン アクションのタイプ。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AD_CALL 広告の電話番号表示オプションがクリックされたときに発生したコンバージョン。
CLICK_TO_CALL モバイル デバイスでユーザーが電話番号をクリックしたときに発生したコンバージョン。
GOOGLE_PLAY_DOWNLOAD ユーザーが Google Play ストアからモバイルアプリをダウンロードしたときに発生したコンバージョン。
GOOGLE_PLAY_IN_APP_PURCHASE Android の請求を通じてユーザーがアプリ内で購入を行った場合に達成されるコンバージョン。
UPLOAD_CALLS 広告主様がトラッキングし、アップロードした通話コンバージョンです。
UPLOAD_CLICKS 広告主によってトラッキングされ、貢献度が割り当てられたクリックとともにアップロードされたコンバージョン。
WEBPAGE ウェブページで発生するコンバージョン。
WEBSITE_CALL 広告主のウェブサイトから動的に生成された電話番号にユーザーが電話をかけたときに発生するコンバージョン。
STORE_SALES_DIRECT_UPLOAD 自社データまたはサードパーティの販売者データのアップロードに基づく店舗販売コンバージョン。許可リストに登録されているお客様のみが、店舗での販売の直接アップロードタイプをご利用になれます。
STORE_SALES 自社またはサードパーティの販売者データのアップロードや、決済ネットワークのカードを使用した実店舗での購入に基づく店舗販売コンバージョン。許可リストに登録されているお客様のみが店舗での販売タイプを使用できます。読み取り専用。
FIREBASE_ANDROID_FIRST_OPEN Firebase でトラッキングされる Android アプリ初回起動コンバージョン。
FIREBASE_ANDROID_IN_APP_PURCHASE Firebase でトラッキングされる Android アプリのアプリ内購入コンバージョン。
FIREBASE_ANDROID_CUSTOM Firebase でトラッキングされる Android アプリのカスタム コンバージョン。
FIREBASE_IOS_FIRST_OPEN Firebase でトラッキングされる iOS アプリの初回起動コンバージョン。
FIREBASE_IOS_IN_APP_PURCHASE Firebase でトラッキングされる iOS アプリのアプリ内購入コンバージョン。
FIREBASE_IOS_CUSTOM Firebase でトラッキングされる iOS アプリのカスタム コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN 第三者のアプリ分析でトラッキングされた Android アプリの初回起動コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE 第三者のアプリ分析でトラッキングした Android アプリ内のアプリ内購入コンバージョン。
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM 第三者のアプリ分析でトラッキングする Android アプリのカスタム コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN 第三者のアプリ分析でトラッキングされる iOS アプリの初回起動コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE 第三者のアプリ分析でトラッキングした iOS アプリのアプリ内購入コンバージョン。
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM 第三者のアプリ分析でトラッキングする iOS アプリのカスタム コンバージョン。
ANDROID_APP_PRE_REGISTRATION ユーザーが Google Play ストアからモバイルアプリを事前登録した場合に発生するコンバージョン。読み取り専用。
ANDROID_INSTALLS_ALL_OTHER_APPS アプリ固有のタイプでトラッキングされない、すべての Google Play ダウンロードをトラッキングするコンバージョン。読み取り専用。
FLOODLIGHT_ACTION ユーザーが広告主の広告を表示またはクリックした後に特定のウェブページを訪問した回数をカウントする Floodlight アクティビティ。読み取り専用。
FLOODLIGHT_TRANSACTION 販売回数または購入されたアイテム数をトラッキングする Floodlight アクティビティ。販売ごとの合計金額も取得できます。読み取り専用。
GOOGLE_HOSTED 広告を操作した後に Google の商品やサービスに由来するローカル アクションをトラッキングしたコンバージョン。読み取り専用。
LEAD_FORM_SUBMIT ユーザーがリードフォームを送信するとコンバージョンがレポートされます。読み取り専用。
SALESFORCE Salesforce から発生したコンバージョン。読み取り専用。
SEARCH_ADS_360 検索広告 360 の Floodlight データからインポートされたコンバージョン。読み取り専用。
SMART_CAMPAIGN_AD_CLICKS_TO_CALL スマート アシスト キャンペーンのカスタム条件を使って、コール トラッキングを設定せずにスマート アシスト キャンペーン広告で発生した通話コンバージョン。読み取り専用。
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL ユーザーが Google マップ内の通話要素をクリックします。スマート アシスト キャンペーンのみ。読み取り専用。
SMART_CAMPAIGN_MAP_DIRECTIONS ユーザーが Google マップ内のビジネス拠点へのルートをリクエストしている。スマート アシスト キャンペーンのみ。読み取り専用。
SMART_CAMPAIGN_TRACKED_CALLS スマート アシスト キャンペーンのカスタム条件を使ってコール トラッキングを設定し、スマート アシスト キャンペーンで発生した通話コンバージョンです。読み取り専用。
STORE_VISITS ユーザーが広告主の実店舗を訪問したときに発生したコンバージョン。読み取り専用。
WEBPAGE_CODELESS 個別にコーディングされたイベント スニペットを使用しない、ウェブサイト イベント（フォームの送信やページの読み込みなど）によって発生したコンバージョン。読み取り専用。
UNIVERSAL_ANALYTICS_GOAL リンクされたユニバーサル アナリティクスの目標から発生したコンバージョン。
UNIVERSAL_ANALYTICS_TRANSACTION リンクされたユニバーサル アナリティクスのトランザクションに起因するコンバージョン。
GOOGLE_ANALYTICS_4_CUSTOM リンクされた Google アナリティクス 4 のカスタム イベント コンバージョンに由来するコンバージョン。
GOOGLE_ANALYTICS_4_PURCHASE リンクされた Google アナリティクス 4 の購入コンバージョンに由来するコンバージョン。

ValueSettings

このコンバージョン アクションに関連付けられたコンバージョン イベントの値に関連する設定。

JSON 表現 
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
フィールド
defaultValue

number

このコンバージョン アクションのコンバージョン イベントに無効な値、許可されていない値、欠落している値がある場合、または常にデフォルト値を使用するように設定されている場合に使用する値です。
defaultCurrencyCode

string

このコンバージョン アクションのコンバージョン イベントに無効な通貨コードまたは欠落している通貨コードが含まれている場合、または常にデフォルト値を使用するように設定されている場合に使用する通貨コードです。
alwaysUseDefaultValue

boolean

このコンバージョン アクションのコンバージョン イベントで指定された値や通貨コードの代わりに、デフォルト値とデフォルトの通貨コードを使用するかどうかを指定します。

ConversionActionCountingType

このアクションのコンバージョンのカウント方法を指定します。詳しくは、https://support.google.com/google-ads/answer/3438531 をご覧ください。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
ONE_PER_CLICK クリックごとに 1 つのコンバージョンのみをカウントします。
MANY_PER_CLICK クリックごとにすべてのコンバージョンをカウントします。

AttributionModelSettings

このコンバージョン アクションのアトリビューション モデルに関連する設定。

JSON 表現 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
フィールド
attributionModel

enum (AttributionModel)

このコンバージョン アクションのアトリビューション モデルのタイプ。
dataDrivenModelStatus

enum (DataDrivenModelStatus)

出力のみ。コンバージョン アクションのデータドリブン アトリビューション モデルのステータス。

AttributionModel

特定のコンバージョンに対する貢献度を、多くの潜在的インタラクションに割り振る方法を示すアトリビューション モデル。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
EXTERNAL 外部のアトリビューションを使用します。
GOOGLE_ADS_LAST_CLICK コンバージョンの貢献度をすべてラストクリックに割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Google 検索アトリビューションを使用して、コンバージョンのすべての貢献度をファースト クリックに割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Google 検索アトリビューションを使用して、コンバージョンに対するすべてのクリックに貢献度を均等に割り当てます。
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Google 検索のアトリビューションを使用して、コンバージョンに貢献した最近のクリックに貢献度を指数関数的に大きく割り当てます（半減期は 1 週間）。
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED コンバージョン経路の最初のクリックとラストクリックに、貢献度の 40% を割り当てます。残りの 20% が他のすべてのクリックに均等に配分されます。Google 検索アトリビューションを使用する。
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN 機械学習により、Google 検索アトリビューションを使用してクリックへの貢献度の適切な配分を判断する柔軟なモデル。

DataDrivenModelStatus

データドリブン モデルのステータスを列挙します。

列挙型
UNSPECIFIED 指定されていません。
UNKNOWN 戻り値にのみ使用されます。このバージョンで不明な値を表します。
AVAILABLE データドリブン モデルを利用できます。
STALE データドリブン モデルが古くなっています。7 日以上更新されていない。まだ使用中ですが、30 日間更新されないと期限切れになります。
EXPIRED データドリブン モデルの有効期限が切れています。少なくとも 30 日間更新されていないため、使用できません。よくある原因としては、直近の 30 日間に、必要な数のイベントが発生していないことが考えられます。
NEVER_GENERATED データドリブン モデルがまだ生成されていない。よくある原因としては、30 日間で必要な数のイベントが存在しないことが挙げられます。

FirebaseSettings

Firebase のコンバージョン アクションに関連する設定。

JSON 表現 
{
  "propertyId": string,
  "propertyName": string,
  "eventName": string,
  "projectId": string
}
フィールド
propertyId

string (int64 format)

出力のみ。コンバージョンの Google アナリティクス プロパティ ID。
propertyName

string

出力のみ。コンバージョンの GA プロパティ名。
eventName

string

出力のみ。Firebase コンバージョンのイベント名。
projectId

string

出力のみ。コンバージョンの Firebase プロジェクト ID。

ThirdPartyAppAnalyticsSettings

第三者アプリ分析のコンバージョン アクションに関連する設定。

JSON 表現 
{
  "providerName": string,
  "eventName": string
}
フィールド
providerName

string

出力のみ。第三者アプリ分析プロバイダの名前。
eventName

string

出力のみ。第三者アプリ分析コンバージョンのイベント名。

GoogleAnalytics4Settings

Google アナリティクス 4 のコンバージョン アクションに関連する設定。

JSON 表現 
{
  "eventName": string,
  "propertyName": string,
  "propertyId": string
}
フィールド
eventName

string

出力のみ。GA4 イベントの名前。
propertyName

string

出力のみ。GA4 プロパティの名前。
propertyId

string (int64 format)

出力のみ。GA4 プロパティの ID。