- Solicitação HTTP
- Parâmetros de caminho
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- CustomerSkAdNetworkConversionValueSchemaOperation
- CustomerSkAdNetworkConversionValueSchema
- SkAdNetworkConversionValueSchema
- FineGrainedConversionValueMappings
- ConversionValueMapping
- Evento
- RevenueRange
- EventOccurrenceRange
- PostbackMapping
- CoarseGrainedConversionValueMappings
- MutateCustomerSkAdNetworkConversionValueSchemaResult
- Faça um teste
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 |
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 ( |
Campos | |
---|---|
operation |
A operação a ser executada. |
validateOnly |
Se verdadeiro, a solicitação é validada, mas não executada. Somente erros são retornados, não resultados. |
enableWarnings |
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 ( |
Campos | |
---|---|
result |
Todos os resultados de mutate. |
warning |
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 ( |
Campos | |
---|---|
update |
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 ( |
Campos | |
---|---|
resourceName |
Apenas saída. O nome do recurso do esquema. Os nomes dos recursos CustomerSkAdNetworkConversionValueSchema têm o formato: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId} |
schema |
Apenas saída. O esquema do recurso especificado. |
SkAdNetworkConversionValueSchema
O SkAdNetworkConversionValueSchema específico do CustomerLink.
Representação JSON |
---|
{ "appId": string, "measurementWindowHours": integer, "fineGrainedConversionValueMappings": [ { object ( |
Campos | |
---|---|
appId |
Obrigatório. Apenas saída. ID do aplicativo da Apple App Store. |
measurementWindowHours |
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[] |
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[] |
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 ( |
Campos | |
---|---|
fineGrainedConversionValue |
Apenas saída. Valor da conversão granular. Os valores válidos estão no intervalo inclusivo [0,63]. |
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 ( |
Campos | |
---|---|
minTimePostInstallHours |
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 |
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[] |
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 |
Campos | |
---|---|
mappedEventName |
Apenas saída. Nome do evento do Google representado por esse valor de conversão. |
currencyCode |
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 |
Apenas saída. Intervalo de receita do evento. |
eventRevenueValue |
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 |
Apenas saída. Intervalo do contador de eventos. |
eventCounter |
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 |
Apenas saída. Para intervalos de receita, é o valor mínimo em |
maxEventRevenue |
Apenas saída. Para intervalos de receita, é o valor máximo em |
EventOccurrenceRange
Define um intervalo para os valores do contador de eventos.
Representação JSON |
---|
{ "minEventCount": string, "maxEventCount": string } |
Campos | |
---|---|
minEventCount |
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 |
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 ( |
Campos | |
---|---|
postbackSequenceIndex |
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 |
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 |
Apenas saída. Valor de conversão granular que aciona o bloqueio da janela de conversão. |
lockWindowFineConversionValue |
Apenas saída. Valor de conversão granular que aciona o bloqueio da janela de conversão. |
lockWindowEvent |
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 ( |
Campos | |
---|---|
lowConversionValueMapping |
Apenas saída. Mapeamento para valor aproximado da conversão "baixo". |
mediumConversionValueMapping |
Apenas saída. Mapeamento para valor aproximado da conversão "médio". |
highConversionValueMapping |
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 |
Nome do recurso do cliente que foi modificado. |
appId |
ID do app do SkanConversionValue modificado. |