Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Cria ou atualiza o CustomerSkAdNetworkConversionValueSchema.

Lista de erros gerados: AuthenticationError AuthorizationError FieldError InternalError MutateError

Solicitação HTTP

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
customerId

string

O ID do cliente cujos conjuntos compartilhados estão sendo modificados.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
Campos
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

A operação a ser executada.
validateOnly

boolean

Se verdadeiro, a solicitação é validada, mas não executada. Somente erros são retornados, não resultados.
enableWarnings

boolean

Opcional. Se verdadeiro, ativa o retorno de avisos. Os avisos retornam mensagens e códigos de erro sem bloquear a execução da operação mutate.

Corpo da resposta

Mensagem de resposta para customerSkAdNetworkConversionValueSchemas.mutate.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
Campos
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Todos os resultados de mutate.
warning

object (Status)

Erros sem bloqueio que fornecem detalhes da falha na validação do esquema. Retornado apenas quando enableWarnings = true.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/adwords

Para mais informações, consulte a Visão geral do OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Uma única operação de atualização para um CustomerSkAdNetworkConversionValueSchema.

Representação JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Campos
update

object (CustomerSkAdNetworkConversionValueSchema)

Operação de atualização: o esquema precisa ter um nome de recurso válido.

CustomerSkAdNetworkConversionValueSchema

Um CustomerSkAdNetworkConversionValueSchema.

Representação JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Campos
resourceName

string

Apenas saída. O nome do recurso do esquema. Os nomes dos recursos CustomerSkAdNetworkConversionValueSchema têm o formato: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Apenas saída. O esquema do recurso especificado.

SkAdNetworkConversionValueSchema

O SkAdNetworkConversionValueSchema específico do CustomerLink.

Representação JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Campos
appId

string

Obrigatório. Apenas saída. ID do aplicativo da Apple App Store.
measurementWindowHours

integer

Apenas saída. Um período (medido em horas) pós-instalação, após a instalação, em que o parceiro de atribuição de app ou o anunciante param de chamar updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Apenas saída. Mapeamentos refinados do valor da conversão. Para versões da SkAdNetwork >= 4.0 compatíveis com várias janelas de conversão, os mapeamentos refinados do valor da conversão são aplicáveis apenas ao primeiro postback.
postbackMappings[]

object (PostbackMapping)

Apenas saída. Mapeamentos de valor da conversão por postback para postbacks em várias janelas de conversão. Aplicável somente para versões da SkAdNetwork >= 4.0.

FineGrainedConversionValueMappings

Mapeamentos para valor de conversão refinado.

Representação JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Campos
fineGrainedConversionValue

integer

Apenas saída. Valor da conversão granular. Os valores válidos estão no intervalo inclusivo [0,63].
conversionValueMapping

object (ConversionValueMapping)

Apenas saída. Eventos de conversão aos quais o valor da conversão detalhado está mapeado.

ConversionValueMapping

Representa o mapeamento de um valor de conversão para um ou mais eventos de conversão.

Representação JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Campos
minTimePostInstallHours

string (int64 format)

Apenas saída. O mínimo do período em que um usuário esteve ativo pela última vez durante a janela de medição.
maxTimePostInstallHours

string (int64 format)

Apenas saída. O máximo do período em que um usuário esteve ativo pela última vez durante a janela de medição.
mappedEvents[]

object (Event)

Apenas saída. O valor da conversão pode ser mapeado para vários eventos com diversos atributos.

Evento

Define um evento de conversão do Google para o qual o valor da conversão é mapeado.

Representação JSON 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Campos
mappedEventName

string

Apenas saída. Nome do evento do Google representado por esse valor de conversão.
currencyCode

string

Apenas saída. A moeda informada para event_revenue. Código de moeda de três letras do ISO 4217, por exemplo, "USD"
Campo de união revenue_rate. Um intervalo ou um valor específico para a receita do evento. revenue_rate pode ser apenas de um dos tipos a seguir:
eventRevenueRange

object (RevenueRange)

Apenas saída. Intervalo de receita do evento.
eventRevenueValue

number

Apenas saída. O valor da receita do evento específico.
Campo de união event_rate. Um intervalo ou um valor específico para o contador de eventos. event_rate pode ser apenas de um dos tipos a seguir:
eventOccurrenceRange

object (EventOccurrenceRange)

Apenas saída. Intervalo do contador de eventos.
eventCounter

string (int64 format)

Apenas saída. Para valores específicos do contador de eventos.

RevenueRange

Define um intervalo para os valores de receita.

Representação JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Campos
minEventRevenue

number

Apenas saída. Para intervalos de receita, é o valor mínimo em currencyCode em que o valor da conversão seria atualizado. Um valor de 0 será tratado como não definido.
maxEventRevenue

number

Apenas saída. Para intervalos de receita, é o valor máximo em currencyCode em que o valor da conversão seria atualizado. Um valor de 0 será tratado como não definido.

EventOccurrenceRange

Define um intervalo para os valores do contador de eventos.

Representação JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Campos
minEventCount

string (int64 format)

Apenas saída. Para intervalos de contador de eventos, o mínimo do intervalo definido. Um valor de 0 será tratado como não definido.
maxEventCount

string (int64 format)

Apenas saída. Para intervalos de contador de eventos, o máximo do intervalo definido. Um valor de 0 será tratado como não definido.

PostbackMapping

Mapeamentos para cada postback em várias janelas de conversão.

Representação JSON 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Campos
postbackSequenceIndex

integer

Apenas saída. Um índice com base em zero que indica a ordem do postback. Os valores válidos estão no intervalo inclusivo [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Apenas saída. Mapeamentos de valor da conversão para todos os valores de conversão aproximados.
Campo de união lock_window_trigger. Valor da conversão ou evento usado para bloquear a janela de conversão. lock_window_trigger pode ser apenas de um dos tipos a seguir:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Apenas saída. Valor de conversão granular que aciona o bloqueio da janela de conversão.
lockWindowFineConversionValue

integer

Apenas saída. Valor de conversão granular que aciona o bloqueio da janela de conversão.
lockWindowEvent

string

Apenas saída. Nome do evento que aciona o bloqueio da janela de conversão.

CoarseGrainedConversionValueMappings

Mapeamentos para valores de conversão aproximados.

Representação JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Campos
lowConversionValueMapping

object (ConversionValueMapping)

Apenas saída. Mapeamento para valor aproximado da conversão "baixo".
mediumConversionValueMapping

object (ConversionValueMapping)

Apenas saída. Mapeamento para valor aproximado da conversão "médio".
highConversionValueMapping

object (ConversionValueMapping)

Apenas saída. Mapeamento para valor aproximado da conversão "alto".

MutateCustomerSkAdNetworkConversionValueSchemaResult

O resultado para a mutate do CustomerSkAdNetworkConversionValueSchema.

Representação JSON 
{
  "resourceName": string,
  "appId": string
}
Campos
resourceName

string

Nome do recurso do cliente que foi modificado.
appId

string

ID do app do SkanConversionValue modificado.