REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Recurso: SKAdNetworkConversionValueSchema

Esquema de valor da conversão da SKAdNetwork de um stream 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 SOMENTE de um fluxo do iOS, e pode haver no máximo uma dessas crianças em um fluxo do iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Obrigatório. As configurações do valor da conversão para a primeira janela de postback. Eles são diferentes dos valores das janelas de postback 2 e 3 porque contêm um valor de conversão "Fine" (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 desta janela se não forem definidas ou desativadas.

postbackWindowTwo

object (PostbackWindow)

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

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

Se enable_postback_window_settings for definido como "false" para essa 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ó vai 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 da janela 1 e 2 estejam definidas e enable_postback_window_settings para essa janela de postback esteja definida como "false", o esquema vai herdar as configurações de postbackWindowTwo.

applyConversionValues

boolean

Se ativada, o SDK do GA vai definir os valores de conversão usando essa definição de esquema, que será exportada para todas as contas do Google Ads vinculadas 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 índices mais baixos têm prioridade maior. A primeira configuração de valor de conversão que for avaliada como verdadeira será selecionada. Ele precisa ter pelo menos uma entrada se enable_postback_window_settings estiver definido como "true". Ele pode ter no máximo 128 entradas.

postbackWindowSettingsEnabled

boolean

Se enable_postback_window_settings for verdadeiro, os valores de conversão precisarão ser preenchidos e serão usados 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 para uso futuro. Isso precisa ser sempre verdadeiro para postbackWindowOne.

ConversionValues

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

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 desta lista são agrupadas pela condição E. Ela precisa ter no mínimo uma entrada e no máximo três entradas, se a janela de postback estiver ativada.

lockEnabled

boolean

Se for true, o SDK vai ser bloqueado para esse valor de conversão na janela de postback atual.

fineValue

integer

O valor de conversão detalhado. Isso é aplicável apenas à primeira janela de postback. Os valores válidos são [0,63]. Ele precisa ser definido para a janela de postback 1, mas não para as janelas 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 aproximado definido na chamada do SDK updatePostbackConversionValue quando uma das condições ConversionValues.event_mappings é atendida. Para mais informações, consulte SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED O valor grosseiro não foi especificado.
COARSE_VALUE_LOW Valor aproximado de baixo.
COARSE_VALUE_MEDIUM Valor aproximado do meio.
COARSE_VALUE_HIGH Valor aproximado de alto.

EventMapping

Configura as condições de um evento 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ínimo/máximo a seguir precisa ser definido. Os valores definidos serão combinados com o operador "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 SKAdNetworkConversionValueSchema em um fluxo.

patch

Atualiza um SKAdNetworkConversionValueSchema.