मोबाइल ऐप्लिकेशन लागू करने की गाइड

यह दस्तावेज़ मोबाइल डेवलपर के लिए है. इस ऐप्लिकेशन में उपयोगकर्ता इंटरैक्शन के आकलन के लिए Google Analytics का इस्तेमाल करने का तरीका बताया गया है. साथ ही, इसमें ऐप्लिकेशन के इस्तेमाल से जुड़े सवालों के जवाब भी दिए गए हैं.

इसके बारे में जानकारी

मोबाइल ऐप्लिकेशन के लिए Google Analytics, उपयोगकर्ता इंटरैक्शन को मापने का एक प्लैटफ़ॉर्म देता है. इसकी मदद से आप अपने ऐप्लिकेशन के साथ, उपयोगकर्ता की दिलचस्पी को बेहतर तरीके से समझ सकते हैं और ऑप्टिमाइज़ कर सकते हैं.

Google Analytics के डिफ़ॉल्ट रूप से लागू होने पर आपके ऐप्लिकेशन के बारे में यह जानकारी अपने-आप मिल जाएगी:

  • उपयोगकर्ताओं और सेशन की संख्या
  • सेशन का समय
  • ऑपरेटिंग सिस्टम
  • डिवाइस मॉडल
  • भूगोल

इस गाइड में बताया जाएगा कि आप अपने उपयोगकर्ताओं और उनके व्यवहार को बेहतर ढंग से समझने के लिए, Google Analytics की दूसरी सुविधाएं कैसे लागू कर सकते हैं.

शुरू करने से पहले

इस गाइड पर काम करने से पहले, यह सुझाव दिया जाता है कि आप मोबाइल ऐप्लिकेशन के लिए Google Analytics सेट अप करने का तरीका जानने के लिए, नीचे दिए गए संसाधनों की समीक्षा करें:

खास जानकारी

ड्रैगन कैचर

यह गाइड, अतिरिक्त Google Analytics सुविधाओं को लागू करने में आपकी मदद करने के लिए सैंपल ऐप्लिकेशन का इस्तेमाल करती है. इस ऐप्लिकेशन को ड्रैगन कैचर कहते हैं और इसमें गेमप्ले से जुड़ी ये विशेषताएं होती हैं:

  • लेवल में खिलाड़ी, ड्रैगन, बाड़ वाली जगह, कुआं, और पेड़ शामिल हैं
  • खिलाड़ी का मकसद होता है कि उन्हें फंसे हुए इलाकों में खींचकर ड्रैगन को पकड़ा जा सके
  • खिलाड़ी, लेवल के अलग-अलग हिस्सों पर जा सकता है. साथ ही, वह कुएं या जादू के पेड़ जैसी चीज़ों पर जा सकता है
  • सभी ड्रैगन कैप्चर करने के बाद, खिलाड़ी अगले लेवल पर पहुंच जाता है
  • इसमें, खिलाड़ी पहले लेवल पर गेम शुरू करता है, जिसे बैरन फ़ील्ड्स कहा जाता है.

Google Analytics का इस्तेमाल करके, उपयोगकर्ता के व्यवहार से जुड़े कुछ ऐसे सवालों के जवाब दिए जा सकते हैं जिनका जवाब ड्रैगन कैचर से मिल सकता है:

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

मेरे उपयोगकर्ता कौनसी कार्रवाइयां कर रहे हैं? (इवेंट)

अगर आप अपने ऐप्लिकेशन में कुछ अहम कार्रवाइयां करना चाहते हैं, तो Google Analytics में इस कार्रवाई के बारे में बताने के लिए इवेंट का इस्तेमाल किया जा सकता है. किसी इवेंट में चार पैरामीटर शामिल होते हैं: category, action,label, और value. Google Analytics में इवेंट के काम करने के तरीके के बारे में जानकारी के लिए, इवेंट ट्रैकिंग की बनावट देखें.

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

Android SDK v4

// To determine how many dragons are being rescued, send an event when the
// player rescues a dragon.
tracker.send(new HitBuilders.EventBuilder()
    .setCategory("Barren Fields")
    .setAction("Rescue")
    .setLabel("Dragon")
    .setValue(1)
    .build());

// To determine if players are visiting the magic tree, send an event when the
// player is in the vicinity of the magic tree.
tracker.send(new HitBuilders.EventBuilder()
    .setCategory("Barren Fields")
    .setAction("Visited")
    .setLabel("Magic Tree")
    .setValue(1)
    .build());

// To determine if players are visiting the well, send an event when the player
// is in the vicinity of the well.
tracker.send(new HitBuilders.EventBuilder()
    .setCategory("Barren Fields")
    .setAction("Visited")
    .setLabel("Well")
    .setValue(1)
    .build());

iOS SDK v3

// To determine how many dragons are being rescued, send an event when the
// player rescues a dragon.
[tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"Barren Fields"
                                                      action:@"Rescue"
                                                       label:@"Dragon"
                                                       value:@1] build]];

// To determine if players are visiting the magic tree, send an event when the
// player is in the vicinity of the magic tree.
[tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"Barren Fields"
                                                      action:@"Visited"
                                                       label:@"Magic Tree"
                                                       value:@1] build]];

// To determine if players are visiting the well, send an event when the player
// is in the vicinity of the well.
[tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"Barren Fields"
                                                      action:@"Visited"
                                                       label:@"Well"
                                                       value:@1] build]];

Unity v3 के लिए GA प्लग इन

// To determine how many dragons are being rescued, send an event when the
// player rescues a dragon.
googleAnalytics.LogEvent("Barren Fields", "Rescue", "Dragon", 1);

// To determine if players are visiting the magic tree, send an event when the
// player is in the vicinity of the magic tree.
googleAnalytics.LogEvent("Barren Fields", "Visited", "Magic Tree", 1);

// To determine if players are visiting the well, send an event when the player
// is in the vicinity of the well.
googleAnalytics.LogEvent("Barren Fields", "Visited", "Well", 1);

प्लेयर और कोटेशन का आकलन करना;

Google Analytics में इवेंट का इस्तेमाल करके, प्लेयर और उपलब्धि का आकलन किया जा सकता है. उदाहरण के लिए, पांच ड्रैगन बचाने की उपलब्धि का आकलन करने के लिए, बचाए गए खिलाड़ी की संख्या रिकॉर्ड की जाती है. इसके बाद, जब खिलाड़ी प्लेयर पर पहुंच जाता है, तो Google Analytics को एक इवेंट भेजा जाता है:

Android SDK v4

if (numDragonsRescued > 5) {
  if (!user.hasAchievement(RESCUED_ACHIEVEMENT) {
    tracker.send(new HitBuilders.EventBuilder()
        .setCategory("Achievement")
        .setAction("Unlocked")
        .setLabel("5 Dragons Rescued")
        .setValue(1)
        .build());
  } else {
    tracker.send(new HitBuilders.EventBuilder()
        .setCategory("Achievement")
        .setAction("Earned")
        .setLabel("5 Dragons Rescued")
        .setValue(1)
        .build());
  }
}

iOS SDK v3

if (numDragonsRescued > 5) {
  if (![user hasAchievement:RESCUED_ACHIEVEMENT]) {
    [tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"Achievement"
                                                          action:@"Unlocked"
                                                           label:@"5 Dragons Rescued"
                                                           value:@1] build]];
  } else {
    [tracker send:[[GAIDictionaryBuilder createEventWithCategory:@"Achievement"
                                                          action:@"Earned"
                                                           label:@"5 Dragons Rescued"
                                                           value:@1] build]];
  }
}

Unity v3 के लिए GA प्लग इन

if (numDragonsRescued > 5) {
  if (!user.HasAchievement(RESCUED_ACHIEVEMENT) {
    googleAnalytics.LogEvent("Achievement", "Unlocked", "5 Dragons Rescued", 1);
  } else {
    googleAnalytics.LogEvent("Achievement", "Earned", "5 Dragons Rescued", 1);
  }
}

इवेंट के लिए डेवलपर गाइड

इवेंट की रिपोर्टिंग

इवेंट का डेटा इन देशों में उपलब्ध है:

उपयोगकर्ता मेरे ऐप्लिकेशन में कितना पैसा खर्च कर रहे हैं? (बेहतर ई-कॉमर्स)

अगर आप उपयोगकर्ताओं की इन-ऐप्लिकेशन खरीदारी का आकलन करना चाहते हैं, तो ई-कॉमर्स ट्रैकिंग का इस्तेमाल करके खरीदारी को ट्रैक किया जा सकता है. साथ ही, इससे प्रॉडक्ट के परफ़ॉर्मेंस और उपयोगकर्ता के व्यवहार को समझने में भी मदद मिलती है. ई-कॉमर्स ट्रैकिंग का इस्तेमाल करके, किसी खास आइटम या वर्चुअल मुद्रा की खरीदारी का आकलन किया जा सकता है.

उदाहरण के लिए, ड्रैगन कैचर में कुछ आइटम की खरीदारी को मापने के लिए लेन-देन डेटा को Google Analytics को इवेंट के साथ भेजा जाता है:

Android SDK v4

Product product = new Product()
    .setName("Dragon Food")
    .setPrice(40.00);

ProductAction productAction = new ProductAction(ProductAction.ACTION_PURCHASE)
    .setTransactionId("T12345");

// Add the transaction data to the event.
HitBuilders.EventBuilder builder = new HitBuilders.EventBuilder()
    .setCategory("In-Game Store")
    .setAction("Purchase")
    .addProduct(product)
    .setProductAction(productAction);

// Send the transaction data with the event.
tracker.send(builder.build());

iOS SDK v3

GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setName:@"Dragon Food"];
[product setPrice:@40.00];

GAIEcommerceProductAction *productAction = [[GAIEcommerceProductAction alloc] init];
[productAction setAction:kGAIPAPurchase];
[productAction setTransactionId:@"T12345"];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"In-Game Store"
                                                                       action:@"Purchase"
                                                                        label:nil
                                                                        value:nil];
// Add the transaction data to the event.
[builder setProductAction:productAction];
[builder addProduct:product];

// Send the transaction data with the event.
[tracker send:[builder build]];

Unity v3 के लिए GA प्लग इन

// Note: Using Android SDK v3 and standard Ecommerce tracking.

googleAnalytics.LogItem("T12345", "Dragon Food", "Food_SKU", "Items", 40.00, 1);
googleAnalytics.LogTransaction("T12345", "In-Game Store", 40.00, 0.00, 0.00);

अगर कोई उपयोगकर्ता वर्चुअल मुद्रा खरीदता है, तो यह सुझाव दिया जाता है कि आप Google Analytics को लेन-देन का डेटा भेजते समय, असली पैसों का लेन-देन करें. जब उपयोगकर्ता आइटम खरीदने के लिए वर्चुअल मुद्रा खर्च करता है, तो इवेंट का इस्तेमाल करके इसे मेज़र करें. उदाहरण के लिए:

Android SDK v4

/**
 * When the user purchases the virtual currency (Gems) measure the transaction
 * using enhanced ecommerce.
 */
Product product =  new Product()
    .setName("2500 Gems")
    .setPrice(5.99);

ProductAction productAction = new ProductAction(ProductAction.ACTION_PURCHASE)
    .setTransactionId("T67890");

// Add the transaction to the screenview.
HitBuilders.ScreenViewBuilder builder = new HitBuilders.ScreenViewBuilder()
    .addProduct(product)
    .setProductAction(productAction);

// Send the transaction with the screenview.
tracker.setScreenName("In-Game Store");
tracker.send(builder.build());


/**
 * When the user purchases an item using the virtual currency (Gems) send an
 * event to measure this in Google Analytics.
 */
HitBuilders.EventBuilder builder = new HitBuilders.EventBuilder()
    .setCategory("In-Game Store")
    .setAction("Purchase")
    .setLabel("Sword")
    .setValue(35);
tracker.send(builder.build());

iOS SDK v3

/**
 * When the user purchases the virtual currency (Gems) measure the transaction
 * using enhanced ecommerce.
 */
GAIEcommerceProduct *product = [[GAIEcommerceProduct alloc] init];
[product setName:@"2500 Gems"];
[product setPrice:@5.99];

GAIEcommerceProductAction *productAction = [[GAIEcommerceProductAction alloc] init];
[productAction setAction:kGAIPAPurchase];
[productAction setTransactionId:@"T67890"];

GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createScreenView];

// Add the transaction data to the screenview.
[builder setProductAction:productAction];
[builder addProduct:product];

// Send the transaction with the screenview.
[tracker set:kGAIScreenName value:@"In-Game Store"]
[tracker send:[builder build]];


/**
 * When the user purchases an item using the virtual currency (Gems) send an
 * event to measure this in Google Analytics.
 */
GAIDictionaryBuilder *builder = [GAIDictionaryBuilder createEventWithCategory:@"In-Game Store"
                                                                       action:@"Purchase"
                                                                        label:@"Sword"
                                                                        value:@35];
[tracker send:[builder build]];

Unity v3 के लिए GA प्लग इन

// Note: Using Android SDK v3 and standard Ecommerce tracking.

/**
 * When the user purchases the virtual currency (Gems) measure the transaction
 * using enhanced ecommerce.
 */

googleAnalytics.LogItem("T12345", "2500 Gems", "GEM2500_SKU", "Items", 5.99, 1);
googleAnalytics.LogTransaction("T12345", "In-Game Store", 5.99, 0.00, 0.00);

/**
 * When the user purchases an item using the virtual currency (Gems) send an
 * event to measure this in Google Analytics.
 */
googleAnalytics.LogEvent("In-Game Store", "Purchase", "Sword", 35);

बेहतर ई-कॉमर्स के लिए डेवलपर गाइड

बेहतर ई-कॉमर्स के लिए रिपोर्टिंग

ई-कॉमर्स डेटा इन देशों में उपलब्ध है:

क्या उपयोगकर्ता मेरे ऐप्लिकेशन के मकसद को पूरा कर रहे हैं? (लक्ष्य)

अगर आपके ऐप्लिकेशन के खास मकसद हैं, जिन्हें आप उपयोगकर्ताओं से पूरा करवाना चाहते हैं, तो आप Google Analytics में लक्ष्यों का इस्तेमाल करके इन मकसद को तय और मेज़र कर सकते हैं. उदाहरण के लिए, एक लक्ष्य यह हो सकता है कि उपयोगकर्ता किसी खास गेम लेवल पर पहुंचें या कोई आइटम खरीदें. लक्ष्यों के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, लक्ष्यों के बारे में जानकारी (सहायता केंद्र) देखें.

ड्रैगन कैचर गेम में, एक लक्ष्य सेट अप करके यह मेज़र किया जा सकता है कि हर खरीदारी के लिए Google Analytics को इवेंट कब भेजा जाए. इन पैरामीटर का इस्तेमाल करके, लक्ष्य को वेब इंटरफ़ेस के एडमिन में बिना किसी अतिरिक्त कोड के तय किया जा सकता है:

  • लक्ष्य का टाइप (बराबर): इवेंट
  • कैटगरी (इसके बराबर है): इन-गेम स्टोर
  • कार्रवाई (बराबर): खरीदारी
  • कन्वर्ज़न के लिए, लक्ष्य वैल्यू के तौर पर इवेंट वैल्यू का इस्तेमाल करें: हां

लक्ष्य रिपोर्टिंग

लक्ष्य डेटा इन देशों में उपलब्ध है:

किसी खास विशेषता वाले उपयोगकर्ता कैसा व्यवहार करते हैं? (कस्टम डाइमेंशन और एएमपी; मेट्रिक)

अगर आप खास एट्रिब्यूट/एट्रिब्यूट/मेटाडेटा से उपयोगकर्ताओं को ट्रैक करना चाहते हैं, तो कस्टम डाइमेंशन का इस्तेमाल करके, इस तरह का डेटा Google Analytics को भेजा जा सकता है. साथ ही, इसका इस्तेमाल विश्लेषण में भी किया जा सकता है. कस्टम डाइमेंशन के काम करने के तरीके के बारे में ज़्यादा जानने के लिए, कस्टम डाइमेंशन और एएमपी की जानकारी वाली मेट्रिक देखें.

उदाहरण के लिए, ड्रैगन कैचर में, पहले स्तर, दूसरे लेवल वगैरह में उपयोगकर्ताओं का प्रतिशत जानने के लिए, कस्टम डाइमेंशन को उपयोगकर्ता के मौजूदा लेवल के साथ सेट किया जा सकता है और Google Analytics को भेजा जा सकता है. चरण इस प्रकार हैं:

  1. User दायरे वाला कस्टम डाइमेंशन बनाएं. User दायरे का इस्तेमाल किया जाता है, क्योंकि यह वैल्यू उस उपयोगकर्ता के सभी सेशन में बनी होनी चाहिए. कस्टम डाइमेंशन सेट अप करना या उनमें बदलाव करना (सहायता केंद्र) देखें.
  2. उपयोगकर्ता का लेवल बदलने पर, कस्टम डाइमेंशन की वैल्यू अपडेट करें.

नीचे दिया गया स्निपेट दिखाता है कि Google Analytics में उपयोगकर्ता की स्थिति अपडेट कैसे की जाए, जहां उपयोगकर्ता लेवल का कस्टम डाइमेंशन इंडेक्स, 1 और उपयोगकर्ता का लेवल Barren Fields में बदल गया है:

Android SDK v4

// Set the user level custom dimension when sending a hit to Google Analytics
// such as a screenview or event.
tracker.setScreen("BarrenFields");
tracker.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "Barren Fields")
    .build()
);

iOS SDK v3

// Set the user level custom dimension when sending a hit to Google Analytics
// such as a screenview or event.
[tracker set:kGAIScreenName value:@"BarrenFields"];
[tracker send:[[[GAIDictionaryBuilder createScreenView]
         set:@"Barren Fields"
      forKey:[GAIFields customDimensionForIndex:1]] build]];

Unity v3 के लिए GA प्लग इन

// Set the user level custom dimension when sending a hit to Google Analytics
// such as a screenview or event.
googleAnalytics.LogScreen(new AppViewHitBuilder()
    .SetScreenName("BarrenFields").SetCustomDimension(1, "Barren Fields"));

कस्टम आयाम और आयाम के लिए डेवलपर गाइड; मेट्रिक

कस्टम आयामों और रिपोर्टिंग के लिए रिपोर्टिंग; मेट्रिक

कस्टम डाइमेंशन को सेगमेंट के तौर पर इस तरह शामिल किया जा सकता है और लागू किया जा सकता है:

कस्टम आयाम को सेगमेंट के रूप में लागू करके, आप उन उपयोगकर्ताओं का विश्लेषण कर सकते हैं जो वर्तमान में गेम के अंतर्गत किसी खास स्तर पर हैं.

किसी उपयोगकर्ता को कोई टास्क पूरा करने में कितना समय लगता है? (पसंद के मुताबिक तय किया गया समय)

अगर आप यह मापना चाहते हैं कि ऐप्लिकेशन में किसी चीज़ को पूरा होने में कितना समय लगता है, तो Google Analytics में समय के मुताबिक मेज़रमेंट के लिए उपयोगकर्ता समय का इस्तेमाल किया जा सकता है. उपयोगकर्ता का समय, इवेंट की तरह ही होता है, लेकिन ये समय के हिसाब से होते हैं. इसमें category, value, name (variable), औरlabel शामिल हो सकते हैं. उपयोगकर्ता समय के काम करने के तरीके के बारे में जानने के लिए, साइट स्पीड के बारे में जानकारी देखें.

उदाहरण के लिए, ड्रैगन कैचर में यह मापने के लिए कि उपयोगकर्ता को उसके पहले ड्रैगन को बचाने में कितना समय लगता है, आप कुछ ऐसा भेज सकते हैं:

Android SDK v4

// Build and send a timing hit.
tracker.send(new HitBuilders.TimingBuilder()
    .setCategory("Barren Fields")
    .setValue(45000)  // 45 seconds.
    .setVariable("First Rescue")
    .setLabel("Dragon")
    .build());

iOS SDK v3

[tracker send:[[GAIDictionaryBuilder createTimingWithCategory:@"Barren Fields"
                                                     interval:@45000   // 45 seconds.
                                                         name:@"First Rescue"
                                                        label:@"Dragon"] build]];

Unity v3 के लिए GA प्लग इन

// Build and send a timing hit.
googleAnalytics.LogTiming("Barren Fields",45000,"First Rescue","Dragon");

कस्टम समय के लिए डेवलपर गाइड

कस्टम समय के लिए रिपोर्टिंग

कस्टम टाइमिंग का डेटा इन देशों में उपलब्ध है:

  • Analytics अकैडमी - मोबाइल ऐप्लिकेशन ऐनलिटिक्स से जुड़ी बुनियादी बातों के साथ-साथ, मुफ़्त ऑनलाइन कोर्स की मदद से Analytics में अपने कौशल को बढ़ाएं.
  • कलेक्शन एपीआई और एएमपी; SDK टूल - Google Analytics में डेटा भेजने के सभी तरीकों के बारे में जानें