Method: customers.uploadCallConversions

Procesa las conversiones de llamada proporcionadas.

Lista de errores arrojados: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

Solicitud HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadCallConversions

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
customerId

string

Obligatorio. El ID del cliente que realiza la carga.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Campos
conversions[]

object (CallConversion)

Obligatorio. Las conversiones que se suben
partialFailure

boolean

Obligatorio. Si es verdadero, se llevarán a cabo operaciones exitosas y las operaciones no válidas mostrarán errores. Si es falso, todas las operaciones se llevarán a cabo en una transacción solo si todas son válidas. Esto siempre se debe establecer como true. Consulta https://developers.google.com/google-ads/api/docs/best-practices/partial-failures para obtener más información sobre las fallas parciales.
validateOnly

boolean

Si es verdadero, la solicitud se valida, pero no se ejecuta. Solo se muestran errores, no resultados.

Cuerpo de la respuesta

Mensaje de respuesta para ConversionUploadService.UploadCallConversions.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
Campos
partialFailureError

object (Status)

Errores relacionados con fallas de conversión en el modo de falla parcial. Se muestra cuando se producen todos los errores en las conversiones. Si se produce algún error fuera de las conversiones (por ejemplo, errores de autenticación), se mostrará un error de nivel de RPC. Consulta https://developers.google.com/google-ads/api/docs/best-practices/partial-failures para obtener más información sobre las fallas parciales.
results[]

object (CallConversionResult)

Se muestra para las conversiones que se procesaron correctamente. El protocolo estará vacío para las filas que recibieron un error. No se muestran los resultados cuando validateOnly es verdadero.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/adwords

Para obtener más información, consulta la Descripción general de OAuth 2.0.

CallConversion

Una conversión de llamada.

Representación JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Campos
customVariables[]

object (CustomVariable)

Son las variables personalizadas asociadas con esta conversión.
consent

object (Consent)

Es la configuración de consentimiento para el evento.
callerId

string

El identificador de llamada desde el que se realizó esta llamada. Se espera que el identificador de llamada esté en formato E.164 con el signo "+" antes, por ejemplo, "+16502531234".
callStartDateTime

string

La fecha y hora en la que se realizó la llamada. Se debe especificar la zona horaria. El formato es "aaaa-mm-dd hh:mm:ss+|-hh:mm", por ejemplo: "2019-01-01 12:32:45-08:00".
conversionAction

string

Es el nombre del recurso de la acción de conversión asociada con esta conversión. Nota: Si bien este nombre de recurso consiste en un ID de cliente y un ID de acción de conversión, la validación ignorará el ID de cliente y usará el ID de acción de conversión como el único identificador de la acción de conversión.
conversionDateTime

string

Indica la fecha y hora en la que se generó la conversión. Debe ser posterior al horario de la llamada. Se debe especificar la zona horaria. El formato es "aaaa-mm-dd hh:mm:ss+|-hh:mm", por ejemplo: "2019-01-01 12:32:45-08:00".
conversionValue

number

Es el valor de la conversión para el anunciante.
currencyCode

string

Es la moneda asociada con el valor de conversión. Este es el código de moneda ISO 4217 de 3 caracteres. Por ejemplo: USD o EUR.

CallConversionResult

Información de identificación de una CallConversionUpload que se procesó correctamente.

Representación JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Campos
callerId

string

El identificador de llamada desde el que se realizó esta llamada. Se espera que el identificador de llamada esté en formato E.164 con el signo "+" antes.
callStartDateTime

string

La fecha y hora en la que se realizó la llamada. El formato es "aaaa-mm-dd hh:mm:ss+|-hh:mm", por ejemplo: "2019-01-01 12:32:45-08:00".
conversionAction

string

Es el nombre del recurso de la acción de conversión asociada con esta conversión.
conversionDateTime

string

Indica la fecha y hora en la que se generó la conversión. El formato es "aaaa-mm-dd hh:mm:ss+|-hh:mm", por ejemplo: "2019-01-01 12:32:45-08:00".