Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Crea o aggiorna CustomerSkAdNetworkConversionValueSchema.

Elenco degli errori generati: AuthenticationError AuthorizationError FieldError InternalError MutateError

Richiesta HTTP

POST https://googleads.googleapis.com/v16/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,
  "enableWarnings": 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.
enableWarnings

boolean

Campo facoltativo. Se il valore è true, consente la restituzione degli avvisi. Gli avvisi restituiscono messaggi e codici di errore senza bloccare l'esecuzione dell'operazione di modifica.

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)
  },
  "warning": {
    object (Status)
  }
}
Campi
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Tutti i risultati per la mutazione.
warning

object (Status)

Errori che non bloccano la convalida dello schema. Restituito solo quando allowalerts = true.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Una singola operazione di aggiornamento di 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 CustomerSkAdNetworkConversionValue.

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

string

Solo output. Il nome della risorsa dello schema. I nomi delle risorse CustomerSkAdNetworkConversionValueSchemas/{accountLinkId} hanno il seguente formato: clienti/{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)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Campi
appId

string

Obbligatoria. Solo output. ID app dell'App Store di Apple.
measurementWindowHours

integer

Solo output. Una finestra temporale (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. Per le versioni di SkAdNetwork successive alla 4.0 che supportano più finestre di conversione, le mappature granulari dei valori di conversione sono applicabili solo al primo postback.
postbackMappings[]

object (PostbackMapping)

Solo output. Mappature dei valori di conversione per postback per i postback in più finestre di conversione. Applicabile solo per le versioni di SkAdNetwork successive alla 4.0.

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 compreso tra [0,63].
conversionValueMapping

object (ConversionValueMapping)

Solo output. Eventi di conversione a cui viene mappato un 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 la finestra 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 la finestra 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 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 dell'evento.
Campo di unione event_rate. Può essere 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 di 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 questo 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 questo 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.

PostbackMapping

Mappature per ogni postback in più finestre di conversione.

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

integer

Solo output. un indice basato su 0 che indica l'ordine dei postback. I valori validi sono compresi nell'intervallo compreso tra [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Solo output. Mappature dei valori di conversione per tutti i valori di conversione granulari.
Campo di unione lock_window_trigger. Evento o valore di conversione utilizzato per bloccare la finestra di conversione. lock_window_trigger può essere solo uno dei seguenti:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Solo output. Valore di conversione approssimativo che attiva il blocco della finestra di conversione.
lockWindowFineConversionValue

integer

Solo output. Valore di conversione granulare che attiva il blocco della finestra di conversione.
lockWindowEvent

string

Solo output. Nome dell'evento che attiva il blocco della finestra di conversione.

CoarseGrainedConversionValueMappings

Mappature per valori di conversione approssimativi.

Rappresentazione JSON 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Campi
lowConversionValueMapping

object (ConversionValueMapping)

Solo output. Mappatura per un valore di conversione approssimativo "basso".
mediumConversionValueMapping

object (ConversionValueMapping)

Solo output. Mappatura del valore di conversione approssimativo "medio".
highConversionValueMapping

object (ConversionValueMapping)

Solo output. Mappatura del valore di conversione approssimativo "alto".

MutateCustomerSkAdNetworkConversionValueSchemaResult

Il risultato per CustomerSkAdNetworkConversionValueSchema muta.

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

string

Nome della risorsa del cliente che è stato modificato.
appId

string

ID app di SkanConversionValue modificato.