Method: customers.customerSkAdNetworkConversionValueSchemas.mutate

Erstellt oder aktualisiert das CustomerSkAdNetworkConversionValueSchema.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError FieldError InternalError MutateError

HTTP-Anfrage

POST https://googleads.googleapis.com/v16/customers/{customerId}/customerSkAdNetworkConversionValueSchemas:mutate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Die ID des Kunden, dessen freigegebene Sätze geändert werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "operation": {
    object (CustomerSkAdNetworkConversionValueSchemaOperation)
  },
  "validateOnly": boolean,
  "enableWarnings": boolean
}
Felder
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Der auszuführende Vorgang.
validateOnly

boolean

Bei „true“ wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.
enableWarnings

boolean

Optional. Bei „true“ wird die Rückgabe von Warnungen aktiviert. Warnungen geben Fehlermeldungen und Fehlercodes zurück, ohne die Ausführung des mutate-Vorgangs zu blockieren.

Antworttext

Antwortnachricht für customerSkAdNetworkConversionValueSchemas.mutate.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "result": {
    object (MutateCustomerSkAdNetworkConversionValueSchemaResult)
  },
  "warning": {
    object (Status)
  }
}
Felder
result

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Alle Ergebnisse für die mutate.
warning

object (Status)

Nicht blockierende Fehler, die Details zu Fehlern bei der Schemavalidierung enthalten. Wird nur zurückgegeben, wenn „enableWarnings“ = „true“ ist.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

CustomerSkAdNetworkConversionValueSchemaOperation

Ein einzelner Aktualisierungsvorgang für ein CustomerSkAdNetworkConversionValueSchema.

JSON-Darstellung 
{
  "update": {
    object (CustomerSkAdNetworkConversionValueSchema)
  }
}
Felder
update

object (CustomerSkAdNetworkConversionValueSchema)

Aktualisierungsvorgang: Das Schema muss einen gültigen Ressourcennamen haben.

CustomerSkAdNetworkConversionValueSchema

Ein CustomerSkAdNetworkConversionValueSchema.

JSON-Darstellung 
{
  "resourceName": string,
  "schema": {
    object (SkAdNetworkConversionValueSchema)
  }
}
Felder
resourceName

string

Nur Ausgabe. Der Ressourcenname des Schemas. Ressourcennamen von CustomerSkAdNetworkConversionValueSchema haben das Format „customers/{customerId}/customerSkAdNetworkConversionValueSchemas/{accountLinkId}“.
schema

object (SkAdNetworkConversionValueSchema)

Nur Ausgabe. Das Schema für die angegebene Ressource.

SkAdNetworkConversionValueSchema

Das CustomerLink-spezifische SkAdNetworkConversionValueSchema.

JSON-Darstellung 
{
  "appId": string,
  "measurementWindowHours": integer,
  "fineGrainedConversionValueMappings": [
    {
      object (FineGrainedConversionValueMappings)
    }
  ],
  "postbackMappings": [
    {
      object (PostbackMapping)
    }
  ]
}
Felder
appId

string

Erforderlich. Nur Ausgabe. App-ID des App Store.
measurementWindowHours

integer

Nur Ausgabe. Ein Zeitfenster (gemessen in Stunden) nach der Installation, nach dem der App Attribution Partner oder der Werbetreibende updateConversionValue nicht mehr aufruft.
fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Nur Ausgabe. Detaillierte Conversion-Wert-Zuordnungen. Ab SkAdNetwork-Versionen ab 4.0, die mehrere Conversion-Tracking-Zeiträume unterstützen, sind detaillierte Conversion-Wert-Zuordnungen nur für das erste Postback anwendbar.
postbackMappings[]

object (PostbackMapping)

Nur Ausgabe. Zuordnungen des Conversion-Werts pro Postback für Postbacks in mehreren Conversion-Tracking-Zeiträumen. Gilt nur für SkAdNetwork-Versionen ab 4.0.

FineGrainedConversionValueMappings

Zuordnungen für einen detaillierten Conversion-Wert.

JSON-Darstellung 
{
  "fineGrainedConversionValue": integer,
  "conversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Felder
fineGrainedConversionValue

integer

Nur Ausgabe. Detaillierter Conversion-Wert. Gültige Werte liegen im Bereich [0,63].
conversionValueMapping

object (ConversionValueMapping)

Nur Ausgabe. Conversion-Ereignisse, denen der detaillierte Conversion-Wert zugeordnet ist.

ConversionValueMapping

Stellt die Zuordnung eines Conversion-Werts zu einem oder mehreren Conversion-Ereignissen dar.

JSON-Darstellung 
{
  "minTimePostInstallHours": string,
  "maxTimePostInstallHours": string,
  "mappedEvents": [
    {
      object (Event)
    }
  ]
}
Felder
minTimePostInstallHours

string (int64 format)

Nur Ausgabe. Der Mindestzeitraum, in dem ein Nutzer im Messzeitraum zuletzt aktiv war.
maxTimePostInstallHours

string (int64 format)

Nur Ausgabe. Der maximale Zeitraum, in dem ein Nutzer im Messzeitraum zuletzt aktiv war.
mappedEvents[]

object (Event)

Nur Ausgabe. Der Conversion-Wert kann mehreren Ereignissen mit verschiedenen Attributen zugeordnet werden.

Veranstaltung

Definiert ein Google-Conversion-Ereignis, dem der Conversion-Wert zugeordnet ist.

JSON-Darstellung 
{
  "mappedEventName": string,
  "currencyCode": string,

  // Union field revenue_rate can be only one of the following:
  "eventRevenueRange": {
    object (RevenueRange)
  },
  "eventRevenueValue": number
  // End of list of possible types for union field revenue_rate.

  // Union field event_rate can be only one of the following:
  "eventOccurrenceRange": {
    object (EventOccurrenceRange)
  },
  "eventCounter": string
  // End of list of possible types for union field event_rate.
}
Felder
mappedEventName

string

Nur Ausgabe. Name des Google-Ereignisses, dargestellt durch diesen Conversion-Wert.
currencyCode

string

Nur Ausgabe. Die angegebene Währung für „event_revenue“. Dreistelliger Währungscode gemäß ISO 4217, z. B. „USD“
Union-Feld revenue_rate. Entweder ein Bereich oder ein bestimmter Wert für den Ereignisumsatz. Für revenue_rate ist nur einer der folgenden Werte zulässig:
eventRevenueRange

object (RevenueRange)

Nur Ausgabe. Der Bereich der Ereigniseinnahmen.
eventRevenueValue

number

Nur Ausgabe. Der spezifische Wert des Ereignisumsatzes.
Union-Feld event_rate. Entweder ein Bereich oder ein bestimmter Wert für den Ereigniszähler. Für event_rate ist nur einer der folgenden Werte zulässig:
eventOccurrenceRange

object (EventOccurrenceRange)

Nur Ausgabe. Bereich des Ereigniszählers
eventCounter

string (int64 format)

Nur Ausgabe. Für bestimmte Ereigniszählerwerte

RevenueRange

Definiert einen Bereich für Umsatzwerte.

JSON-Darstellung 
{
  "minEventRevenue": number,
  "maxEventRevenue": number
}
Felder
minEventRevenue

number

Nur Ausgabe. Für Umsatzbereiche der Mindestwert in currencyCode, für den dieser Conversion-Wert aktualisiert wird. Ein Wert von 0 wird als nicht festgelegt behandelt.
maxEventRevenue

number

Nur Ausgabe. Für Umsatzbereiche der Maximalwert in currencyCode, für den dieser Conversion-Wert aktualisiert wird. Ein Wert von 0 wird als nicht festgelegt behandelt.

EventOccurrenceRange

Definiert einen Bereich für Werte von Ereigniszählern.

JSON-Darstellung 
{
  "minEventCount": string,
  "maxEventCount": string
}
Felder
minEventCount

string (int64 format)

Nur Ausgabe. Der Mindestwert des festgelegten Bereichs bei Ereigniszählern. Ein Wert von 0 wird als nicht festgelegt behandelt.
maxEventCount

string (int64 format)

Nur Ausgabe. Der Höchstwert des definierten Bereichs für Ereigniszählerbereiche. Ein Wert von 0 wird als nicht festgelegt behandelt.

PostbackMapping

Zuordnungen für jedes Postback in mehreren Conversion-Tracking-Zeiträumen.

JSON-Darstellung 
{
  "postbackSequenceIndex": integer,
  "coarseGrainedConversionValueMappings": {
    object (CoarseGrainedConversionValueMappings)
  },

  // Union field lock_window_trigger can be only one of the following:
  "lockWindowCoarseConversionValue": enum (SkAdNetworkCoarseConversionValue),
  "lockWindowFineConversionValue": integer,
  "lockWindowEvent": string
  // End of list of possible types for union field lock_window_trigger.
}
Felder
postbackSequenceIndex

integer

Nur Ausgabe. 0-basierter Index, der die Reihenfolge des Postbacks angibt. Gültige Werte liegen im Bereich [0,2].
coarseGrainedConversionValueMappings

object (CoarseGrainedConversionValueMappings)

Nur Ausgabe. Conversion-Wert-Zuordnungen für alle groben Conversion-Werte.
Union-Feld lock_window_trigger. Ereignis oder Conversion-Wert, das zum Sperren des Conversion-Tracking-Zeitraums verwendet wird. Für lock_window_trigger ist nur einer der folgenden Werte zulässig:
lockWindowCoarseConversionValue

enum (SkAdNetworkCoarseConversionValue)

Nur Ausgabe. Der grobe Conversion-Wert, der eine Sperre des Conversion-Tracking-Zeitraums auslöst.
lockWindowFineConversionValue

integer

Nur Ausgabe. Detaillierter Conversion-Wert, der eine Sperre des Conversion-Tracking-Zeitraums auslöst.
lockWindowEvent

string

Nur Ausgabe. Ereignisname, der die Sperre des Conversion-Tracking-Zeitraums auslöst.

CoarseGrainedConversionValueMappings

Zuordnungen für grobe Conversion-Werte.

JSON-Darstellung 
{
  "lowConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "mediumConversionValueMapping": {
    object (ConversionValueMapping)
  },
  "highConversionValueMapping": {
    object (ConversionValueMapping)
  }
}
Felder
lowConversionValueMapping

object (ConversionValueMapping)

Nur Ausgabe. Zuordnung für einen „niedrigen“ groben Conversion-Wert.
mediumConversionValueMapping

object (ConversionValueMapping)

Nur Ausgabe. Zuordnung für „mittlerer“ grober Conversion-Wert.
highConversionValueMapping

object (ConversionValueMapping)

Nur Ausgabe. Zuordnung für einen „hohen“ groben Conversion-Wert.

MutateCustomerSkAdNetworkConversionValueSchemaResult

Das Ergebnis für die Änderung „CustomerSkAdNetworkConversionValueSchema“.

JSON-Darstellung 
{
  "resourceName": string,
  "appId": string
}
Felder
resourceName

string

Ressourcenname des Kunden, der geändert wurde.
appId

string

App-ID von SkanConversionValue geändert.