--- title: "POST /v23/customers/{+customerId}/conversionActions:mutate" method: POST path: "/v23/customers/{+customerId}/conversionActions:mutate" tags: ["customers"] --- # POST /v23/customers/{+customerId}/conversionActions:mutate `POST /v23/customers/{+customerId}/conversionActions:mutate` Creates, updates or removes conversion actions. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [ConversionActionError]() [CurrencyCodeError]() [DatabaseError]() [FieldError]() [FieldMaskError]() [HeaderError]() [InternalError]() [MutateError]() [NewResourceCreationError]() [QuotaError]() [RangeError]() [RequestError]() [ResourceCountLimitExceededError]() [StringLengthError]() ## Path parameters - `customerId` string, required ## Request body - GoogleAdsSearchads360V23ServicesMutateConversionActionsRequest — Request message for ConversionActionService.MutateConversionActions. - `partialFailure` boolean — If true, successful operations will be carried out and invalid operations will return errors. If false, all operations will be carried out in one transaction if and only if they are all valid. Default is false. - `validateOnly` boolean — If true, the request is validated but not executed. Only errors are returned, not results. - `operations` GoogleAdsSearchads360V23ServicesConversionActionOperation[] — Required. The list of operations to perform on individual conversion actions. - `create` GoogleAdsSearchads360V23ResourcesConversionAction — A conversion action. - `name` string — The name of the conversion action. This field is required and should not be empty when creating new conversion actions. - `viewThroughLookbackWindowDays` string, int64 — The maximum number of days which may elapse between an impression and a conversion without an interaction. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_CALL' | 'CLICK_TO_CALL' | 'GOOGLE_PLAY_DOWNLOAD' | 'GOOGLE_PLAY_IN_APP_PURCHASE' | 'UPLOAD_CALLS' | 'UPLOAD_CLICKS' | 'WEBPAGE' | 'WEBSITE_CALL' | 'STORE_SALES_DIRECT_UPLOAD' | 'STORE_SALES' | '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' | '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' | 'UNIVERSAL_ANALYTICS_GOAL' | 'UNIVERSAL_ANALYTICS_TRANSACTION' | 'GOOGLE_ANALYTICS_4_CUSTOM' | 'GOOGLE_ANALYTICS_4_PURCHASE' — Immutable. The type of this conversion action. - `clickThroughLookbackWindowDays` string, int64 — The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event. - `phoneCallDurationSeconds` string, int64 — The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive. - `valueSettings` GoogleAdsSearchads360V23ResourcesConversionActionValueSettings — Settings related to the value for conversion events associated with this conversion action. - `defaultValue` number, double — 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. - `alwaysUseDefaultValue` boolean — 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. - `defaultCurrencyCode` string — 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. - `category` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT' | 'PAGE_VIEW' | 'PURCHASE' | 'SIGNUP' | 'DOWNLOAD' | 'ADD_TO_CART' | 'BEGIN_CHECKOUT' | 'SUBSCRIBE_PAID' | 'PHONE_CALL_LEAD' | 'IMPORTED_LEAD' | 'SUBMIT_LEAD_FORM' | 'BOOK_APPOINTMENT' | 'REQUEST_QUOTE' | 'GET_DIRECTIONS' | 'OUTBOUND_CLICK' | 'CONTACT' | 'ENGAGEMENT' | 'STORE_VISIT' | 'STORE_SALE' | 'QUALIFIED_LEAD' | 'CONVERTED_LEAD' — The category of conversions reported for this conversion action. - `includeInClientAccountConversionsMetric` boolean — Whether this conversion action should be included in the "client_account_conversions" metric. - `firebaseSettings` GoogleAdsSearchads360V23ResourcesConversionActionFirebaseSettings — Settings related to a Firebase conversion action. - `eventName` string — Output only. The event name of a Firebase conversion. - `propertyId` string, int64 — Output only. The GA property ID of the conversion. - `projectId` string — Output only. The Firebase project ID of the conversion. - `propertyName` string — Output only. The GA property name of the conversion. - `floodlightSettings` GoogleAdsSearchads360V23ResourcesConversionActionFloodlightSettings — Settings related to a Floodlight conversion action. - `activityGroupTag` string — Output only. String used to identify a Floodlight activity group when reporting conversions. - `activityTag` string — Output only. String used to identify a Floodlight activity when reporting conversions. - `activityId` string, int64 — Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM). - `creationTime` string — Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601. - `includeInConversionsMetric` boolean — Output only. Whether this conversion action should be included in the "conversions" metric. - `resourceName` string — Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}` - `ownerCustomer` string — Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action. - `countingType` 'UNSPECIFIED' | 'UNKNOWN' | 'ONE_PER_CLICK' | 'MANY_PER_CLICK' — How to count conversion events for the conversion action. - `mobileAppVendor` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_APP_STORE' — Output only. Mobile app vendor for an app conversion action. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'HIDDEN' — The status of this conversion action for conversion event accrual. - `primaryForGoal` boolean — If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional. - `tagSnippets` GoogleAdsSearchads360V23CommonTagSnippet[] — Output only. The snippets used for tracking conversions. - `pageFormat` 'UNSPECIFIED' | 'UNKNOWN' | 'HTML' | 'AMP' — The format of the web page where the tracking tag and snippet will be installed, for example, HTML. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBPAGE' | 'WEBPAGE_ONCLICK' | 'CLICK_TO_CALL' | 'WEBSITE_CALL' — The type of the generated tag snippets for tracking conversions. - `globalSiteTag` string — The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain. - `eventSnippet` string — The event snippet that works with the site tag to track actions that should be counted as conversions. - `thirdPartyAppAnalyticsSettings` GoogleAdsSearchads360V23ResourcesConversionActionThirdPartyAppAnalyticsSettings — Settings related to a third party app analytics conversion action. - `eventName` string — Output only. The event name of a third-party app analytics conversion. - `providerName` string — Output only. Name of the third-party app analytics provider. - `attributionModelSettings` GoogleAdsSearchads360V23ResourcesConversionActionAttributionModelSettings — Settings related to this conversion action's attribution model. - `dataDrivenModelStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AVAILABLE' | 'STALE' | 'EXPIRED' | 'NEVER_GENERATED' — Output only. The status of the data-driven attribution model for the conversion action. - `attributionModel` 'UNSPECIFIED' | 'UNKNOWN' | 'EXTERNAL' | 'GOOGLE_ADS_LAST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_LINEAR' | 'GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY' | 'GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED' | 'GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN' — The attribution model type of this conversion action. - `id` string, int64 — Output only. The ID of the conversion action. - `origin` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBSITE' | 'GOOGLE_HOSTED' | 'APP' | 'CALL_FROM_ADS' | 'STORE' | 'YOUTUBE_HOSTED' | 'FLOODLIGHT' — Output only. The conversion origin of this conversion action. - `appId` string — App ID for an app conversion action. - `googleAnalytics4Settings` GoogleAdsSearchads360V23ResourcesConversionActionGoogleAnalytics4Settings — Settings related to a Google Analytics 4 conversion action. - `eventName` string — Output only. The name of the GA 4 event. - `propertyId` string, int64 — Output only. The ID of the GA 4 property. - `propertyName` string — Output only. The name of the GA 4 property. - `update` GoogleAdsSearchads360V23ResourcesConversionAction — A conversion action. - `name` string — The name of the conversion action. This field is required and should not be empty when creating new conversion actions. - `viewThroughLookbackWindowDays` string, int64 — The maximum number of days which may elapse between an impression and a conversion without an interaction. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'AD_CALL' | 'CLICK_TO_CALL' | 'GOOGLE_PLAY_DOWNLOAD' | 'GOOGLE_PLAY_IN_APP_PURCHASE' | 'UPLOAD_CALLS' | 'UPLOAD_CLICKS' | 'WEBPAGE' | 'WEBSITE_CALL' | 'STORE_SALES_DIRECT_UPLOAD' | 'STORE_SALES' | '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' | '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' | 'UNIVERSAL_ANALYTICS_GOAL' | 'UNIVERSAL_ANALYTICS_TRANSACTION' | 'GOOGLE_ANALYTICS_4_CUSTOM' | 'GOOGLE_ANALYTICS_4_PURCHASE' — Immutable. The type of this conversion action. - `clickThroughLookbackWindowDays` string, int64 — The maximum number of days that may elapse between an interaction (for example, a click) and a conversion event. - `phoneCallDurationSeconds` string, int64 — The phone call duration in seconds after which a conversion should be reported for this conversion action. The value must be between 0 and 10000, inclusive. - `valueSettings` GoogleAdsSearchads360V23ResourcesConversionActionValueSettings — Settings related to the value for conversion events associated with this conversion action. - `defaultValue` number, double — 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. - `alwaysUseDefaultValue` boolean — 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. - `defaultCurrencyCode` string — 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. - `category` 'UNSPECIFIED' | 'UNKNOWN' | 'DEFAULT' | 'PAGE_VIEW' | 'PURCHASE' | 'SIGNUP' | 'DOWNLOAD' | 'ADD_TO_CART' | 'BEGIN_CHECKOUT' | 'SUBSCRIBE_PAID' | 'PHONE_CALL_LEAD' | 'IMPORTED_LEAD' | 'SUBMIT_LEAD_FORM' | 'BOOK_APPOINTMENT' | 'REQUEST_QUOTE' | 'GET_DIRECTIONS' | 'OUTBOUND_CLICK' | 'CONTACT' | 'ENGAGEMENT' | 'STORE_VISIT' | 'STORE_SALE' | 'QUALIFIED_LEAD' | 'CONVERTED_LEAD' — The category of conversions reported for this conversion action. - `includeInClientAccountConversionsMetric` boolean — Whether this conversion action should be included in the "client_account_conversions" metric. - `firebaseSettings` GoogleAdsSearchads360V23ResourcesConversionActionFirebaseSettings — Settings related to a Firebase conversion action. - `eventName` string — Output only. The event name of a Firebase conversion. - `propertyId` string, int64 — Output only. The GA property ID of the conversion. - `projectId` string — Output only. The Firebase project ID of the conversion. - `propertyName` string — Output only. The GA property name of the conversion. - `floodlightSettings` GoogleAdsSearchads360V23ResourcesConversionActionFloodlightSettings — Settings related to a Floodlight conversion action. - `activityGroupTag` string — Output only. String used to identify a Floodlight activity group when reporting conversions. - `activityTag` string — Output only. String used to identify a Floodlight activity when reporting conversions. - `activityId` string, int64 — Output only. ID of the Floodlight activity in DoubleClick Campaign Manager (DCM). - `creationTime` string — Output only. Timestamp of the Floodlight activity's creation, formatted in ISO 8601. - `includeInConversionsMetric` boolean — Output only. Whether this conversion action should be included in the "conversions" metric. - `resourceName` string — Immutable. The resource name of the conversion action. Conversion action resource names have the form: `customers/{customer_id}/conversionActions/{conversion_action_id}` - `ownerCustomer` string — Output only. The resource name of the conversion action owner customer, or null if this is a system-defined conversion action. - `countingType` 'UNSPECIFIED' | 'UNKNOWN' | 'ONE_PER_CLICK' | 'MANY_PER_CLICK' — How to count conversion events for the conversion action. - `mobileAppVendor` 'UNSPECIFIED' | 'UNKNOWN' | 'APPLE_APP_STORE' | 'GOOGLE_APP_STORE' — Output only. Mobile app vendor for an app conversion action. - `status` 'UNSPECIFIED' | 'UNKNOWN' | 'ENABLED' | 'REMOVED' | 'HIDDEN' — The status of this conversion action for conversion event accrual. - `primaryForGoal` boolean — If a conversion action's primary_for_goal bit is false, the conversion action is non-biddable for all campaigns regardless of their customer conversion goal or campaign conversion goal. However, custom conversion goals do not respect primary_for_goal, so if a campaign has a custom conversion goal configured with a primary_for_goal = false conversion action, that conversion action is still biddable. By default, primary_for_goal will be true if not set. In V9, primary_for_goal can only be set to false after creation through an 'update' operation because it's not declared as optional. - `tagSnippets` GoogleAdsSearchads360V23CommonTagSnippet[] — Output only. The snippets used for tracking conversions. - `pageFormat` 'UNSPECIFIED' | 'UNKNOWN' | 'HTML' | 'AMP' — The format of the web page where the tracking tag and snippet will be installed, for example, HTML. - `type` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBPAGE' | 'WEBPAGE_ONCLICK' | 'CLICK_TO_CALL' | 'WEBSITE_CALL' — The type of the generated tag snippets for tracking conversions. - `globalSiteTag` string — The site tag that adds visitors to your basic remarketing lists and sets new cookies on your domain. - `eventSnippet` string — The event snippet that works with the site tag to track actions that should be counted as conversions. - `thirdPartyAppAnalyticsSettings` GoogleAdsSearchads360V23ResourcesConversionActionThirdPartyAppAnalyticsSettings — Settings related to a third party app analytics conversion action. - `eventName` string — Output only. The event name of a third-party app analytics conversion. - `providerName` string — Output only. Name of the third-party app analytics provider. - `attributionModelSettings` GoogleAdsSearchads360V23ResourcesConversionActionAttributionModelSettings — Settings related to this conversion action's attribution model. - `dataDrivenModelStatus` 'UNSPECIFIED' | 'UNKNOWN' | 'AVAILABLE' | 'STALE' | 'EXPIRED' | 'NEVER_GENERATED' — Output only. The status of the data-driven attribution model for the conversion action. - `attributionModel` 'UNSPECIFIED' | 'UNKNOWN' | 'EXTERNAL' | 'GOOGLE_ADS_LAST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK' | 'GOOGLE_SEARCH_ATTRIBUTION_LINEAR' | 'GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY' | 'GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED' | 'GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN' — The attribution model type of this conversion action. - `id` string, int64 — Output only. The ID of the conversion action. - `origin` 'UNSPECIFIED' | 'UNKNOWN' | 'WEBSITE' | 'GOOGLE_HOSTED' | 'APP' | 'CALL_FROM_ADS' | 'STORE' | 'YOUTUBE_HOSTED' | 'FLOODLIGHT' — Output only. The conversion origin of this conversion action. - `appId` string — App ID for an app conversion action. - `googleAnalytics4Settings` GoogleAdsSearchads360V23ResourcesConversionActionGoogleAnalytics4Settings — Settings related to a Google Analytics 4 conversion action. - `eventName` string — Output only. The name of the GA 4 event. - `propertyId` string, int64 — Output only. The ID of the GA 4 property. - `propertyName` string — Output only. The name of the GA 4 property. - `remove` string — Remove operation: A resource name for the removed conversion action is expected, in this format: `customers/{customer_id}/conversionActions/{conversion_action_id}` - `updateMask` string, google-fieldmask — FieldMask that determines which resource fields are modified in an update. - `responseContentType` 'UNSPECIFIED' | 'RESOURCE_NAME_ONLY' | 'MUTABLE_RESOURCE' — The response content type setting. Determines whether the mutable resource or just the resource name should be returned post mutation. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/searchads360.md) · [All operations](https://skmtc.net/google/apis/searchads360/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/searchads360/revisions/40d087435afd/schema)