ניהול הגדרות התשלום

תכונת ההפניה לדף התשלום מאפשרת ללקוחות שמוכנים לקנות לעבור ישירות מכרטיסי המוצר ב-Google לדף התשלום או לדף עגלת הקניות באתר שלכם. כך אפשר לשפר את שיעורי ההמרה ולשפר את חוויית הקנייה.

באמצעות Merchant API, אפשר לנהל את ההגדרות של התכונה הזו באמצעות המשאב CheckoutSettings.

במדריך הזה מוסבר איך להשתמש ב-Merchant API כדי ליצור ולנהל את ההרשמה לתכונה 'תשלום' באופן פרוגרמטי.

מידע נוסף זמין במאמר הוספת קישור לדף תשלום עבור מוצרים.

דרישות מוקדמות

כדי להשתמש במשאב CheckoutSettings ובשיטות המשויכות, צריך לבצע את הפעולות הבאות:

  • אתם צריכים לקבל אישור להשתתף במודעות שופינג, בכרטיסי מוצר חינמיים או בשניהם, ולהשתתף בהם.
  • מדינת המכירה חייבת להיות ארצות הברית.

Methods

כדי ליצור, לאחזר, לעדכן ולמחוק הגדרות של תהליך התשלום, אפשר להשתמש בשיטות הבאות:

יצירת הגדרות תשלום

כדי ליצור הגדרת תשלום, משתמשים בשיטה checkoutSettings.create. כוללים את השדה uri_settings עם הערך checkout_uri_template או cart_uri_template ואת הערך שנבחר בשדה eligible_destinations בגוף הבקשה.

הנה דוגמה לבקשה:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

מחליפים את {ACCOUNT_ID} במזהה הייחודי של חשבון Merchant Center.

זוהי דוגמה לתגובה מקריאה מוצלחת:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

אחזור של הגדרות התשלום

כדי לאחזר את הגדרות התשלום, כולל תבנית כתובת ה-URL, היעדים שנבחרו, סטטוס ההרשמה וסטטוס בדיקת כתובת ה-URL, משתמשים ב-method‏ checkoutSettings.get.

הנה דוגמה לבקשה:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

זוהי דוגמה לתגובה מקריאה מוצלחת:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

עדכון הגדרות התשלום

כדי לעדכן את הגדרות התשלום בקופה, משתמשים בשיטה checkoutSettings.update. כוללים את השדות שרוצים לשנות בגוף הבקשה ומציינים את השדות האלה בפרמטר השאילתה update_mask.

update_mask תומך בשדות הבאים:

  • eligible_destinations
  • uri_settings

הנה דוגמה לבקשה לעדכון כתובת ה-URL ולהסרת יעד המודעות:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

זוהי דוגמה לתגובה מקריאה מוצלחת:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

מחיקה

כדי למחוק את הגדרות התשלום, משתמשים בשיטה checkoutSettings.delete.

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

הנה דוגמה לבקשה:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

אם הקריאה מסתיימת בהצלחה, מוחזר גוף תגובה ריק.

יש שתי דרכים לספק כתובות URL של דפי תשלום למוצרים:

  • ברמת החשבון (API משני או Merchant Center): כדי להגדיר תבנית יחידה של כתובת URL, checkout_uri_template או cart_uri_template, אפשר להשתמש ב-API המשני או בהגדרות של Merchant Center. התבנית הזו חלה על כל המוצרים שעומדים בדרישות. מומלץ להשתמש בכתובת URL עקבית בכל המוצרים. לדוגמה, yourstore.com/checkout?id={id}.

  • ברמת המוצר (פיד): כדי לספק כתובת URL ספציפית לדף תשלום של מוצרים ספציפיים, משתמשים במאפיין checkout_link_template בפיד המוצרים. כך תוכלו ליצור כתובות URL בהתאמה אישית לכל מוצר, או להציע תשלום רק לקבוצת משנה של מלאי שטחי הפרסום.

  • אם מגדירים תבנית של כתובת URL ברמת החשבון באמצעות ה-API המשני הזה, חשוב לוודא שלא שולחים ערכים למאפיין checkout_link_template בפיד של המוצרים האלה.

  • אם אתם משתמשים במאפיין הפיד checkout_link_template, חשוב לוודא שאתם לא מגדירים תבנית של כתובת URL ברמת החשבון באמצעות ה-API המשני או ההגדרות של Merchant Center. אם אתם מנהלים את כתובות ה-URL רק דרך הפיד, עדיין תוכלו להשתמש ב-API המשני כדי לבחור את eligible_destinations בלי לספק את uri_settings.

תבנית של כתובת URL שמובילה לדף תשלום

התבנית של כתובת ה-URL לדף התשלום מאפשרת לכלול בנתוני המוצרים כתובת URL לדף התשלום, שמספקת לקונים באינטרנט את האפשרות לעבור מכרטיסי המוצר שלכם ישירות לדף התשלום. הוא חייב לכלול פלייסהולדר של הפרמטר {ID} ולכלול דומיין תואם.

כשמגדירים קישורי תשלום באמצעות ה-API המשני, משתמשים בשדה uri_settings. בשדה הזה אפשר להזין אחת משתי תבניות:

  • checkout_uri_template: תבנית של כתובת URL, שבה, כשהתו המשתנה למיקום ה-placeholder מתמלא, המשתמש מופנה לדף התשלום עם הפריט הספציפי שזמין לרכישה.
  • cart_uri_template: תבנית של כתובת URL שמפנה את המשתמש לדף עגלת הקניות, שכבר נוספו אליו הפריט הספציפי.

תבניות לדוגמה

  • תשלום: https://www.your-store.com/checkout?item_id={id}
  • עגלת קניות: https://shop.your-store.com/add_to_cart?product_sku={id}

צריך לעמוד בדרישות הבאות:

  • תבנית כתובת ה-URL חייבת להפנות לדף תקין באתר שלכם, שתואם לדומיין הרשום שלכם, פועל בשיטה HTTP GET ולא מחייב את הלקוח להיכנס לחשבון.
  • הדומיין מתבנית התשלום שסיפקתם חייב להיות זהה לדומיין של המוצר.

מידע נוסף