Method: customers.uploadConversionAdjustments

Procesa los ajustes de conversión especificados.

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

Solicitud HTTP

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

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 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Campos
conversionAdjustments[]

object (ConversionAdjustment)

Obligatorio. Los ajustes de 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.
jobId

integer

Opcional. Entrada opcional para establecer el ID de trabajo. Debe ser un número no negativo menor que 2^31 si se proporciona. Si no se proporciona este campo, la API generará un ID de trabajo en el rango [2^31, (2^63)-1]. La API mostrará el valor de esta solicitud en el campo jobId de UploadConversionAdjustmentsResponse.

Cuerpo de la respuesta

Mensaje de respuesta para ConversionAdjustmentUploadService.UploadConversionAdjustments.

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

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

object (Status)

Errores relacionados con fallas de ajuste de conversiones en el modo de falla parcial. Se devuelve cuando todos los errores se producen dentro de los ajustes. Si se produce algún error fuera de los ajustes (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 (ConversionAdjustmentResult)

Se muestra para los ajustes de conversiones procesados 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.

ConversionAdjustment

Es un ajuste de conversión.

Representación JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Campos
gclidDateTimePair

object (GclidDateTimePair)

En el caso de los ajustes, identifica de forma exclusiva una conversión que se registró sin un ID de pedido especificado. Si AdjustType es ENHANCEMENT, este valor es opcional, pero se puede establecer además de orderId.
adjustmentType

enum (ConversionAdjustmentType)

Es el tipo de ajuste.
restatementValue

object (RestatementValue)

Información necesaria para rectificar el valor de la conversión. Obligatorio para las rectificaciones. No se debe proporcionar para las retractaciones. Se mostrará un error si se proporciona una retractación. NOTA: Si deseas subir una segunda reafirmación con un valor ajustado diferente, esta debe tener una hora de caso de ajuste nueva y más reciente. De lo contrario, se considerará como un duplicado de la reafirmación anterior y se ignorará.
userIdentifiers[]

object (UserIdentifier)

Los identificadores de usuario para mejorar la conversión original. ConversionAdjustUploadService solo acepta identificadores de usuario en las mejoras. La cantidad máxima de identificadores de usuario para cada mejora es 5.
orderId

string

Es el ID de pedido de la conversión que se ajustará. Si la conversión se registró con un ID de pedido especificado, este se debe usar como identificador aquí. Se requiere el ID de pedido para realizar mejoras.
conversionAction

string

Es el nombre del recurso de la acción de conversión asociada con este ajuste de 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.
adjustmentDateTime

string

Indica la fecha y hora en la que se realizó el ajuste. Debe ser posterior a conversionDateTime. 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".
userAgent

string

El usuario-agente para mejorar la conversión original. Se puede encontrar en el encabezado de la solicitud HTTP del usuario cuando este genera una conversión en tu página web. Ejemplo, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 como Mac OS X)". El usuario-agente solo se puede especificar en las mejoras con identificadores de usuario. Debe coincidir con el usuario-agente de la solicitud que envió la conversión original, de modo que la conversión y su mejora se atribuyan como en el mismo dispositivo o como en varios dispositivos.

GclidDateTimePair

Identifica de forma exclusiva una conversión que se informó sin un ID de pedido especificado.

Representación JSON 
{
  "gclid": string,
  "conversionDateTime": string
}
Campos
gclid

string

ID de clic de Google (gclid) asociado con la conversión original para este ajuste.
conversionDateTime

string

Indica la fecha y hora en la que se generó la conversión original de este ajuste. 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".

ConversionAdjustmentType

Las diferentes acciones que los anunciantes pueden realizar para ajustar las conversiones que ya registraron. Las retractaciones anulan las conversiones. Las rectificaciones cambian el valor de una conversión.

Enumeradores
UNSPECIFIED No se especifica.
UNKNOWN Representa un valor desconocido en esta versión.
RETRACTION Nega una conversión de modo que su valor total y recuento sean cero.
RESTATEMENT Cambia el valor de una conversión.
ENHANCEMENT Complementa una conversión existente con identificadores de usuario y usuario-agente proporcionados, que Google puede usar para mejorar el registro de conversiones.

RestatementValue

Contiene la información necesaria para rectificar el valor de una conversión.

Representación JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
Campos
adjustedValue

number

Es el valor de conversión rectificado. Este es el valor de la conversión después de la reafirmación. Por ejemplo, para cambiar el valor de una conversión de 100 a 70, se debe informar un valor ajustado de 70. NOTA: Si deseas subir una segunda reafirmación con un valor ajustado diferente, esta debe tener una hora de caso de ajuste nueva y más reciente. De lo contrario, se considerará como un duplicado de la reafirmación anterior y se ignorará.
currencyCode

string

La moneda del valor rectificado. Si no se proporciona, se utiliza la moneda predeterminada de la acción de conversión y, si no se establece, se utiliza la moneda de la cuenta. Corresponde al código de moneda ISO 4217 de 3 caracteres, por ejemplo, USD o EUR.

ConversionAdjustmentResult

Información que identifica un ajuste de conversión que se procesó correctamente.

Representación JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Campos
gclidDateTimePair

object (GclidDateTimePair)

El GCLID y la fecha y hora de la conversión.
orderId

string

Es el ID de pedido de la conversión que se ajustará.
adjustmentType

enum (ConversionAdjustmentType)

Es el tipo de ajuste.
conversionAction

string

Es el nombre del recurso de la acción de conversión asociada con este ajuste de conversión.
adjustmentDateTime

string

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