समुदाय टेंप्लेट गैलरी में कोई टेंप्लेट सबमिट करना

Google Tag Manager की कम्यूनिटी टेंप्लेट गैलरी की मदद से, आपके संगठन को ऐसे टैग और वैरिएबल टेंप्लेट बनाने और मैनेज करने की सुविधा मिलती है जो Google Tag Manager के साथ नेटिव तौर पर इंटिग्रेट होते हैं. आपका संगठन कोई टेंप्लेट बना सकता है और GitHub पर टेंप्लेट डेटाबेस पब्लिश कर सकता है. इसके बाद, अपने टेंप्लेट को कम्यूनिटी टेंप्लेट गैलरी में सबमिट करके, उसे दुनिया भर के उपयोगकर्ताओं के लिए उपलब्ध कराया जा सकता है. आपके संगठन को ये फ़ायदे मिलेंगे:

• आपके क्लाइंट, आपके टेंप्लेट आसानी से जोड़ और इस्तेमाल कर पाएंगे.
• Tag Manager के उपयोगकर्ताओं को आपके संगठन का ब्रैंड दिखेगा.
• आपके क्लाइंट, आपके टैग को महीनों के बजाय कुछ ही मिनटों में डिप्लॉय कर पाएंगे.
• अपने टेंप्लेट में अपडेट पब्लिश किए जा सकते हैं. साथ ही, उन अपडेट को अपने क्लाइंट के लिए अपने-आप उपलब्ध कराया जा सकता है.

समुदाय टेंप्लेट गैलरी में नया टेंप्लेट सबमिट करने के लिए, ये मुख्य चरण पूरे करने होंगे:

1. अपना टेंप्लेट बनाना
2. अपनी प्रोजेक्ट फ़ाइलें तैयार करना
3. GitHub पर अपनी फ़ाइलें अपलोड करना
4. अपना टेंप्लेट सबमिट करना

अपना टेंप्लेट बनाना

शुरू करने के लिए, Google Tag Manager में अपना टेंप्लेट कस्टम टेंप्लेट के तौर पर बनाएं. पक्का करें कि आपके टेंप्लेट की पूरी तरह से जांच की गई हो. साथ ही, यह भी पक्का करें कि आपके टेंप्लेट का कॉन्टेंट स्टाइल गाइड के मुताबिक हो. इसके अलावा, यह भी पक्का करें कि आपके पास अपने टेंप्लेट को बनाए रखने और अपडेट करने का कोई प्लान या प्रोसेस हो, ताकि आने वाले समय में ज़रूरत पड़ने पर ऐसा किया जा सके.

सेवा की शर्तें

सबमिट किए जाने वाले हर नए टेंप्लेट के लिए, Google Tag Manager की कम्यूनिटी टेंप्लेट गैलरी की सेवा की शर्तों को स्वीकार करना ज़रूरी है. अपने टेंप्लेट के लिए, सेवा की शर्तों से सहमति देने की पुष्टि करने के लिए:

1. Google Tag Manager की कम्यूनिटी टेंप्लेट गैलरी की सेवा की शर्तें पढ़ें.
2. टेंप्लेट एडिटर में, बदलाव करने के लिए अपना टेंप्लेट खोलें और जानकारी टैब में जाकर, "कम्यूनिटी टेंप्लेट गैलरी की सेवा की शर्तों से सहमत हूं" लेबल वाले बॉक्स को चुनें.

टेंप्लेट एक्सपोर्ट करना

टेंप्लेट पूरा होने के बाद, टेंप्लेट फ़ाइल को अपनी लोकल मशीन पर एक्सपोर्ट करें और फ़ाइल का नाम बदलकर template.tpl करें.

प्रोजेक्ट फ़ाइलें तैयार करना

अगला चरण, GitHub पर पब्लिश करने के लिए अपनी रिपॉज़िटरी को तैयार करना है. हर रिपॉज़िटरी में ये फ़ाइलें होनी चाहिए:

1. template.tpl नाम की एक्सपोर्ट की गई टेंप्लेट फ़ाइल. categories एंट्री जोड़ने के लिए, इस फ़ाइल को अपडेट करना होगा.
2. metadata.yaml फ़ाइल.
3. LICENSE फ़ाइल. फ़ाइल का नाम अंग्रेज़ी के बड़े अक्षरों में होना चाहिए. साथ ही, लाइसेंस फ़ाइल में सिर्फ़ Apache 2.0 का कॉन्टेंट होना चाहिए.
4. README.md फ़ाइल जोड़ें (ज़रूरी नहीं, लेकिन हमारा सुझाव है कि आप ऐसा करें).

ध्यान दें: GitHub पर मौजूद सैंपल टेंप्लेट रिपॉज़िटरी का इस्तेमाल मॉडल के तौर पर करें. सैंपल टेंप्लेट से LICENSE फ़ाइल को अपने प्रोजेक्ट में कॉपी करें, ताकि यह पक्का किया जा सके कि कॉन्टेंट में कोई गड़बड़ी न हो. साथ ही, सैंपल वर्शन में "Copyright [yyyy] [name of copyright owner]" वाली कॉपीराइट लाइन को ज़रूर अपडेट करें. yyyy की जगह कॉपीराइट का साल और [name of copyright owner] की जगह कॉपीराइट के मालिक का नाम डालें.

template.tpl में कैटगरी जोड़ना

अपनी template.tpl फ़ाइल को INFO सेक्शन में categories एंट्री के साथ अपडेट करें. साथ ही, नीचे दी गई टेबल से चुनी गई कम से कम एक काम की कैटगरी वैल्यू दें. अगर एक से ज़्यादा कैटगरी सही हैं, तो कैटगरी की तीन वैल्यू दी जा सकती हैं. इन वैल्यू को सबसे काम की से लेकर सबसे कम काम की के क्रम में लगाया जाना चाहिए.

ध्यान दें: categories एंट्री की वैल्यू को ऐरे के तौर पर फ़ॉर्मैट किया जाना चाहिए.

उदाहरण:

___INFO___

{
  "displayName": "Example Template",
  "categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
  // additional template properties, etc...
}

इस्तेमाल की जा सकने वाली कैटगरी वैल्यू की टेबल:

कैटगरी	ब्यौरा
विज्ञापन	विज्ञापन
AFFILIATE_MARKETING	अफ़िलिएट मार्केटिंग
ANALYTICS	Analytics
विशेषता	एट्रिब्यूशन
चैट	चैट करें
कन्वर्ज़न	कन्वर्ज़न मेज़रमेंट
DATA_WAREHOUSING	डेटा वेयरहाउस
EMAIL_MARKETING	ईमेल मार्केटिंग
एक्सपेरिमेंट	A/B प्रयोग और कॉन्टेंट ऑप्टिमाइज़ेशन
HEAT_MAP	हीट मैप
LEAD_GENERATION	लीड बनाना
मार्केटिंग	Marketing
कॉन्टेंट को उपयोगकर्ता के हिसाब से बनाना	मनमुताबिक बनाना
रीमार्केटिंग	रीमार्केटिंग
सेल	बिक्री और सीआरएम
SESSION_RECORDING	सेशन की रिकॉर्डिंग
सामाजिक	सोशल
सर्वे	सर्वे
TAG_MANAGEMENT	टैग मैनेजमेंट सिस्टम
उपयोगिता	Google Tag Manager की सुविधाएं

metadata.yaml

metadata.yaml फ़ाइल में आपके टेंप्लेट के बारे में जानकारी होती है. इसमें आपके संगठन के होम पेज, टेंप्लेट के दस्तावेज़, और वर्शन की जानकारी के लिंक शामिल होते हैं. हर वर्शन को बदलाव के नंबर से दिखाया जाता है. इसे SHA नंबर भी कहा जाता है. यह Git कमिट से जुड़ा बदलाव नंबर होता है. changeNotes फ़ील्ड की वैल्यू देना ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इस फ़ील्ड की वैल्यू दें, ताकि आपके उपयोगकर्ताओं को वर्शन में किए गए बदलावों के बारे में पता चल सके.

metadata.yaml फ़ाइल सेट अप करने के लिए:

1. कोई एंट्री homepage जोड़ें. यह ऐसा यूआरएल होना चाहिए जो आपके संगठन के होम पेज पर ले जाता हो.
2. documentation के लिए कोई एंट्री जोड़ें. यह ऐसा यूआरएल होना चाहिए जो आपके टेंप्लेट के दस्तावेज़ पर ले जाता हो.
3. GitHub में, वह कमिट ढूंढें जिसमें वे बदलाव शामिल हैं जिन्हें आपको अपने टेंप्लेट के शुरुआती वर्शन के लिए पुश करना है. इसके बाद, SHA नंबर कॉपी करें. GitHub में SHA नंबर पाने का आसान तरीका यह है कि कमिट व्यू पर जाएं और क्लिपबोर्ड आइकॉन () पर क्लिक करें. इससे पूरा SHA नंबर आपके क्लिपबोर्ड पर कॉपी हो जाएगा. उस नंबर को versions नोड के चाइल्ड के तौर पर, अपनी sha एंट्री की वैल्यू के तौर पर चिपकाएं, जैसा कि यहां दिखाया गया है.
4. इस नए वर्शन में किए गए बदलावों के बारे में कम शब्दों में बताने के लिए, versions नोड में changeNotes एंट्री जोड़ें.

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

अहम जानकारी: sha और changeNotes को ऊपर दिए गए कोड के उदाहरण में दिखाए गए तरीके से अलाइन किया जाना चाहिए.

ध्यान दें: sha वैल्यू में उस खास template.tpl फ़ाइल का रेफ़रंस होना चाहिए जिसे आपको पब्लिश करना है. हर नए वर्शन के साथ, इस वैल्यू को सही तरीके से अपडेट करना न भूलें!

GitHub पर अपलोड करना

अगला चरण, अपनी फ़ाइलों को GitHub पर अपलोड करना है. ऊपर बताए गए तरीके के मुताबिक, सही फ़ाइलों और स्ट्रक्चर के साथ GitHub रिपॉज़िटरी बनाएं.

टेंप्लेट रिपॉज़िटरी में, Git रिपॉज़िटरी के रूट लेवल पर * template.tpl, metadata.yaml, और LICENSE फ़ाइलें होनी चाहिए. हर Git रिपॉज़िटरी में सिर्फ़ एक template.tpl फ़ाइल होनी चाहिए. सभी संसाधन, आपके GitHub रिपॉज़िटरी की मुख्य शाखा में होने चाहिए. इस स्ट्रक्चर से मेल न खाने वाले किसी भी टेंप्लेट को गैलरी से हटा दिया जाएगा.

कम्यूनिटी टेंप्लेट गैलरी में मौजूद हर एंट्री, टेंप्लेट के GitHub डेटा संग्रह स्थान के समस्याएं सेक्शन से लिंक होगी. इससे, उपयोगकर्ताओं को किसी बग का पता चलने पर, आपको इसकी सूचना देने में मदद मिलेगी. पक्का करें कि आपके टेंप्लेट के GitHub डेटा स्टोर करने की जगह के लिए, समस्याओं को बंद न किया गया हो. इससे, आपको आने वाली किसी भी समस्या की समीक्षा करने और उसे ठीक करने में मदद मिलेगी.

अपना टेंप्लेट सबमिट करना

जब आपका टेंप्लेट डेटा स्टोर करने की जगह GitHub पर होस्ट हो जाए, तब कम्यूनिटी टेंप्लेट गैलरी में अपना टेंप्लेट सबमिट किया जा सकता है. टेंप्लेट सबमिट करने के लिए, यह तरीका अपनाएं:

1. पक्का करें कि आपने GitHub में उस खाते से साइन इन किया हो जिसके पास उस टेंप्लेट रिपॉज़िटरी का ऐक्सेस है जिसे आपको गैलरी में जोड़ना है.
2. tagmanager.google.com/gallery पर जाकर, कम्यूनिटी टेंप्लेट गैलरी पर जाएं.
3. पर क्लिक करें और टेंप्लेट सबमिट करें चुनें.
4. दिए गए फ़ील्ड में रिपॉज़िटरी का यूआरएल डालें और सबमिट करें पर क्लिक करें.

अपना टेंप्लेट अपडेट करना

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

metadata.yaml फ़ाइल का इस्तेमाल यह तय करने के लिए किया जाता है कि गैलरी में आपके टेंप्लेट के किस वर्शन का इस्तेमाल करना है. नए वर्शन पब्लिश करने के लिए, आपको अपनी metadata.yaml फ़ाइल के versions सेक्शन में बदलाव नंबर (SHA नंबर) जोड़ना होगा.

1. वह कमिट ढूंढें जिसमें वे बदलाव शामिल हैं जिन्हें आपको पुश करना है. इसके बाद, SHA नंबर कॉपी करें. GitHub में, कमिट व्यू पर जाकर और क्लिपबोर्ड आइकॉन () पर क्लिक करके, यह आसानी से किया जा सकता है. इससे पूरा SHA नंबर आपके क्लिपबोर्ड पर कॉपी हो जाएगा.
2. metadata.yaml में, versions सूची में सबसे ऊपर नई sha एंट्री जोड़ें. (नीचे दिया गया उदाहरण देखें.)
3. इस नए वर्शन में किए गए बदलावों के बारे में कम शब्दों में बताने के लिए, changeNotes जोड़ें. आपके पास एक से ज़्यादा लाइन वाली टिप्पणियां बनाने का विकल्प होता है. (नीचे दिया गया उदाहरण देखें.)
4. बदलाव को metadata.yaml में लागू करें. आम तौर पर, आपका अपडेट दो से तीन दिनों में गैलरी में दिखने लगेगा.

इस उदाहरण में, नए वर्शन की जानकारी जोड़ने का तरीका बताया गया है. इसमें SHA नंबर और बदलाव के नोट भी शामिल हैं:

homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
  # Latest version
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874c
    changeNotes: |2
      Fix bug with the whatsamajig.
      Improve menu options.
      Update API calls.
  # Older versions
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874b
    changeNotes: Adds eject button.
  - sha: 5f02a788b90ae804f86b04aa24af8937e567874a
    changeNotes: Initial release.

अहम जानकारी: टेंप्लेट का हर पब्लिश किया गया वर्शन, versions सेक्शन में शामिल किया जाना चाहिए. साथ ही, इसे समय के हिसाब से उलटे क्रम (सबसे नए से सबसे पुराने) में क्रम से लगाया जाना चाहिए.

ध्यान दें: कम्यूनिटी टेंप्लेट गैलरी में, हर इंक्रीमेंटल कमिट को वर्शन में हुए बदलाव के तौर पर शामिल करने की ज़रूरत नहीं है. उदाहरण के लिए, अगर आपने पहले, दूसरे, और तीसरे कंपिटमेंट में क्रम से बदलाव किए हैं और फ़ाइनल वर्शन चौथा कंपिटमेंट है, तो आपके पास चौथे कंपिटमेंट के लिए सिर्फ़ एक एंट्री होनी चाहिए. इसमें पहले, दूसरे, और तीसरे कंपिटमेंट के सभी बदलाव शामिल होने चाहिए.

अपनी रिपॉज़िटरी को दूसरी जगह ले जाना

अगर आपको मालिकाना हक या रिपॉज़िटरी के नाम बदलने हैं, तो GitHub रिपॉज़िटरी ट्रांसफ़र करने की प्रोसेस का इस्तेमाल करें. नई जगह का पता चल जाएगा और उपयोगकर्ताओं को अगली बार टेंप्लेट अपडेट करने पर, अपने-आप नई रिपॉज़िटरी पर भेज दिया जाएगा.

अपना टेंप्लेट हटाना

टेंप्लेट को गैलरी से हटाने के लिए, उसके रिपॉज़िटरी से LICENSE फ़ाइल या metadata.yaml फ़ाइल को मिटाएं. गैलरी मॉनिटरिंग सिस्टम इस बदलाव का पता लगाएगा और टेंप्लेट को अपने-आप हटा देगा.