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/v16/customers/{customerId}:uploadCallConversions

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

object (CallConversion)

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

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 in den 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. Für Zeilen mit Fehlern ist das Proto leer. Es werden keine Ergebnisse zurückgegeben, wenn „validOnly“ auf „true“ gesetzt ist.

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 „+“-Zeichen 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: 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.
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

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 „+“-Zeichen 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".