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

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 में कैटगरी जोड़ें

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

ध्यान दें: 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 रेपो बनाएं.

टेंप्लेट डेटा स्टोर करने की जगहों में * template.tpl, metadata.yaml, और LICENSE फ़ाइलें होनी चाहिए. ये फ़ाइलें, Git रिपॉज़िटरी के रूट लेवल पर मौजूद होती हैं. हर 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 के सभी बदलाव शामिल हों.