Google Ads click conversions check consent and identifiers.
Offline and enhanced-for-leads click conversions posted to the Google Ads API UploadClickConversions method, including the JSON Conversion payload. Conversion adjustments are vendor/google-ads-conversion-adjustments. The image pixel on /pagead/conversion is a different pack.
Nondefault adPersonalization values receive service-specific checks. Proto3 default values remain valid. Currency assignment and resource spelling receive scoped advice.
What this pack matches
Rules
Codes are stable. A finding in CI, MCP, or the playground lands on the same id.
| Field | Required | What it checks | Rule ids | Source |
|---|---|---|---|---|
conversions |
required | UploadClickConversions requires a `conversions` array. Native JSON type: array. Minimum array items: 1. Maximum array items: 2000. Fix: Send at least one ClickConversion in `conversions`. | vendor.google-ads-click-conversions.body.conversions.missingvendor.google-ads-click-conversions.body.conversions.invalid |
docs |
partialFailure |
required | Google documents `partial_failure` as required, and the upload guides say to always send true. Native JSON type: boolean. Fix: Set `partialFailure` to `true`. | vendor.google-ads-click-conversions.body.partialFailure.missingvendor.google-ads-click-conversions.body.partialFailure.emptyvendor.google-ads-click-conversions.body.partialFailure.invalid |
docs |
conversions[] |
optional | The vendor documents `conversions[]` in the request contract. Native JSON type: object. | vendor.google-ads-click-conversions.body.conversions[].invalid |
docs |
validateOnly |
optional | The vendor documents `validateOnly` in the request contract. Native JSON type: boolean. | vendor.google-ads-click-conversions.body.validateOnly.invalid |
docs |
jobId |
optional | The vendor documents `jobId` in the request contract. Native JSON type: integer or string. Minimum numeric value: 0. Maximum numeric value: 2147483647. Exact numeric increment: 1. | vendor.google-ads-click-conversions.body.jobId.emptyvendor.google-ads-click-conversions.body.jobId.invalid |
docs |
root |
optional | The vendor documents `` in the request contract. Native JSON type: object. | vendor.google-ads-click-conversions.body.root.invalid |
docs |
conversionAction |
required | It is the conversion action resource name, and every uploaded click conversion requires it. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Set `conversionAction` to `customers/{id}/conversionActions/{id}`. | vendor.google-ads-click-conversions.body.conversionAction.missingvendor.google-ads-click-conversions.body.conversionAction.emptyvendor.google-ads-click-conversions.body.conversionAction.invalid |
docs |
conversionDateTime |
required | Google documents the conversion time with a timezone offset as `yyyy-mm-dd hh:mm:ss+|-hh:mm`. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Send a timestamp such as `2026-08-21 12:00:00+00:00`. | vendor.google-ads-click-conversions.body.conversionDateTime.missingvendor.google-ads-click-conversions.body.conversionDateTime.emptyvendor.google-ads-click-conversions.body.conversionDateTime.invalid |
docs |
gclid |
optional | Google click ID. A click-ID upload needs exactly one of `gclid`, `gbraid`, or `wbraid`. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.gclid.emptyvendor.google-ads-click-conversions.body.gclid.invalid |
docs |
gbraid |
optional | App-to-web click identifier from iOS. Alternative to `gclid`. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.gbraid.emptyvendor.google-ads-click-conversions.body.gbraid.invalid |
docs |
wbraid |
optional | Web-to-app click identifier. Alternative to `gclid`. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.wbraid.emptyvendor.google-ads-click-conversions.body.wbraid.invalid |
docs |
userIdentifiers |
optional | Hashed user identifiers for enhanced conversions for leads. The upload service accepts `hashedEmail` and `hashedPhoneNumber` only, at most five. Body scope: ["conversions[]"]. Native JSON type: array. Maximum array items: 5. | vendor.google-ads-click-conversions.body.userIdentifiers.invalid |
docs |
currencyCode |
optional | It is an ISO 4217 currency code for `conversionValue`. Google documents both together. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Use the three-letter code, such as `USD`, together with `conversionValue`. | vendor.google-ads-click-conversions.body.currencyCode.emptyvendor.google-ads-click-conversions.body.currencyCode.invalid |
docs |
conversionValue |
optional | It is the conversion value for the advertiser. Google documents it together with `currencyCode`. Body scope: ["conversions[]"]. Native JSON type: number or string. Fix: Send a number such as `1.0`, with no currency symbol, together with `currencyCode`. | vendor.google-ads-click-conversions.body.conversionValue.emptyvendor.google-ads-click-conversions.body.conversionValue.invalid |
docs |
userIpAddress |
optional | It is the customer IP on the landing page after the click, sent unhashed. Google documents the device address, not the advertiser server. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.userIpAddress.emptyvendor.google-ads-click-conversions.body.userIpAddress.invalid |
docs |
orderId |
optional | It is the order ID for the conversion. Google documents one order id per conversion action, and recommends it for later adjustments. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Send `orderId` as a string, or drop the empty pair. | vendor.google-ads-click-conversions.body.orderId.emptyvendor.google-ads-click-conversions.body.orderId.invalid |
docs |
conversionEnvironment |
optional | It is where the conversion was recorded. Google documents `APP` or `WEB`. Body scope: ["conversions[]"]. Native JSON type: string or integer. Fix: Set `conversionEnvironment` to `APP` or `WEB`. | vendor.google-ads-click-conversions.body.conversionEnvironment.emptyvendor.google-ads-click-conversions.body.conversionEnvironment.invalid |
docs |
customerType |
optional | It is whether the converting user is new or returning. Google documents `NEW` or `RETURNING`. Body scope: ["conversions[]"]. Native JSON type: string or integer. Fix: Set `customerType` to `NEW` or `RETURNING`. | vendor.google-ads-click-conversions.body.customerType.emptyvendor.google-ads-click-conversions.body.customerType.invalid |
docs |
consent.adUserData |
optional | It is consent for ad user data on the click conversion. Google documents `GRANTED` or `DENIED`. Body scope: ["conversions[]"]. Native JSON type: string or integer. Fix: Send `consent.adUserData` as `GRANTED` or `DENIED`. | vendor.google-ads-click-conversions.body.consent.adUserData.emptyvendor.google-ads-click-conversions.body.consent.adUserData.invalid |
docs |
cartData.merchantId |
optional | It is the Merchant Center ID where the cart items are uploaded. Body scope: ["conversions[]"]. Native JSON type: integer or string. Minimum numeric value: -9223372036854776000. Maximum numeric value: 9223372036854776000. Exact numeric increment: 1. Fix: Send `cartData.merchantId` as a whole number. | vendor.google-ads-click-conversions.body.cartData.merchantId.emptyvendor.google-ads-click-conversions.body.cartData.merchantId.invalid |
docs |
cartData.feedCountryCode |
optional | It is the country code of the Merchant Center feed the items come from. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Send `cartData.feedCountryCode`, or drop the empty pair. | vendor.google-ads-click-conversions.body.cartData.feedCountryCode.emptyvendor.google-ads-click-conversions.body.cartData.feedCountryCode.invalid |
docs |
cartData.feedLanguageCode |
optional | It is the language code of the Merchant Center feed the items come from. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Send `cartData.feedLanguageCode`, or drop the empty pair. | vendor.google-ads-click-conversions.body.cartData.feedLanguageCode.emptyvendor.google-ads-click-conversions.body.cartData.feedLanguageCode.invalid |
docs |
cartData.localTransactionCost |
optional | It is cart-level discounts such as free shipping or coupons. The currency is the same as `currencyCode`. Body scope: ["conversions[]"]. Native JSON type: number or string. Fix: Send `cartData.localTransactionCost` as a number, such as `2.50`, without a currency symbol. | vendor.google-ads-click-conversions.body.cartData.localTransactionCost.emptyvendor.google-ads-click-conversions.body.cartData.localTransactionCost.invalid |
docs |
cartData.items[].productId |
optional | It is the Merchant Center product identifier for a purchased item. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Set `cartData.items[].productId` to the Merchant Center id, or drop the empty pair. | vendor.google-ads-click-conversions.body.cartData.items[].productId.emptyvendor.google-ads-click-conversions.body.cartData.items[].productId.invalid |
docs |
cartData.items[].quantity |
optional | It is how many of that item were sold. Body scope: ["conversions[]"]. Native JSON type: integer or string. Minimum numeric value: -2147483648. Maximum numeric value: 2147483647. Exact numeric increment: 1. Fix: Send a whole number in `cartData.items[].quantity`, such as `1`. | vendor.google-ads-click-conversions.body.cartData.items[].quantity.emptyvendor.google-ads-click-conversions.body.cartData.items[].quantity.invalid |
docs |
cartData.items[].unitPrice |
optional | It is the unit price excluding tax, shipping, and cart-level discounts. Body scope: ["conversions[]"]. Native JSON type: number or string. Fix: Send `cartData.items[].unitPrice` as a number, such as `19.99`, without a currency symbol. | vendor.google-ads-click-conversions.body.cartData.items[].unitPrice.emptyvendor.google-ads-click-conversions.body.cartData.items[].unitPrice.invalid |
docs |
customVariables[].conversionCustomVariable |
optional | It is the custom conversion variable resource name. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Set `conversionCustomVariable` to `customers/{id}/conversionCustomVariables/{id}`. | vendor.google-ads-click-conversions.body.customVariables[].conversionCustomVariable.emptyvendor.google-ads-click-conversions.body.customVariables[].conversionCustomVariable.invalid |
docs |
customVariables[].value |
optional | It is the custom variable value. Google documents that it must not carry private customer data such as email or phone. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Send a non-empty custom variable value with no email or phone. | vendor.google-ads-click-conversions.body.customVariables[].value.emptyvendor.google-ads-click-conversions.body.customVariables[].value.invalid |
docs |
externalAttributionData.externalAttributionCredit |
optional | It is the fraction of the conversion attributed to the Google Ads click. Body scope: ["conversions[]"]. Native JSON type: number or string. Fix: Send `externalAttributionCredit` as a number, such as `0.3`. | vendor.google-ads-click-conversions.body.externalAttributionData.externalAttributionCredit.emptyvendor.google-ads-click-conversions.body.externalAttributionData.externalAttributionCredit.invalid |
docs |
externalAttributionData.externalAttributionModel |
optional | It is the name of the external attribution model. Body scope: ["conversions[]"]. Native JSON type: string. Fix: Send `externalAttributionModel`, or drop the empty pair. | vendor.google-ads-click-conversions.body.externalAttributionData.externalAttributionModel.emptyvendor.google-ads-click-conversions.body.externalAttributionData.externalAttributionModel.invalid |
docs |
consent |
optional | The vendor documents `consent` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.consent.invalid |
docs |
cartData |
optional | The vendor documents `cartData` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.cartData.invalid |
docs |
externalAttributionData |
optional | The vendor documents `externalAttributionData` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.externalAttributionData.invalid |
docs |
sessionAttributesKeyValuePairs |
optional | The vendor documents `sessionAttributesKeyValuePairs` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.invalid |
docs |
customVariables |
optional | The vendor documents `customVariables` in the request contract. Body scope: ["conversions[]"]. Native JSON type: array. | vendor.google-ads-click-conversions.body.customVariables.invalid |
docs |
cartData.items |
optional | The vendor documents `cartData.items` in the request contract. Body scope: ["conversions[]"]. Native JSON type: array. | vendor.google-ads-click-conversions.body.cartData.items.invalid |
docs |
sessionAttributesKeyValuePairs.keyValuePairs |
optional | The vendor documents `sessionAttributesKeyValuePairs.keyValuePairs` in the request contract. Body scope: ["conversions[]"]. Native JSON type: array. | vendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.keyValuePairs.invalid |
docs |
userIdentifiers[] |
optional | The vendor documents `userIdentifiers[]` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.userIdentifiers[].invalid |
docs |
customVariables[] |
optional | The vendor documents `customVariables[]` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.customVariables[].invalid |
docs |
cartData.items[] |
optional | The vendor documents `cartData.items[]` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.cartData.items[].invalid |
docs |
sessionAttributesKeyValuePairs.keyValuePairs[] |
optional | The vendor documents `sessionAttributesKeyValuePairs.keyValuePairs[]` in the request contract. Body scope: ["conversions[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.keyValuePairs[].invalid |
docs |
sessionAttributesEncoded |
optional | The vendor documents `sessionAttributesEncoded` in the request contract. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.sessionAttributesEncoded.invalid |
docs |
sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeKey |
required | The vendor documents `sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeKey` in the request contract. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeKey.missingvendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeKey.invalid |
docs |
sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeValue |
required | The vendor documents `sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeValue` in the request contract. Body scope: ["conversions[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeValue.missingvendor.google-ads-click-conversions.body.sessionAttributesKeyValuePairs.keyValuePairs[].sessionAttributeValue.invalid |
docs |
consent.adPersonalization |
optional | Google limits non-default ad personalization consent to OfflineUserDataJobService and UserDataService. This proto3 enum has implicit presence: UNSPECIFIED, numeric zero and null retain default or unset behavior. Body scope: ["conversions[]"]. Presence diagnostic severity: error. Native JSON type: string or integer. Fix: Remove non-default adPersonalization from this upload; keep supported adUserData consent according to the integration. | vendor.google-ads-click-conversions.body.consent.adPersonalization.invalid |
docs |
body.click_id_or_user_required |
required | The conversion has no click ID and no `userIdentifiers`. Google documents a `gclid`, `gbraid`, or `wbraid` for click-ID uploads, or hashed user identifiers for enhanced conversions for leads. Body scope: ["conversions[]"]. Fix: Send `gclid` (or `gbraid` / `wbraid`), or send hashed `userIdentifiers`. | vendor.google-ads-click-conversions.body.click_id_or_user_required |
docs |
body.value_requires_currency |
required | The conversion sends `conversionValue` without `currencyCode`. Google documents the ISO 4217 code together with the value. Body scope: ["conversions[]"]. Fix: Add `currencyCode`, such as `USD`. | vendor.google-ads-click-conversions.body.value_requires_currency |
docs |
body.currency_requires_value |
required | The conversion sends `currencyCode` without `conversionValue`. Google documents both together. Body scope: ["conversions[]"]. Fix: Add `conversionValue` as a number, with no currency symbol. | vendor.google-ads-click-conversions.body.currency_requires_value |
docs |
body.unhashed_email |
required | A field carries what looks like a raw email address. Google requires email as `hashedEmail`, SHA-256 hashed after normalization. Body scope: ["conversions[]"]. Fix: Normalize the address, hash it with SHA-256, and send `userIdentifiers[].hashedEmail`. | vendor.google-ads-click-conversions.body.unhashed_email |
docs |
body.hashed_plaintext_field |
required | `userIpAddress` looks like a SHA-256 digest, but Google documents it as the customer IP, unhashed. Body scope: ["conversions[]"]. Fix: Send the raw IP address of the customer's device. | vendor.google-ads-click-conversions.body.hashed_plaintext_field |
docs |
body.session_attributes_exclusive |
required | The request does not satisfy the documented session attributes exclusive requirement. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.session_attributes_exclusive |
docs |
body.custom_variables_unsupported_with_braids |
required | Custom conversion variables are unsupported with GBRAID. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.custom_variables_unsupported_with_braids |
docs |
body.custom_variables_unsupported_with_wbraid |
required | Custom conversion variables are unsupported with WBRAID. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.custom_variables_unsupported_with_wbraid |
docs |
body.custom_variables_unsupported_with_user_data |
required | Custom variables with user-provided data are invalid and dropped by Google Ads. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.custom_variables_unsupported_with_user_data |
docs |
body.external_attribution_unsupported_with_user_data |
required | Enhanced conversions for leads do not support external attribution data. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.external_attribution_unsupported_with_user_data |
docs |
body.conversionDateTime.calendar_invalid |
required | The conversion timestamp must represent a valid calendar date, time and timezone offset. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.conversionDateTime.calendar_invalid |
docs |
body.conversionAction.resource_name |
recommended | Check the canonical conversion action resource spelling: customers/{customer_id}/conversionActions/{conversion_action_id}. This advice does not check ownership, existence or equality with the upload customer; Google ignores the customer component for conversion-action lookup. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.conversionAction.resource_name |
docs |
body.currencyCode.assignment |
recommended | The three-letter currency value is not assigned in the built-in current or historical ISO 4217 lists. Registry advice does not establish Google account eligibility or currency support. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.currencyCode.assignment |
docs |
body.consent.adPersonalization.forbidden |
required | Non-default ad personalization consent is supported only by OfflineUserDataJobService and UserDataService. This conversion upload must leave it unspecified. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.consent.adPersonalization.forbidden |
docs |
body.consent.adPersonalization.invalid |
required | Use an enum name or integer spelling. Unspecified zero is retained; non-default consent belongs to other services. Body scope: ["conversions[]"]. | vendor.google-ads-click-conversions.body.consent.adPersonalization.invalid |
docs |
hashedEmail |
optional | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. | docs | |
hashedPhoneNumber |
optional | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. | docs | |
body.user_identifier_union |
required | A user identifier specifies exactly one identifier. Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. | vendor.google-ads-click-conversions.body.user_identifier_union |
docs |
body.user_identifier_required |
required | Conversion uploads accept a hashed email or phone identifier. Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. | vendor.google-ads-click-conversions.body.user_identifier_required |
docs |
root |
optional | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.root.invalid |
docs |
hashedEmail |
optional | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.hashedEmail.emptyvendor.google-ads-click-conversions.body.hashedEmail.invalid |
docs |
hashedPhoneNumber |
optional | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.hashedPhoneNumber.emptyvendor.google-ads-click-conversions.body.hashedPhoneNumber.invalid |
docs |
userIdentifierSource |
optional | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: string or integer. | vendor.google-ads-click-conversions.body.userIdentifierSource.emptyvendor.google-ads-click-conversions.body.userIdentifierSource.invalid |
docs |
mobileId |
forbidden | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.mobileId.forbiddenvendor.google-ads-click-conversions.body.mobileId.invalid |
docs |
thirdPartyUserId |
forbidden | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.thirdPartyUserId.forbiddenvendor.google-ads-click-conversions.body.thirdPartyUserId.invalid |
docs |
addressInfo |
forbidden | Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.addressInfo.forbiddenvendor.google-ads-click-conversions.body.addressInfo.invalid |
docs |
body.identifier_required |
required | The request does not satisfy the documented identifier required requirement. Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. | vendor.google-ads-click-conversions.body.identifier_required |
docs |
body.identifier_oneof |
required | The request does not satisfy the documented identifier oneof requirement. Body scope: ["conversions[].userIdentifiers[]","conversions[].user_identifiers[]"]. | vendor.google-ads-click-conversions.body.identifier_oneof |
docs |
root |
optional | Body scope: ["conversions[].customVariables[]","conversions[].custom_variables[]"]. Native JSON type: object. | vendor.google-ads-click-conversions.body.root.invalid |
docs |
conversionCustomVariable |
required | Body scope: ["conversions[].customVariables[]","conversions[].custom_variables[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.conversionCustomVariable.missingvendor.google-ads-click-conversions.body.conversionCustomVariable.emptyvendor.google-ads-click-conversions.body.conversionCustomVariable.invalid |
docs |
value |
required | Body scope: ["conversions[].customVariables[]","conversions[].custom_variables[]"]. Native JSON type: string. | vendor.google-ads-click-conversions.body.value.missingvendor.google-ads-click-conversions.body.value.invalid |
docs |
keyValuePairs |
required | Body scope: ["conversions[].sessionAttributesKeyValuePairs","conversions[].session_attributes_key_value_pairs"]. Native JSON type: array. Minimum array items: 1. | vendor.google-ads-click-conversions.body.keyValuePairs.missingvendor.google-ads-click-conversions.body.keyValuePairs.invalid |
docs |
method |
required | This published ingestion operation uses HTTP POST. Complete HTTP capture contract. Native JSON type: string. | vendor.google-ads-click-conversions.http.method.missingvendor.google-ads-click-conversions.http.method.emptyvendor.google-ads-click-conversions.http.method.invalid |
docs |
content_type |
recommended | Use a published request media type. Complete HTTP capture contract. Presence diagnostic severity: warning. Value diagnostic severity: warning. Native JSON type: string. | vendor.google-ads-click-conversions.http.content_type.missingvendor.google-ads-click-conversions.http.content_type.emptyvendor.google-ads-click-conversions.http.content_type.invalid |
docs |
body |
required | The request body is a JSON object. Complete HTTP capture contract. Native JSON type: object. | vendor.google-ads-click-conversions.http.body.missingvendor.google-ads-click-conversions.http.body.invalid |
docs |
path |
required | REST conversion upload requires a versioned customer RPC path. Complete HTTP capture contract. Native JSON type: string. | vendor.google-ads-click-conversions.http.path.missingvendor.google-ads-click-conversions.http.path.emptyvendor.google-ads-click-conversions.http.path.invalid |
docs |
headers.authorization |
required | Every Google Ads API request requires an OAuth Bearer token. Complete HTTP capture contract. Native JSON type: string. | vendor.google-ads-click-conversions.http.headers.authorization.missingvendor.google-ads-click-conversions.http.headers.authorization.emptyvendor.google-ads-click-conversions.http.headers.authorization.invalid |
docs |
headers.developer-token |
required | Every Google Ads API request requires a developer token. Complete HTTP capture contract. Native JSON type: string. | vendor.google-ads-click-conversions.http.headers.developer-token.missingvendor.google-ads-click-conversions.http.headers.developer-token.emptyvendor.google-ads-click-conversions.http.headers.developer-token.invalid |
docs |
headers.login-customer-id |
optional | Manager customer ID, when supplied, omits hyphens. Complete HTTP capture contract. Native JSON type: string. | vendor.google-ads-click-conversions.http.headers.login-customer-id.emptyvendor.google-ads-click-conversions.http.headers.login-customer-id.invalid |
docs |
headers.linked-customer-id |
optional | Linked account customer ID, when supplied, omits hyphens. Complete HTTP capture contract. Native JSON type: string. | vendor.google-ads-click-conversions.http.headers.linked-customer-id.emptyvendor.google-ads-click-conversions.http.headers.linked-customer-id.invalid |
docs |
Validate a payload
pixellint validate request @request.json --rulepack vendor/google-ads-click-conversions
Try this failing payload in the playground. An example with a validation finding.
{
"url": "https://googleads.googleapis.com/v25/customers/1234567890:uploadClickConversions",
"method": "POST",
"headers": {
"Content-Type": "application/json",
"Authorization": "Bearer synthetic-token",
"developer-token": "synthetic-developer"
},
"body": "{\"partialFailure\":true,\"conversions\":[{\"conversionAction\":\"customers/1234567890/conversionActions/987654321\",\"conversionDateTime\":\"2026-08-21 12:00:00+00:00\",\"gclid\":\"TeSter-123\",\"conversionValue\":1.0,\"currencyCode\":\"USD\",\"consent\":{\"adPersonalization\":\"GRANTED\"}}]}"
}
cargo install pixellint
·
npm install pixellint