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

תכונת ההפניה לדף התשלום מאפשרת ללקוחות שמוכנים לבצע רכישה לעבור ישירות מכרטיסי מוצר ב-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, משתמשים בשיטה 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 של דפי תשלום על מוצרים:

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

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

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

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

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

מאפיין התבנית של כתובת URL לתשלום מאפשר לכם לכלול בנתוני המוצרים כתובת URL שבעזרתה הקונים באינטרנט יוכלו לעבור מכרטיסי המוצר שלכם ישירות לדף התשלום. היא חייבת להכיל את ה-placeholder של הפרמטר {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 ולא לדרוש מהלקוח להיכנס לחשבון.
  • הדומיין שמופיע בתבנית דף התשלום שסיפקתם צריך להיות זהה לדומיין של המוצר.

מידע נוסף