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/v14/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
}
Felder
operation

object (CustomerSkAdNetworkConversionValueSchemaOperation)

Der auszuführende Vorgang.

validateOnly

boolean

Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.

Antworttext

Antwortnachricht für customerSkAdNetworkConversionValueSchemas.mutate.

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

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

object (MutateCustomerSkAdNetworkConversionValueSchemaResult)

Alle Ergebnisse für die mutate.

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 vom Typ „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)
    }
  ]
}
Felder
appId

string

Erforderlich. Nur Ausgabe App-ID im App Store.

measurementWindowHours

integer

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

fineGrainedConversionValueMappings[]

object (FineGrainedConversionValueMappings)

Nur Ausgabe Detailgenaue Zuordnungen von Conversion-Werten.

FineGrainedConversionValueMappings

Zuordnungen für 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

Zuordnung von einem Conversion-Wert zu einem oder mehreren Conversion-Ereignissen

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

string (int64 format)

Nur Ausgabe Minimaler Zeitraum, in dem ein Nutzer während des Messzeitraums zuletzt aktiv war.

maxTimePostInstallHours

string (int64 format)

Nur Ausgabe Der maximale Zeitraum, in dem ein Nutzer im Messfenster 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 Google-Ereignisname, der durch diesen Conversion-Wert dargestellt wird.

currencyCode

string

Nur Ausgabe Die angegebene Währung für „event_revenue“. Aus drei Buchstaben bestehender ISO 4217-Währungscode, 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 für den Ereignisumsatz.

eventRevenueValue

number

Nur Ausgabe Der Umsatzwert für ein bestimmtes Ereignis.

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 für Ereigniszähler

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 konfiguriert 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 konfiguriert behandelt.

EventOccurrenceRange

Definiert einen Bereich für Ereigniszählerwerte.

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

string (int64 format)

Nur Ausgabe Bei Ereigniszählerbereichen ist dies der Mindestwert des definierten Bereichs. Ein Wert von 0 wird als nicht konfiguriert behandelt.

maxEventCount

string (int64 format)

Nur Ausgabe Bei Ereigniszählerbereichen das Maximum des definierten Bereichs. Ein Wert von 0 wird als nicht konfiguriert behandelt.

MutateCustomerSkAdNetworkConversionValueSchemaResult

Das Ergebnis für die Mutation CustomerSkAdNetworkConversionValueSchema.

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

string

Ressourcenname des Kunden, der geändert wurde.

appId

string

Die App-ID des SkanConversionValue wurde geändert.