REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Ressource: SKAdNetworkConversionValueSchema

SKAdNetwork-Conversion-Wert-Schema eines iOS-Streams.

JSON-Darstellung 
{
  "name": string,
  "postbackWindowOne": {
    object (PostbackWindow)
  },
  "postbackWindowTwo": {
    object (PostbackWindow)
  },
  "postbackWindowThree": {
    object (PostbackWindow)
  },
  "applyConversionValues": boolean
}
Felder
name

string

Nur Ausgabe. Ressourcenname des Schemas. Dieses Element ist NUR ein untergeordnetes Element eines iOS-Streams und es kann maximal ein solches untergeordnetes Element unter einem iOS-Stream geben. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema
postbackWindowOne

object (PostbackWindow)

Erforderlich. Die Einstellungen für den Conversion-Wert für das erste Postback-Fenster. Sie unterscheiden sich von den Werten für die Postback-Fenster 2 und 3 dadurch, dass sie einen detaillierten Conversion-Wert (einen numerischen Wert) enthalten.

Conversion-Werte für dieses Postback-Fenster müssen festgelegt werden. Die anderen Fenster sind optional und übernehmen möglicherweise die Einstellungen dieses Fensters, wenn sie nicht festgelegt oder deaktiviert sind.
postbackWindowTwo

object (PostbackWindow)

Die Einstellungen für den Conversion-Wert für den zweiten Postback-Zeitraum.

Dieses Feld sollte nur konfiguriert werden, wenn für dieses Postback-Fenster unterschiedliche Conversion-Werte definiert werden müssen.

Wenn „enable_postback_window_settings“ für dieses Postback-Fenster auf „false“ gesetzt ist, werden die Werte aus „postbackWindowOne“ verwendet.
postbackWindowThree

object (PostbackWindow)

Die Einstellungen für den Conversion-Wert für das dritte Postback-Fenster.

Dieses Feld sollte nur festgelegt werden, wenn der Nutzer unterschiedliche Conversion-Werte für diesen Postback-Zeitraum definiert hat. Es ist zulässig, Fenster 3 zu konfigurieren, ohne Fenster 2 festzulegen. Wenn die Einstellungen für Fenster 1 und 2 festgelegt sind und „enable_postback_window_settings“ für dieses Postback-Fenster auf „false“ gesetzt ist, werden die Einstellungen aus „postbackWindowTwo“ in das Schema übernommen.
applyConversionValues

boolean

Wenn diese Option aktiviert ist, werden mit dem GA SDK Conversion-Werte anhand dieser Schemadefinition festgelegt. Das Schema wird in alle Google Ads-Konten exportiert, die mit dieser Property verknüpft sind. Wenn diese Option deaktiviert ist, werden Conversion-Werte nicht automatisch vom GA SDK festgelegt und das Schema wird nicht in Google Ads exportiert.

PostbackWindow

Einstellungen für einen SKAdNetwork-Conversion-Postback-Zeitraum.

JSON-Darstellung 
{
  "conversionValues": [
    {
      object (ConversionValues)
    }
  ],
  "postbackWindowSettingsEnabled": boolean
}
Felder
conversionValues[]

object (ConversionValues)

Die Reihenfolge des wiederholten Felds wird verwendet, um die Einstellungen für Conversion-Werte zu priorisieren. Einträge mit niedrigerem Index haben eine höhere Priorität. Die erste Conversion-Werteinstellung, die als „wahr“ ausgewertet wird, wird ausgewählt. Es muss mindestens einen Eintrag enthalten, wenn „enable_postback_window_settings“ auf „true“ gesetzt ist. Sie kann maximal 128 Einträge enthalten.
postbackWindowSettingsEnabled

boolean

Wenn „enable_postback_window_settings“ auf „true“ festgelegt ist, müssen „conversionValues“ ausgefüllt werden. Anhand dieser Werte wird festgelegt, wann und wie der Conversion-Wert auf einem Clientgerät festgelegt und das Schema in verknüpfte Google Ads-Konten exportiert wird. Wenn „false“ festgelegt ist, werden die Einstellungen nicht verwendet, aber beibehalten, falls sie in Zukunft verwendet werden können. Das muss für „postbackWindowOne“ immer der Fall sein.

ConversionValues

Einstellungen für den Conversion-Wert für einen Postback-Zeitraum für das SKAdNetwork-Conversion-Wert-Schema.

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

string

Anzeigename des SKAdNetwork-Conversion-Werts. Der Anzeigename darf maximal 50 UTF-16-Codeeinheiten lang sein.
coarseValue

enum (CoarseValue)

Erforderlich. Ein grober Conversion-Wert.

Dieser Wert ist nicht zwangsläufig eindeutig.
eventMappings[]

object (EventMapping)

Ereignisbedingungen, die erfüllt sein müssen, damit dieser Conversion-Wert erreicht wird. Die Bedingungen in dieser Liste werden mit „UND“ verknüpft. Es muss mindestens einen und maximal drei Einträge enthalten, wenn das Postback-Fenster aktiviert ist.
lockEnabled

boolean

Wenn „true“ festgelegt ist, sollte das SDK für das aktuelle Postback-Fenster auf diesen Conversion-Wert festgelegt werden.
fineValue

integer

Der detaillierte Conversion-Wert. Dies gilt nur für das erste Postback-Window. Gültige Werte sind [0,63], einschließlich. Sie muss für Postback-Fenster 1 festgelegt sein, aber nicht für Postback-Fenster 2 und 3. Dieser Wert ist nicht zwangsläufig eindeutig.

Wenn die Konfiguration für das erste Postback-Fenster für das zweite oder dritte Postback-Fenster wiederverwendet wird, hat dieses Feld keine Auswirkungen.

CoarseValue

Der grobe Conversion-Wert, der beim SDK-Aufruf „updatePostbackConversionValue“ festgelegt wird, wenn eine der Bedingungen in „ConversionValues.event_mappings“ erfüllt ist. Weitere Informationen finden Sie unter SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED Grober Wert nicht angegeben.
COARSE_VALUE_LOW Grober Wert „Niedrig“.
COARSE_VALUE_MEDIUM Grober Wert von „mittel“.
COARSE_VALUE_HIGH Grober Wert „Hoch“

EventMapping

Bedingungen für Ereigniseinstellungen, die mit einem Ereignis übereinstimmen.

JSON-Darstellung 
{
  "eventName": string,
  "minEventCount": string,
  "maxEventCount": string,
  "minEventValue": number,
  "maxEventValue": number
}
Felder
eventName

string

Erforderlich. Name des Google Analytics-Ereignisses. Er muss immer festgelegt sein. Der Anzeigename darf maximal 40 UTF-16-Codeeinheiten lang sein.
minEventCount

string (int64 format)

Mindestens einer der folgenden vier Mindest-/Höchstwerte muss festgelegt werden. Die festgelegten Werte werden mit „AND“ verknüpft, um ein Ereignis zu qualifizieren. Die Mindestanzahl, wie oft das Ereignis aufgetreten ist. Wenn diese Option nicht festgelegt ist, wird die Mindestanzahl von Ereignissen nicht überprüft.
maxEventCount

string (int64 format)

Die maximale Anzahl, mit der das Ereignis aufgetreten ist. Wenn dieser Wert nicht festgelegt ist, wird die maximale Ereignisanzahl nicht überprüft.
minEventValue

number

Der Mindestumsatz, der durch das Ereignis erzielt wurde. Die Währung für den Umsatz wird auf Unterkunftsebene definiert. Wenn dieser Wert nicht festgelegt ist, wird der Mindestereigniswert nicht überprüft.
maxEventValue

number

Der maximale Umsatz, der durch das Ereignis erzielt wurde. Die Währung für den Umsatz wird auf Unterkunftsebene definiert. Wenn dieser Wert nicht festgelegt ist, wird der maximale Ereigniswert nicht überprüft.

Methoden

create

 Erstellt ein SKAdNetworkConversionValueSchema.

delete

 Löscht das Ziel-SKAdNetworkConversionValueSchema.

get

 Lässt ein einzelnes SKAdNetworkConversionValueSchema abfragen.

list

 Listet das SKAdNetwork-Conversion-Wert-Schema in einem Stream auf.

patch

 Aktualisiert ein SKAdNetworkConversionValueSchema.