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. Es 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.

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 festgelegt 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 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 dieses Postback-Fenster 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-Tracking-Zeitraum.

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

object (ConversionValues)

Die Reihenfolge des wiederholten 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-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 immer für „postbackWindowOne“ der Fall sein.

ConversionValues

Conversion-Wert-Einstellungen für ein Postback-Fenster 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 garantiert 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-Window 1 festgelegt sein und darf nicht für Postback-Window 2 und 3 festgelegt sein. Dieser Wert ist nicht garantiert 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 von „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 für „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, mit der 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 diese Option 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

Sucht nach einem einzelnen SKAdNetworkConversionValueSchema.

list

Listet das SKAdNetworkConversionValueSchema in einem Stream auf.

patch

Aktualisiert ein SKAdNetworkConversionValueSchema.