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 risorsa dello schema. Sarà l'elemento secondario SOLO di uno stream iOS e può esserci al massimo uno di questo elemento secondario in uno stream iOS. Formato: proprietà/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

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

È necessario impostare i valori di conversione per questa finestra di postback. Le altre finestre sono facoltative e potrebbero ereditare le impostazioni di questa finestra se non vengono configurate 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 allow_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. Può configurare la finestra 3 senza impostare la finestra 2. Nel caso finestra 1 e Sono state configurate due impostazioni e il valore 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 di schema e lo schema verrà esportato in qualsiasi account Google Ads collegato a questa proprietà. Se la disattivi, 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 per le conversioni di SKAdNetwork.

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

object (ConversionValues)

L'ordine del campo ripetuto verrà utilizzato per assegnare la priorità alle impostazioni del valore di conversione. Le voci indicizzate più basse hanno una priorità più alta. Verrà selezionata la prima impostazione del valore di conversione che restituisce come valore true. Deve avere almeno una voce se allow_postback_window_settings è impostato su true. Può avere un massimo di 128 voci.

postbackWindowSettingsEnabled

boolean

Se allow_postback_window_settings è true, il valore di conversione deve essere compilato 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 il criterio è impostato su false, le impostazioni non vengono utilizzate, ma vengono conservate in caso di utilizzo futuro. Questo deve sempre essere 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 di SKAdNetwork. La lunghezza massima consentita per il nome visualizzato è di 50 unità di codice UTF-16.

coarseValue

enum (CoarseValue)

Obbligatorio. Un valore di conversione approssimativo.

Non è garantito che questo valore sia univoco.

eventMappings[]

object (EventMapping)

Condizioni evento che devono essere soddisfatte per ottenere questo valore di conversione. Le condizioni in questo elenco sono correlate con una relazione AND. Deve avere un minimo di 1 voce e un massimo di 3 voci, se la finestra di postback è abilitata.

lockEnabled

boolean

Se impostato su true, l'SDK si blocca 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 per la finestra di postback 2 & 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 nella chiamata all'SDK updatePostbackConversionValue quando sono soddisfatte una condizione ConversionValues.event_mappings. Per ulteriori informazioni, consulta SKAdNetwork.CoarseConversionValue.

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

EventMapping

Condizioni di impostazione dell'evento per la corrispondenza con un evento.

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

string

Obbligatorio. Nome dell'evento GA4. Deve essere sempre impostato. La lunghezza massima consentita per il nome visualizzato è di 40 unità di codice UTF-16.

minEventCount

string (int64 format)

È necessario impostare almeno uno dei seguenti quattro valori min/max. I valori impostati saranno collegati tramite una relazione di tipo AND per qualificare un evento. Il numero minimo di volte in cui si è verificato l'evento. Se non viene 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 viene configurato, il numero 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 viene impostato, il valore minimo dell'evento non verrà controllato.

maxEventValue

number

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

Metodi

create

Crea un SKAdNetworkConversionValueSchema.

delete

Elimina SKAdNetworkConversionValueSchema.

get

Cerca un singolo SKAdNetworkConversionValueSchema.

list

Elenca SKAdNetworkConversionValueSchema in uno stream.

patch

Aggiorna uno SKAdNetworkConversionValueSchema.