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

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
विशेषता	एट्रिब्यूशन
चैट	चैट करें
कन्वर्ज़न	कन्वर्ज़न मेज़रमेंट
DATA_WAREHOUSING	डेटा वेयरहाउसिंग
EMAIL_MARKETING	विपणन संबंधी ईमेल
एक्सपेरिमेंट करना	A/B एक्सपेरिमेंट और कॉन्टेंट ऑप्टिमाइज़ेशन
HEAT_MAP	हीट मैप
LEAD_GENERATION	लीड जनरेशन
मार्केटिंग	मार्केटिंग
पसंद के मुताबिक बनाना	पसंद के मुताबिक सुझाव देना
रीमार्केटिंग	रीमार्केटिंग
सेल	बिक्री और सीआरएम
SESSION_RECORDING	सेशन रिकॉर्डिंग
SOCIAL	सोशल
सर्वे	सर्वे
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 में परिवर्तन करें और आपका अपडेट गैलरी में आमतौर पर 2 से 3 दिनों में दिखाई देगा.

यह उदाहरण बताता है कि 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 के सभी बदलाव शामिल होने चाहिए.