Conversions: batchinsert

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
`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: "`ADWORDS_CUSTOMER`" "`DBM_ADVERTISER`" "`DBM_PARTNER`" "`DCM_ACCOUNT`" "`DCM_ADVERTISER`" "`DFP_NETWORK_CODE`" "`ENCRYPTION_ENTITY_TYPE_UNKNOWN`"
`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: "`AD_SERVING`" "`DATA_TRANSFER`" "`ENCRYPTION_SCOPE_UNKNOWN`"

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
`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: "`INTERNAL`" "`INVALID_ARGUMENT`" "`NOT_FOUND`" "`PERMISSION_DENIED`"
`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.