Additional Conversion Action Types

The Google Ads API makes additional types of conversion actions available in reports, but may limit or prohibit creation or modification of those actions.

Google Analytics

Conversions from a linked Google Analytics property have one of the following type values:

• GA4 property conversion:

  • GOOGLE_ANALYTICS_4_CUSTOM
  • GOOGLE_ANALYTICS_4_PURCHASE

  You can also retrieve the GA4 property ID, property name, and event name from the google_analytics_4_settings field.

• Universal Analytics property conversion:

  • UNIVERSAL_ANALYTICS_GOAL
  • UNIVERSAL_ANALYTICS_TRANSACTION

Conversions in a linked Google Analytics property that haven't been imported into Google Ads have a status of HIDDEN. You cannot change the status or any other attributes of Google Analytics conversions using the API; they can only be modified using the Google Ads UI.

Firebase and third-party app analytics

To import third-party app analytics or Firebase conversions, change the status of the ConversionAction from HIDDEN to ENABLED using the mutate method of ConversionActionService. Updating the app_id is not supported for these conversion actions.

• FIREBASE_ANDROID_FIRST_OPEN
• FIREBASE_ANDROID_IN_APP_PURCHASE
• FIREBASE_ANDROID_CUSTOM
• FIREBASE_IOS_FIRST_OPEN
• FIREBASE_IOS_IN_APP_PURCHASE
• FIREBASE_IOS_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM
• THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN
• THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE
• THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM

Store sales

Although you cannot create STORE_SALES or STORE_SALES_DIRECT_UPLOAD conversion actions using the Google Ads API, the API does support uploading store sales transactions.

• STORE_SALES
• STORE_SALES_DIRECT_UPLOAD

Miscellaneous

The following conversion action types are read-only in the Google Ads API and provided for reporting purposes.

• ANDROID_APP_PRE_REGISTRATION
• ANDROID_INSTALLS_ALL_OTHER_APPS
• FLOODLIGHT_ACTION
• FLOODLIGHT_TRANSACTION
• GOOGLE_HOSTED
• 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_VISITS

Unknown

If your Google Ads account includes other types of conversion actions, you may find that queries and reports return conversion actions where the ConversionAction.type is UNKNOWN. The API does not support managing these conversion actions, but returns them in reports in order to provide complete results for key conversion metrics such as metrics.conversions and metrics.conversion_values.