Method: customers.uploadCallConversions

Verarbeitet die angegebenen Anruf-Conversions.

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

HTTP-Anfrage

POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadCallConversions

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 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
Felder
conversions[]

object (CallConversion)

Erforderlich. Die Conversions, 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 ConversionUploadService.UploadCallConversions.

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

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

object (Status)

Fehler, die sich auf Konvertierungsfehler im teilweisen Fehlermodus beziehen. Wird zurückgegeben, wenn alle Fehler innerhalb der Conversions auftreten. Wenn Fehler außerhalb der Conversions 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 (CallConversionResult)

Wird für erfolgreich verarbeitete Conversions 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.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

CallConversion

Eine Anruf-Conversion

JSON-Darstellung 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
Felder
customVariables[]

object (CustomVariable)

Die benutzerdefinierten Variablen, die mit dieser Conversion verknüpft sind.
consent

object (Consent)

Die Einwilligungseinstellung für das Ereignis.
callerId

string

Die Anrufer-ID, über die dieser Anruf getätigt wurde. Die Anrufer-ID muss im E.164-Format mit vorangestelltem „+“ vorliegen, z. B. „+16502531234“.
callStartDateTime

string

Datum und Uhrzeit des Anrufs 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".
conversionAction

string

Ressourcenname der Conversion-Aktion, die mit dieser Conversion 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.
conversionDateTime

string

Datum und Uhrzeit der Conversion Muss nach der Anrufzeit 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".
conversionValue

number

Der Wert der Conversion für den Werbetreibenden.
currencyCode

string

Währung, die dem Conversion-Wert zugeordnet ist Dies ist der dreistellige Währungscode gemäß ISO 4217. Beispiel: USD, EUR.

CallConversionResult

Identifikationsinformationen für einen erfolgreich verarbeiteten CallConversionUpload

JSON-Darstellung 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
Felder
callerId

string

Die Anrufer-ID, über die dieser Anruf getätigt wurde. Die Anrufer-ID muss im E.164-Format mit vorangestelltem „+“ vorliegen.
callStartDateTime

string

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

string

Ressourcenname der Conversion-Aktion, die mit dieser Conversion verknüpft ist.
conversionDateTime

string

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