চেকআউট বৈশিষ্ট্যটি কিনতে প্রস্তুত গ্রাহকদের জন্য ক্রয়কে দ্রুততর করে, তাদের Google পণ্য তালিকা থেকে সরাসরি আপনার ওয়েবসাইটের কার্ট বা চেকআউট পৃষ্ঠায় যেতে দেয়, যা রূপান্তর হার উন্নত করতে পারে এবং কেনাকাটার অভিজ্ঞতা মসৃণ করতে পারে।
Merchant API এর মাধ্যমে, আপনি CheckoutSettings রিসোর্স ব্যবহার করে এই বৈশিষ্ট্যের সেটিংস পরিচালনা করতে পারেন।
এই নির্দেশিকাটি ব্যাখ্যা করে যে কীভাবে মার্চেন্ট API ব্যবহার করে চেকআউট বৈশিষ্ট্যটি প্রোগ্রাম্যাটিকভাবে তৈরি এবং পরিচালনা করবেন।
আরও তথ্যের জন্য, আপনার পণ্যের জন্য একটি চেকআউট লিঙ্ক যোগ করুন দেখুন।
পূর্বশর্ত
CheckoutSettings রিসোর্স এবং সংশ্লিষ্ট পদ্ধতিগুলি ব্যবহার করতে, নিম্নলিখিতগুলি করতে ভুলবেন না:
- আপনাকে অবশ্যই শপিং বিজ্ঞাপন, বিনামূল্যের তালিকা, অথবা উভয়ের জন্য অনুমোদিত হতে হবে এবং অংশগ্রহণ করতে হবে।
- আপনার বিক্রয় দেশ অবশ্যই মার্কিন যুক্তরাষ্ট্র হতে হবে।
পদ্ধতি
চেকআউট সেটিংস তৈরি, পুনরুদ্ধার, আপডেট এবং মুছে ফেলার জন্য, আপনি নিম্নলিখিত পদ্ধতিগুলি ব্যবহার করতে পারেন:
চেকআউট সেটিংস তৈরি করুন
চেকআউট সেটিং তৈরি করতে, checkoutSettings.create পদ্ধতিটি ব্যবহার করুন। অনুরোধের মূল অংশে checkout_uri_template অথবা cart_uri_template সহ uri_settings এবং নির্বাচিত 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} প্রতিস্থাপন করুন।
একটি সফল কলের নমুনা প্রতিক্রিয়া এখানে দেওয়া হল:
{
"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 প্রদান করার দুটি উপায় আছে:
অ্যাকাউন্ট-স্তর (সাব-এপিআই অথবা মার্চেন্ট সেন্টার): একটি একক ইউআরএল টেমপ্লেট,
checkout_uri_templateঅথবাcart_uri_template, নির্ধারণ করতে আপনি সাব-এপিআই অথবা মার্চেন্ট সেন্টার সেটিংস ব্যবহার করতে পারেন। এই টেমপ্লেটটি আপনার সমস্ত যোগ্য পণ্যের ক্ষেত্রে প্রয়োগ করা হয়। আমরা সুপারিশ করছি যে আপনার সমস্ত পণ্য জুড়ে একটি সামঞ্জস্যপূর্ণ ইউআরএল থাকুক। উদাহরণস্বরূপ,yourstore.com/checkout?id={id}।পণ্য-স্তর (ফিড): প্রতিটি পণ্যের জন্য একটি নির্দিষ্ট চেকআউট URL প্রদান করতে, আপনার পণ্য ফিডে
checkout_link_templateঅ্যাট্রিবিউট ব্যবহার করুন। এটি প্রতিটি পণ্যের জন্য কাস্টমাইজড URL তৈরি করতে দেয় অথবা শুধুমাত্র আপনার ইনভেন্টরির একটি উপসেটের জন্য চেকআউট অফার করতে দেয়।আপনি যদি এই সাব-এপিআই ব্যবহার করে একটি অ্যাকাউন্ট-স্তরের URL টেমপ্লেট সেট করেন, তাহলে নিশ্চিত করুন যে আপনি সেই পণ্যগুলির জন্য আপনার ফিডে
checkout_link_templateঅ্যাট্রিবিউটের জন্য মান জমা দিচ্ছেন না।যদি আপনি
checkout_link_templateফিড অ্যাট্রিবিউট ব্যবহার করেন, তাহলে সাব-এপিআই বা মার্চেন্ট সেন্টার সেটিংস ব্যবহার করে অ্যাকাউন্ট-স্তরের URL টেমপ্লেট সেট না করেই নিশ্চিত করুন। আপনি যদি শুধুমাত্র ফিডের মাধ্যমে URL পরিচালনা করেন তবেuri_settingsপ্রদান না করেওeligible_destinationsনির্বাচন করতে সাব-এপিআই ব্যবহার করতে পারেন।
চেকআউট URL টেমপ্লেট
চেকআউট URL টেমপ্লেট আপনাকে আপনার পণ্যের ডেটাতে একটি চেকআউট URL অন্তর্ভুক্ত করতে দেয় যা অনলাইন ক্রেতাদের আপনার তালিকা থেকে সরাসরি আপনার চেকআউট পৃষ্ঠায় যাওয়ার বিকল্প দেয়। এতে {ID} প্যারামিটার প্লেসহোল্ডার থাকতে হবে এবং একটি মিলিত ডোমেন থাকতে হবে।
সাব-এপিআই ব্যবহার করে চেকআউট লিঙ্ক সেট আপ করার সময়, uri_settings ক্ষেত্রটি ব্যবহার করুন। এই ক্ষেত্রটি দুটি টেমপ্লেটের মধ্যে একটি গ্রহণ করে:
-
checkout_uri_template: একটি URL টেমপ্লেট যা, স্থানধারক পূরণ হয়ে গেলে, ব্যবহারকারীকে আপনার চেকআউট পৃষ্ঠায় নিয়ে যায় যেখানে নির্দিষ্ট আইটেমটি কেনার জন্য প্রস্তুত থাকে। -
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পদ্ধতি ব্যবহার করে কাজ করে এবং গ্রাহককে সাইন ইন করার প্রয়োজন হয় না। - প্রদত্ত চেকআউট টেমপ্লেটের ডোমেনটি অবশ্যই পণ্য ডোমেনের সাথে মিলবে।