Method: customers.uploadConversionAdjustments

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

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

בקשת HTTP

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

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

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

פרמטרים
customerId

string

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

גוף הבקשה

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

ייצוג JSON 
{
  "conversionAdjustments": [
    {
      object (ConversionAdjustment)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "jobId": integer
}
שדות
conversionAdjustments[]

object (ConversionAdjustment)

חובה. ההתאמות של ההמרות שהמערכת מעלה.
partialFailure

boolean

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

boolean

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

integer

אפשרות. שדה אופציונלי להגדרת מזהה המשימה. חייב להיות מספר לא שלילי שקטן מ-2^31, אם צוין. אם לא תספקו את השדה הזה, ה-API ייצור מזהה משימה בטווח [ 2^31, (2^63)-1]. ה-API יחזיר את הערך של הבקשה הזו בשדה jobId של UploadConversionAdjustmentsResponse.

גוף התשובה

הודעת תשובה לגבי ConversionAdjustmentUploadService.UploadConversionAdjustments.

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

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

object (Status)

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

object (ConversionAdjustmentResult)

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

string (int64 format)

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

היקפי הרשאות

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

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

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

ConversionAdjustment

שינוי ערך המרה.

ייצוג JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "adjustmentType": enum (ConversionAdjustmentType),
  "restatementValue": {
    object (RestatementValue)
  },
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ],
  "orderId": string,
  "conversionAction": string,
  "adjustmentDateTime": string,
  "userAgent": string
}
שדות
gclidDateTimePair

object (GclidDateTimePair)

כשמדובר בהתאמות, המערכת מזהה באופן ייחודי המרה שדווחה בלי לציין מזהה הזמנה. אם הפרמטר AdjustType הוא ENHANCEMENT, הערך הזה הוא אופציונלי, אבל אפשר להגדיר אותו בנוסף ל-orderId.
adjustmentType

enum (ConversionAdjustmentType)

סוג ההתאמה.
restatementValue

object (RestatementValue)

המידע הנחוץ כדי להגדיר מחדש את ערך ההמרה. נדרש להעברת הצהרות מחדש. אין לספק אפשרות לביטול תלונות על הפרת זכויות יוצרים. תוחזר שגיאה אם יסופקו עבור ביטול התלונה. הערה: אם רוצים להעלות שינוי דיווח שני עם ערך מותאם אחר, צריך להגדיר לו מועד ביצוע התאמה חדש ועדכני יותר. אחרת, המערכת תתייחס אליו כעותק כפול של השינוי הקודם, והמערכת תתעלם ממנו.
userIdentifiers[]

object (UserIdentifier)

מזהי המשתמש שצריך לשפר את ההמרה המקורית. השירות ConversionAdjustmentUploadService מקבל רק מזהי משתמשים בשיפורים. כל שיפור יכול לכלול עד 5 מזהי משתמש.
orderId

string

מזהה ההזמנה של ההמרה שיש להתאים. אם דווח על ההמרה באמצעות מזהה הזמנה, צריך להשתמש במזהה ההזמנה הזה כמזהה כאן. מזהה ההזמנה נדרש לשיפורים.
conversionAction

string

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

string

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

string

סוכן המשתמש שנועד לשפר את ההמרה המקורית. ניתן למצוא זאת בכותרת בקשת ה-HTTP של המשתמש כשהוא מבצע המרה בדף האינטרנט. לדוגמה, "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 כגון Mac OS X)". אפשר לציין סוכן משתמש רק בשיפורים עם מזהי משתמשים. הערך הזה צריך להתאים לסוכן המשתמש של הבקשה ששלחה את ההמרה המקורית, כך שההמרה והשיפור שלה ישויכו שניהם לאותו המכשיר או שניהם ישויכו כהמרות חוצות-מכשירים.

GclidDateTimePair

מזהה באופן ייחודי המרה שדווחה בלי לציין מזהה הזמנה.

ייצוג JSON 
{
  "gclid": string,
  "conversionDateTime": string
}
שדות
gclid

string

מספר הקליק ב-Google (GCLID) שמשויך להמרה המקורית המשויכת להתאמה הזו.
conversionDateTime

string

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

ConversionAdjustmentType

הפעולות השונות שמפרסמים יכולים לבצע כדי לשנות את ההמרות שכבר דיווחו עליהן. ביטולים מבטלים את ההמרה. הצהרות מחדש משנות את הערך של המרה.

טיפוסים בני מנייה (enums)
UNSPECIFIED לא צוין.
UNKNOWN מייצג ערך לא ידוע בגרסה הזו.
RETRACTION הפונקציה מגבילה את ההמרה כך שהערך הכולל והספירה שלה יהיו אפס.
RESTATEMENT שינוי הערך של המרה.
ENHANCEMENT משלימה המרה קיימת עם מזהי משתמש וסוכן משתמש שסופקו, שיכולים לשמש את Google כדי לשפר את מספר ההמרות.

RestatementValue

מכיל מידע שנדרש כדי להגדיר מחדש את ערך ההמרה.

ייצוג JSON 
{
  "adjustedValue": number,
  "currencyCode": string
}
שדות
adjustedValue

number

ערך ההמרה שנקבע מחדש. זהו הערך של ההמרה לאחר שינוי הדיווח. לדוגמה, כדי לשנות את הערך של המרה מ-100 ל-70, צריך לדווח על ערך מותאם של 70. הערה: אם רוצים להעלות שינוי דיווח שני עם ערך מותאם אחר, צריך להגדיר לו מועד ביצוע התאמה חדש ועדכני יותר. אחרת, המערכת תתייחס אליו כעותק כפול של השינוי הקודם, והמערכת תתעלם ממנו.
currencyCode

string

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

ConversionAdjustmentResult

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

ייצוג JSON 
{
  "gclidDateTimePair": {
    object (GclidDateTimePair)
  },
  "orderId": string,
  "adjustmentType": enum (ConversionAdjustmentType),
  "conversionAction": string,
  "adjustmentDateTime": string
}
שדות
gclidDateTimePair

object (GclidDateTimePair)

ה-gclid ותאריך ההמרה של ההמרה.
orderId

string

מזהה ההזמנה של ההמרה שיש להתאים.
adjustmentType

enum (ConversionAdjustmentType)

סוג ההתאמה.
conversionAction

string

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

string

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