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. Diese ist NUR einem iOS-Stream untergeordnet und es kann höchstens ein solches Kind in einem iOS-Stream vorhanden sein. 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 das Postback-Fenster 2 und 3 darin, dass sie einen detaillierten, detaillierten Conversion-Wert, also einen numerischen Wert, enthalten.

Für dieses Postback-Fenster müssen Conversion-Werte festgelegt werden. Die anderen Fenster sind optional und übernehmen ggf. die Einstellungen dieses Fensters.

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 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 Conversion-Wert-Einstellungen für das dritte Postback-Fenster.

Dieses Feld sollte nur festgelegt werden, wenn der Nutzer unterschiedliche Conversion-Werte für dieses Postback-Fenster definiert hat. Sie können Fenster 3 konfigurieren, 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 über das Google Analytics SDK Conversion-Werte anhand dieser Schemadefinition festgelegt und das Schema wird in alle Google Ads-Konten exportiert, die mit dieser Property verknüpft sind. Ist die Option deaktiviert, werden über das Google Analytics 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 Reihenfolge der wiederkehrenden Felder wird verwendet, um die Einstellungen für den Conversion-Wert zu priorisieren. Einträge mit niedrigerem Index werden höher priorisiert. Die erste Conversion-Wert-Einstellung, bei der „wahr“ ausgewertet wird, wird ausgewählt. Sie muss mindestens einen Eintrag enthalten, wenn "enable_postback_window_settings" auf "true" festgelegt 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. Damit wird bestimmt, wann und wie der Conversion-Wert auf einem Clientgerät festgelegt und das Schema in verknüpfte Google Ads-Konten exportiert wird. Bei „false“ werden die Einstellungen nicht verwendet, aber für den Fall aufbewahrt, dass sie später noch einmal verwendet werden können. Dies muss für postbackWindowOne immer "true" sein.

ConversionValues

Einstellungen für den Conversion-Wert eines Postback-Fensters für das SKAdNetwork-Conversion-Wert-Schema.

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

string

Der Anzeigename des SKAdNetwork-Conversion-Werts. Die maximal zulässige Länge für Anzeigenamen 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 höchstens 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 eingeschlossen). Er muss für Postback-Fenster 1 und 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 wird, wenn eine ConversionValues.event_mappings-Bedingung erfüllt ist. Weitere Informationen finden Sie unter SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED Grober Wert nicht angegeben.
COARSE_VALUE_LOW Grober Wert von niedrig.
COARSE_VALUE_MEDIUM Grober Wert für „Medium“.
COARSE_VALUE_HIGH Grober Wert oder hoch.

EventMapping

Bedingungen für Ereigniseinstellungen, die mit einem Ereignis abgeglichen werden sollen.

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

string

Erforderlich. Name des GA4-Ereignisses. Er muss immer festgelegt werden. Die maximal zulässige Länge für Anzeigenamen 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 AND verbunden, um ein Ereignis zu qualifizieren. Die Häufigkeit, mit der 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 für den Umsatz 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 für den Umsatz 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 SKAdNetworkConversionValueSchema in einem Stream auf.

patch

Aktualisiert ein SKAdNetworkConversionValueSchema.