REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Recurso: SKAdNetworkConversionValueSchema

Esquema de valor de conversión de SKAdNetwork de una transmisión de iOS.

Representación JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Campos
name

string

Solo salida. El nombre del recurso del esquema. Este será un elemento secundario SOLO de una transmisión de iOS, y puede haber como máximo uno de ese tipo en una transmisión de iOS. Formato: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Obligatorio. La configuración del valor de conversión del primer período de notificación de conversión. Estos difieren de los valores del período de notificación de conversión dos y tres en que contienen un valor de conversión detallado "Fine" (un valor numérico).

Se deben establecer los valores de conversión para este período de notificación de conversión. Las otras ventanas son opcionales y, si no las estableces o la inhabilitas, es posible que hereden la configuración de esta ventana.
postbackWindowTwo

object (PostbackWindow)

La configuración del valor de conversión para el segundo período de notificación de conversión.

Este campo solo se debe configurar si es necesario definir diferentes valores de conversión para este período de notificación de conversión.

Si enable_postback_window_settings se establece como falso para este período de notificación de conversión, se usarán los valores de postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

La configuración del valor de conversión para el tercer período de notificación de conversión.

Este campo solo debe establecerse si el usuario eligió definir diferentes valores de conversión para este período de notificación de conversión. Se permite configurar la ventana 3 sin configurar la ventana 2. Si se establece la configuración de los períodos 1 y 2, y se establece enable_postback_window_settings para este período de notificación de conversión, el esquema heredará la configuración de postbackWindowTwo.
applyConversionValues

boolean

Si se habilita, el SDK de Google Analytics establecerá los valores de conversión con esta definición de esquema y el esquema se exportará a todas las cuentas de Google Ads vinculadas a esta propiedad. Si se inhabilita, el SDK de Google Analytics no establecerá los valores de conversión automáticamente, y el esquema no se exportará a Google Ads.

PostbackWindow

Configuración de una ventana de notificación de conversión de conversión de SKAdNetwork.

Representación JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Campos
conversionValues[]

object (ConversionValues)

Se utilizará el orden de los campos repetidos para priorizar la configuración del valor de conversión. Las entradas indexadas más bajas tienen prioridad más alta. Se seleccionará el primer parámetro de configuración del valor de conversión que se evalúe como verdadero. Debe tener al menos una entrada si enable_postback_window_settings se establece como verdadero. Puede tener un máximo de 128 entradas.
postbackWindowSettingsEnabled

boolean

Si enable_postback_window_settings se establece en "true", se deben propagar conversionValues que se usarán para determinar cuándo y cómo establecer el valor de conversión en un dispositivo cliente y exportar el esquema a las cuentas de Google Ads vinculadas. Si es falsa, la configuración no se utiliza, pero se conserva en caso de que se pueda utilizar en el futuro. Esto siempre debe ser verdadero para postbackWindowOne.

ConversionValues

Configuración del valor de conversión de un período de notificación de conversión para el esquema de valor de conversión de SKAdNetwork.

Representación JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Campos
displayName

string

Nombre visible del valor de conversión de SKAdNetwork. La longitud máxima permitida del nombre visible es de 50 unidades de código UTF-16.
coarseValue

enum (CoarseValue)

Obligatorio. Es un valor de conversión poco detallado.

No se garantiza que este valor sea único.
eventMappings[]

object (EventMapping)

Condiciones del evento que se deben cumplir para que se alcance este valor de conversión. Las condiciones de esta lista se unen mediante el operador Y. Debe tener un mínimo de 1 entrada y un máximo de 3 entradas si el período de notificación de conversión está habilitado.
lockEnabled

boolean

Si es verdadero, el SDK debería bloquear este valor de conversión para el período de notificación de conversión actual.
fineValue

integer

Es el valor de conversión detallado. Esto se aplica solo al primer período de notificación de conversión. Sus valores válidos son [0,63], ambos inclusivos. Se debe configurar para el período de notificación de conversión 1, pero no para los períodos de notificación de conversión 2 y 3. No se garantiza que este valor sea único.

Si la configuración del primer período de notificación de conversión se vuelve a utilizar para el segundo o tercer período de notificación, este campo no tiene ningún efecto.

CoarseValue

Es el valor de conversión general establecido en la llamada del SDK updatePostbackConversionValue cuando se cumplen las condiciones ConversionValues.event_mappings. Para obtener más información, consulta SKAdNetwork.CoarseConversionValue.

Enumeradores
COARSE_VALUE_UNSPECIFIED No se especificó el valor general.
COARSE_VALUE_LOW Valor general de bajo.
COARSE_VALUE_MEDIUM Valor general de medio.
COARSE_VALUE_HIGH Valor aproximado de alto

EventMapping

Condiciones de configuración de eventos que deben coincidir con un evento

Representación JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Campos
eventName

string

Obligatorio. Es el nombre del evento de GA4. Siempre debe configurarse. La longitud máxima permitida del nombre visible es de 40 unidades de código UTF-16.
minEventCount

string (int64 format)

Se debe establecer al menos uno de los siguientes cuatro valores mínimos o máximos. Los valores establecidos se unirán con el operador Y para calificar un evento. La cantidad mínima de veces que ocurrió el evento. Si no la estableces, no se verificará la cantidad mínima de eventos.
maxEventCount

string (int64 format)

La cantidad máxima de veces que ocurrió el evento. Si no la estableces, no se verificará la cantidad máxima de eventos.
minEventValue

number

Son los ingresos mínimos generados debido al evento. La moneda de los ingresos se definirá a nivel de la propiedad. Si no la estableces, no se verificará el valor mínimo del evento.
maxEventValue

number

Son los ingresos máximos generados debido al evento. La moneda de los ingresos se definirá a nivel de la propiedad. Si no la estableces, no se verificará el valor máximo del evento.

Métodos

create

 Crea un SKAdNetworkConversionValueSchema.

delete

 Se borra el objetivo SKAdNetworkConversionValueSchema.

get

 Busca un solo SKAdNetworkConversionValueSchema.

list

 Se muestra SKAdNetworkConversionValueSchema en una transmisión.

patch

 Actualiza un SKAdNetworkConversionValueSchema.