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

Apenas saída. Nome do recurso do esquema. Ele será filho APENAS de um fluxo do iOS, e poderá haver no máximo um filho em um stream do iOS. Formato: propriedades/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Obrigatório. As configurações do valor da conversão para a primeira janela de postback. Eles diferem dos valores para a janela de postback dois e três porque contêm uma um valor de conversão granular (um valor numérico).

É necessário definir os valores de conversão para essa janela de postback. As outras janelas são opcionais e poderão herdar as configurações desta janela se não forem definidas ou se forem desativadas.

postbackWindowTwo

object (PostbackWindow)

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

Esse campo só deverá ser configurado se for necessário definir valores de conversão diferentes para a janela de postback.

Se enable_postback_window_settings for definido como falso para esta janela de postback, os valores de postbackWindowOne serão usados.

postbackWindowThree

object (PostbackWindow)

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

Esse campo só deverá ser definido se o usuário tiver optado por definir valores de conversão diferentes para essa janela de postback. É possível configurar a janela 3 sem definir a janela 2. Caso a janela 1 e Duas configurações estão definidas e enable_postback_window_settings para esta janela de postback está definido como falso, o esquema herdará as configurações de postbackWindowTwo.

applyConversionValues

boolean

Se ativado, o SDK do GA define os valores de conversão usando essa definição de esquema, e o esquema é exportado para qualquer conta do Google Ads vinculada a essa propriedade. Se desativado, o SDK do GA não vai definir automaticamente os valores de conversão, e o esquema 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 do valor da conversão. As entradas com indexação mais baixa têm prioridade mais alta. 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 verdadeiro. Ele 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 as contas vinculadas do Google Ads. Se for falso, as configurações não serão usadas, mas serão retidas caso possam ser usadas no futuro. Precisa ser sempre verdadeiro para postbackWindowOne.

ConversionValues

Configurações do valor da conversão para uma janela de postback para o esquema de valor da 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 da 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 com baixa granularidade.

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

eventMappings[]

object (EventMapping)

Condições do evento que precisam ser atendidas para que esse valor da conversão seja alcançado. As condições nesta lista são unidas por AND. Ela precisa ter no mínimo uma entrada e no máximo três se a janela de postback estiver ativada.

lockEnabled

boolean

Se for verdadeiro, o SDK deverá bloquear esse valor de conversão para a janela de postback atual.

fineValue

integer

O valor de conversão detalhado. Aplicável apenas à primeira janela de postback. Seus valores válidos são [0,63], ambos inclusivos. Ele deve ser definido para a janela de postback 1 e não para a janela de postback 2 & 3: Não há garantia de que esse valor seja exclusivo.

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

CoarseValue

O valor de conversão aproximado definido na chamada do SDK updatePostbackConversionValue quando uma condição ConversionValues.event_mappings é atendida. Para mais informações, consulte SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED O valor aproximado não foi especificado.
COARSE_VALUE_LOW Valor aproximado de "Baixo".
COARSE_VALUE_MEDIUM Valor aproximado da mídia.
COARSE_VALUE_HIGH Valor aproximado de "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 GA4. Ele precisa ser definido sempre. 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ínimo/máximo a seguir precisa ser definido. Os valores definidos serão combinados pelo AND para qualificar um evento. O número mínimo de vezes que o evento ocorreu. Se ela não for definida, 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 ela não for definida, a contagem máxima de eventos não será verificada.

minEventValue

number

É a receita mínima gerada devido ao evento. A moeda da receita é definida no nível da propriedade. Se ela for deixada sem definição, o valor mínimo do evento não será verificado.

maxEventValue

number

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

Métodos

create

Cria um SKAdNetworkConversionValueSchema.

delete

Exclui o SKAdNetworkConversionValueSchema desejado.

get

Procura um único SKAdNetworkConversionValueSchema.

list

Lista SKAdNetworkConversionValueSchema em um stream.

patch

Atualiza um SKAdNetworkConversionValueSchema.