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」オペレーションで作成された場合のみ 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。