Inserts conversions. Try it now.
Request
HTTP request
POST https://www.googleapis.com/dfareporting/v3.4/userprofiles/profileId/conversions/batchinsert
Parameters
Parameter name | Value | Description |
---|---|---|
Path parameters | ||
profileId |
long |
User profile ID associated with this request. |
Authorization
This request requires authorization with the following scope:
Scope |
---|
https://www.googleapis.com/auth/ddmconversions |
For more information, see the authentication and authorization page.
Request body
In the request body, supply data with the following structure:
{ "kind": "dfareporting#conversionsBatchInsertRequest", "conversions": [ conversions Resource ], "encryptionInfo": { "kind": "dfareporting#encryptionInfo", "encryptionEntityType": string, "encryptionEntityId": long, "encryptionSource": string } }
Property name | Value | Description | Notes |
---|---|---|---|
kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchInsertRequest" . |
|
conversions[] |
list |
The set of conversions to insert. | |
encryptionInfo |
nested object |
Describes how encryptedUserId or encryptedUserIdCandidates[] is encrypted. This is a required field if encryptedUserId or encryptedUserIdCandidates[] is used. |
|
encryptionInfo.kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#encryptionInfo" . |
|
encryptionInfo.encryptionEntityType |
string |
The encryption entity type. This should match the encryption configuration for ad serving or Data Transfer.
Acceptable values are:
|
|
encryptionInfo.encryptionEntityId |
long |
The encryption entity ID. This should match the encryption configuration for ad serving or Data Transfer. | |
encryptionInfo.encryptionSource |
string |
Describes whether the encrypted cookie was received from ad serving (the %m macro) or from Data Transfer.
Acceptable values are:
|
Response
If successful, this method returns a response body with the following structure:
{ "kind": "dfareporting#conversionsBatchInsertResponse", "hasFailures": boolean, "status": [ { "kind": "dfareporting#conversionStatus", "conversion": conversions Resource, "errors": [ { "kind": "dfareporting#conversionError", "code": string, "message": string } ] } ] }
Property name | Value | Description | Notes |
---|---|---|---|
kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionsBatchInsertResponse" . |
|
hasFailures |
boolean |
Indicates that some or all conversions failed to insert. | |
status[] |
list |
The insert status of each conversion. Statuses are returned in the same order that conversions are inserted. | |
status[].kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionStatus" . |
|
status[].conversion |
nested object |
The original conversion that was inserted or updated. | |
status[].errors[] |
list |
A list of errors related to this conversion. | |
status[].errors[].kind |
string |
Identifies what kind of resource this is. Value: the fixed string "dfareporting#conversionError" . |
|
status[].errors[].code |
string |
The error code.
Acceptable values are:
|
|
status[].errors[].message |
string |
A description of the error. |
Try it!
Use the APIs Explorer below to call this method on live data and see the response.