ConversionAction
A conversion action.
View-Specific Information
Select
Google Ads does not allow every column to be selected in a single query, as some data conflicts if selected together. Therefore, when issuing a query that selects all columns, only the default metrics, segments, and attributes are returned. In general, these defaults are the same fields that are exposed through the Ads console. To use the nondefault fields, explicitly select them in your query.
Filters can also be used in the WHERE clause using the following supported operators: =, !=, >, >=, <, <=, LIKE, NOT LIKE, IN, NOT IN . Note that all filters must be joined by AND, as OR is not supported by the Ads API.
Columns
| Name | Type | Behavior | Description |
| ConversionActionAppId | String | ATTRIBUTE | App ID for an app conversion action. |
| ConversionActionAttributionModelSettingsAttributionModel | String | ATTRIBUTE | The attribution model type of this conversion action.
The allowed values are EXTERNAL, GOOGLE_ADS_LAST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN, GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK, GOOGLE_SEARCH_ATTRIBUTION_LINEAR, GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED, GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY, UNKNOWN. |
| ConversionActionAttributionModelSettingsDataDrivenModelStatus | String | ATTRIBUTE | Output only. The status of the data-driven attribution model for the conversion action.
The allowed values are AVAILABLE, EXPIRED, NEVER_GENERATED, STALE, UNKNOWN. |
| ConversionActionCategory | String | ATTRIBUTE | The category of conversions reported for this conversion action.
The allowed values are ADD_TO_CART, BEGIN_CHECKOUT, BOOK_APPOINTMENT, CONTACT, CONVERTED_LEAD, DEFAULT, DOWNLOAD, ENGAGEMENT, GET_DIRECTIONS, IMPORTED_LEAD, OUTBOUND_CLICK, PAGE_VIEW, PHONE_CALL_LEAD, PURCHASE, QUALIFIED_LEAD, REQUEST_QUOTE, SIGNUP, STORE_SALE, STORE_VISIT, SUBMIT_LEAD_FORM, SUBSCRIBE_PAID, UNKNOWN, YOUTUBE_FOLLOW_ON_VIEWS. |
| ConversionActionClickThroughLookbackWindowDays | Long | ATTRIBUTE | The maximum number of days that may elapse between an interaction |
| ConversionActionCountingType | String | ATTRIBUTE | How to count conversion events for the conversion action.
The allowed values are MANY_PER_CLICK, ONE_PER_CLICK, UNKNOWN. |
| ConversionActionFirebaseSettingsEventName | String | ATTRIBUTE | Output only. The event name of a Firebase conversion. |
| ConversionActionFirebaseSettingsProjectId | String | ATTRIBUTE | Output only. The Firebase project ID of the conversion. |
| ConversionActionFirebaseSettingsPropertyId | Long | ATTRIBUTE | Output only. The GA property ID of the conversion. |
| ConversionActionFirebaseSettingsPropertyName | String | ATTRIBUTE | Output only. The GA property name of the conversion. |
| ConversionActionGoogleAnalytics4SettingsEventName | String | ATTRIBUTE | Output only. The name of the GA 4 event. |
| ConversionActionGoogleAnalytics4SettingsPropertyId | Long | ATTRIBUTE | Output only. The ID of the GA 4 property. |
| ConversionActionGoogleAnalytics4SettingsPropertyName | String | ATTRIBUTE | Output only. The name of the GA 4 property. |
| ConversionActionId | Long | ATTRIBUTE | Output only. The ID of the conversion action. |
| ConversionActionIncludeInConversionsMetric | Bool | ATTRIBUTE | Whether this conversion action should be included in the 'conversions' |
| ConversionActionMobileAppVendor | String | ATTRIBUTE | Output only. Mobile app vendor for an app conversion action.
The allowed values are APPLE_APP_STORE, GOOGLE_APP_STORE, UNKNOWN. |
| ConversionActionName | String | ATTRIBUTE | The name of the conversion action. |
| ConversionActionOrigin | String | ATTRIBUTE | Output only. The conversion origin of this conversion action.
The allowed values are APP, CALL_FROM_ADS, GOOGLE_HOSTED, STORE, UNKNOWN, WEBSITE, YOUTUBE_HOSTED. |
| ConversionActionOwnerCustomer | String | ATTRIBUTE | Output only. The resource name of the conversion action owner customer, or |
| ConversionActionPhoneCallDurationSeconds | Long | ATTRIBUTE | The phone call duration in seconds after which a conversion should be |
| ConversionActionPrimaryForGoal | Bool | ATTRIBUTE | If a conversion action's primary_for_goal bit is false, the conversion |
| ConversionActionResourceName | String | ATTRIBUTE | Immutable. The resource name of the conversion action. |
| ConversionActionStatus | String | ATTRIBUTE | The status of this conversion action for conversion event accrual.
The allowed values are ENABLED, HIDDEN, REMOVED, UNKNOWN. |
| ConversionActionTagSnippets | String | ATTRIBUTE | Output only. The snippets used for tracking conversions. |
| ConversionActionThirdPartyAppAnalyticsSettingsEventName | String | ATTRIBUTE | Output only. The event name of a third-party app analytics conversion. |
| ConversionActionThirdPartyAppAnalyticsSettingsProviderName | String | ATTRIBUTE | Output only. Name of the third-party app analytics provider. |
| ConversionActionType | String | ATTRIBUTE | Immutable. The type of this conversion action.
The allowed values are AD_CALL, ANDROID_APP_PRE_REGISTRATION, ANDROID_INSTALLS_ALL_OTHER_APPS, CLICK_TO_CALL, FIREBASE_ANDROID_CUSTOM, FIREBASE_ANDROID_FIRST_OPEN, FIREBASE_ANDROID_IN_APP_PURCHASE, FIREBASE_IOS_CUSTOM, FIREBASE_IOS_FIRST_OPEN, FIREBASE_IOS_IN_APP_PURCHASE, FLOODLIGHT_ACTION, FLOODLIGHT_TRANSACTION, GOOGLE_ANALYTICS_4_CUSTOM, GOOGLE_ANALYTICS_4_PURCHASE, GOOGLE_HOSTED, GOOGLE_PLAY_DOWNLOAD, GOOGLE_PLAY_IN_APP_PURCHASE, LEAD_FORM_SUBMIT, SALESFORCE, SEARCH_ADS_360, SMART_CAMPAIGN_AD_CLICKS_TO_CALL, SMART_CAMPAIGN_MAP_CLICKS_TO_CALL, SMART_CAMPAIGN_MAP_DIRECTIONS, SMART_CAMPAIGN_TRACKED_CALLS, STORE_SALES, STORE_SALES_DIRECT_UPLOAD, STORE_VISITS, THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM, THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN, THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE, THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM, THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN, THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE, UNIVERSAL_ANALYTICS_GOAL, UNIVERSAL_ANALYTICS_TRANSACTION, UNKNOWN, UPLOAD_CALLS, UPLOAD_CLICKS, WEBPAGE, WEBPAGE_CODELESS, WEBSITE_CALL. |
| ConversionActionValueSettingsAlwaysUseDefaultValue | Bool | ATTRIBUTE | Controls whether the default value and default currency code are used in place of the value and currency code specified in conversion events for this conversion action. |
| ConversionActionValueSettingsDefaultCurrencyCode | String | ATTRIBUTE | The currency code to use when conversion events for this conversion action are sent with an invalid or missing currency code, or when this conversion action is configured to always use the default value. |
| ConversionActionValueSettingsDefaultValue | Double | ATTRIBUTE | The value to use when conversion events for this conversion action are sent with an invalid, disallowed or missing value, or when this conversion action is configured to always use the default value. |
| ConversionActionViewThroughLookbackWindowDays | Long | ATTRIBUTE | The maximum number of days which may elapse between an impression and a |
| CustomerId | Long | ATTRIBUTE | Output only. The ID of the customer. |
| AllConversions | Double | METRIC | The total number of conversions. This includes all conversions regardless |
| AllConversionsValue | Double | METRIC | The value of all conversions. |
| ConversionLastConversionDate | Date | METRIC | The date of the most recent conversion for this conversion action. The date |
| ConversionLastReceivedRequestDateTime | Datetime | METRIC | The last date/time a conversion tag for this conversion action successfully |
| Date | Date | SEGMENT | Date to which metrics apply. |
| Month | Date | SEGMENT | Month as represented by the date of the first day of a month. Formatted as |
| Period | String | SEGMENT | Predefined date range.
The allowed values are TODAY, YESTERDAY, LAST_7_DAYS, LAST_BUSINESS_WEEK, THIS_MONTH, LAST_MONTH, LAST_14_DAYS, LAST_30_DAYS, THIS_WEEK_SUN_TODAY, THIS_WEEK_MON_TODAY, LAST_WEEK_SUN_SAT, LAST_WEEK_MON_SUN. |
| Quarter | Date | SEGMENT | Quarter as represented by the date of the first day of a quarter. |
| Week | Date | SEGMENT | Week as defined as Monday through Sunday, and represented by the date of |
Pseudo-Columns
Pseudo column fields are used in the WHERE clause of SELECT statements and offer more granular control over the data returned from the data source.
| Name | Type | Description |
| ManagerId | Long | Id of the manager account on behalf of which you are requesting customer data. |