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/v14/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
}
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 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.

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 muestra cuando se producen todos los errores dentro de los ajustes. Si se produce algún error fuera de los ajustes (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 (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

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 informó sin un ID de pedido especificado. Si AdjustType es ENHANCEMENT, este valor es opcional, pero se puede establecer junto con 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 rectificación con un valor ajustado diferente, esta debe tener un nuevo horario de caso de ajuste 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 debe ajustar. Si la conversión se informó con un ID de pedido especificado, ese ID de pedido se debe usar como el 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 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.
adjustmentDateTime

string

Es la fecha y hora en la que se produjo 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. Puede encontrarla en el encabezado de la solicitud HTTP de los usuarios cuando generan conversiones en tu página web. Por ejemplo, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)". El usuario-agente solo se puede especificar en las mejoras con identificadores de usuario. Esto 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 única una conversión que se informó sin un ID de pedido especificado.

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

string

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

string

Es 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 pueden realizar los anunciantes 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 Negara una conversión para 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 rectificación con un valor ajustado diferente, esta debe tener un nuevo horario de caso de ajuste más reciente. De lo contrario, se considerará como un duplicado de la reafirmación anterior y se ignorará.
currencyCode

string

Es la moneda del valor reformulado. Si no se proporciona, se utiliza la moneda predeterminada de la acción de conversión y, de lo contrario, se utiliza la moneda de la cuenta. Este es el 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)

Corresponde al GCLID y la fecha y hora de la conversión.
orderId

string

Es el ID de pedido de la conversión que se debe 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

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