আপনার অ্যাকশনের লিঙ্ক (ডায়ালগফ্লো)

আপনি একটি URL তৈরি করতে পারেন যা নির্দিষ্ট অ্যাকশনের সাথে সরাসরি লিঙ্ক করবে, প্রতি-অ্যাকশন ভিত্তিতে। যে ব্যবহারকারীরা একটি ওয়েব বা মোবাইল ব্রাউজারে অ্যাসিস্ট্যান্ট লিঙ্কে ক্লিক করেন (আগে অ্যাকশন লিঙ্ক বলা হত) তাদের ডিভাইসে অ্যাসিস্ট্যান্টের কাছে পাঠানো হবে, যেখানে তারা সরাসরি আপনার সংশ্লিষ্ট অ্যাকশনের সাথে যোগাযোগ করবে।

সহায়ক সহায়ক লিঙ্কের কিছু উদাহরণের মধ্যে রয়েছে:

কিভাবে-করবেন ওয়েবসাইট থেকে ভয়েস-নির্দেশিত নির্দেশাবলীর সাথে ব্যবহারকারীদের লিঙ্ক করা।
একটি "সহায়তা পান" পৃষ্ঠা থেকে ব্যবহারকারীদের একটি গ্রাহক সহায়তা অভিজ্ঞতার সাথে লিঙ্ক করা।
ব্যবহারকারীদের একটি আপডেটের উদ্দেশ্যের সাথে লিঙ্ক করা যাতে তারা আপনার ভবিষ্যতের আপডেটগুলিতে অপ্ট-ইন করতে পারে৷

একটি কর্মের জন্য একটি URL তৈরি করতে, নিম্নলিখিতগুলি করুন:

অ্যাকশন কনসোলে , ডেভেলপ > অ্যাকশন- এ নেভিগেট করুন।
আপনি যে অ্যাকশনের জন্য একটি লিঙ্ক তৈরি করতে চান সেটিতে ক্লিক করুন।
লিঙ্ক বিভাগের অধীনে, সক্ষম করুন আপনি কি এই কর্মের জন্য একটি URL সক্ষম করতে চান ।
একটি লিঙ্ক শিরোনাম লিখুন. এই শিরোনামে একটি ক্রিয়াপদ অন্তর্ভুক্ত করা উচিত যা ক্রিয়াটি কী করবে তার বর্ণনামূলক। উদাহরণস্বরূপ, যদি আপনার অ্যাকশন ব্যবহারকারীকে একটি কনসার্টের টিকিট কেনার জন্য একটি লেনদেন প্রবাহের নিচে নিয়ে যায়, তাহলে একটি দরকারী লিঙ্ক শিরোনাম হবে "কনসার্টের টিকিট কিনুন"।
Save এ ক্লিক করুন।

আপনি প্রদত্ত URLটি অনুলিপি করতে পারেন এবং যেখানেই আপনি ব্যবহারকারীদের এই নির্দিষ্ট অ্যাকশনে নির্দেশ দিতে চান সেখানে এটি উল্লেখ করতে পারেন।

সহকারী লিঙ্ক প্যারামিটার

অ্যাসিস্ট্যান্ট লিঙ্কে ঐচ্ছিকভাবে ইউআরএলে একটি উদ্দেশ্য এবং প্যারামিটার থাকতে পারে। ইউআরএল-এ উল্লেখ করা উদ্দেশ্যের ধরন অনুযায়ী Google প্যারামিটারগুলি পরিচালনা করে।

সহকারী লিঙ্ক URL স্পেসিফিকেশন

অ্যাসিস্ট্যান্ট লিঙ্কের ইউআরএলের সাধারণ সিনট্যাক্স নিম্নরূপ:

https://assistant.google.com/services/invoke[/$action_id][?intent=$intent&param.$param=$value][&$utm_param=$utm_value]

আপনি যে URL প্যারামিটারগুলি সেট করতে পারেন সেগুলি নিম্নলিখিত টেবিলে বর্ণনা করা হয়েছে:

URL প্যারামিটার	বর্ণনা
`$action_id`	অ্যাকশনের সংখ্যাসূচক শনাক্তকারী।
`$intent`	অন্তর্নির্মিত বা কাস্টম অভিপ্রায়ের সম্পূর্ণ নাম।
`$param`	অ্যাকশন প্যাকেজে নির্দিষ্ট করা একটি ইন্টেন্ট প্যারামিটারের পুরো নাম।
`$value`	অ্যাকশন প্যাকেজে `$param` এর জন্য ঘোষিত প্রকারের URL এনকোড করা মান।
`$utm_param`	এক বা একাধিক UTM প্যারামিটারের তালিকা। বৈধ মানগুলির মধ্যে রয়েছে: `utm_source` , `utm_medium` , `utm_campaign` , `utm_term` , এবং `utm_content` ।
`$utm_value`	UTM প্যারামিটারের স্ট্রিং মান।

বিল্ট-ইন ইন্টেন্ট সহ সহকারী লিঙ্ক URL

অ্যাসিস্ট্যান্ট লিঙ্কে বিল্ট-ইন ইনটেন্ট থাকলে (অভিপ্রায় শুরু হয় actions.intent.* ), Google ইউআরএল-এ যেকোনও বিল্ট-ইন ইনটেন্ট প্যারামিটার বের করে আপনার অ্যাকশনে পাঠানোর চেষ্টা করবে। বিল্ট-ইন ইনটেন্ট প্যারামিটার হিসেবে Google বোঝে না এমন যেকোনও প্যারামিটার ছিনিয়ে নেওয়া হয়।

কথোপকথনমূলক অ্যাকশনের জন্য, AppRequest মেসেজের অংশ হিসেবে Google এই প্যারামিটারগুলি আপনার পূরণে পাঠায়।

নিম্নলিখিত উদাহরণটি দেখায় যে আপনি কীভাবে একটি সহকারী লিঙ্ক URL নির্দিষ্ট করতে পারেন যাতে একটি একক অভিপ্রায় প্যারামিটার সহ একটি অন্তর্নির্মিত অভিপ্রায় অন্তর্ভুক্ত থাকে:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.GET_HOROSCOPE&param.astrologySign=%22cancer%22

কাস্টম ইন্টেন্ট সহ সহকারী লিঙ্ক URL

কাস্টম ইন্টেন্টের জন্য Google শুধুমাত্র সেই প্যারামিটারগুলি বের করে যা আপনার অ্যাকশন দ্বারা অভিপ্রায়ের অংশ হিসাবে সংজ্ঞায়িত করা হয় এবং অন্য কোনও প্যারামিটার বাতিল করে।

নিম্নলিখিত উদাহরণটি দেখায় যে আপনি কীভাবে একটি কাস্টম অভিপ্রায় অন্তর্ভুক্ত সহ একটি সহকারী লিঙ্ক URL নির্দিষ্ট করতে পারেন:

https://assistant.google.com/services/invoke/uid/0000001f575305a0?intent=NEWS_UPDATE_DEEP_LINK&param.topic=sports

উপরের উদাহরণ ইউআরএলের জন্য, AppRequest এ, Google নিম্নরূপ একটি JSON অবজেক্ট যোগ করে:

argument {
  name: ‘topic’,
  raw_text: ‘sports’,
  text_value: ‘sports’,
}

অ্যাসিস্ট্যান্ট লিঙ্ক ইউআরএল, কোনো উদ্দেশ্য ছাড়াই

আপনি যদি অ্যাসিস্ট্যান্ট লিঙ্কে কোনো অভিপ্রায় উল্লেখ না করেন, তাহলে Google আপনার অ্যাকশনের MAIN উদ্দেশ্য ( actions.intent.MAIN ) এর সাথে ডিফল্টভাবে নিম্নলিখিত আচরণের সাথে লিঙ্ক করে:

আপনি যদি অ্যাসিস্ট্যান্ট লিঙ্কে MAIN অভিপ্রায়টি স্পষ্টভাবে সক্ষম না করে থাকেন, তাহলে Google কোনো প্যারামিটার ছাড়াই মূল অভিপ্রায়টিকে ট্রিগার করে, যা "অ্যাপ_নামের সাথে কথা বলুন" এর আচরণের মতো।
আপনি যদি স্পষ্টভাবে MAIN অভিপ্রায় সক্রিয় করেন, Google আপনার অ্যাকশনগুলিতে প্যারামিটারগুলি পাস করে।

নিম্নলিখিত উদাহরণটি দেখায় যে আপনি কীভাবে কোনও উদ্দেশ্য ছাড়াই একটি সহকারী লিঙ্ক URL নির্দিষ্ট করতে পারেন:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4

ইউটিএম প্যারামিটার সহ সহকারী লিঙ্ক URL

ইউটিএম প্যারামিটার হল স্ট্রিং যা ব্যবহারকারীরা অ্যাসিস্ট্যান্ট লিঙ্কে ক্লিক করলে Google আপনার অ্যাকশনে পাঠায়, যা আপনি পরে বিশ্লেষণের জন্য ব্যবহার করতে পারেন।

Google আপনার অ্যাকশনে যে UTM প্যারামিটার পাঠায় সেগুলির মধ্যে নিম্নলিখিতগুলি রয়েছে:

utm_source
utm_medium
utm_campaign
utm_term
utm_content

নিম্নলিখিত উদাহরণটি দেখায় যে আপনি কীভাবে একটি সহকারী লিঙ্ক URL নির্দিষ্ট করতে পারেন যাতে UTM প্যারামিটার রয়েছে:

https://assistant.google.com/services/invoke/uid/000000d139bbc4d4?utm_source=Google&utm_medium=email&utm_campaign=holiday+sale

উপরের ইউআরএলের উদাহরণের জন্য, Google AppRequest বার্তায় নিম্নলিখিত আর্গুমেন্ট যোগ করে:

argument {
  name: ‘utm_source’,
  raw_text: ‘Google’,
  text_value: ‘Google’,
}
argument {
  name: ‘utm_medium’,
  raw_text: ‘email’,
  text_value: ‘email’,
}
argument {
  name: ‘utm_campaign’,
  raw_text: ‘holiday sale’,
  text_value: ‘holiday sale’,
}

সহকারী লিঙ্ক পরীক্ষা করুন

আপনি সিমুলেটর বা ডিভাইসের মাধ্যমে যেকোনো উদ্দেশ্যের (প্রধান বা কাস্টম, প্যারামিটার সহ বা ছাড়া) সহকারী লিঙ্কগুলি পরীক্ষা করতে পারেন।

আপনার সহকারী লিঙ্ক পরীক্ষা করতে:

কনসোলে অ্যাসিস্ট্যান্ট লিঙ্ক চালু করুন।
আপনার অ্যাকশন অন Google প্রোজেক্ট তৈরি করতে আপনি যে অ্যাকাউন্ট ব্যবহার করেছিলেন সেই অ্যাকাউন্ট দিয়ে অ্যাসিস্ট্যান্টে সাইন-ইন করুন।
আপনার সহকারী লিঙ্কের একটি ক্লিকযোগ্য সংস্করণ তৈরি করুন (ইমেল, চ্যাট, ডক ইত্যাদিতে)।
একটি সহকারী সক্ষম ডিভাইসে, পূর্ববর্তী ধাপে তৈরি করা লিঙ্কটিতে ক্লিক করুন৷

আপনি প্রত্যাশিতভাবে অ্যাসিস্ট্যান্ট লিঙ্ক ফাংশন নিশ্চিত করার পরে, আপনার ব্যবহারকারীদের কাছে লিঙ্কটি উপলব্ধ করতে আপনাকে আপনার অ্যাকশন পুনরায় স্থাপন করতে হবে।

সীমাবদ্ধতা এবং সর্বোত্তম অনুশীলন

যেহেতু আপনার অ্যাসিস্ট্যান্ট লিঙ্ক URL এখন ডিরেক্টরি বা অন্যান্য Google পরিষেবার বাইরে বিতরণ এবং উল্লেখ করা যেতে পারে, অনুগ্রহ করে মনে রাখবেন যে নিম্নলিখিত বিধিনিষেধ এবং সর্বোত্তম অনুশীলনগুলি প্রযোজ্য:

নিশ্চিত করুন যে আপনি আপনার সমস্ত অ্যাসিস্ট্যান্ট লিঙ্কগুলিকে সমর্থন করে চলেছেন। যদি আপনি একটি সহকারী লিঙ্ক বিতরণ করেন যেটি পরে ভেঙে যায়, তাহলে আপনার অ্যাকশন প্রকল্প অস্বাস্থ্যকর হিসাবে ফ্ল্যাগ করা হতে পারে এবং সরিয়ে দেওয়া হতে পারে।
একটি লিঙ্ক প্রকাশ করার অর্থ হল আপনি অবিশ্বস্ত উত্স থেকে ট্রিগার সমর্থন করেন৷ যেকোন লিঙ্কড অ্যাকশনের জন্য, যেকোনও "রিয়েল-ওয়ার্ল্ড অ্যাকশন" নেওয়ার আগে আপনাকে অবশ্যই ব্যবহারকারীর সাথে স্পষ্টভাবে নিশ্চিত করতে হবে। উদাহরণস্বরূপ, একটি অ্যাকশন যা একটি স্মার্ট হোম অ্যাপ্লায়েন্স বন্ধ করে দেয় সেটি ব্যবহারকারীকে বলে "আপনি কি নিশ্চিত $applianceName বন্ধ করতে চান?"
এই প্রসঙ্গে, একটি "বাস্তব বিশ্ব কর্ম" হল ব্যবহারকারীর পরিষেবা, ডেটা, ডিভাইস, নেটওয়ার্ক, কম্পিউটার বা API-কে প্রভাবিত করে এমন কোনো ক্রিয়া। উদাহরণস্বরূপ, একটি ইমেল পাঠানো, একটি লেনদেন সম্পাদন করা, একটি স্মার্ট হোম অ্যাপ্লায়েন্সের স্থিতি পরিবর্তন করা, একটি সদস্যতা তৈরি করা, বা সামগ্রীর একটি অংশ আপডেট করা।