Method: customers.uploadClickConversions

Procesa las conversiones de clics determinadas.

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

Solicitud HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadClickConversions

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 (ClickConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "debugEnabled": boolean
}
Campos
conversions[]

object (ClickConversion)

Obligatorio. Las conversiones que se están subiendo.
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 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

boolean

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

boolean

Si es verdadero, la API realizará todas las verificaciones de carga y mostrará errores si se encuentra alguno. Si es falso, solo realizará una validación de entrada básica, omitirá las siguientes verificaciones de carga y mostrará el resultado correcto incluso si no se encontró ningún clic para el userIdentifiers proporcionado.

Este parámetro de configuración solo afecta a las conversiones avanzadas de cargas de clientes potenciales que utilizan userIdentifiers en lugar de GCLID, GBRAID o WBRAID. Al subir conversiones avanzadas de clientes potenciales, debes subir todos los eventos de conversión a la API, incluidos aquellos que no provengan de campañas de Google Ads. La carga de un evento que no sea de una campaña de Google Ads generará un error CLICK_NOT_FOUND si este campo se establece como true. Dado que se esperan estos errores para estos eventos, establece este campo en false para confirmar que tus cargas tienen el formato adecuado, pero ignorar los errores CLICK_NOT_FOUND de todas las conversiones que no provienen de una campaña de Google Ads. Esto te permitirá enfocarte solo en los errores que puedes corregir.

El valor predeterminado es falso.

Cuerpo de la respuesta

Mensaje de respuesta para ConversionUploadService.UploadClickConversions.

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

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

object (Status)

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[]

object (ClickConversionResult)

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.
jobId

string (int64 format)

ID de trabajo para el lote de carga.

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.

ClickConversion

Una conversión de clic.

Representación JSON 
{
  "gbraid": string,
  "wbraid": string,
  "externalAttributionData": {
    object (ExternalAttributionData)
  },
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "cartData": {
    object (CartData)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "conversionEnvironment": enum (ConversionEnvironment),
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string,
  "orderId": string
}
Campos
gbraid

string

Es el identificador de clics para los clics asociados con las conversiones de aplicación y que se originan en dispositivos iOS a partir de iOS 14.
wbraid

string

Es el identificador de clics para los clics asociados con conversiones web y que se originan en dispositivos iOS a partir de iOS 14.
externalAttributionData

object (ExternalAttributionData)

Datos adicionales sobre las conversiones atribuidas externamente. Este campo es obligatorio para las conversiones con una acción de conversión atribuida externamente, pero no se debe establecer de otra manera.
customVariables[]

object (CustomVariable)

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

object (CartData)

Son los datos del carrito asociados con esta conversión.
userIdentifiers[]

object (UserIdentifier)

Son los identificadores de usuario asociados con esta conversión. Solo se admiten hashedEmail y hashedPhoneNumber para las cargas de conversiones. La cantidad máxima de identificadores de usuario para cada conversión es 5.
conversionEnvironment

enum (ConversionEnvironment)

El entorno en el que se registró esta conversión, por ejemplo, de aplicaciones o web
gclid

string

Es el ID de clic de Google (GCLID) asociado con esta conversión.
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 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

string

Es la fecha y hora en la que se generó la conversión. Debe ser posterior al momento del clic. 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.
orderId

string

Es el ID de pedido asociado con la conversión. Un ID de pedido solo puede utilizarse para una conversión por acción de conversión.

ExternalAttributionData

Contiene información adicional sobre las conversiones atribuidas externamente.

Representación JSON 
{
  "externalAttributionCredit": number,
  "externalAttributionModel": string
}
Campos
externalAttributionCredit

number

Representa la fracción de la conversión que se atribuye al clic de Google Ads.
externalAttributionModel

string

Especifica el nombre del modelo de atribución.

CartData

Contiene información adicional sobre los datos del carrito.

Representación JSON 
{
  "merchantId": string,
  "feedCountryCode": string,
  "feedLanguageCode": string,
  "localTransactionCost": number,
  "items": [
    {
      object (Item)
    }
  ]
}
Campos
merchantId

string (int64 format)

El ID de Merchant Center donde se suben los artículos.
feedCountryCode

string

Es el código de país asociado al feed en el que se suben los artículos.
feedLanguageCode

string

Es el código de idioma asociado al feed en el que se suben los artículos.
localTransactionCost

number

Es la suma de todos los descuentos a nivel de la transacción, como el envío gratis y los descuentos de cupones para todo el carrito. El código de moneda es el mismo que el del mensaje ClickConversion.
items[]

object (Item)

Son los datos de los artículos comprados.

Elemento

Contiene datos de los artículos comprados.

Representación JSON 
{
  "productId": string,
  "quantity": integer,
  "unitPrice": number
}
Campos
productId

string

El ID de Shopping del artículo. Debe ser igual al identificador de producto de Merchant Center.
quantity

integer

Cantidad de artículos vendidos.
unitPrice

number

Precio unitario sin impuestos, envío ni descuentos a nivel de la transacción. El código de moneda es el mismo que el del mensaje ClickConversion.

ConversionEnvironment

Es el entorno de conversión de la conversión subida.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Se usa solo para el valor de retorno. Representa un valor desconocido en esta versión.
APP La conversión se registró en una aplicación.
WEB La conversión se registró en un sitio web.

ClickConversionResult

Información de identificación de una ClickConversion procesada correctamente.

Representación JSON 
{
  "gbraid": string,
  "wbraid": string,
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "gclid": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Campos
gbraid

string

Es el identificador de clics para los clics asociados con las conversiones de aplicación y que se originan en dispositivos iOS a partir de iOS 14.
wbraid

string

Es el identificador de clics para los clics asociados con conversiones web y que se originan en dispositivos iOS a partir de iOS 14.
userIdentifiers[]

object (UserIdentifier)

Son los identificadores de usuario asociados con esta conversión. Solo se admiten hashedEmail y hashedPhoneNumber para las cargas de conversiones. La cantidad máxima de identificadores de usuario para cada conversión es 5.
gclid

string

Es el ID de clic de Google (GCLID) asociado con esta conversión.
conversionAction

string

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

string

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