REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Risorsa: SKAdNetworkConversionValueSchema

Schema dei valori di conversione di SKAdNetwork di uno stream iOS.

Rappresentazione JSON 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Campi
name

string

Identificatore. Nome della risorsa dello schema. Questo sarà un elemento secondario SOLO di uno stream iOS e può esserci al massimo un elemento secondario di questo tipo in uno stream iOS. Formato: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Obbligatorio. Le impostazioni del valore di conversione per la prima finestra di postback. Questi valori differiscono da quelli delle finestre di postback 2 e 3 in quanto contengono un valore di conversione granulare "Fine" (un valore numerico).

I valori di conversione per questa finestra di postback devono essere impostati. Le altre finestre sono facoltative e possono ereditare le impostazioni di questa finestra se non sono impostate o disattivate.
postbackWindowTwo

object (PostbackWindow)

Le impostazioni del valore di conversione per la seconda finestra di postback.

Questo campo deve essere configurato solo se è necessario definire valori di conversione diversi per questa finestra di postback.

Se enable_postback_window_settings è impostato su false per questa finestra di postback, verranno utilizzati i valori di postbackWindowOne.
postbackWindowThree

object (PostbackWindow)

Le impostazioni del valore di conversione per la terza finestra di postback.

Questo campo deve essere impostato solo se l'utente ha scelto di definire valori di conversione diversi per questa finestra di postback. È consentito configurare la finestra 3 senza impostare la finestra 2. Se le impostazioni delle finestre 1 e 2 sono impostate e enable_postback_window_settings per questa finestra di postback è impostato su false, lo schema erediterà le impostazioni da postbackWindowTwo.
applyConversionValues

boolean

Se attivato, l'SDK GA imposterà i valori di conversione utilizzando questa definizione dello schema e lo schema verrà esportato in tutti gli account Google Ads collegati a questa proprietà. Se disattivato, l'SDK GA non imposterà automaticamente i valori di conversione e lo schema non verrà esportato in Google Ads.

PostbackWindow

Impostazioni per una finestra di postback delle conversioni SKAdNetwork.

Rappresentazione JSON 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Campi
conversionValues[]

object (ConversionValues)

L'ordine del campo ripetuto verrà utilizzato per dare la priorità alle impostazioni del valore di conversione. Le voci con indice più basso hanno una priorità più alta. Verrà selezionata la prima impostazione del valore di conversione che restituisce il valore true. Deve avere almeno una voce se enable_postback_window_settings è impostato su true. Può contenere un massimo di 128 voci.
postbackWindowSettingsEnabled

boolean

Se enable_postback_window_settings è true, conversionValues deve essere compilato e verrà utilizzato per determinare quando e come impostare il valore di conversione su un dispositivo client ed esportare lo schema negli account Google Ads collegati. Se il valore è false, le impostazioni non vengono utilizzate, ma vengono conservate nel caso in cui possano essere utilizzate in futuro. Questo deve essere sempre vero per postbackWindowOne.

ConversionValues

Impostazioni del valore di conversione per una finestra di postback per lo schema del valore di conversione di SKAdNetwork.

Rappresentazione JSON 
{
  "displayName": string,
  "coarseValue": enum (CoarseValue),
  "eventMappings": [
    {
      object (EventMapping)
    }
  ],
  "lockEnabled": boolean,
  "fineValue": integer
}
Campi
displayName

string

Nome visualizzato del valore di conversione SKAdNetwork. La lunghezza massima consentita del nome visualizzato è di 50 unità di codice UTF-16.
coarseValue

enum (CoarseValue)

Obbligatorio. Un valore di conversione a granularità grossa.

Non è garantito che questo valore sia univoco.
eventMappings[]

object (EventMapping)

Condizioni dell'evento che devono essere soddisfatte per raggiungere questo valore di conversione. Le condizioni in questo elenco sono collegate mediante l'operatore di tipo E. Se la finestra di postback è abilitata, deve contenere un minimo di 1 e un massimo di 3 voci.
lockEnabled

boolean

Se è true, l'SDK deve bloccare questo valore di conversione per la finestra di postback corrente.
fineValue

integer

Il valore di conversione granulare. Questo vale solo per la prima finestra di postback. I valori validi sono [0,63], entrambi inclusi. Deve essere impostato per la finestra di postback 1 e non deve essere impostato per le finestre di postback 2 e 3. Non è garantito che questo valore sia univoco.

Se la configurazione della prima finestra di postback viene riutilizzata per la seconda o la terza finestra di postback, questo campo non ha effetto.

CoarseValue

Il valore di conversione approssimativo impostato nella chiamata SDK updatePostbackConversionValue quando le condizioni di ConversionValues.event_mappings sono soddisfatte. Per saperne di più, consulta SKAdNetwork.CoarseConversionValue.

Enum
COARSE_VALUE_UNSPECIFIED Valore approssimativo non specificato.
COARSE_VALUE_LOW Valore approssimativo di basso.
COARSE_VALUE_MEDIUM Valore approssimativo del mezzo.
COARSE_VALUE_HIGH Valore approssimativo di alto.

EventMapping

Condizioni di impostazione degli eventi per la corrispondenza di un evento.

Rappresentazione JSON 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Campi
eventName

string

Obbligatorio. Nome dell'evento Google Analytics. Deve essere sempre impostato. La lunghezza massima consentita del nome visualizzato è di 40 unità di codice UTF-16.
minEventCount

string (int64 format)

Deve essere impostato almeno uno dei seguenti quattro valori min/max. I valori impostati verranno combinati con l'operatore AND per qualificare un evento. Il numero minimo di volte in cui si è verificato l'evento. Se non viene impostato, il conteggio minimo degli eventi non verrà controllato.
maxEventCount

string (int64 format)

Il numero massimo di volte in cui si è verificato l'evento. Se non viene impostato, il conteggio massimo degli eventi non verrà controllato.
minEventValue

number

Le entrate minime generate a causa dell'evento. La valuta delle entrate verrà definita a livello di proprietà. Se non è impostato, il valore minimo dell'evento non verrà controllato.
maxEventValue

number

Le entrate massime generate grazie all'evento. La valuta delle entrate verrà definita a livello di proprietà. Se non è impostato, il valore massimo dell'evento non verrà controllato.

Metodi

create

 Crea uno schema SKAdNetworkConversionValueSchema.

delete

 Elimina lo schema SKAdNetworkConversionValueSchema di destinazione.

get

 Cerca un singolo SKAdNetworkConversionValueSchema.

list

 Elenca SKAdNetworkConversionValueSchema in un flusso.

patch

 Aggiorna uno schema del valore di conversione SKAdNetwork.