REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Recurso: SKAdNetworkConversionValueSchema

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

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

string

Solo salida. Es el nombre del recurso del esquema. Será un elemento secundario ÚNICAMENTE de una transmisión para iOS, y puede haber un máximo de un elemento secundario de este tipo en una transmisión para iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Obligatorio. Es la configuración del valor de conversión para la primera ventana de notificación de conversión. Estos difieren de los valores de los períodos dos y tres de la notificación de conversión en que contienen un valor de conversión detallado (un valor numérico).

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

object (PostbackWindow)

Es la configuración del valor de conversión para la segunda ventana 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 "false" para este período de notificación de conversión, se usarán los valores de postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

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

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

boolean

Si está habilitada, el SDK de GA 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 GA no establecerá automáticamente los valores de conversión, y tampoco se exportará el esquema a Google Ads.

PostbackWindow

Configuración de una ventana de notificación 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á 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 es verdadero, se deben propagar conversionValues y 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 falso, no se usa la configuración, pero se retiene en caso de que se use en el futuro. Esto siempre debe ser verdadero para postbackWindowOne.

ConversionValues

Configuración del valor de conversión para un período de notificación de conversión del 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 del evento que se deben cumplir para que se alcance este valor de conversión. Las condiciones de esta lista se combinan con el operador AND. Si la ventana de notificación de conversión está habilitada, debe tener un mínimo de 1 entrada y un máximo de 3.
lockEnabled

boolean

Si es verdadero, el SDK debe bloquearse en este valor de conversión para el período de la notificación de conversión actual.
fineValue

integer

El valor de conversión detallado. Esto solo se aplica a la primera ventana de notificación de conversión. Los valores válidos son [0,63], ambos inclusive. Se debe configurar para el período de la notificación de conversión 1 y no para los períodos 2 y 3. No se garantiza que este valor sea único.

Si la configuración de la primera ventana de notificación de conversión se vuelve a usar para la segunda o tercera ventana, este campo no tiene efecto.

CoarseValue

Es el valor de conversión aproximado 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.

Enumeraciones
COARSE_VALUE_UNSPECIFIED No se especificó el valor aproximado.
COARSE_VALUE_LOW Valor bajo de baja resolución.
COARSE_VALUE_MEDIUM Es el valor aproximado del medio.
COARSE_VALUE_HIGH Valor alto de la escala gruesa.

EventMapping

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 debe estar configurado. 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. Es la cantidad mínima de veces que ocurrió el evento. Si no se establece, no se verificará el recuento mínimo de eventos.
maxEventCount

string (int64 format)

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

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 objetivo.

get

 Busca un solo SKAdNetworkConversionValueSchema.

list

 Enumera SKAdNetworkConversionValueSchema en una transmisión.

patch

 Actualiza un SKAdNetworkConversionValueSchema.