REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Risorsa: SKAdNetworkConversionValueSchema

Schema del valore 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

Solo output. Nome risorsa dello schema. Sarà l'elemento figlio SOLO di uno stream iOS e può esserci al massimo uno di questi stream in uno stream iOS. Formato: Properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Obbligatoria. Le impostazioni del valore di conversione per la prima finestra di postback. Questi differiscono dai valori della finestra di postback 2 e 3 in quanto contengono un valore di conversione granulare "fine" (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 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 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. È consentito configurare la finestra 3 senza impostare la finestra 2. Se le impostazioni delle finestre 1 e 2 sono configurate e il valore di 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 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 di conversione di SKAdNetwork.

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

object (ConversionValues)

L'ordine dei campi ripetuti verrà utilizzato per assegnare la priorità alle impostazioni dei valori di conversione. Le voci indicizzate più basse hanno la priorità più alta. Verrà selezionata la prima impostazione del valore di conversione che restituisce true. Deve contenere almeno una voce se allow_postback_window_settings è impostato su true. Può includere 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 e lo schema di esportazione 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 valido 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)

Obbligatoria. Un valore di conversione approssimativo.

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

object (EventMapping)

Condizioni dell'evento che devono essere soddisfatte per ottenere questo valore di conversione. Le condizioni in questo elenco sono collegate tra loro tramite AND. Deve contenere un minimo di 1 e un massimo di 3 voci, se la finestra di postback è attivata.
lockEnabled

boolean

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

integer

Il valore di conversione granulare. Si applica solo alla prima finestra di postback. I suoi valori validi sono [0,63], entrambi inclusi. Deve essere impostato per la finestra di postback 1 e non 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 alla chiamata dell'SDK updatePostbackConversionValue quando una condizione ConversionValues.event_mappings è soddisfatta. Per ulteriori informazioni, consulta SKAdNetwork.CoarseConversionValue.

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

EventMapping

Condizioni di impostazione dell'evento in modo che corrispondano a un evento.

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

string

Obbligatoria. 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)

Devi impostare almeno uno dei seguenti quattro valori min/max. I valori impostati verranno uniti tra loro tramite AND per qualificare un evento. Il numero minimo di volte in cui si è verificato l'evento. Se non viene configurato, 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 viene controllato.
minEventValue

number

Le entrate minime generate a causa dell'evento. La valuta delle entrate verrà definita a livello di proprietà. Se non viene configurato, 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 di destinazione.

get

 Cerca un singolo SKAdNetworkConversionValueSchema.

list

 Elenca SKAdNetworkConversionValueSchema in un flusso.

patch

 Aggiorna SKAdNetworkConversionValueSchema.