- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- CallConversion
- CallConversionResult
- Pruébala
Procesa las conversiones de llamada determinadas.
Lista de errores arrojados: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
Solicitud HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
customerId |
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 ( |
Campos | |
---|---|
conversions[] |
Obligatorio. Las conversiones que se están subiendo. |
partialFailure |
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 son válidas. Esto siempre se debe configurar como true. Consulte https://developers.google.com/google-ads/api/docs/best-practices/partial-failures para obtener más información sobre los errores parciales. |
validateOnly |
Si es verdadera, 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 ( |
Campos | |
---|---|
partialFailureError |
Errores relacionados con las 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 muestra un error a nivel de RPC. Consulte https://developers.google.com/google-ads/api/docs/best-practices/partial-failures para obtener más información sobre los errores parciales. |
results[] |
Se muestra para las conversiones procesadas 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 ( |
Campos | |
---|---|
customVariables[] |
Son las variables personalizadas asociadas con esta conversión. |
consent |
Es la configuración de consentimiento del evento. |
callerId |
El identificador de llamada desde el que se realizó esta llamada. Se espera que el identificador de llamadas tenga el formato E.164 precedido por un signo "+"; por ejemplo, "+16502531234". |
callStartDateTime |
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 |
Es el nombre del recurso de la acción de conversión asociada con esta conversión. Nota: Si bien este nombre de recurso consta de 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 |
Es 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 |
Es el valor de la conversión para el anunciante. |
currencyCode |
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 llamada de conversión procesada correctamente.
Representación JSON |
---|
{ "callerId": string, "callStartDateTime": string, "conversionAction": string, "conversionDateTime": string } |
Campos | |
---|---|
callerId |
El identificador de llamada desde el que se realizó esta llamada. Se espera que el identificador de llamadas tenga el formato E.164 precedido por un signo "+". |
callStartDateTime |
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 |
Es el nombre del recurso de la acción de conversión asociada con esta conversión. |
conversionDateTime |
Es 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". |