Method: customers.uploadCallConversions

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

רשימה של שגיאות הטמעה: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError

בקשת HTTP

POST https://googleads.googleapis.com/v15/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'.