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
WEBPAGE_CODELESS
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
.