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

Solo salida. Nombre de recurso del esquema. Esto 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. Es la configuración del valor de conversión para el primer período de notificación de conversión. Difieren de los valores para los períodos de notificación de conversión dos y tres porque contienen un valor "Fino". un valor de conversión detallado (un valor numérico).

Se deben establecer los valores de conversión para este período de notificación. Las otras ventanas son opcionales y pueden heredar la configuración de esta ventana si no la estableces o la inhabilitas.

postbackWindowTwo

object (PostbackWindow)

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

Este campo solo debe configurarse si es necesario definir valores de conversión diferentes 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)

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

Este campo solo debe establecerse si el usuario decidió definir diferentes valores de conversión para este período de notificación. Se permite configurar la ventana 3 sin configurar la ventana 2. En caso de las ventanas 1 y Se establecieron 2 parámetros de configuración y enable_postback_window_settings para este período de notificación de conversión se establece en falso, 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 cualquier cuenta de Google Ads vinculada a esta propiedad. Si se inhabilita, el SDK de Google Analytics no establecerá automáticamente los valores de conversión y, además, el esquema no se exportará a Google Ads.

PostbackWindow

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

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

object (ConversionValues)

El orden del campo repetido se utilizará para priorizar la configuración del valor de conversión. Las entradas indexadas más bajas tienen mayor prioridad. 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 como 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 cuentas de Google Ads vinculadas. Si es falso, la configuración no se usa, 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 para 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. 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 unen mediante el operador Y. Debe tener un mínimo de 1 entrada y un máximo de 3, si el período de notificació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 solo se aplica al primer período de notificación de conversión. Sus valores válidos son [0,63], ambos inclusivos. Se debe establecer para el período de notificación de conversión 1, pero no para el período de notificación de conversión 2 ni 3) No se garantiza que este valor sea único.

Si se vuelve a usar la configuración del primer período de notificación de conversión para el segundo o tercer período de notificación de conversión, este campo no tendrá efecto.

CoarseValue

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

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

EventMapping

Son las condiciones de configuración de eventos que coinciden 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 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ínimos o máximos. Los valores establecidos se combinarán con el operador Y para calificar un evento. Indica la cantidad mínima de veces que ocurrió el evento. Si no la estableces, 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 la estableces, no se verificará la cantidad máxima de eventos.

minEventValue

number

Indica 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

Indica la cantidad máxima de ingresos 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

Borra el objetivo SKAdNetworkConversionValueSchema.

get

Busca un solo SKAdNetworkConversionValueSchema.

list

Se muestra una lista de SKAdNetworkConversionValueSchema en un flujo.

patch

Actualiza un SKAdNetworkConversionValueSchema.