- HTTP-Anfrage
- Pfadparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- CallConversion
- CallConversionResult
- Testen!
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 |
Erforderlich. Die ID des Kunden, der den Upload durchführt. |
Anfragetext
Der Anfragetext enthält Daten mit folgender Struktur:
JSON-Darstellung |
---|
{
"conversions": [
{
object ( |
Felder | |
---|---|
conversions[] |
Erforderlich. Die Conversions, die hochgeladen werden. |
partialFailure |
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 |
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 ( |
Felder | |
---|---|
partialFailureError |
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[] |
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 ( |
Felder | |
---|---|
customVariables[] |
Die benutzerdefinierten Variablen, die mit dieser Conversion verknüpft sind. |
consent |
Die Einwilligungseinstellung für das Ereignis. |
callerId |
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 |
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 |
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 |
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 |
Der Wert der Conversion für den Werbetreibenden. |
currencyCode |
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 |
Die Anrufer-ID, über die dieser Anruf getätigt wurde. Die Anrufer-ID muss im E.164-Format mit vorangestelltem „+“ vorliegen. |
callStartDateTime |
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 |
Ressourcenname der Conversion-Aktion, die mit dieser Conversion verknüpft ist. |
conversionDateTime |
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". |