सीधे तौर पर चेकआउट पेज पर जाने की सुविधा की मदद से, खरीदारी करने के लिए तैयार ग्राहक तुरंत खरीदारी कर पाते हैं. इसके लिए, उन्हें 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को चुनने के लिए, सब-एपीआई का इस्तेमाल किया जा सकता है.
चेकआउट पेज का यूआरएल टेंप्लेट
चेकआउट पेज के यूआरएल का टेंप्लेट [checkout_url_template] एट्रिब्यूट की मदद से, प्रॉडक्ट डेटा में चेकआउट पेज का यूआरएल शामिल किया जा सकता है. इससे ऑनलाइन खरीदारी करने वाले लोगों को, आपकी लिस्टिंग से सीधे आपके चेकआउट पेज पर जाने का विकल्प मिलता है. इसमें {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तरीके का इस्तेमाल करके काम करता हो और इसके लिए खरीदार को साइन इन करने की ज़रूरत न पड़े. - दिए गए चेकआउट टेंप्लेट का डोमेन, प्रॉडक्ट के डोमेन से मेल खाना चाहिए.