Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Crea o actualiza el CustomerSkAdNetworkConversionValueSchema.

Lista de errores arrojados: AuthenticationError AuthorizationError FieldError InternalError MutateError

Solicitud HTTP

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

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

Parámetros de ruta de acceso

Parámetros
customerId

string

El ID del cliente cuyos conjuntos compartidos se están modificando.

Cuerpo de la solicitud

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

Representación JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
Campos
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

La operación que se realizará.
validateOnly

boolean

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

boolean

Opcional. Si es verdadero, habilita las advertencias que se muestran. Las advertencias muestran mensajes y códigos de error sin bloquear la ejecución de la operación de mutación.

Cuerpo de la respuesta

Mensaje de respuesta para customerSkAdNetworkConversionValueSchemas.mutate.

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

Representación JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
Campos
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Todos los resultados para la mutación.
warning

object (Status)

Son errores que no generan bloqueo y que proporcionan detalles sobre la falla de validación del esquema. Solo se muestra cuando enableWarnings = true.

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.

CustomerSkAdNetworkConversionValueSchemaOperation

Una sola operación de actualización para un CustomerSkAdNetworkConversionValueSchema.

Representación JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Campos
update

object (CustomerSkAdNetworkConversionValueSchema)

Operación de actualización: se espera que el esquema tenga un nombre de recurso válido.

CustomerSkAdNetworkConversionValueSchema

Un CustomerSkAdNetworkConversionValueSchema.

Representación JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Campos
resourceName

string

Solo salida. El nombre del recurso del esquema. Los nombres de recursos de CustomerSkAdNetworkConversionValueSchema tienen el siguiente formato: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}.
schema

object (SkAdNetworkConversionValueSchema)

Solo salida. El esquema del recurso especificado.

SkAdNetworkConversionValueSchema

El SkAdNetworkConversionValueSchema específico de CustomerLink.

Representación JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Campos
appId

string

Obligatorio. Solo salida. ID de la aplicación de la App Store de Apple.
measurementWindowHours

integer

Solo salida. Es un período (medido en horas) posterior a la instalación, después del cual el socio de atribución en aplicaciones o el anunciante deja de llamar a updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Solo salida. Asignaciones detalladas de valores de conversión. Para las versiones de SkAdNetwork >= 4.0 que admiten varias ventanas de conversión, las asignaciones detalladas de valores de conversión solo se aplican a la primera notificación de conversión.
postbackMappings[]

object (PostbackMapping)

Solo salida. Asignaciones de valores de conversión por notificación de conversión para notificaciones en varias ventanas de conversión. Solo se aplica a las versiones de SkAdNetwork 4.0 o posteriores.

FineGrainedConversionValueMappings

Asignaciones para valores de conversión detallados

Representación JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Campos
fineGrainedConversionValue

integer

Solo salida. Valor de conversión detallado. Los valores válidos se encuentran en el rango inclusivo [0,63].
conversionValueMapping

object (ConversionValueMapping)

Solo salida. Eventos de conversión a los que se asigna el valor de conversión detallado.

ConversionValueMapping

Representa la asignación de un valor de conversión a uno o más eventos de conversión.

Representación JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Campos
minTimePostInstallHours

string (int64 format)

Solo salida. Es el intervalo de tiempo mínimo en el que un usuario estuvo activo por última vez durante el período de medición.
maxTimePostInstallHours

string (int64 format)

Solo salida. El intervalo de tiempo máximo en el que un usuario estuvo activo por última vez durante la ventana de medición.
mappedEvents[]

object (Event)

Solo salida. El valor de conversión se puede asignar a varios eventos con distintos atributos.

Evento

Define un evento de conversión de Google al que se asigna el valor de conversión.

Representación JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Campos
mappedEventName

string

Solo salida. Es el nombre del evento de Google representado por este valor de conversión.
currencyCode

string

Solo salida. La moneda informada para event_revenue. Código de moneda ISO 4217 de tres letras, por ejemplo, “USD”
Campo de unión revenue_rate. Puede ser un rango o un valor específico para los ingresos del evento. Las direcciones (revenue_rate) solo pueden ser una de las siguientes opciones:
eventRevenueRange

object (RevenueRange)

Solo salida. Es el rango de ingresos del evento.
eventRevenueValue

number

Solo salida. Es el valor específico de los ingresos del evento.
Campo de unión event_rate. Es un rango o valor específico para el contador de eventos. Las direcciones (event_rate) solo pueden ser una de las siguientes opciones:
eventOccurrenceRange

object (EventOccurrenceRange)

Solo salida. El rango del contador de eventos.
eventCounter

string (int64 format)

Solo salida. Para valores de contador de eventos específicos.

RevenueRange

Define un rango para los valores de ingresos.

Representación JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Campos
minEventRevenue

number

Solo salida. Para los rangos de ingresos, es el valor mínimo en currencyCode para el que se actualizaría este valor de conversión. Un valor de 0 se tratará como no establecido.
maxEventRevenue

number

Solo salida. Para los rangos de ingresos, el valor máximo en currencyCode para el que se actualizaría este valor de conversión. Un valor de 0 se tratará como no establecido.

EventOccurrenceRange

Define un rango para los valores del contador de eventos.

Representación JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Campos
minEventCount

string (int64 format)

Solo salida. Para los rangos del contador de eventos, el mínimo del rango definido. Un valor de 0 se tratará como no establecido.
maxEventCount

string (int64 format)

Solo salida. Para los rangos del contador de eventos, el valor máximo del rango definido. Un valor de 0 se tratará como no establecido.

PostbackMapping

Asignaciones para cada notificación de conversión en varias ventanas de conversión.

Representación JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Campos
postbackSequenceIndex

integer

Solo salida. Es un índice basado en 0 que indica el orden de la notificación de conversión. Los valores válidos se encuentran en el rango inclusivo [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Solo salida. Asignaciones de valores de conversión para todos los valores de conversión generales.
Campo de unión lock_window_trigger. Valor de conversión o evento que se usa para bloquear la ventana de conversión. Las direcciones (lock_window_trigger) solo pueden ser una de las siguientes opciones:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Solo salida. Valor de conversión poco detallado que activa el bloqueo de la ventana de conversión.
lockWindowFineConversionValue

integer

Solo salida. Valor de conversión detallado que activa el bloqueo de la ventana de conversión.
lockWindowEvent

string

Solo salida. Nombre del evento que activa el bloqueo de la ventana de conversión.

CoarseGrainedConversionValueMappings

Asignaciones para valores de conversión generales.

Representación JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Campos
lowConversionValueMapping

object (ConversionValueMapping)

Solo salida. Asignación para el valor de conversión general "bajo"
mediumConversionValueMapping

object (ConversionValueMapping)

Solo salida. Asignación para el valor de conversión general "medio".
highConversionValueMapping

object (ConversionValueMapping)

Solo salida. Asignación para el valor de conversión general "alto".

MutateCustomerSkAdNetworkConversionValueSchemaResult

El resultado de la mutación de CustomerSkAdNetworkConversionValueSchema.

Representación JSON 
{
  "resourceName": string,
  "appId": string
}
Campos
resourceName

string

Nombre del recurso del cliente que se modificó.
appId

string

Es el ID de app de SkanConversionValue modificado.