UploadClickConversionsRequest
Fields |
customer_id
|
string
Required. The ID of the customer performing the upload.
|
conversions[]
|
ClickConversion
Required. The conversions that are being uploaded.
|
partial_failure
|
bool
Required. 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. This should always be set to true. See https://developers.google.com/google-ads/api/docs/best-practices/partial-failures for more information about partial failure.
|
validate_only
|
bool
If true, the request is validated but not executed. Only errors are returned, not results.
|
debug_enabled
|
bool
If true, the API will perform all upload checks and return errors if any are found. If false, it will perform only basic input validation, skip subsequent upload checks, and return success even if no click was found for the provided user_identifiers . This setting only affects Enhanced conversions for leads uploads that use user_identifiers instead of GCLID , GBRAID , or WBRAID . When uploading enhanced conversions for leads, you should upload all conversion events to the API, including those that may not come from Google Ads campaigns. The upload of an event that is not from a Google Ads campaign will result in a CLICK_NOT_FOUND error if this field is set to true . Since these errors are expected for such events, set this field to false so you can confirm your uploads are properly formatted but ignore CLICK_NOT_FOUND errors from all of the conversions that are not from a Google Ads campaign. This will allow you to focus only on errors that you can address. Default is false.
|
job_id
|
int32
Optional. Optional input to set job ID. Must be a non-negative number that is less than 2^31 if provided. If this field is not provided, the API will generate a job ID in the range [2^31, (2^63)-1]. The API will return the value for this request in the job_id field of the UploadClickConversionsResponse .
|
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-11-25 UTC.
[null,null,["Last updated 2024-11-25 UTC."],[[["Uploads click conversions for a specified Google Ads customer ID using the `customer_id` field."],["Requires providing conversion details in the `conversions` field, using the `ClickConversion` object."],["Utilizes `partial_failure` (recommended to be set as true) for handling potential errors during the upload process, ensuring successful operations are carried out even if some conversions are invalid."],["Offers validation without execution using `validate_only`, returning only errors for verification before actual upload."],["Includes optional debugging capabilities through `debug_enabled` for detailed error reporting during Enhanced Conversions for Leads uploads and provides flexibility in handling `CLICK_NOT_FOUND` errors."],["Allows setting a custom `job_id` for tracking the upload process or utilizes an automatically generated ID if not provided."]]],[]]