--- title: "POST /userprofiles/{profileId}/conversions/batchupdate" method: POST path: "/userprofiles/{profileId}/conversions/batchupdate" tags: ["conversions"] --- # POST /userprofiles/{profileId}/conversions/batchupdate `POST /userprofiles/{profileId}/conversions/batchupdate` Updates existing conversions. ## Path parameters - `profileId` string, required ## Request body - ConversionsBatchUpdateRequest — Update Conversions Request. - `kind` string — Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchUpdateRequest". - `encryptionInfo` EncryptionInfo — A description of how user IDs are encrypted. - `encryptionEntityId` string, int64 — The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer. - `encryptionEntityType` 'ENCRYPTION_ENTITY_TYPE_UNKNOWN' | 'DCM_ACCOUNT' | 'DCM_ADVERTISER' | 'DBM_PARTNER' | 'DBM_ADVERTISER' | 'ADWORDS_CUSTOMER' | 'DFP_NETWORK_CODE' — The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer. - `encryptionSource` 'ENCRYPTION_SCOPE_UNKNOWN' | 'AD_SERVING' | 'DATA_TRANSFER' — Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer. - `kind` string — Identifies what kind of resource this is. Value: the fixed string "dfareporting#encryptionInfo". - `conversions` Conversion[] — The set of conversions to update. - `nonPersonalizedAd` boolean — Whether the conversion was for a non personalized ad. - `cartData` CartData — Contains additional information about cart data. This field may only be used when calling batchinsert; it is not supported by batchupdate. Cart data reporting is only supported in SA360. [Learn more](https://support.google.com/sa360/topic/13425788) - `merchantFeedLabel` string — The feed labels associated with the feed where your items are uploaded. For more information, please refer to ​​ https://support.google.com/merchants/answer/12453549. Providing the feed label reduces ambiguity in identifying the right offer details. - `merchantFeedLanguage` string — The language associated with the feed where your items are uploaded. Use ISO 639-1 language codes. Providing the feed language reduces ambiguity in identifying the right offer details. - `items` CartDataItem[] — Data of the items purchased. - `itemId` string — The shopping id of the item. Must be equal to the Merchant Center product identifier. This is a required field. - `quantity` integer — Number of items sold. This is a required field. - `unitPrice` number, double — Unit price excluding tax, shipping, and any transaction level discounts. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field. - `merchantId` string, int64 — The Merchant Center ID where the items are uploaded. Providing Merchant Center ID reduces ambiguity in identifying the right offer details. - `treatmentForUnderage` boolean — Whether this particular request may come from a user under the age of 16 (may differ by country), under compliance with the European Union's General Data Protection Regulation (GDPR). - `timestampMicros` string, int64 — The timestamp of conversion, in Unix epoch micros. This is a required field. - `userIdentifiers` UserIdentifier[] — The user identifiers to enhance the conversion. The maximum number of user identifiers for each conversion is 5. - `hashedEmail` string — Hashed email address using SHA-256 hash function after normalization. - `addressInfo` OfflineUserAddressInfo — Identify a user by name and address. - `hashedStreetAddress` string — The street address of the user hashed using SHA-256 hash function after normalization (lower case only). - `hashedFirstName` string — First name of the user, which is hashed as SHA-256 after normalized (Lowercase all characters; Remove any extra spaces before, after, and in between). - `postalCode` string — Postal code of the user's address. - `countryCode` string — 2-letter country code in ISO-3166-1 alpha-2 of the user's address. - `hashedLastName` string — Last name of the user, which is hashed as SHA-256 after normalized (lower case only and no punctuation). - `state` string — State code of the address. - `city` string — City of the address. - `hashedPhoneNumber` string — Hashed phone number using SHA-256 hash function after normalization (E164 standard). - `kind` string — Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversion". - `matchId` string — The match ID field. A match ID is your own first-party identifier that has been synced with Google using the match ID feature in Floodlight. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[],mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserId orencryptedUserIdCandidates[] or mobileDeviceId or gclid or dclid or impressionIdis a required field. - `impressionId` string — The impression ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, and gclid. One of these identifiers must be set. - `encryptedUserId` string — The alphanumeric encrypted user ID. When set, encryptionInfo should also be specified. This field is mutually exclusive with encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, dclid, and impressionId. This or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field. - `value` number, double — The value of the conversion. Interpreted in CM360 Floodlight config parent advertiser's currency code. This is a required field. - `childDirectedTreatment` boolean — Whether this particular request may come from a user under the age of 13, under COPPA compliance. - `limitAdTracking` boolean — Whether Limit Ad Tracking is enabled. When set to true, the conversion will be used for reporting but not targeting. This will prevent remarketing. - `dclid` string — The display click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, gclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or gclid or impressionId is a required field. - `encryptedUserIdCandidates` string[] — A list of the alphanumeric encrypted user IDs. Any user ID with exposure prior to the conversion timestamp will be used in the inserted conversion. If no such user ID is found then the conversion will be rejected with INVALID_ARGUMENT error. When set, encryptionInfo should also be specified. This field may only be used when calling batchinsert; it is not supported by batchupdate. This field is mutually exclusive with encryptedUserId, matchId, mobileDeviceId, gclid dclid, and impressionId. This or encryptedUserId or matchId or mobileDeviceId or gclid or dclid or impressionId is a required field. - `quantity` string, int64 — The quantity of the conversion. This is a required field. - `gclid` string — The Google click ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, mobileDeviceId, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or mobileDeviceId or dclid or impressionId is a required field. - `floodlightConfigurationId` string, int64 — Floodlight Configuration ID of this conversion. This is a required field. - `ordinal` string — The ordinal of the conversion. Use this field to control how conversions of the same user and day are de-duplicated. This is a required field. - `customVariables` CustomFloodlightVariable[] — Custom floodlight variables. - `type` 'U1' | 'U2' | 'U3' | 'U4' | 'U5' | 'U6' | 'U7' | 'U8' | 'U9' | 'U10' | 'U11' | 'U12' | 'U13' | 'U14' | 'U15' | 'U16' | 'U17' | 'U18' | 'U19' | 'U20' | 'U21' | 'U22' | 'U23' | 'U24' | 'U25' | 'U26' | 'U27' | 'U28' | 'U29' | 'U30' | 'U31' | 'U32' | 'U33' | 'U34' | 'U35' | 'U36' | 'U37' | 'U38' | 'U39' | 'U40' | 'U41' | 'U42' | 'U43' | 'U44' | 'U45' | 'U46' | 'U47' | 'U48' | 'U49' | 'U50' | 'U51' | 'U52' | 'U53' | 'U54' | 'U55' | 'U56' | 'U57' | 'U58' | 'U59' | 'U60' | 'U61' | 'U62' | 'U63' | 'U64' | 'U65' | 'U66' | 'U67' | 'U68' | 'U69' | 'U70' | 'U71' | 'U72' | 'U73' | 'U74' | 'U75' | 'U76' | 'U77' | 'U78' | 'U79' | 'U80' | 'U81' | 'U82' | 'U83' | 'U84' | 'U85' | 'U86' | 'U87' | 'U88' | 'U89' | 'U90' | 'U91' | 'U92' | 'U93' | 'U94' | 'U95' | 'U96' | 'U97' | 'U98' | 'U99' | 'U100' — The type of custom floodlight variable to supply a value for. These map to the "u[1-100]=" in the tags. - `kind` string — Identifies what kind of resource this is. Value: the fixed string "dfareporting#customFloodlightVariable". - `value` string — The value of the custom floodlight variable. The length of string must not exceed 100 characters. - `adUserDataConsent` 'GRANTED' | 'DENIED' — This represents consent for ad user data. - `floodlightActivityId` string, int64 — Floodlight Activity ID of this conversion. This is a required field. - `mobileDeviceId` string — The mobile device ID. This field is mutually exclusive with encryptedUserId, encryptedUserIdCandidates[], matchId, gclid, dclid, and impressionId. This or encryptedUserId or encryptedUserIdCandidates[] or matchId or gclid or dclid or impressionId is a required field. - `sessionAttributesEncoded` string, byte — Session attributes for the conversion, encoded as based64 bytes. This field may only be used when calling batchinsert; it is not supported by batchupdate. ## Response `200` Successful response --- [API](https://skmtc.net/google/apis/dfareporting.md) · [All operations](https://skmtc.net/google/apis/dfareporting/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/dfareporting/revisions/8163d57aeb31/schema)