Method: conversions.batchinsert

  • The content provides details on how to insert conversions using an HTTP POST request to a specific API endpoint.

  • The request requires a profileId as a path parameter and a request body containing a ConversionsBatchInsertRequest object.

  • The response body indicates the success or failure of the conversion insertions and provides the status for each.

  • Authorization requires the https://www.googleapis.com/auth/ddmconversions OAuth scope.

Inserts conversions.

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.