Conversions: batchinsert

Note: Requires authorization.

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: "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	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: "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.