सीधे तौर पर चेकआउट पेज पर जाने की सुविधा से, खरीदारी करने के लिए तैयार लोगों को तुरंत खरीदारी करने में मदद मिलती है. इससे वे Google पर दिखाई जाने वाली प्रॉडक्ट लिस्टिंग से सीधे तौर पर आपकी वेबसाइट के कार्ट या चेकआउट पेज पर जा सकते हैं. इससे कन्वर्ज़न रेट को बेहतर बनाने और खरीदारी के अनुभव को बेहतर बनाने में मदद मिल सकती है.
Merchant API की मदद से, इस सुविधा की सेटिंग मैनेज की जा सकती हैं. इसके लिए, CheckoutSettings रिसोर्स का इस्तेमाल करें.
इस गाइड में, Merchant API का इस्तेमाल करके, चेकआउट की सुविधा के लिए प्रोग्राम के ज़रिए रजिस्टर करने और उसे मैनेज करने का तरीका बताया गया है.
ज़्यादा जानकारी के लिए, अपने प्रॉडक्ट के लिए चेकआउट पेज का लिंक जोड़ना लेख पढ़ें.
ज़रूरी शर्तें
CheckoutSettings रिसॉर्स और उससे जुड़े तरीकों का इस्तेमाल करने के लिए, यह पक्का करें कि आपने ये काम किए हों:
- आपको शॉपिंग विज्ञापनों, मुफ़्त में दिखाई जाने वाली लिस्टिंग या दोनों में हिस्सा लेने की मंज़ूरी मिली हो.
- आपके डेटा फ़ीड में शामिल प्रॉडक्ट, अमेरिका में बेचे जाने चाहिए.
तरीके
चेकआउट सेटिंग बनाने, वापस पाने, अपडेट करने, और मिटाने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है:
चेकआउट की सेटिंग बनाना
चेकआउट सेटिंग बनाने के लिए, 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"
}
चेकआउट की सेटिंग वापस पाना
यूआरएल टेंप्लेट, चुने गए डेस्टिनेशन, रजिस्टर करने की स्थिति, और यूआरएल की समीक्षा की स्थिति जैसी चेकआउट सेटिंग वापस पाने के लिए, 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_destinationsuri_settings
यूआरएल अपडेट करने और विज्ञापन का डेस्टिनेशन हटाने के अनुरोध का सैंपल यहां दिया गया है:
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
कॉल पूरा होने पर, जवाब के मुख्य हिस्से में कोई डेटा नहीं होता.
खाता-लेवल के चेकआउट लिंक बनाम प्रॉडक्ट-लेवल के चेकआउट लिंक
अपने प्रॉडक्ट के लिए चेकआउट पेज के यूआरएल देने के दो तरीके हैं:
खाते के लेवल पर (सब-एपीआई या Merchant Center): एक यूआरएल टेंप्लेट,
checkout_uri_templateयाcart_uri_templateको तय करने के लिए, सब-एपीआई या Merchant Center की सेटिंग का इस्तेमाल किया जा सकता है. यह टेंप्लेट, ज़रूरी शर्तें पूरी करने वाले सभी प्रॉडक्ट पर लागू होता है. हमारा सुझाव है कि आपके सभी प्रॉडक्ट के लिए, एक जैसा यूआरएल हो. उदाहरण के लिए,yourstore.com/checkout?id={id}.प्रॉडक्ट लेवल (फ़ीड): अलग-अलग प्रॉडक्ट के लिए चेकआउट पेज का यूआरएल देने के लिए, अपने प्रॉडक्ट फ़ीड में
checkout_link_templateएट्रिब्यूट का इस्तेमाल करें. इससे हर प्रॉडक्ट के लिए यूआरएल को पसंद के मुताबिक बनाया जा सकता है. इसके अलावा, इससे आपको अपनी इन्वेंट्री के सिर्फ़ कुछ प्रॉडक्ट के लिए चेकआउट की सुविधा देने का विकल्प मिलता है.अगर आपने इस सब-एपीआई का इस्तेमाल करके, खाते के लेवल पर यूआरएल टेंप्लेट सेट किया है, तो पक्का करें कि आपने उन प्रॉडक्ट के लिए अपने फ़ीड में
checkout_link_templateएट्रिब्यूट की वैल्यू सबमिट न की हों.अगर
checkout_link_templateफ़ीड एट्रिब्यूट का इस्तेमाल किया जाता है, तो पक्का करें कि आपने सब-एपीआई या Merchant Center की सेटिंग का इस्तेमाल करके, खाते के लेवल पर यूआरएल टेंप्लेट सेट न किया हो. अगर यूआरएल सिर्फ़ फ़ीड के ज़रिए मैनेज किए जा रहे हैं, तोuri_settingsकी जानकारी दिए बिना भीeligible_destinationsको चुनने के लिए, सब-एपीआई का इस्तेमाल किया जा सकता है.
चेकआउट पेज के यूआरएल टेंप्लेट
चेकआउट वाले यूआरएल के टेंप्लेट की मदद से, प्रॉडक्ट डेटा में चेकआउट का यूआरएल शामिल किया जा सकता है. इससे ऑनलाइन खरीदारी करने वाले लोगों को, लिस्टिंग से सीधे आपके चेकआउट पेज पर जाने का विकल्प मिलता है. इसमें {ID} पैरामीटर प्लेसहोल्डर होना चाहिए और इसका डोमेन, मैचिंग डोमेन होना चाहिए.
सब-एपीआई का इस्तेमाल करके चेकआउट लिंक सेट अप करते समय, uri_settings फ़ील्ड का इस्तेमाल करें.
इस फ़ील्ड में, इनमें से कोई एक टेंप्लेट इस्तेमाल किया जा सकता है:
checkout_uri_template: यह एक यूआरएल टेंप्लेट होता है. इसमें प्लेसहोल्डर की वैल्यू भरने पर, उपयोगकर्ता को आपके चेकआउट पेज पर भेज दिया जाता है. इस पेज पर, वह प्रॉडक्ट खरीदने के लिए तैयार होता है जिसे उसने चुना है.cart_uri_template: यह एक यूआरएल टेंप्लेट है. यह उपयोगकर्ता को आपके शॉपिंग कार्ट पेज पर ले जाता है. साथ ही, कार्ट में जोड़ा गया प्रॉडक्ट भी दिखाता है.
उदाहरण के लिए टेंप्लेट
- चेकआउट:
https://www.your-store.com/checkout?item_id={id} - कार्ट:
https://shop.your-store.com/add_to_cart?product_sku={id}
पक्का करें कि आपने इन ज़रूरी शर्तों को पूरा किया हो:
- आपका यूआरएल टेंप्लेट, आपकी साइट के ऐसे मान्य पेज पर ले जाना चाहिए जो आपके रजिस्टर किए गए डोमेन से मेल खाता हो. साथ ही, यह
HTTP GETतरीके का इस्तेमाल करके काम करता हो और इसके लिए ग्राहक को साइन इन करने की ज़रूरत न हो. - चेकआउट के लिए दिए गए टेंप्लेट का डोमेन, प्रॉडक्ट के डोमेन से मेल खाना चाहिए.