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/v15/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
}
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.

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)
  }
}
Campos
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Todos os resultados para a função mutate.

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 para o recurso especificado.

SkAdNetworkConversionValueSchema

O SkAdNetworkConversionValueSchema específico do CustomerLink.

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

string

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

integer

Apenas saída. Uma janela de tempo (medida em horas) pós-instalação, após o qual o parceiro de atribuição de app ou o anunciante para de chamar updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Apenas saída. Mapeamentos de valor da conversão refinados.

FineGrainedConversionValueMappings

Mapeamentos para valor de conversão detalhado.

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 para onde o valor de conversão detalhado é 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 este valor de conversão.
currencyCode

string

Apenas saída. A moeda informada para a 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 da 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 do contador de eventos. event_rate pode ser apenas de um dos tipos a seguir:
eventOccurrenceRange

object (EventOccurrenceRange)

Apenas saída. O intervalo do contador de eventos.
eventCounter

string (int64 format)

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

RevenueRange

Define um intervalo de 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.

MutateCustomerSkAdNetworkConversionValueSchemaResult

O resultado da mutação 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.