Unity के लिए Google Analytics प्लग इन - एपीआई का संदर्भ

इस दस्तावेज़ में डेटा भेजने का तरीका बताया गया है और Unity के लिए Google Analytics प्लग इन की सभी विधियों की सूची दी गई है.

शुरुआती जानकारी

Unity के लिए GA प्लगिन का इस्तेमाल करके, Google Analytics को डेटा भेजते समय, बेसिक तरीके या Builder तरीके का इस्तेमाल किया जा सकता है. अगर आपको हिट में कैंपेन पैरामीटर या कस्टम डाइमेंशन या मेट्रिक जोड़नी हैं, तो बिल्डर तरीके जोड़ना ज़रूरी है. हिट को एक-दूसरे की जगह पर किसी भी तरीके का इस्तेमाल करके भेजा जा सकता है.

अपने प्रोजेक्ट के लिए, Unity के लिए Google Analytics प्लग इन को सेटअप और कॉन्फ़िगर करने के लिए, डेवलपर की गाइड का पालन करें.

सामान्य

डिस्पैच हिट

नेटवर्क कनेक्शन उपलब्ध होने पर, Google Analytics को हिट (व्यू, इवेंट वगैरह) भेजा जाता है.

public void DispatchHits();

इसी विषय से जुड़े लिंक:

सेशन कंट्रोल

सेशन, आपके गेम के साथ उपयोगकर्ता के इंटरैक्शन की एक अवधि को दिखाता है. सेशन, मेज़र की गई गतिविधि के काम के कंटेनर के तौर पर काम करते हैं. इनमें स्क्रीन व्यू, इवेंट, और ई-कॉमर्स लेन-देन शामिल हैं.

किसी सेशन को ज़बरदस्ती शुरू या खत्म करने के लिए, इन तरीकों का इस्तेमाल किया जा सकता है.

// Start a new session.
public void StartSession();

// There should be no need to end a session explicitly. However, if you do
// need to indicate the end of session you can use the following method.
public void StopSession();

इसी विषय से जुड़े लिंक:

स्क्रीन

Google Analytics की स्क्रीन उस कॉन्टेंट को दिखाती हैं जिसे उपयोगकर्ता आपके गेम में देख रहे हैं. स्क्रीन व्यू में एक स्ट्रिंग फ़ील्ड होता है, जिसका इस्तेमाल आपकी Google Analytics रिपोर्ट में स्क्रीन नाम के रूप में किया जाएगा.

सामान्य टिकट

public void LogScreen(string title);

निर्माता

public void LogScreen(AppViewHitBuilder builder);

उदाहरण

googleAnalytics.LogScreen("Main Menu");

//Builder Hit with all App View parameters (all parameters required):
googleAnalytics.LogScreen(new AppViewHitBuilder()
    .SetScreenName("Main Menu"));

इसी विषय से जुड़े लिंक:

इवेंट

इवेंट, आपके गेम के इंटरैक्टिव कॉम्पोनेंट के साथ उपयोगकर्ता के इंटरैक्शन का डेटा इकट्ठा करने का एक उपयोगी तरीका है, जैसे किसी खास आइटम का इस्तेमाल. इवेंट में चार फ़ील्ड होते हैं, जिनका इस्तेमाल आप अपने गेम के साथ किसी उपयोगकर्ता के इंटरैक्शन की जानकारी देने के लिए कर सकते हैं.

सामान्य टिकट

public void LogEvent(string eventCategory,
    string eventAction,
    string eventLabel,
    long value);

निर्माता

public void LogEvent(EventHitBuilder builder);

उदाहरण

googleAnalytics.LogEvent("Achievement", "Unlocked", "Slay 10 dragons", 5);

// Builder Hit with all Event parameters.
googleAnalytics.LogEvent(new EventHitBuilder()
    .SetEventCategory("Achievement")
    .SetEventAction("Unlocked")
    .SetEventLabel("Slay 10 dragons")
    .SetEventValue(5));

// Builder Hit with minimum required Event parameters.
googleAnalytics.LogEvent(new EventHitBuilder()
    .SetEventCategory("Achievement")
    .SetEventAction("Unlocked"));

इसी विषय से जुड़े लिंक:

क्रैश और अपवाद

क्रैश और अपवाद के मेज़रमेंट की मदद से, अपने गेम में होने वाले अपवादों और पकड़े गए और नहीं पढ़े गए क्रैश की संख्या और उनके टाइप का पता लगाया जा सकता है.

सामान्य टिकट

public void LogException(string exceptionDescription, bool isFatal);

निर्माता

public void LogException(ExceptionHitBuilder builder);

उदाहरण

googleAnalytics.LogException("Incorrect input exception", true);

// Builder Hit with all Exception parameters.
googleAnalytics.LogException(new ExceptionHitBuilder()
    .SetExceptionDescription("Incorrect input exception")
    .SetFatal(true));

// Builder Hit with minimum required Exception parameters.
googleAnalytics.LogException(new ExceptionHitBuilder());

इसी विषय से जुड़े लिंक:

उपयोगकर्ता समय

उपयोगकर्ता समय को मापने से, Google Analytics में किसी खास समयावधि को मापने का एक आसान तरीका उपलब्ध होता है. उदाहरण के लिए, यह संसाधन लोड होने में लगने वाले समय को मापने में काम आ सकता है.

सामान्य टिकट

public void LogTiming(string timingCategory,
    long timingInterval,
    string timingName,
    string timingLabel);

निर्माता

public void LogTiming(TimingHitBuilder builder);

उदाहरण

googleAnalytics.LogTiming("Loading", 50L, "Main Menu", "First Load");

// Builder Hit with all Timing parameters.
googleAnalytics.LogTiming(new TimingHitBuilder()
    .SetTimingCategory("Loading")
    .SetTimingInterval(50L)
    .SetTimingName("Main Menu")
    .SetTimingLabel("First load"));

// Builder Hit with minimum required Timing parameters.
googleAnalytics.LogTiming(new TimingHitBuilder()
    .SetTimingCategory("Loading")
    .SetTimingInterval(50L));

इसी विषय से जुड़े लिंक:

सामाजिक इंटरैक्शन

सोशल इंटरैक्शन मेज़रमेंट की मदद से, अपनी कॉन्टेंट में एम्बेड किए गए, अलग-अलग सोशल नेटवर्क शेयरिंग और सुझाव वाले विजेट के साथ, उपयोगकर्ता के इंटरैक्शन को मेज़र किया जा सकता है.

सामान्य टिकट

public void LogSocial(string socialNetwork,
    string socialAction,
    string socialTarget);

निर्माता

public void LogSocial(SocialHitBuilder builder);

उदाहरण

googleAnalytics.LogSocial("twitter", "retweet", "twitter.com/googleanalytics/status/482210840234295296");

// Builder Hit with all Social parameters.
googleAnalytics.LogSocial(new SocialHitBuilder()
    .SetSocialNetwork("Twitter")
    .SetSocialAction("Retweet")
    .SetSocialTarget("twitter.com/googleanalytics/status/482210840234295296"));

// Builder Hit with minimum required Social parameters.
googleAnalytics.LogSocial(new SocialHitBuilder()
    .SetSocialNetwork("Twitter")
    .SetSocialAction("Retweet"));

इसी विषय से जुड़े लिंक:

ई-कॉमर्स

ई-कॉमर्स मेज़रमेंट की मदद से, इन-गेम खरीदारी और बिक्री को Google Analytics को भेजा जा सकता है. Google Analytics में ई-कॉमर्स डेटा में शेयर ट्रांज़ैक्शन आईडी से जुड़े लेन-देन और आइटम हिट शामिल होते हैं.

लेन-देन

सामान्य टिकट

public void LogTransaction(string transID,
    string affiliation,
    double revenue,
    double tax,
    double shipping);

public void LogTransaction(string transID,
    string affiliation,
    double revenue,
    double tax,
    double shipping,
    string currencyCode);

निर्माता

public void LogTransaction(TransactionHitBuilder builder);

उदाहरण

googleAnalytics.LogTransaction("TRANS001", "Coin Store", 3.0, 0.0, 0.0);
googleAnalytics.LogTransaction("TRANS001", "Coin Store", 3.0, 0.0, 0.0, "USD");

// Builder Hit with all Transaction parameters.
googleAnalytics.LogTransaction(new TransactionHitBuilder()
    .SetTransactionID("TRANS001")
    .SetAffiliation("Coin Store")
    .SetRevenue(3.0)
    .SetTax(0)
    .SetShipping(0.0)
    .SetCurrencyCode("USD"));

// Builder Hit with minimum required Transaction parameters.
googleAnalytics.LogTransaction(new TransactionHitBuilder()
    .SetTransactionID("TRANS001")
    .SetAffiliation("Coin Store")
    .SetRevenue(3.0)
    .SetTax(0)
    .SetShipping(0.0));

आइटम

सामान्य टिकट

public void LogItem(string transID,
    string name,
    string SKU,
    string category,
    double price,
    long quantity);

public void LogItem(string transID,
    string name,
    string SKU,
    string category,
    double price,
    long quantity,
    string currencyCode);

निर्माता

public void LogItem(ItemHitBuilder builder);

उदाहरण

googleAnalytics.LogItem("TRANS001", "Sword", "SWORD1223", "Weapon", 3.0, 2);
googleAnalytics.LogItem("TRANS001", "Sword", "SWORD1223", "Weapon", 3.0, 2, "USD");

// Builder Hit with all Item parameters.
googleAnalytics.LogItem(new ItemHitBuilder()
    .SetTransactionID("TRANS001")
    .SetName("Sword")
    .SetSKU("SWORD1223")
    .SetCategory("Weapon")
    .SetPrice(3.0)
    .SetQuantity(2)
    .SetCurrencyCode("USD"));

// Builder Hit with minimum required Item parameters.
googleAnalytics.LogItem(new ItemHitBuilder()
    .SetTransactionID("TRANS001")
    .SetName("Sword")
    .SetSKU("SWORD1223")
    .SetPrice(3.0)
    .SetQuantity(2));

इसी विषय से जुड़े लिंक:

कस्टम आयाम और मीट्रिक

कस्टम आयाम Google Analytics में हिट, उपयोगकर्ताओं और सेशन के साथ मेटाडेटा की संबद्धता को सक्षम करते हैं, जबकि कस्टम मीट्रिक की सहायता से आप Google Analytics में अपनी खुद की मीट्रिक बनाकर उनमें वृद्धि कर सकते हैं.

कस्टम डाइमेंशन और कस्टम मेट्रिक का इस्तेमाल करने से पहले, आपको इन्हें बनाना और कॉन्फ़िगर करना होगा. कॉन्फ़िगर होने के बाद, Builder तरीके का इस्तेमाल करके डेटा को किसी भी हिट के हिस्से के रूप में भेजा जा सकता है.

निर्माता

// Custom Dimension.
public T SetCustomDimension(int dimensionNumber, string value);

// Custom Metric.
public T SetCustomMetric(int metricNumber, string value);

उदाहरण

// Custom Dimension.
// An AppView hit example, but custom dimensions can be sent with all hit types.
googleAnalytics.LogScreen(new AppViewHitBuilder()
    .SetScreenName("Another screen")
    .SetCustomDimension(1, "200"));

// Custom Metric.
// An Event hit example, but custom metrics can be sent with all hit types.
googleAnalytics.LogEvent(new EventHitBuilder()
    .SetEventCategory("Achievement")
    .SetEventAction("Unlocked")
    .SetEventLabel("Slay 10 dragons")
    .SetEventValue(5)
    .SetCustomMetric(3, "200"));

इसी विषय से जुड़े लिंक:

कैंपेन

Google Analytics में कैंपेन को मेज़र करने से, आपके गेम में उपयोगकर्ता गतिविधि के लिए कैंपेन और ट्रैफ़िक सोर्स का एट्रिब्यूशन चालू हो जाता है.

Builder तरीके का इस्तेमाल करके, कैंपेन के पैरामीटर को किसी भी हिट के हिस्से के तौर पर भेजा जा सकता है.

निर्माता

public T SetCampaignName(string campaignName);
public T SetCampaignSource(string campaignSource);
public T SetCampaignMedium(string campaignMedium);
public T SetCampaignKeyword(string campaignKeyword);
public T SetCampaignContent(string campaignContent);
public T SetCampaignID(string campaignID);

उदाहरण

googleAnalytics.LogTiming(new TimingHitBuilder()
    .SetTimingCategory("Loading")
    .SetTimingInterval(50L)
    .SetTimingName("Main Menu")
    .SetTimingLabel("First load")
    .SetCampaignName("Summer Campaign")
    .SetCampaignSource("google")
    .SetCampaignMedium("cpc")
    .SetCampaignKeyword("games")
    .SetCampaignContent("Free power ups")
    .SetCampaignId("Summer1"));

// Send campaign parameters with timing hit.
// Builder Hit with minimum required Campaign parameters.
googleAnalytics.LogTiming(new TimingHitBuilder()
    .SetTimingCategory("Loading")
    .SetTimingInterval(50L)
    .SetTimingName("Main Menu")
    .SetTimingLabel("First load")
    .SetCampaignSource("google");

इसी विषय से जुड़े लिंक:

ज़रूरत के हिसाब से तय की गई तारीख की सीमा

इन तरीकों का सुझाव सिर्फ़ Google Analytics के ऐसे जानकार उपयोगकर्ताओं के लिए दिया जाता है जिन्हें ट्रैकर के सिद्धांतों के बारे में पता है.

SetOnTracker

अन्य हिट के साथ भेजने के लिए ट्रैकर पर वैल्यू सेट करें.

fieldName पैरामीटर (जैसे, Fields.SCREEN_NAME) के लिए Assets/Plugins/Fields.cs के वैरिएबल का इस्तेमाल करें.

public void SetOnTracker(Field fieldName, object value);

उदाहरण

googleAnalytics.SetOnTracker(Fields.SCREEN_NAME, "Main Menu");

नष्ट करें

मैनेज किए जा रहे संसाधनों को खाली करें और ट्रैकर को रीसेट करें.

अगर डिस्पोज़ को अगला ट्रैकिंग हिट कहा जाता है, तो एक नया ट्रैकर बनाना होगा इसलिए, यह सुझाव दिया जाता है कि ट्रैकिंग पूरी तरह से खत्म होने के बाद ही इस तरीके को कॉल करें. उदाहरण के लिए, onDispose() वाले तरीके में, जो तब काम करती है, जब उपयोगकर्ता आपका गेम छोड़ता है.

public void Dispose();

उदाहरण

googleAnalytics.Dispose();