Assistant के लिंक

आपके पास ऐसा यूआरएल जनरेट करने का विकल्प है जो आपकी सेट की गई कार्रवाई के किसी इंटेंट से सीधे तौर पर जुड़ा हो. किसी वेब या मोबाइल ब्राउज़र में Assistant के लिंक (जिसे पहले कार्रवाई के लिंक कहा जाता था) पर क्लिक करने वाले लोगों को अपने डिवाइस पर, Assistant के पास भेज दिया जाता है. यहां वे आपकी सेट की गई कार्रवाई से सीधे तौर पर इंटरैक्ट करते हैं.

Assistant के लिंक, डायरेक्ट्री के वेब लिंक से अलग होते हैं, जो लोगों को Assistant की डायरेक्ट्री में मौजूद, आपकी सेट की गई कार्रवाई के पेज पर भेजते हैं.

यहां कुछ ऐसे मामले दिए गए हैं जिनमें Assistant के लिंक काम के हो सकते हैं:

  • उपयोगकर्ताओं को किसी वेबसाइट पर, बोलकर दिए जाने वाले निर्देशों के साथ लिंक करना.
  • उपयोगकर्ताओं को एक सहायता पेज से, ग्राहक सहायता अनुभव से लिंक करना.
  • उपयोगकर्ताओं को किसी अपडेट इंटेंट से लिंक करना, ताकि वे आने वाले समय में होने वाले अपडेट के लिए ऑप्ट-इन कर सकें.

आप Actions कंसोल में, अपने प्रोजेक्ट में Assistant के लिंक जनरेट कर सकते हैं. Assistant लिंक सभी डिप्लॉयमेंट चैनलों (ऐल्फ़ा, बीटा, और प्रोडक्शन) पर उपलब्ध हैं. उदाहरण के लिए, अगर आपकी सेट की गई कार्रवाई के ऐल्फ़ा वर्शन में आपका Assistant लिंक चालू है, तो यह लिंक ऐल्फ़ा टेस्टर के लिए उपलब्ध होगा.

किसी कार्रवाई के लिए यूआरएल जनरेट करने के लिए, यह तरीका अपनाएं:

  1. Actions कंसोल में, डिप्लॉय करें > Assistant के लिंक पर जाएं.
  2. इंटेंट के लिए वह इंटेंट चुनें जिसके लिए आपको लिंक जनरेट करना है.
  3. क्या आपको इंटेंट_name के लिए लिंक करने की सुविधा चालू करनी है? विकल्प को चालू करें.
  4. (ज़रूरी नहीं) कैंपेन पैरामीटर सेक्शन में, ऐसी कोई भी जानकारी डालें जिसे आपको लिंक में यूआरएल पैरामीटर के तौर पर भी कैप्चर करना है.
  5. (ज़रूरी नहीं) लिंक का टाइटल डालें. कार्रवाई क्या करती है, यह बताने के लिए इस टाइटल का इस्तेमाल करें. उदाहरण के लिए, अगर आपकी सेट की गई कार्रवाई, उपयोगकर्ता को किसी कॉन्सर्ट के टिकट खरीदने के लिए लेन-देन फ़्लो पर ले जाती है, तो आपके लिंक का टाइटल "कॉन्सर्ट के टिकट खरीदें" हो सकता है.

अपनी जानकारी डालने के बाद, Assistant लिंक के लिए जनरेट किया गया यूआरएल या जनरेट किया गया कोड स्निपेट देखा जा सकता है और उसे कॉपी किया जा सकता है. लोगों को इस खास कार्रवाई पर ले जाने के लिए, Assistant के लिंक का इस्तेमाल करें.

आप सिम्युलेटर के ज़रिए या डिवाइस पर किसी भी इंटेंट (मुख्य या पसंद के मुताबिक, पैरामीटर के साथ या उसके बिना) के लिए Assistant के लिंक की जाँच कर सकते हैं.

किसी डिवाइस पर Assistant के लिंक की जाँच करने के लिए, यह तरीक़ा अपनाएँ:

  1. Actions कंसोल में Assistant का लिंक जनरेट करें.
  2. Assistant के लिंक को ईमेल, चैट मैसेज या दूसरे फ़ॉर्मैट में खुद को यूआरएल के तौर पर भेजें.
  3. Assistant की सुविधा वाले डिवाइस पर, उसी खाते से Assistant में साइन इन करें जिसका इस्तेमाल आपने अपना Actions प्रोजेक्ट बनाने के लिए किया था.
  4. उसी डिवाइस पर, Assistant के उस लिंक पर क्लिक करें जिसे आपने खुद को भेजा था.

Assistant के लिंक के सही फ़ंक्शन की पुष्टि होने के बाद, आपको अपनी सेट की गई कार्रवाई को फिर से डिप्लॉय करना होगा, ताकि आपके उपयोगकर्ताओं को लिंक उपलब्ध कराया जा सके.

Assistant लिंक के यूआरएल में, वैकल्पिक तौर पर एक इंटेंट और पैरामीटर शामिल हो सकते हैं. कैंपेन पैरामीटर जोड़ने के लिए, कैंपेन पैरामीटर सेक्शन का इस्तेमाल करें.

जब Assistant के लिंक में कोई अतिरिक्त पैरामीटर नहीं होता, तब Google Assistant आपकी सेट की गई कार्रवाई के MAIN इंटेंट (actions.intent.MAIN) को इस तरह से लिंक करती है:

  • अगर आपने Assistant के लिंक में MAIN इंटेंट को साफ़ तौर पर चालू नहीं किया है, तो Assistant बिना किसी पैरामीटर के मुख्य इंटेंट से मैच करेगी. यह "app_name से बात करें" की कार्रवाई जैसी ही होती है.
  • अगर आपने साफ़ तौर पर MAIN इंटेंट को चालू किया है, तो Assistant आपकी कार्रवाइयों में पैरामीटर पास करती है.

यहां बिना किसी अतिरिक्त पैरामीटर के MAIN इंटेंट का इस्तेमाल करके, Assistant लिंक यूआरएल का एक उदाहरण दिया गया है:

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

Assistant के लिंक के यूआरएल का सामान्य सिंटैक्स इस तरह है:

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

आप जिन यूआरएल पैरामीटर को सेट कर सकते हैं उनकी जानकारी इस टेबल में दी गई है:

यूआरएल पैरामीटर ब्यौरा
$action_id कार्रवाई का संख्या वाला आइडेंटिफ़ायर.
$intent बिल्ट-इन या उपयोगकर्ता के इंटेंट का पूरा नाम.
$param कार्रवाई पैकेज में दिए गए इंटेंट पैरामीटर का पूरा नाम.
$value कार्रवाई पैकेज में, $param के लिए बताए गए टाइप की यूआरएल कोड में बदली गई वैल्यू.
$utm_param एक या एक से ज़्यादा UTM पैरामीटर टाइप की सूची. मान्य वैल्यू में ये शामिल हैं: utm_source, utm_medium, utm_campaign, utm_term, और utm_content.
$utm_value UTM पैरामीटर की स्ट्रिंग की वैल्यू.

अगर Assistant के लिंक में कोई बिल्ट-इन इंटेंट है (इंटेंट actions.intent. से शुरू होता है), तो Google Assistant यूआरएल से किसी भी बिल्ट-इन इंटेंट पैरामीटर को निकालने की कोशिश करती है और उन्हें आपकी सेट की गई कार्रवाई में भेज देती है. ऐसे सभी पैरामीटर हटा दिए जाते हैं जो Assistant को बिल्ट-इन इंटेंट पैरामीटर के तौर पर नहीं समझते हैं.

बातचीत की सुविधा वाली कार्रवाइयों के लिए, Assistant ये पैरामीटर AppRequest मैसेज के हिस्से के तौर पर, आपके ऑर्डर पूरा करने के लिए भेजती है.

यहां दिए गए उदाहरण में बताया गया है कि किसी Assistant लिंक का यूआरएल कैसे तय किया जा सकता है, जिसमें एक ही इंटेंट पैरामीटर वाला बिल्ट-इन इंटेंट शामिल हो:

https://assistant.google.com/services/invoke/uid/0000008ddd7eabec?intent=actions.intent.PLAY_GAME&param.name=%22ExampleGame%22

उपयोगकर्ता के इंटेंट के लिए, Google Assistant सिर्फ़ उन पैरामीटर को एक्सट्रैक्ट करती है जो आपकी सेट की गई कार्रवाई में इंटेंट के तौर पर तय किए गए हों. Google Assistant किसी भी दूसरे पैरामीटर को मिटा देती है.

यहां दिए गए उदाहरण में बताया गया है कि ऐसे Assistant लिंक का यूआरएल कैसे तय किया जा सकता है जिसमें उपयोगकर्ता की दिलचस्पी शामिल हो:

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

ऊपर दिए गए उदाहरण के यूआरएल के लिए, AppRequest में Assistant एक JSON ऑब्जेक्ट जोड़ती है. ऐसा इस तरह से किया जाता है:

argument {
  name: 'topic',
  raw_text: 'sports',
  text_value: 'sports',
}

UTM पैरामीटर ऐसी स्ट्रिंग होती हैं जिन्हें Google Assistant आपकी कार्रवाई को तब भेजती है, जब उपयोगकर्ता किसी Assistant लिंक पर क्लिक करते हैं. इन स्ट्रिंग में शामिल जानकारी का इस्तेमाल, बाद में आंकड़ों के लिए किया जा सकता है.

आपकी सेट की गई कार्रवाई को Assistant जो UTM पैरामीटर भेजता है उनमें ये शामिल हैं:

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

यहां दिए गए उदाहरण में बताया गया है कि ऐसे Assistant लिंक का यूआरएल कैसे तय किया जा सकता है जिसमें UTM पैरामीटर शामिल हों:

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

ऊपर दिए गए उदाहरण के यूआरएल के लिए, Assistant 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',
}

बेहतर Assistant लिंक की मदद से,असिस्ट.js का इस्तेमाल करके आपकी वेबसाइट के ज़रिए, आपकी सेट की गई कार्रवाई को ज़्यादा लोग आसानी से खोज सकते हैं. उपयोगकर्ता आपकी सेट की गई कार्रवाई को आज़मा सकते हैं. साथ ही, खाता लिंक करने की सुविधा का इस्तेमाल करके, अपने Google खाते को आपकी सेवा से लिंक कर सकते हैं.

जब कोई उपयोगकर्ता आपकी वेबसाइट पर आता है, तो उसे "Google Assistant के साथ आज़माएं" बटन दिखता है. यह बटन, रिच Assistant लिंक फ़्लो को ट्रिगर करता है.

अपनी सेट की गई कार्रवाई के लिए खाता लिंक करने की सुविधा चालू करने पर, लोग आपकी सेट की गई कार्रवाई को Assistant की सुविधा वाले किसी भी डिवाइस पर ऐक्सेस कर सकते हैं. इसके अलावा, उपयोगकर्ता अपने खाते को आपकी सेवा के साथ अपने Google खाते से लिंक कर सकते हैं, जिससे उन्हें ज़्यादा मनमुताबिक अनुभव मिलता है.

खाता लिंक करने के साथ इस्तेमाल किए जाने पर, रिच असिस्टेंट लिंक, आपके अनुमति देने वाले यूआरएल का इस्तेमाल करता है. यह यूआरएल, Actions कंसोल में आपके प्रोजेक्ट में सेट होता है. ज़्यादा जानकारी के लिए, खाता लिंक करने से जुड़ा दस्तावेज़ देखें.

ज़रूरी शर्तें

रिच असिस्टेंट वाले लिंक इस्तेमाल करने के लिए, आपको इन चीज़ों की ज़रूरत होगी:

लोकल डेवलपमेंट

अपनी वेबसाइट पर बेहतर Assistant लिंक शामिल करने के लिए, नीचे दिए गए चरणों को पूरा करें:

  1. <PROJECT_ID> की जगह अपने कार्रवाई प्रोजेक्ट आईडी का इस्तेमाल करके, अपने पेज पर यह JavaScript लाइब्रेरी शामिल करें:

    <script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
</script>

  2. नीचे दिया गया एचटीएमएल टैग अपने पेज पर कहीं भी जोड़ें. इससे इनलाइन "Google Assistant के साथ आज़माएं" बटन लोड होता है:

    <google-assistant-link-group>
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

पहले से ट्रिगर करना

अगर आपको यह तय करना है कि जब उपयोगकर्ता आपके पेज पर पहली बार आएं, तब Assistant का रिच लिंक फ़्लो अपने-आप शुरू हो जाए, तो <google-assistant-proactive-link> टैग का इस्तेमाल करें. जब इस टैग को लागू किया जाता है, तो उपयोगकर्ता जब पहली बार वेबसाइट पर आते हैं, तब लिंक चालू हो जाता है. इसके लिए, इनलाइन बटन को नहीं चुना जाता.

  1. अपने Assistant लिंक किए गए ग्रुप टैग में कोई id जोड़ें:

    <google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

  2. अपने वेबपेज पर <google-assistant-proactive-action-link> टैग रखें और उसकी groupId एट्रिब्यूट को id पर सेट करें:

    <google-assistant-link-group id="my-group">
  <!-- One or more <google-assistant-link> tags -->
  <google-assistant-link href="{ASSISTANT_LINK_1}">
  </google-assistant-link>
  <google-assistant-link href="{ASSISTANT_LINK_2}">
  </google-assistant-link>
</google-assistant-link-group>

<google-assistant-proactive-link
groupId="my-group">
</google-assistant-proactive-link>

डिप्लॉयमेंट

Assistant के रिच लिंक सिर्फ़ उन डोमेन के लिए काम करते हैं जिनका मालिकाना हक आपके पास है और जिनकी Google पर पुष्टि हो चुकी है. स्थानीय तौर पर डेवलप करते समय, कार्रवाई प्रोजेक्ट को ऐक्सेस करने, अपने Google खाते में लॉग इन करने, और अपने स्क्रिप्ट टैग में dev=true क्वेरी पैरामीटर सेट करने से इस ज़रूरी शर्त को बायपास किया जाता है.

  <script async
    src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}&dev=true">
  </script>

अपनी सेट की गई कार्रवाई को, ऐसे लिंक के साथ डिप्लॉय करने के लिए जो Assistant के बेहतर लिंक का इस्तेमाल करते हैं:

  1. अपना सार्वजनिक डोमेन रजिस्टर करने के लिए, डिप्लॉय करें > ब्रैंड की पुष्टि > साइट कनेक्ट करें में जाकर, कार्रवाइयां कंसोल में अपना डोमेन रजिस्टर करें.

  2. स्क्रिप्ट से dev=true क्वेरी पैरामीटर हटाएं:

    <script async
src="https://actions.google.com/api/assist.js?projectId={PROJECT_ID}">
</script>

पाबंदियां और सबसे सही तरीके

नीचे दी गई पाबंदियां और सबसे सही तरीके लागू होते हैं, ताकि Assistant लिंक के यूआरएल को डायरेक्ट्री या Google की अन्य सेवाओं से बाहर भी उपलब्ध कराया जा सके और उसका रेफ़रंस दिया जा सके:

  • Assistant के सभी लिंक पर काम करना जारी रखें. अगर आपने कोई ऐसा Assistant लिंक दिया है जो बाद में टूट जाता है, तो आपके Actions प्रोजेक्ट को 'खराब' के तौर पर फ़्लैग करके हटा दिया जाएगा.

  • लिंक पब्लिश करने का मतलब है कि आपको गैर-भरोसेमंद सोर्स से ट्रिगर करने की सुविधा मिलती है. लिंक की गई किसी भी कार्रवाई के लिए, आपको असल में की जाने वाली कोई भी कार्रवाई करने से पहले, उपयोगकर्ता से साफ़ तौर पर पुष्टि करनी होगी. उदाहरण के लिए, अगर कोई कार्रवाई स्मार्ट होम को बंद कर देती है, तो उपयोगकर्ता से कहा जाना चाहिए कि, "क्या आपको वाकई $applianceName को बंद करना है?"

    इस संदर्भ में, ऐसी कार्रवाई जो उपयोगकर्ता की सेवाओं, डेटा, डिवाइस, नेटवर्क, कंप्यूटर या एपीआई पर असर डालती है. उदाहरण के लिए, ईमेल भेजना, लेन-देन करना, स्मार्ट होम डिवाइस की स्थिति में बदलाव करना, सदस्यता बनाना या किसी कॉन्टेंट को अपडेट करना.