REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Risorsa: SKAdNetworkConversionValueSchema

Schema del valore di conversione di SKAdNetwork di uno stream per iOS.

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

string

Solo output. Nome della risorsa dello schema. Sarà un elemento secondario SOLO di uno stream per iOS e può essere presente al massimo un elemento secondario di questo tipo in uno stream per iOS. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Obbligatorio. Le impostazioni del valore di conversione per la prima finestra di postback. Questi valori sono diversi da quelli per la finestra 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 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 della finestra 1 e 2 sono impostate e l'opzione enable_postback_window_settings per questa finestra di postback è impostata su false, lo schema erediterà le impostazioni da postbackWindowTwo.

applyConversionValues

boolean

Se è attivato, l'SDK GA imposta i valori di conversione utilizzando questa definizione di schema, che verrà esportata in tutti gli account Google Ads collegati a questa proprietà. Se questa impostazione non è attiva, l'SDK GA non imposta automaticamente i valori di conversione e lo schema non viene esportato in Google Ads.

PostbackWindow

Impostazioni per una finestra di postback delle conversioni di SKAdNetwork.

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

object (ConversionValues)

L'ordinamento del campo ripetuto verrà utilizzato per dare la priorità alle impostazioni del valore di conversione. Le voci con un numero inferiore hanno una priorità maggiore. Verrà selezionata la prima impostazione del valore di conversione che restituisce true. Deve contenere almeno una voce se enable_postback_window_settings è impostato su true. Può contenere al massimo 128 voci.

postbackWindowSettingsEnabled

boolean

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

ConversionValues

Impostazioni del valore di conversione per una finestra di postback per lo schema dei valori 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 di SKAdNetwork. La lunghezza massima consentita per il nome visualizzato è 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 degli eventi che devono essere soddisfatte per raggiungere questo valore di conversione. Le condizioni in questo elenco sono collegate mediante l'operatore AND. Deve contenere almeno 1 voce e un massimo di 3 voci, se la finestra di postback è attivata.

lockEnabled

boolean

Se true, l'SDK deve bloccarsi su 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 per la prima finestra di postback viene riutilizzata per la seconda o la terza finestra di postback, questo campo non ha alcun effetto.

CoarseValue

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

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

EventMapping

Condizioni di impostazione evento per trovare una corrispondenza con 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 è 40 unità di codice UTF-16.

minEventCount

string (int64 format)

Deve essere impostato almeno uno dei seguenti quattro valori minimo/massimo. 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 è impostato, il numero minimo di eventi non verrà controllato.

maxEventCount

string (int64 format)

Il numero massimo di volte in cui si è verificato l'evento. Se non è impostato, il conteggio massimo di 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 dall'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 SKAdNetworkConversionValue.

delete

Consente di eliminare lo schema SKAdNetworkConversionValueSchema target.

get

Cerca un singolo SKAdNetworkConversionValueSchema.

list

Elenca SKAdNetworkConversionValueSchema in uno stream.

patch

Aggiorna uno schema SKAdNetworkConversionValue.