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

'Google टैग मैनेजर' की समुदाय टेम्प्लेट गैलरी की मदद से, आपका संगठन टैग और वैरिएबल टेंप्लेट बना और मैनेज कर सकता है. ये टेंप्लेट, 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
ATTRIBUTION	एट्रिब्यूशन
चैट	Chat
कन्वर्ज़न	कन्वर्ज़न मेज़रमेंट
DATA_WAREHOUSING	डेटा वेयरहाउसिंग
EMAIL_MARKETING	ईमेल मार्केटिंग
EXPERIMENTATION	A/B प्रयोग और कॉन्टेंट ऑप्टिमाइज़ेशन
HEAT_MAP	हीट मैप
LEAD_GENERATION	लीड बनाना
MARKETING	Marketing
PERSONALIZATION	मनमुताबिक बनाना
REMARKETING	रीमार्केटिंग
SALES	सेल्स और सीआरएम
SESSION_RECORDING	सेशन रिकॉर्डिंग
SOCIAL	सोशल
सर्वे	सर्वे
TAG_MANAGEMENT	टैग मैनेजमेंट सिस्टम
UTILITY	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 सेक्शन में उल्टे कालक्रमानुसार (सबसे नया वर्शन सबसे पहले और सबसे पुराना वर्शन सबसे आखिर में) शामिल किया जाना चाहिए.

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

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

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

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

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