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

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

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

מידע נוסף