Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Crea o actualiza CustomerSkAdNetworkConversionValueSchema.

Lista de errores arrojados: AuthenticationError AuthorizationError FieldError InternalError MutateError

Solicitud HTTP

POST https://googleads.googleapis.com/v15/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
}
Campos
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

La operación que se realizará.
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 customerSkAdNetworkConversionValueSchemas.mutate.

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Todos los resultados de la función{i> mutate<i}.

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 CustomerSkAdNetworkConversionValueSchema tienen el siguiente formato: clientes/{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)
    }
  ]
}
Campos
appId

string

Obligatorio. Solo salida. ID de la aplicación de Apple App Store.
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.

FineGrainedConversionValueMappings

Asignaciones para el valor de conversión detallado.

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. Son los 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. Es el período máximo en el que un usuario estuvo activo por última vez durante el período 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 que se informa para event_revenue. Código de moneda ISO 4217 de tres letras (por ejemplo, “USD”)
Campo de unión revenue_rate. Es 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. El rango de ingresos del evento.
eventRevenueValue

number

Solo salida. El valor de los ingresos del evento específico
Campo de unión event_rate. Es un rango o un 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, el valor mínimo en currencyCode para el que se actualizaría este valor de conversión. Un valor igual a 0 se considerará 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 igual a 0 se considerará 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 de contador de eventos, el mínimo del rango definido. Un valor igual a 0 se considerará no establecido.
maxEventCount

string (int64 format)

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

MutateCustomerSkAdNetworkConversionValueSchemaResult

Es 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 del SkanConversionValue modificado.