Method: customers.uploadCallConversions

מעבד את המרות השיחה הנתונות.

רשימת שגיאות שקרו: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
customerId

string

חובה. מזהה הלקוח שמבצע את ההעלאה.

גוף הבקשה

גוף הבקשה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "conversions": [
    {
      object (CallConversion)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean
}
שדות
conversions[]

object (CallConversion)

חובה. ההמרות שמעלים.
partialFailure

boolean

חובה. אם הערך הוא true, פעולות שבוצעו בהצלחה ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא False, כל הפעולות יבוצעו בעסקה אחת אם ורק אם כולן תקינות. תמיד צריך להגדיר את הערך כ-True. מידע נוסף על כשל חלקי זמין בכתובת https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
validateOnly

boolean

אם הערך הוא True, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות.

גוף התשובה

הודעת תשובה לגבי ConversionUploadService.UploadCallConversions.

אם הפעולה בוצעה ללא שגיאות, גוף התשובה מכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "partialFailureError": {
    object (Status)
  },
  "results": [
    {
      object (CallConversionResult)
    }
  ]
}
שדות
partialFailureError

object (Status)

שגיאות שמתייחסות לכשלים בהמרות במצב 'כשל חלקי'. מוחזרות כאשר כל השגיאות מתרחשות בתוך ההמרות. אם מתרחשות שגיאות מחוץ להמרות (למשל, שגיאות אימות), נחזיר שגיאה ברמת ה-RPC. מידע נוסף על כשל חלקי זמין בכתובת https://developers.google.com/google-ads/api/docs/best-practices/partial-failures.
results[]

object (CallConversionResult)

מוחזר עבור המרות שעובדו בהצלחה. השדה Proto יהיה ריק בשורות שהתקבלה בהן שגיאה. התוצאות לא מוחזרות אם הערך של validateOnly הוא TRUE.

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

למידע נוסף, עיינו בסקירה הכללית על OAuth 2.0.

CallConversion

המרה מסוג שיחה.

ייצוג JSON 
{
  "customVariables": [
    {
      object (CustomVariable)
    }
  ],
  "consent": {
    object (Consent)
  },
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string,
  "conversionValue": number,
  "currencyCode": string
}
שדות
customVariables[]

object (CustomVariable)

המשתנים המותאמים אישית שמשויכים להמרה הזו.
consent

object (Consent)

הגדרת ההסכמה לאירוע.
callerId

string

מספר הזיהוי של המתקשר שממנו בוצעה השיחה. מזהה המתקשר אמור להיות בפורמט E.164 עם הסימן '+' לפני הסימן '+', לדוגמה: '+16502531234'.
callStartDateTime

string

התאריך והשעה שבהם השיחה התרחשה. חובה לציין את אזור הזמן. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm', לדוגמה, '2019-01-01 12:32:45-08:00'.
conversionAction

string

שם המשאב של פעולת ההמרה שמשויכת להמרה הזו. הערה: שם המשאב הזה מורכב ממספר לקוח וממזהה של פעולת המרה, אבל המערכת תתעלם ממספר הלקוח ותשתמש במזהה פעולת ההמרה בתור המזהה היחיד של פעולת ההמרה.
conversionDateTime

string

התאריך שבו התרחשה ההמרה. התאריך חייב להיות מאוחר יותר משעת השיחה. חובה לציין את אזור הזמן. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm', לדוגמה, '2019-01-01 12:32:45-08:00'.
conversionValue

number

ערך ההמרה של המפרסם.
currencyCode

string

המטבע שמשויך לערך ההמרה. זהו קוד המטבע בן 3 התווים לפי תקן ISO 4217. לדוגמה: USD, EUR.

CallConversionResult

זיהוי מידע עבור CallConversionUpload שעובד בהצלחה.

ייצוג JSON 
{
  "callerId": string,
  "callStartDateTime": string,
  "conversionAction": string,
  "conversionDateTime": string
}
שדות
callerId

string

מספר הזיהוי של המתקשר שממנו בוצעה השיחה. מזהה המתקשר צפוי להיות בפורמט E.164 עם הסימן '+' לפניו.
callStartDateTime

string

התאריך והשעה שבהם השיחה התרחשה. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm', לדוגמה, '2019-01-01 12:32:45-08:00'.
conversionAction

string

שם המשאב של פעולת ההמרה שמשויכת להמרה הזו.
conversionDateTime

string

התאריך שבו התרחשה ההמרה. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm', לדוגמה, '2019-01-01 12:32:45-08:00'.