Method: conversions.batchinsert
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
POST https://dfareporting.googleapis.com/dfareporting/v4/userprofiles/{profileId}/conversions/batchinsert
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
profileId |
string (int64 format)
User profile ID associated with this request.
|
Request body
The request body contains an instance of ConversionsBatchInsertRequest
.
Response body
Insert Conversions Response.
If successful, the response body contains data with the following structure:
JSON representation |
{
"hasFailures": boolean,
"status": [
{
object (ConversionStatus )
}
],
"kind": string
} |
Fields |
hasFailures |
boolean
Indicates that some or all conversions failed to insert.
|
status[] |
object (ConversionStatus )
The insert status of each conversion. Statuses are returned in the same order that conversions are inserted.
|
kind |
string
Identifies what kind of resource this is. Value: the fixed string
"dfareporting#conversionsBatchInsertResponse"
.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/ddmconversions
ConversionsBatchInsertRequest
Insert Conversions Request.
JSON representation |
{
"kind": string,
"conversions": [
{
object (Conversion )
}
],
"encryptionInfo": {
object (EncryptionInfo )
}
} |
Fields |
kind |
string
Identifies what kind of resource this is. Value: the fixed string
"dfareporting#conversionsBatchInsertRequest"
.
|
conversions[] |
object (Conversion )
The set of conversions to insert.
|
encryptionInfo |
object (EncryptionInfo )
Describes how
encryptedUserId
or
encryptedUserIdCandidates[]
is encrypted. This is a required field if
encryptedUserId
or
encryptedUserIdCandidates[]
is used.
|
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-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eInserts conversions into DoubleClick Campaign Manager using the provided conversion data.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/ddmconversions\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eConversions are submitted in batches using the \u003ccode\u003eConversionsBatchInsertRequest\u003c/code\u003e object, which includes an array of conversions and optional encryption information.\u003c/p\u003e\n"],["\u003cp\u003eThe response indicates whether any conversions failed to insert and provides individual status for each conversion.\u003c/p\u003e\n"]]],[],null,["# Method: conversions.batchinsert\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ConversionsBatchInsertResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [ConversionsBatchInsertRequest](#ConversionsBatchInsertRequest)\n - [JSON representation](#ConversionsBatchInsertRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nInserts conversions.\n\n### HTTP request\n\n`POST https://dfareporting.googleapis.com/dfareporting/v4/userprofiles/{profileId}/conversions/batchinsert`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------|-----------------------------------------------------------------------------------------------------------------------------------|\n| `profile``Id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` User profile ID associated with this request. |\n\n### Request body\n\nThe request body contains an instance of [ConversionsBatchInsertRequest](/doubleclick-advertisers/rest/v4/conversions/batchinsert#ConversionsBatchInsertRequest).\n\n### Response body\n\nInsert Conversions Response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"hasFailures\": boolean, \"status\": [ { object (/doubleclick-advertisers/rest/v4/ConversionStatus) } ], \"kind\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `has``Failures` | `boolean` Indicates that some or all conversions failed to insert. |\n| `status[]` | `object (`[ConversionStatus](/doubleclick-advertisers/rest/v4/ConversionStatus)`)` The insert status of each conversion. Statuses are returned in the same order that conversions are inserted. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#conversionsBatchInsertResponse\"` . |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/ddmconversions`\n\nConversionsBatchInsertRequest\n-----------------------------\n\nInsert Conversions Request.\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"conversions\": [ { object (/doubleclick-advertisers/rest/v4/Conversion) } ], \"encryptionInfo\": { object (/doubleclick-advertisers/rest/v4/EncryptionInfo) } } ``` |\n\n| Fields ||\n|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"dfareporting#conversionsBatchInsertRequest\"` . |\n| `conversions[]` | `object (`[Conversion](/doubleclick-advertisers/rest/v4/Conversion)`)` The set of conversions to insert. |\n| `encryption``Info` | `object (`[EncryptionInfo](/doubleclick-advertisers/rest/v4/EncryptionInfo)`)` Describes how `encryptedUserId` or `encryptedUserIdCandidates[]` is encrypted. This is a required field if `encryptedUserId` or `encryptedUserIdCandidates[]` is used. |"]]