REST Resource: properties.dataStreams.sKAdNetworkConversionValueSchema

Ressource: SKAdNetworkConversionValueSchema

Das 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. Es wird NUR einem iOS-Stream untergeordnet und in einem iOS-Stream darf es höchstens ein solches Kind geben. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

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

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

postbackWindowTwo

object (PostbackWindow)

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

Dieses Feld sollte nur konfiguriert werden, wenn für dieses Postback-Fenster andere 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 Conversion-Wert-Einstellungen für das dritte Postback-Fenster.

Dieses Feld sollte nur festgelegt werden, wenn der Nutzer verschiedene Conversion-Werte für dieses Postback-Fenster definiert. Fenster 3 kann konfiguriert werden, ohne Fenster 2 festzulegen. Falls die Einstellungen für Fenster 1 und 2 festgelegt und „enable_postback_window_settings“ für dieses Postback-Fenster auf „false“ gesetzt sind, übernimmt das Schema die Einstellungen von postbackWindowTwo.

applyConversionValues

boolean

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

PostbackWindow

Einstellungen für ein SKAdNetwork-Conversion-Postback-Fenster.

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

object (ConversionValues)

Die Einstellungen für den Conversion-Wert werden anhand der Reihenfolge der wiederkehrenden Felder priorisiert. Einträge mit einem niedrigeren Indexwert werden höher priorisiert. Die erste Conversion-Wert-Einstellung, die als „wahr“ ausgewertet wird, wird ausgewählt. Sie muss mindestens einen Eintrag enthalten, wenn "enable_postback_window_settings" auf "true" gesetzt ist. Er darf maximal 128 Einträge enthalten.

postbackWindowSettingsEnabled

boolean

Wenn „enable_postback_window_settings“ auf „true“ gesetzt ist, müssen „conversionValues“ ausgefüllt werden. Anhand dieser Werte wird ermittelt, wann und wie der Conversion-Wert auf einem Clientgerät festgelegt und das Schema in verknüpfte Google Ads-Konten exportiert werden soll. Bei „false“ werden die Einstellungen nicht verwendet, aber für den Fall, dass sie später verwendet werden, beibehalten. Dies muss für postbackWindowOne immer "true" sein.

ConversionValues

Conversion-Wert-Einstellungen für einen Postback-Tracking-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 Die maximal zulässige Länge des Anzeigenamens beträgt 50 UTF-16-Codeeinheiten.

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 durch UND verbunden. Es muss mindestens einen und maximal drei Einträge haben, 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

Detaillierter Conversion-Wert Dies gilt nur für das erste Postback-Fenster. Die gültigen Werte sind [0,63], beide einschließlich. Es muss für Postback-Fenster 1 festgelegt werden und darf nicht für Postback-Fenster 2 und 3 festgelegt werden. 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 UpdatePostbackConversionValue SDK-Aufruf festgelegt wurde, wenn eine ConversionValues.event_mappings-Bedingung erfüllt ist. Weitere Informationen finden Sie unter SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED Der grobe Wert wurde nicht angegeben.
COARSE_VALUE_LOW Grober Wert oder niedriger Wert.
COARSE_VALUE_MEDIUM Grober Wert des Mediums.
COARSE_VALUE_HIGH Grober Wert oder hoch.

EventMapping

Bedingungen für die Ereigniseinstellung, die mit einem Ereignis abgeglichen werden soll.

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

string

Erforderlich. Name des GA4-Ereignisses. Es muss immer festgelegt werden. Die maximal zulässige Länge des Anzeigenamens beträgt 40 UTF-16-Codeeinheiten.

minEventCount

string (int64 format)

Es muss mindestens einer der folgenden vier Minimal-/Maximalwerte festgelegt werden. Die festgelegten Werte werden durch eine UND-Verbindung verknüpft, um ein Ereignis zu qualifizieren. Gibt an, wie oft das Ereignis mindestens aufgetreten ist. Wenn die Richtlinie nicht konfiguriert ist, wird die Mindestanzahl von Ereignissen nicht geprüft.

maxEventCount

string (int64 format)

Gibt an, wie oft das Ereignis maximal aufgetreten ist. Wenn die Richtlinie nicht konfiguriert ist, wird die maximale Ereignisanzahl nicht geprüft.

minEventValue

number

Der Mindestumsatz, der durch das Ereignis generiert wurde. Die Währung des Umsatzes wird auf Property-Ebene festgelegt. Wenn die Richtlinie nicht konfiguriert ist, wird der Mindestereigniswert nicht geprüft.

maxEventValue

number

Der maximale Umsatz, der durch das Ereignis generiert wurde. Die Währung des Umsatzes wird auf Property-Ebene festgelegt. Wenn die Richtlinie nicht konfiguriert ist, wird der maximale Ereigniswert nicht geprüft.

Methoden

create

Erstellt ein SKAdNetworkConversionValueSchema.

delete

Löscht das SKAdNetworkConversionValueSchema-Ziel.

get

Sucht nach einem einzelnen SKAdNetworkConversionValueSchema.

list

Listet das SKAdNetworkConversionValueSchema in einem Stream auf.

patch

Aktualisiert ein SKAdNetworkConversionValueSchema.