Method: customers.uploadConversionAdjustments

Verarbeitet die angegebenen Conversion-Anpassungen.

Liste der ausgelösten Fehler: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
customerId

string

Erforderlich. Die ID des Kunden, der den Upload durchführt.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
Felder
conversionAdjustments[]

object (ConversionAdjustment)

Erforderlich. Die Conversion-Anpassungen, die hochgeladen werden.
partialFailure

boolean

Erforderlich. Bei „true“ werden erfolgreiche Vorgänge ausgeführt und bei ungültigen Vorgängen werden Fehler zurückgegeben. Bei „false“ werden alle Vorgänge in einer Transaktion ausgeführt, wenn und nur wenn sie alle gültig sind. Dies sollte immer auf „true“ festgelegt sein. Weitere Informationen zu teilweisen Fehlern finden Sie unter https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
validateOnly

boolean

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

integer

Optional. Optionale Eingabe zum Festlegen der Job-ID. Muss eine positive Zahl sein, die kleiner als 2^31 ist, falls angegeben. Ist dieses Feld nicht angegeben, generiert die API eine Job-ID im Bereich [2^31; (2^63)-1]. Die API gibt den Wert für diese Anfrage im Feld jobId von UploadConversionAdjustmentsResponse zurück.

Antworttext

Antwortnachricht für ConversionAdjustmentUploadService.UploadConversionAdjustments.

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

JSON-Darstellung 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (ConversionAdjustmentResult)
    }
  ],
  "jobId": string
}
Felder
partialFailureError

object (Status)

Fehler, die mit Conversion-Anpassungen im teilweisen Fehlermodus zusammenhängen. Wird zurückgegeben, wenn alle Fehler innerhalb der Anpassungen auftreten. Wenn Fehler außerhalb der Anpassungen auftreten (z. B. Authentifizierungsfehler), wird ein RPC-Fehler zurückgegeben. Weitere Informationen zu teilweisen Fehlern finden Sie unter https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
results[]

object (ConversionAdjustmentResult)

Für erfolgreich verarbeitete Conversion-Anpassungen zurückgegeben. Für Zeilen mit Fehlern ist das Proto leer. Es werden keine Ergebnisse zurückgegeben, wenn „validOnly“ auf „true“ gesetzt ist.
jobId

string (int64 format)

Job-ID für den Upload-Batch.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

ConversionAdjustment

Eine Conversion-Anpassung.

JSON-Darstellung 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
Felder
gclidDateTimePair

object (GclidDateTimePair)

Bei Anpassungen wird eine Conversion, die ohne angegebene Bestell-ID gemeldet wurde, eindeutig identifiziert. Wenn der AdjustType ENHANCEMENT ist, ist dieser Wert optional, kann aber zusätzlich zur orderId festgelegt werden.
adjustmentType

enum (ConversionAdjustmentType)

Die Art der Anpassung.
restatementValue

object (RestatementValue)

Informationen, die erforderlich sind, um den Conversion-Wert neu zu formulieren. Erforderlich für Neuformulierungen. Sollte nicht für den Widerruf angegeben werden. Wenn für einen Widerruf angegeben wird, wird ein Fehler zurückgegeben. HINWEIS: Wenn Sie eine zweite Aktualisierung mit einem anderen angepassten Wert hochladen möchten, muss sie einen neuen, aktuelleren Zeitpunkt für die Anpassung haben. Andernfalls wird sie als Duplikat der vorherigen Aktualisierung behandelt und ignoriert.
userIdentifiers[]

object (UserIdentifier)

Die Nutzerkennungen, mit denen die ursprüngliche Conversion verbessert werden soll. ConversionAnpassungUploadService akzeptiert nur Nutzerkennungen in Verbesserungen. Für jede Erweiterung sind maximal 5 Nutzerkennungen zulässig.
orderId

string

Die Bestell-ID der Conversion, die angepasst werden soll. Wenn die Conversion mit einer angegebenen Bestell-ID erfasst wurde, muss diese Bestell-ID hier als Kennung verwendet werden. Für Verbesserungen ist die Bestell-ID erforderlich.
conversionAction

string

Ressourcenname der Conversion-Aktion, die dieser Conversion-Anpassung zugeordnet ist. Hinweis: Auch wenn dieser Ressourcenname aus einer Kundennummer und einer ID für die Conversion-Aktion besteht, wird bei der Validierung die Kundennummer ignoriert und stattdessen die ID der Conversion-Aktion als einzige Kennung der Conversion-Aktion verwendet.
adjustmentDateTime

string

Datum und Uhrzeit der Anpassung. Muss nach der Conversion-Datum/Uhrzeit liegen. Die Zeitzone muss angegeben werden. Das Format ist "jjjj-mm-tt hh:mm:ss+|-hh:mm", z. B. "2019-01-01 12:32:45-08:00".
userAgent

string

Der User-Agent, der die ursprüngliche Conversion verbessern soll. Sie finden sie im HTTP-Anfrageheader des Nutzers, wenn er auf Ihrer Webseite eine Conversion ausführt. Beispiel: „Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X)“. Der User-Agent kann nur bei Erweiterungen mit User-IDs angegeben werden. Dieser sollte mit dem User-Agent der Anfrage übereinstimmen, über die die ursprüngliche Conversion gesendet wurde. So werden die Conversion und die Verbesserung entweder beide demselben Gerät oder beide als geräteübergreifend zugeordnet.

GclidDateTimePair

Kennzeichnet eindeutig eine Conversion, die ohne angegebene Bestell-ID gemeldet wurde.

JSON-Darstellung 
{
  "gclid": string,
  "conversionDateTime": string
}
Felder
gclid

string

Die GCLID (Google Click ID), die der ursprünglichen Conversion für diese Anpassung zugeordnet ist.
conversionDateTime

string

Datum und Uhrzeit der ursprünglichen Conversion für diese Anpassung. Die Zeitzone muss angegeben werden. Das Format ist "jjjj-mm-tt hh:mm:ss+|-hh:mm", z. B. "2019-01-01 12:32:45-08:00".

ConversionAdjustmentType

Verschiedene Maßnahmen, die Werbetreibende ergreifen können, um die bereits erfassten Conversions anzupassen. Mit Widerrufen wird eine Conversion negiert. Durch Aktualisierungen wird der Wert einer Conversion geändert.

Enums
UNSPECIFIED Nicht angegeben.
UNKNOWN Stellt einen unbekannten Wert in dieser Version dar.
RETRACTION Negiert eine Conversion, sodass Gesamtwert und Anzahl null sind.
RESTATEMENT Ändert den Wert einer Conversion.
ENHANCEMENT Ergänzt eine vorhandene Conversion durch bereitgestellte User-IDs und User-Agents, die von Google zur Steigerung der Conversion-Anzahl verwendet werden können.

RestatementValue

Enthält Informationen, die zur Neuformulierung des Conversion-Werts erforderlich sind.

JSON-Darstellung 
{
  "adjustedValue": number,
  "currencyCode": string
}
Felder
adjustedValue

number

Der neu erstellte Conversion-Wert. Dies ist der Wert der Conversion nach der Aktualisierung. Wenn Sie beispielsweise den Wert einer Conversion von 100 auf 70 ändern möchten, sollte ein angepasster Wert von 70 erfasst werden. HINWEIS: Wenn Sie eine zweite Aktualisierung mit einem anderen angepassten Wert hochladen möchten, muss sie einen neuen, aktuelleren Zeitpunkt für die Anpassung haben. Andernfalls wird sie als Duplikat der vorherigen Aktualisierung behandelt und ignoriert.
currencyCode

string

Währung des neu eingegebenen Werts Andernfalls wird die Standardwährung der Conversion-Aktion verwendet. Ist sie nicht festgelegt, wird die Kontowährung verwendet. Dies ist der dreistellige Währungscode gemäß ISO 4217, zum Beispiel USD oder EUR.

ConversionAdjustmentResult

Informationen zu einer erfolgreich verarbeiteten ConversionAnpassung.

JSON-Darstellung 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
Felder
gclidDateTimePair

object (GclidDateTimePair)

Die GCLID sowie Datum und Uhrzeit der Conversion.
orderId

string

Die Bestell-ID der Conversion, die angepasst werden soll.
adjustmentType

enum (ConversionAdjustmentType)

Die Art der Anpassung.
conversionAction

string

Ressourcenname der Conversion-Aktion, die dieser Conversion-Anpassung zugeordnet ist.
adjustmentDateTime

string

Datum und Uhrzeit der Anpassung. Das Format ist "jjjj-mm-tt hh:mm:ss+|-hh:mm", z. B. "2019-01-01 12:32:45-08:00".