ঐক্যের জন্য Google Analytics প্লাগইন - API রেফারেন্স

এই ডকুমেন্টটি বর্ণনা করে কিভাবে ডেটা পাঠাতে হয় এবং Google Analytics প্লাগইন ফর ইউনিটির জন্য সমস্ত পদ্ধতি তালিকাভুক্ত করে।

ভূমিকা

GA প্লাগইন ফর ইউনিটি ব্যবহার করে Google Analytics-এ ডেটা পাঠানোর সময় আপনি মৌলিক পদ্ধতি বা বিল্ডার পদ্ধতি ব্যবহার করতে পারেন। আপনি যদি হিটের সাথে প্রচারাভিযানের পরামিতি বা কাস্টম মাত্রা বা মেট্রিক্স যুক্ত করতে চান তাহলে নির্মাতা পদ্ধতির প্রয়োজন হয়। হিটগুলি বিনিময়যোগ্যভাবে উভয় পদ্ধতি ব্যবহার করে পাঠানো যেতে পারে।

আপনার প্রকল্পের জন্য একতার জন্য 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 রিপোর্টে স্ক্রিন নাম হিসাবে ব্যবহার করা হবে।

মৌলিক

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-এ আপনার নিজস্ব মেট্রিক্স তৈরি এবং বৃদ্ধি করতে সক্ষম করে৷

কাস্টম মাত্রা এবং কাস্টম মেট্রিক্স ব্যবহার করার আগে আপনাকে অবশ্যই তৈরি এবং কনফিগার করতে হবে। একবার কনফিগার করা হলে, বিল্ডার পদ্ধতি ব্যবহার করে যেকোনো হিটের অংশ হিসেবে ডেটা পাঠানো যেতে পারে।

নির্মাতা

// Custom Dimension.
public T SetCustomDimension(int dimensionNumber, string value);
// Custom Metric.
public T SetCustomMetric(int metricNumber, float 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, 81.5));

সম্পর্কিত সম্পদ:

প্রচারণা

গুগল অ্যানালিটিক্সে প্রচারাভিযান পরিমাপ আপনার গেমের মধ্যে ব্যবহারকারীর কার্যকলাপে প্রচারাভিযান এবং ট্র্যাফিক উত্সের অ্যাট্রিবিউশন সক্ষম করে।

বিল্ডার পদ্ধতি ব্যবহার করে যে কোনো হিটের অংশ হিসেবে ক্যাম্পেইনের প্যারামিটার পাঠানো যেতে পারে।

নির্মাতা

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-এর শক্তি ব্যবহারকারীদের জন্য সুপারিশ করা হয় যারা ট্র্যাকার ধারণার সাথে পরিচিত।

সেটঅনট্র্যাকার

অন্যান্য হিটের সাথে পাঠানোর জন্য ট্র্যাকারে মান সেট করুন।

fieldName প্যারামিটারের জন্য Assets/Plugins/Fields.cs থেকে ভেরিয়েবল ব্যবহার করুন (যেমন Fields.SCREEN_NAME )।

public void SetOnTracker(Field fieldName, object value);

উদাহরণ

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

নিষ্পত্তি

পরিচালিত সম্পদ খালি করুন এবং ট্র্যাকার রিসেট করুন।

নিষ্পত্তি করা হলে পরবর্তী ট্র্যাকিং হিটকে একটি নতুন ট্র্যাকার তৈরি করতে হবে তাই ট্র্যাকিং সম্পূর্ণভাবে শেষ হলে শুধুমাত্র এই পদ্ধতিতে কল করার পরামর্শ দেওয়া হয়। উদাহরণস্বরূপ, একটি onDispose() পদ্ধতিতে যা কার্যকর হয় যখন ব্যবহারকারী আপনার গেমটি ছেড়ে দেয়।

public void Dispose();

উদাহরণ

googleAnalytics.Dispose();