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 Person wird NUR einem iOS-Stream untergeordnet, und es kann höchstens ein Kind unter einem iOS-Stream haben. Format: properties/{property}/dataStreams/{dataStream}/sKAdNetworkConversionValueSchema

postbackWindowOne

object (PostbackWindow)

Erforderlich. Die Einstellungen für den Conversion-Wert für das erste Postback-Fenster. Diese unterscheiden sich von den Werten für das Postback-Fenster 2 und 3 dadurch, dass sie einen "Fein"-Wert genauer Conversion-Wert (ein numerischer Wert)

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

Dieses Feld sollte nur konfiguriert werden, wenn Sie unterschiedliche Conversion-Werte für dieses Postback-Fenster definieren 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 verschiedene Conversion-Werte für dieses Postback-Fenster definieren möchte. Fenster 3 kann konfiguriert werden, ohne Fenster 2 festzulegen. In Fallfenster 1 und Zwei Einstellungen sind festgelegt und „enable_postback_window_settings“ für dieses Postback-Fenster ist auf „false“ gesetzt. Das Schema übernimmt Einstellungen von postbackWindowTwo.

applyConversionValues

boolean

Wenn diese Option aktiviert ist, werden Conversion-Werte im GA SDK anhand dieser Schemadefinition festgelegt und das Schema wird in alle Google Ads-Konten exportiert, die mit dieser Property verknüpft sind. Wenn diese Option deaktiviert ist, werden Conversion-Werte über das Google Analytics SDK nicht automatisch festgelegt und das Schema wird nicht in 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 des wiederkehrenden Felds wird verwendet, um die Einstellungen für den Conversion-Wert zu priorisieren. Einträge mit niedrigerem Index haben eine höhere Priorität. Die erste Conversion-Wert-Einstellung, die mit „true“ ausgewertet wird, wird ausgewählt. Es muss mindestens einen Eintrag enthalten, wenn „enable_postback_window_settings“ auf „true“ gesetzt ist. Er darf maximal 128 Einträge haben.

postbackWindowSettingsEnabled

boolean

Wenn „enable_postback_window_settings“ auf „true“ gesetzt ist, müssen „conversionValues“ ausgefüllt werden. Sie werden dann verwendet, um zu bestimmen, wann und wie der Conversion-Wert auf einem Clientgerät festgelegt wird und wie das Schema in verknüpfte Google Ads-Konten exportiert wird. Bei „false“ werden die Einstellungen nicht verwendet, aber für den Fall einer zukünftigen Verwendung beibehalten. Dies muss für postbackWindowOne immer „true“ sein.

ConversionValues

Einstellungen für den Conversion-Wert eines Postback-Zeitraums 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 eines Anzeigenamens beträgt 50 UTF-16-Codeeinheiten.

coarseValue

enum (CoarseValue)

Erforderlich. Ein grober Conversion-Wert.

Es ist nicht garantiert, dass dieser Wert eindeutig ist.

eventMappings[]

object (EventMapping)

Ereignisbedingungen, die erfüllt sein müssen, damit dieser Conversion-Wert erreicht wird. Die Bedingungen in dieser Liste werden durch eine UND-Verbindung verknüpft. Wenn das Postback-Fenster aktiviert ist, muss es mindestens einen und höchstens drei Einträge enthalten.

lockEnabled

boolean

Bei Einstellung auf „true“ sollte das SDK für das aktuelle Postback-Tracking-Zeitraum auf diesen Conversion-Wert festgelegt werden.

fineValue

integer

Der detaillierte Conversion-Wert. Dies gilt nur für das erste Postback-Fenster. Die gültigen Werte sind [0,63], beide inklusive. Dieser Wert muss für das Postback-Fenster 1 festgelegt werden, nicht für das Postback-Fenster 2 und 3. Es ist nicht garantiert, dass dieser Wert eindeutig ist.

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 im SDK-Aufruf updatePostbackConversionValue festgelegt wird, wenn die Bedingungen von „ConversionValues.event_mappings“ erfüllt sind. Weitere Informationen finden Sie unter SKAdNetwork.CoarseConversionValue.

Enums
COARSE_VALUE_UNSPECIFIED Grobwert nicht angegeben.
COARSE_VALUE_LOW Grober Wert von niedrig.
COARSE_VALUE_MEDIUM Der grobe Wert des Mediums.
COARSE_VALUE_HIGH Grober Wert von hoch.

EventMapping

Bedingungen für Ereigniseinstellungen entsprechend einem Ereignis.

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. Anzeigenamen sind maximal 40 UTF-16-Codeeinheiten zulässig.

minEventCount

string (int64 format)

Mindestens einer der folgenden vier Minimal-/Maximalwerte muss 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)

Die maximale Häufigkeit, mit der das Ereignis aufgetreten ist. Wenn die Richtlinie nicht konfiguriert ist, wird die maximale Ereignisanzahl nicht geprüft.

minEventValue

number

Der aufgrund des Ereignisses generierte Mindestumsatz. Die Währung für den Umsatz wird auf Property-Ebene definiert. 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 definiert. Wenn die Richtlinie nicht konfiguriert ist, wird der maximale Ereigniswert nicht geprüft.

Methoden

create

Erstellt ein SKAdNetworkConversionValueSchema

delete

Löscht das Ziel-SKAdNetworkConversionValueSchema.

get

Sucht nach einem einzelnen SKAdNetworkConversionValueSchema.

list

Listet das SKAdNetworkConversionValueSchema für einen Stream auf.

patch

Aktualisiert ein SKAdNetworkConversionValueSchema.