Method: conversions.batchinsert

  • The "conversions.batchinsert" method is used to insert conversions.

  • It utilizes an HTTP POST request to a specific URL containing a profileId.

  • The request body requires a ConversionsBatchInsertRequest object, which includes the conversions to be inserted and optional encryption information.

  • The response body is a ConversionsBatchInsertResponse object indicating if there were failures and providing the status for each conversion insertion.

  • This method requires the https://www.googleapis.com/auth/ddmconversions authorization scope.

Inserts conversions.

HTTP request

POST https://dfareporting.googleapis.com/dfareporting/v5/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.