Method: customers.uploadConversionAdjustments

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

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

בקשת HTTP

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

להתאמות, המערכת מזהה באופן ייחודי המרה שדווחה בלי לציין מזהה הזמנה. אם סוג ההתאמה הוא 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'.