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/v14/customers/{customerId}:uploadConversionAdjustments

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
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
}
Felder
conversionAdjustments[]

object (ConversionAdjustment)

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

boolean

Erforderlich. Bei Einstellung auf „true“ werden erfolgreiche Vorgänge ausgeführt und bei ungültigen Vorgängen werden Fehler zurückgegeben. Bei „false“ werden alle Vorgänge nur dann in einer Transaktion ausgeführt, 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

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

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 sich auf fehlgeschlagene Conversion-Anpassungen im Modus „Teilweise fehlgeschlagen“ beziehen. Wird zurückgegeben, wenn alle Fehler innerhalb der Anpassungen auftreten. Wenn Fehler außerhalb der Anpassungen auftreten (z. B. Authentifizierungsfehler), wird ein Fehler auf RPC-Ebene 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)

Wird für erfolgreich verarbeitete Conversion-Anpassungen zurückgegeben. Proto ist für Zeilen, in denen ein Fehler aufgetreten ist, leer. Es werden keine Ergebnisse zurückgegeben, wenn "validOnly" den Wert "true" hat.
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 Anpassungstyp ENHANCEMENT lautet, ist dieser Wert optional, kann aber zusätzlich zur Auftrags-ID festgelegt werden.
adjustmentType

enum (ConversionAdjustmentType)

Die Art der Anpassung.
restatementValue

object (RestatementValue)

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

object (UserIdentifier)

Die Nutzerkennungen zur Verbesserung der ursprünglichen Conversion ConversionAnpassungUploadService akzeptiert nur bei Verbesserungen Nutzerkennungen. Für jede Erweiterung sind maximal 5 Nutzerkennungen zulässig.
orderId

string

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

string

Ressourcenname der Conversion-Aktion, die mit dieser Conversion-Anpassung verknüpft ist. Hinweis: Obwohl dieser Ressourcenname aus einer Kundennummer und einer ID für die Conversion-Aktion besteht, wird die Kundennummer bei der Validierung ignoriert. Stattdessen wird die ID der Conversion-Aktion als einzige Kennung der Conversion-Aktion verwendet.
adjustmentDateTime

string

Datum und Uhrzeit der Anpassung. Muss nach der conversionDateTime 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 zur Verbesserung der ursprünglichen Conversion. 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 in Erweiterungen mit User-IDs angegeben werden. Dieser sollte dem User-Agent der Anfrage entsprechen, über die die ursprüngliche Conversion gesendet wurde, sodass die Conversion und die Optimierung entweder beide oder beide als geräteübergreifend zugeordnet werden.

GclidDateTimePair

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

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

string

Die Google Click ID (GCLID), 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, mit denen Werbetreibende bereits erfasste Conversions anpassen können Ein Widerruf negiert eine Conversion. Aktualisierungen ändern den Wert einer Conversion.

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

RestatementValue

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

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

number

Der geänderte 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 gemeldet werden. HINWEIS: Wenn Sie eine zweite Aktualisierung mit einem anderen angepassten Wert hochladen möchten, muss diese einen neuen, aktuelleren Zeitpunkt der Anpassung haben. Andernfalls wird er als Duplikat der vorherigen Aktualisierung behandelt und ignoriert.
currencyCode

string

Währung des neu eingegebenen Werts. Wenn nicht angegeben, 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, z. B. USD oder EUR.

ConversionAdjustmentResult

Informationen zu einer erfolgreich verarbeiteten Conversion-Anpassung.

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 Auftrags-ID der Conversion, die angepasst werden soll.
adjustmentType

enum (ConversionAdjustmentType)

Die Art der Anpassung.
conversionAction

string

Ressourcenname der Conversion-Aktion, die mit dieser Conversion-Anpassung verknüpft 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".