TagManager

पब्लिक क्लास TagManager

यह Google Tag Manager (GTM) को मोबाइल पर लागू करने का तरीका है. इस्तेमाल के उदाहरण:

 Container container = TagManager.getInstance(context).openContainer(myContainerId);
 String value = container.getString("myKey");

 DataLayer dataLayer = TagManager.getInstance(context).getDataLayer();
 dataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", "Main Page"));

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

Container क्लास, किसी कुंजी के ज़रिए दी गई वैल्यू को वापस पाने के तरीके उपलब्ध कराती है. रूटीन getBoolean(String), getDouble(String), getLong(String), getString(String) मौजूदा वैल्यू दिखाएं मान मेमोरी मैक्रो की कुंजी के लिए मान, कंटेनर से जुड़े नियमों के आधार पर.

उदाहरण के लिए, अगर आपके कंटेनर में मान इकट्ठा करने वाला मैक्रो है, जिसकी speed कुंजी है, जिसकी वैल्यू 32 है और चालू करने का नियम Language है "en"; और एक अन्य वैल्यू कलेक्शन speed कुंजी वाला मैक्रो, जिसकी मान 45 है और सक्षम करने का नियम यह है Language "en" नहीं है, फिर यह कॉल किया जा रहा है:

 container.getLong("speed")

डिवाइस की मौजूदा भाषा अंग्रेज़ी होने पर, कोड 32 लौटाएगा या 45 दिखाएगा.

डेटा लेयर एक मैप है, जिसमें ऐप्लिकेशन के बारे में सामान्य जानकारी होती है. DataLayer क्लास, डेटा लेयर से डेटा पुश करने और वापस पाने के तरीके उपलब्ध कराती है. event कुंजी को डेटा लेयर में पुश करने से, इस इवेंट से मैच करने वाले टैग बन जाएंगे कुछ भी नहीं करना है.

कंटेनर का शुरुआती वर्शन, ऐप्लिकेशन के साथ बंडल किया जाता है. यह ऐसा होना चाहिए tagmanager/containerId नाम वाली एसेट के तौर पर डाली जाती है, जहां containerId एक जैसी होती है कंटेनर आईडी का इस्तेमाल करें, जिसका इस्तेमाल इस एपीआई में किया जाएगा. openContainer(String, Container.Callback) को कॉल करने पर, कंटेनर बंडल किए गए नियमों/मैक्रो के साथ लौटाए जाएंगे. आपको यूज़र इंटरफ़ेस (यूआई) में कंटेनर बनाना होगा और उसे डाउनलोड करने के लिए 'डाउनलोड करें' बटन का इस्तेमाल करना होगा.

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

डाउनलोड किए गए कंटेनर को डिवाइस में सेव किया गया हो; जब आप openContainer(String, Container.Callback) को कॉल करेंगे, तो सबसे पहले डिफ़ॉल्ट कंटेनर लोड करेगा और फिर सभी सेव किए गए कंटेनर को एसिंक्रोनस रूप से लोड करेगा. अगर कोई नहीं है मिलता है या अगर यह 12 घंटे से ज़्यादा पुराना है, तो यह नेटवर्क से नया वर्शन पाने की कोशिश करेगा. उन एसिंक्रोनस लोड का स्टेटस देखने के लिए, openContainer(String, Container.Callback) के लिए Container.Callback.

हो सकता है कि कभी-कभी आप एक ऐसा कंटेनर उपलब्ध न होने तक ब्लॉक करना चाहें, जो डिफ़ॉल्ट नहीं है या जब तक हाल का ताज़ा कंटेनर उपलब्ध है. ContainerOpener एक यूटिलिटी क्लास है जो आपकी मदद कर सकती है.

कंटेनर बनाने के बाद, close() को कॉल करें.

नेस्ट की गई क्लास की खास जानकारी

इंटरफ़ेस	TagManager.Logger		गड़बड़ी/चेतावनी/जानकारी/डीबग/वर्बज़ लॉगिंग के लिए एक आसान इंटरफ़ेस.
enum	TagManager.RefreshMode		कंटेनर को रीफ़्रेश करने का मोड.

सार्वजनिक तौर पर उपलब्ध तरीके के बारे में खास जानकारी

कंटेनर	getContainer(स्ट्रिंग containerId)
संदर्भ	getContext()
DataLayer	getDataLayer()
स्टैटिक TagManager	getInstance(कॉन्टेक्स्ट कॉन्टेक्स्ट)
लॉगर	getLogger()
TagManager.RefreshMode	getRefreshMode()
कंटेनर	openContainer(स्ट्रिंग containerId, Container.Callback कॉलबैक)
अमान्य	setLogger(Logger logger)
अमान्य	setRefreshMode(TagManager.RefreshMode mode)

सार्वजनिक तरीके

सार्वजनिक कंटेनर getContainer (स्ट्रिंग containerId)

containerId से जुड़ा खुला कंटेनर दिखाता है; अगर कंटेनर पहले से खुला नहीं है, तो यह null दिखाता है.

सार्वजनिक संदर्भ getContext ()

इस ऑब्जेक्ट से जुड़ा सेव किया गया संदर्भ दिखाता है.

सार्वजनिक DataLayer getDataLayer ()

वह डेटा लेयर ऑब्जेक्ट दिखाता है जिसका इस्तेमाल टैग मैनेजर करता है.

सार्वजनिक स्टैटिक TagManager getInstance (संदर्भ संदर्भ)

TagManager क्लास का सिंगलटन इंस्टेंस पाएं. इसके लिए, ज़रूरी होने पर इसे बनाएं.

सार्वजनिक लॉगर getLogger ()

वह लॉगर दिखाता है जिसका इस्तेमाल Tag Manager में किया जा रहा है.

सार्वजनिक TagManager.RefreshMode getRefreshMode ()

सभी कंटेनर के लिए इस्तेमाल किए जाने वाले रीफ़्रेश मोड को दिखाता है.

सार्वजनिक कंटेनर openContainer (स्ट्रिंग containerId, Container.Callback containerId)

कंटेनर दिखाता है. कॉलबैक कई चीज़ों के लिए कॉल किया जाएगा कंटेनर. कम से कम, OpenContainer, कंटेनर. अगर सेव किया गया कोई वर्शन नहीं है या सेव किया गया वर्शन पुराना है, तो को नेटवर्क से लोड करने के लिए बनाया जाएगा.

आम तौर पर, लौटाया गया कंटेनर खाली होगा, लेकिन लोडिंग एक अलग कंटेनर पर होगी थ्रेड हो, ताकि लौटाए गए कंटेनर को वापस आने से पहले, वापस आने के बाद, रीफ़्रेश किया जा सके, या कभी रीफ़्रेश नहीं किया जा सकता (उदाहरण के लिए, जीवनकाल के दौरान कोई नेटवर्क कनेक्शन नहीं रहा कंटेनर के लिए).

अगर आपने openContainer को किसी containerId के लिए दूसरी बार कॉल किया है, तो अपवाद को निकाल दिया जाएगा.

पैरामीटर

containerId	खोलने के लिए कंटेनर का आईडी
कॉलबैक	एक ऐसा ऑब्जेक्ट जिसके अलग-अलग तरीकों को, लोड होने के कुछ हिस्सों के दौरान कॉल किया जाएगा प्रोसेस. ध्यान दें कि तरीकों को अलग-अलग थ्रेड से कॉल किया जा सकता है. साथ ही, वे openContainer के लौटाने से पहले कॉल किया जाएगा.

सार्वजनिक अमान्य setLogger (लॉगर लॉगर)

Tag Manager में इस्तेमाल किए जा रहे मौजूदा लॉगर को बदल देता है.

सार्वजनिक अमान्य setRefreshMode (TagManager.RefreshMode मोड)

सभी कंटेनर के लिए इस्तेमाल होने वाला रीफ़्रेश मोड सेट करता है.