REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Recurso: SKAdNetworkConversionValueSchema

Esquema de valor de conversión de SKAdNetwork de un flujo de iOS.

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

string

Es el identificador. Es el nombre del recurso del esquema. Será un elemento secundario SOLO de un flujo de iOS, y puede haber como máximo uno de esos elementos secundarios en un flujo de iOS. Formato: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Obligatorio. Es la configuración del valor de conversión para la primera ventana de devolución de llamada. Estos difieren de los valores de la segunda y tercera ventanas de devolución de llamada en que contienen un valor de conversión "preciso" (un valor numérico).

Se deben establecer los valores de conversión para esta ventana de devolución de llamada. Las otras ventanas son opcionales y pueden heredar la configuración de esta ventana si no se establecen o se inhabilitan.
postbackWindowTwo

object (PostbackWindow)

Es la configuración del valor de conversión para la segunda ventana de devolución de llamada.

Este campo solo se debe configurar si es necesario definir valores de conversión diferentes para esta ventana de devolución de llamada.

Si enable_postback_window_settings se establece en falso para esta ventana de devolución de llamada, se usarán los valores de postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

Es la configuración del valor de conversión para la tercera ventana de devolución de llamada.

Este campo solo se debe establecer si el usuario eligió definir valores de conversión diferentes para esta ventana de devolución de llamada. Se permite configurar la ventana 3 sin establecer la ventana 2. En caso de que se establezca la configuración de las ventanas 1 y 2, y enable_postback_window_settings para esta ventana de devolución de llamada se establezca en falso, el esquema heredará la configuración de postbackWindowTwo.
applyConversionValues

boolean

Si está habilitado, el SDK de GA establecerá valores de conversión con esta definición de esquema, y el esquema se exportará a las cuentas de Google Ads vinculadas a esta propiedad. Si está inhabilitado, el SDK de GA no establecerá automáticamente valores de conversión, y el esquema tampoco se exportará a Ads.

PostbackWindow

Es la configuración de una ventana de devolución de llamada de conversión de SKAdNetwork.

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

object (ConversionValues)

El orden del campo repetido se usará para priorizar la configuración del valor de conversión. Las entradas indexadas más bajas tienen una prioridad más alta. Se seleccionará la primera configuración del valor de conversión que se evalúe como verdadera. Debe tener al menos una entrada si enable_postback_window_settings se establece en verdadero. Puede tener un máximo de 128 entradas.
postbackWindowSettingsEnabled

boolean

Si enable_postback_window_settings es verdadero, se debe completar conversionValues y se usará 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 Ads vinculadas. Si es falso, la configuración no se usa, pero se conserva en caso de que se pueda usar en el futuro. Siempre debe ser verdadero para postbackWindowOne.

ConversionValues

Es la configuración del valor de conversión para una ventana de devolución de llamada 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

Es el 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 general.

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

object (EventMapping)

Son las condiciones de eventos que se deben cumplir para alcanzar este valor de conversión. Las condiciones de esta lista se combinan con el operador AND. Debe tener un mínimo de 1 entrada y un máximo de 3 entradas si la ventana de devolución de llamada está habilitada.
lockEnabled

boolean

Si es verdadero, el SDK debe bloquearse en este valor de conversión para la ventana de devolución de llamada actual.
fineValue

integer

Es el valor de conversión preciso. Esto solo se aplica a la primera ventana de devolución de llamada. Sus valores válidos son [0,63], ambos inclusive. Se debe establecer para la ventana de devolución de llamada 1 y no se debe establecer para las ventanas de devolución de llamada 2 y 3. No se garantiza que este valor sea único.

Si la configuración de la primera ventana de devolución de llamada se vuelve a usar para la segunda o tercera ventanas de devolución de llamada, este campo no tiene ningún efecto.

CoarseValue

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

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

EventMapping

Son las condiciones de configuración de eventos para que coincidan 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 Google Analytics. Siempre se debe establecer. 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ín./máx. Los valores establecidos se combinarán con el operador AND para calificar un evento. Es la cantidad mínima de veces que ocurrió el evento. Si no se establece, no se verificará la cantidad mínima de eventos.
maxEventCount

string (int64 format)

Es la cantidad máxima de veces que ocurrió el evento. Si no se establece, 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 se establece, 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 se establece, no se verificará el valor máximo del evento.

Métodos

create

 Crea un SKAdNetworkConversionValueSchema.

delete

 Borra el SKAdNetworkConversionValueSchema de destino.

get

 Busca un solo SKAdNetworkConversionValueSchema.

list

 Muestra SKAdNetworkConversionValueSchema en un flujo.

patch

 Actualiza un SKAdNetworkConversionValueSchema.