Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Crea o aggiorna il CustomerSkAdNetworkConversionValueSchema.

Elenco degli errori generati: AuthenticationError AuthorizationError FieldError InternalError MutateError

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customerId

string

L'ID del cliente i cui set condivisi vengono modificati.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean
}
Campi
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

L'operazione da eseguire.
validateOnly

boolean

Se il valore è true, la richiesta viene convalidata ma non eseguita. Vengono restituiti solo gli errori, non i risultati.

Corpo della risposta

Messaggio di risposta per customerSkAdNetworkConversionValueSchemas.mutate.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  }
}
Campi
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Tutti i risultati per la mutazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Una singola operazione di aggiornamento per uno schema CustomerSkAdNetworkConversionValueSchema.

Rappresentazione JSON 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Campi
update

object (CustomerSkAdNetworkConversionValueSchema)

Operazione di aggiornamento: lo schema deve avere un nome risorsa valido.

CustomerSkAdNetworkConversionValueSchema

Uno schema CustomerSkAdNetworkConversionValueSchema.

Rappresentazione JSON 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Campi
resourceName

string

Solo output. Il nome della risorsa dello schema. I nomi delle risorse CustomerSkAdNetworkConversionValueSchemas hanno il formato: customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}
schema

object (SkAdNetworkConversionValueSchema)

Solo output. Lo schema per la risorsa specificata.

SkAdNetworkConversionValueSchema

Lo schema SkAdNetworkConversionValueSchema specifico per CustomerLink.

Rappresentazione JSON 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ]
}
Campi
appId

string

Obbligatorio. Solo output. ID app di Apple App Store.
measurementWindowHours

integer

Solo output. Una finestra di tempo (misurata in ore) post-installazione, dopo la quale il partner di attribuzione app o l'inserzionista smette di chiamare updateConversionValue.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Solo output. Mappature granulari dei valori di conversione.

FineGrainedConversionValueMappings

Mappature per un valore di conversione granulare.

Rappresentazione JSON 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Campi
fineGrainedConversionValue

integer

Solo output. Valore di conversione granulare. I valori validi sono compresi nell'intervallo incluso [0,63].
conversionValueMapping

object (ConversionValueMapping)

Solo output. Eventi di conversione a cui viene mappato il valore di conversione granulare.

ConversionValueMapping

Rappresenta la mappatura da un valore di conversione a uno o più eventi di conversione.

Rappresentazione JSON 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Campi
minTimePostInstallHours

string (int64 format)

Solo output. Il minimo dell'intervallo di tempo in cui un utente è stato attivo per l'ultima volta durante il periodo di misurazione.
maxTimePostInstallHours

string (int64 format)

Solo output. Il massimo dell'intervallo di tempo in cui un utente è stato attivo per l'ultima volta durante il periodo di misurazione.
mappedEvents[]

object (Event)

Solo output. Il valore di conversione può essere mappato a più eventi con vari attributi.

Evento

Definisce un evento di conversione Google a cui è associato il valore di conversione.

Rappresentazione 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.
}
Campi
mappedEventName

string

Solo output. Nome dell'evento Google rappresentato da questo valore di conversione.
currencyCode

string

Solo output. La valuta del report per event_revenue. Codice valuta ISO 4217 di tre lettere, ad esempio "USD"
Campo di unione revenue_rate. Un intervallo o un valore specifico per le entrate generate dall'evento. revenue_rate può essere solo uno dei seguenti:
eventRevenueRange

object (RevenueRange)

Solo output. L'intervallo di entrate dell'evento.
eventRevenueValue

number

Solo output. Il valore delle entrate specifiche per l'evento.
Campo di unione event_rate. Un intervallo o un valore specifico per il contatore eventi. event_rate può essere solo uno dei seguenti:
eventOccurrenceRange

object (EventOccurrenceRange)

Solo output. L'intervallo del contatore di eventi.
eventCounter

string (int64 format)

Solo output. Per valori specifici del contatore eventi.

RevenueRange

Definisce un intervallo per i valori delle entrate.

Rappresentazione JSON 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Campi
minEventRevenue

number

Solo output. Per le fasce di entrate, il valore minimo in currencyCode per il quale il valore di conversione verrà aggiornato. Un valore pari a 0 verrà considerato non impostato.
maxEventRevenue

number

Solo output. Per le fasce di entrate, il valore massimo in currencyCode per il quale il valore di conversione verrà aggiornato. Un valore pari a 0 verrà considerato non impostato.

EventOccurrenceRange

Definisce un intervallo per i valori del contatore eventi.

Rappresentazione JSON 
{
  "minEventCount": string,
  "maxEventCount": string
}
Campi
minEventCount

string (int64 format)

Solo output. Per gli intervalli del contatore di eventi, il minimo dell'intervallo definito. Un valore pari a 0 verrà considerato non impostato.
maxEventCount

string (int64 format)

Solo output. Per gli intervalli del contatore di eventi, il massimo dell'intervallo definito. Un valore pari a 0 verrà considerato non impostato.

MutateCustomerSkAdNetworkConversionValueSchemaResult

Il risultato della mutazione CustomerSkAdNetworkConversionValueSchema.

Rappresentazione JSON 
{
  "resourceName": string,
  "appId": string
}
Campi
resourceName

string

Nome risorsa del cliente che è stato modificato.
appId

string

ID app di SkanConversionValue modificato.