REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Recurso: SKAdNetworkConversionValueSchema

Esquema de valor da conversão da SKAdNetwork de um fluxo do iOS.

Representação JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Campos
name

string

Identificador. Nome do recurso do esquema. Esse será um filho de APENAS um fluxo do iOS, e poderá haver no máximo um filho desse tipo em um fluxo do iOS. Formato: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Obrigatório. As configurações de valor de conversão para a primeira janela de postback. Elas são diferentes dos valores para as janelas de postback dois e três, porque contêm um valor de conversão "fino" (um valor numérico).

Os valores de conversão para essa janela de postback precisam ser definidos. As outras janelas são opcionais e podem herdar as configurações dessa janela se não forem definidas ou desativadas.
postbackWindowTwo

object (PostbackWindow)

As configurações de valor de conversão para a segunda janela de postback.

Esse campo só precisa ser configurado se houver necessidade de definir valores de conversão diferentes para essa janela de postback.

Se enable_postback_window_settings estiver definido como "false" para essa janela de postback, os valores de postbackWindowOne serão usados.
postbackWindowThree

object (PostbackWindow)

As configurações de valor de conversão para a terceira janela de postback.

Esse campo só precisa ser definido se o usuário escolher definir valores de conversão diferentes para essa janela de postback. É permitido configurar a janela 3 sem definir a janela 2. Caso as configurações das janelas 1 e 2 estejam definidas e enable_postback_window_settings para essa janela de postback esteja definido como "false", o esquema vai herdar as configurações de postbackWindowTwo.
applyConversionValues

boolean

Se ativado, o SDK do GA vai definir valores de conversão usando essa definição de esquema, e o esquema será exportado para todas as contas do Google Ads vinculadas a essa propriedade. Se desativado, o SDK do GA não vai definir valores de conversão automaticamente, e o esquema também não será exportado para o Google Ads.

PostbackWindow

Configurações para uma janela de postback de conversão da SKAdNetwork.

Representação JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Campos
conversionValues[]

object (ConversionValues)

A ordem do campo repetido será usada para priorizar as configurações de valor de conversão. As entradas indexadas mais baixas são priorizadas. A primeira configuração de valor de conversão avaliada como verdadeira será selecionada. Ela precisa ter pelo menos uma entrada se enable_postback_window_settings estiver definido como "true". Ela pode ter no máximo 128 entradas.
postbackWindowSettingsEnabled

boolean

Se enable_postback_window_settings for verdadeiro, conversionValues precisará ser preenchido e será usado para determinar quando e como definir o valor da conversão em um dispositivo cliente e exportar o esquema para contas vinculadas do Google Ads. Se for falso, as configurações não serão usadas, mas serão mantidas caso possam ser usadas no futuro. Isso precisa ser sempre verdadeiro para postbackWindowOne.

ConversionValues

Configurações de valor de conversão para uma janela de postback para o esquema de valor de conversão da SKAdNetwork.

Representação JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Campos
displayName

string

Nome de exibição do valor de conversão da SKAdNetwork. O comprimento máximo permitido do nome de exibição é de 50 unidades de código UTF-16.
coarseValue

enum (CoarseValue)

Obrigatório. Um valor de conversão geral.

Não há garantia de que esse valor seja exclusivo.
eventMappings[]

object (EventMapping)

Condições de evento que precisam ser atendidas para que esse valor de conversão seja alcançado. As condições nessa lista são agrupadas pela condição E. Ela precisa ter no mínimo 1 entrada e no máximo 3 entradas, se a janela de postback estiver ativada.
lockEnabled

boolean

Se for verdadeiro, o SDK precisará ser bloqueado para esse valor de conversão na janela de postback atual.
fineValue

integer

O valor de conversão detalhado. Isso se aplica apenas à primeira janela de postback. Os valores válidos são [0,63], ambos inclusos. Ele precisa ser definido para a janela de postback 1 e não pode ser definido para as janelas de postback 2 e 3. Não há garantia de que esse valor seja exclusivo.

Se a configuração da primeira janela de postback for reutilizada para a segunda ou terceira janela de postback, esse campo não terá efeito.

CoarseValue

O valor de conversão geral definido na chamada do SDK updatePostbackConversionValue quando as condições de ConversionValues.event_mappings são atendidas. Para mais informações, consulte SKAdNetwork.CoarseConversionValue.

Tipos enumerados
COARSE_VALUE_UNSPECIFIED Valor geral não especificado.
COARSE_VALUE_LOW Valor geral baixo.
COARSE_VALUE_MEDIUM Valor geral médio.
COARSE_VALUE_HIGH Valor geral alto.

EventMapping

Condições de configuração de eventos para corresponder a um evento.

Representação JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Campos
eventName

string

Obrigatório. Nome do evento do Google Analytics. Ele precisa ser sempre definido. O comprimento máximo permitido do nome de exibição é de 40 unidades de código UTF-16.
minEventCount

string (int64 format)

Pelo menos um dos quatro valores mínimos/máximos a seguir precisa ser definido. Os valores definidos serão agrupados pela condição E para qualificar um evento. O número mínimo de vezes que o evento ocorreu. Se não for definido, a contagem mínima de eventos não será verificada.
maxEventCount

string (int64 format)

O número máximo de vezes que o evento ocorreu. Se não for definido, a contagem máxima de eventos não será verificada.
minEventValue

number

A receita mínima gerada devido ao evento. A moeda da receita será definida no nível da propriedade. Se não for definido, o valor mínimo do evento não será verificado.
maxEventValue

number

A receita máxima gerada devido ao evento. A moeda da receita será definida no nível da propriedade. Se não for definido, o valor máximo do evento não será verificado.

Métodos

create

 Cria um SKAdNetworkConversionValueSchema.

delete

 Exclui o SKAdNetworkConversionValueSchema de destino.

get

 Procura um único SKAdNetworkConversionValueSchema.

list

 Lista o SKAdNetworkConversionValueSchema em um fluxo.

patch

 Atualiza um SKAdNetworkConversionValueSchema.