- בקשת HTTP
- פרמטרים של נתיב
- גוף הבקשה
- גוף התשובה
- היקפי הרשאות
- ConversionAdjustment
- GclidDateTimePair
- ConversionAdjustmentType
- RestatementValue
- ConversionAdjustmentResult
- רוצים לנסות?
מעבד את ההתאמות הנתונות של ההמרות.
רשימה של שגיאות הטמעה: AuthenticationError AuthorizationError HeaderError InternalError PartialFailureError QuotaError RequestError
בקשת HTTP
POST https://googleads.googleapis.com/v15/customers/{customerId}:uploadConversionAdjustments
בכתובת ה-URL נעשה שימוש בתחביר המרת gRPC.
פרמטרים של נתיב
פרמטרים | |
---|---|
customerId |
חובה. מספר הלקוח שמבצע את ההעלאה. |
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{
"conversionAdjustments": [
{
object ( |
שדות | |
---|---|
conversionAdjustments[] |
חובה. ההתאמות של ערכי ההמרות שמעלים. |
partialFailure |
חובה. אם הערך הוא true, יבוצעו פעולות מוצלחות ופעולות לא חוקיות יחזירו שגיאות. אם הערך הוא False, כל הפעולות יבוצעו בעסקה אחת אך ורק אם כולן תקינות. תמיד צריך להגדיר את הערך True. מידע נוסף על כשל חלקי זמין בכתובת https://developers.google.com/google-ads/api/docs/best-practices/partial-failures. |
validateOnly |
אם הערך הוא true, הבקשה מאומתת אבל לא מבוצעת. רק שגיאות מוחזרות, לא תוצאות. |
jobId |
אפשרות. אפשר להזין כאן קלט אופציונלי להגדרת מזהה המשימה. חייב להיות מספר לא שלילי שקטן מ-2^31 אם צוין. אם לא מזינים את השדה הזה, ה-API ייצור מזהה משימה בטווח [ 2^31, (2^63)-1]. ה-API יחזיר את הערך של הבקשה הזו בשדה |
גוף התגובה
הודעת תשובה לגבי ConversionAdjustmentUploadService.UploadConversionAdjustments
.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכלול נתונים במבנה הבא:
ייצוג JSON |
---|
{ "partialFailureError": { object ( |
שדות | |
---|---|
partialFailureError |
שגיאות שמתייחסות לכשלים בהתאמות של ערכי המרות במצב של כשל חלקי. מוחזרת כאשר כל השגיאות מתרחשות בתוך ההתאמות. אם מתרחשות שגיאות שלא קשורות להתאמות (לדוגמה, שגיאות אימות), נחזיר הודעת שגיאה ברמת ה-RPC. מידע נוסף על כשל חלקי זמין בכתובת https://developers.google.com/google-ads/api/docs/best-practices/partial-failures. |
results[] |
הוחזר בגלל התאמות של ערכי המרות שעובדו בהצלחה. קובץ Proto יהיה ריק בשורות שהתקבלה בהן שגיאה. התוצאות לא מוחזרות כאשר הערך של validateOnly הוא TRUE. |
jobId |
מזהה המשימה שמיועדת להעלאת הקובץ. |
היקפי הרשאות
נדרש היקף OAuth הבא:
https://www.googleapis.com/auth/adwords
למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
ConversionAdjustment
שינוי ערך המרה.
ייצוג JSON |
---|
{ "gclidDateTimePair": { object ( |
שדות | |
---|---|
gclidDateTimePair |
להתאמות, המערכת מזהה באופן ייחודי המרה שדווחה בלי לציין מזהה הזמנה. אם סוג ההתאמה הוא ENHANCEMENT, הערך הזה הוא אופציונלי, אבל אפשר להגדיר אותו בנוסף ל-orderId. |
adjustmentType |
סוג ההתאמה. |
restatementValue |
מידע שנדרש כדי להגדיר מחדש את ערך ההמרה. נדרש לניסוחים מחדש. אין לספק עבור ביטולי תלונות. אם הוגשה בקשת ביטול, תוחזר שגיאה. הערה: אם אתם רוצים להעלות שינוי דיווח שני עם ערך מותאם אחר, חייבת להיות לו מועד ביצוע חדש ועדכני יותר של ההתאמה. אחרת, המערכת תתייחס אליה כעותק כפול של השינוי הקודם, והמערכת תתעלם ממנו. |
userIdentifiers[] |
מזהי המשתמש שנועדו לשפר את ההמרה המקורית. ConversionAdjustmentUploadService מקבל רק מזהי משתמשים במסגרת שיפורים. כל שיפור יכול לכלול עד 5 מזהי משתמשים. |
orderId |
מזהה ההזמנה של ההמרה שיש להתאים. אם דיווח על ההמרה וצוין בה מזהה הזמנה, צריך להשתמש במזהה ההזמנה הזה כמזהה כאן. מזהה ההזמנה נדרש עבור שיפורים. |
conversionAction |
שם המשאב של פעולת ההמרה המשויכת לשינוי ההמרה הזה. הערה: שם המשאב הזה כולל מספר לקוח ומזהה פעולת המרה, אבל המערכת תתעלם ממספר הלקוח ותשתמש במזהה פעולת ההמרה כמזהה היחיד של פעולת ההמרה. |
adjustmentDateTime |
התאריך והשעה שבהם בוצעה ההתאמה. הערך חייב להיות אחרי conversionDateTime. חובה לציין את אזור הזמן. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm'. לדוגמה, '2019-01-01 12:32:45-08:00'. |
userAgent |
סוכן המשתמש שישפר את ההמרה המקורית. אפשר למצוא את הבקשה הזו בכותרת בקשת ה-HTTP של המשתמש כשהוא מבצע המרה בדף האינטרנט שלכם. לדוגמה, 'Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 כגון Mac OS X)'. אפשר לציין סוכן משתמש רק בשיפורים עם מזהי משתמש. הערך הזה צריך להיות זהה לסוכן המשתמש של הבקשה ששלחה את ההמרה המקורית, כך שההמרה והשיפור שלה ישויכו שניהם לאותו מכשיר או שניהם ישויכו כמכשירים אחרים. |
GclidDateTimePair
מזהה באופן ייחודי המרה שדווחה מבלי לציין מזהה הזמנה.
ייצוג JSON |
---|
{ "gclid": string, "conversionDateTime": string } |
שדות | |
---|---|
gclid |
מספר הקליק ב-Google (gclid) המשויך להמרה המקורית עבור ההתאמה הזו. |
conversionDateTime |
התאריך שבו התרחשה ההמרה המקורית המשויכת להתאמה הזו. חובה לציין את אזור הזמן. הפורמט הוא '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 |
ערך ההמרה שהוגדר מחדש. זהו הערך של ההמרה לאחר שינוי הדיווח. לדוגמה, כדי לשנות את הערך של המרה מ-100 ל-70, צריך לדווח על ערך מותאם של 70. הערה: אם אתם רוצים להעלות שינוי דיווח שני עם ערך מותאם אחר, חייבת להיות לו מועד ביצוע חדש ועדכני יותר של ההתאמה. אחרת, המערכת תתייחס אליה כעותק כפול של השינוי הקודם, והמערכת תתעלם ממנו. |
currencyCode |
המטבע של הערך שמוגדר מחדש. אם לא תגדירו אותו, המערכת תשתמש במטבע שמוגדר כברירת מחדל מפעולת ההמרה. אם הוא לא יוגדר, המערכת תשתמש במטבע שמוגדר כברירת מחדל בחשבון. זהו קוד המטבע בן 3 התווים לפי תקן ISO 4217, לדוגמה: USD או EUR. |
ConversionAdjustmentResult
מידע שמזהה התאמת המרה שעובדה בהצלחה.
ייצוג JSON |
---|
{ "gclidDateTimePair": { object ( |
שדות | |
---|---|
gclidDateTimePair |
ה-gclid ותאריך ההמרה של ההמרה. |
orderId |
מזהה ההזמנה של ההמרה שיש להתאים. |
adjustmentType |
סוג ההתאמה. |
conversionAction |
שם המשאב של פעולת ההמרה המשויכת לשינוי ההמרה הזה. |
adjustmentDateTime |
התאריך והשעה שבהם בוצעה ההתאמה. הפורמט הוא 'yyyy-mm-dd hh:mm:ss+|-hh:mm'. לדוגמה, '2019-01-01 12:32:45-08:00'. |