কাস্টম মাত্রা এবং মেট্রিক্স - iOS SDK

এই বিকাশকারী নির্দেশিকা বর্ণনা করে কিভাবে iOS v3 এর জন্য Google Analytics SDK ব্যবহার করে কাস্টম মাত্রা এবং মেট্রিক্স প্রয়োগ করতে হয়।

ওভারভিউ

কাস্টম মাত্রাগুলি Google Analytics-এ হিট, ব্যবহারকারী এবং সেশনের সাথে মেটাডেটা সংযুক্ত করতে সক্ষম করে, যখন কাস্টম মেট্রিক্স আপনাকে Google Analytics-এ আপনার নিজস্ব মেট্রিক্স তৈরি এবং বৃদ্ধি করতে সক্ষম করে৷

  1. Google Analytics ওয়েব ইন্টারফেস ব্যবহার করে কাস্টম মাত্রা বা মেট্রিক কনফিগার করুন। কীভাবে একটি কাস্টম মাত্রা বা মেট্রিক কনফিগার করতে হয় তা শিখুন (সহায়তা কেন্দ্র)
  2. একটি অ্যাপ থেকে কাস্টম মাত্রা এবং মেট্রিক মান সেট করুন এবং পাঠান।

কাস্টম মাত্রা এবং মেট্রিক্স দুটি ক্ষেত্র নিয়ে গঠিত:

  • NSNumber Index – কাস্টম মাত্রা বা মেট্রিকের সূচক। এই সূচকটি 1-ভিত্তিক।
  • NSString মান – কাস্টম মাত্রা বা মেট্রিকের মান। মেট্রিক্সের এই ক্ষেত্রে, একটি পূর্ণসংখ্যা হিসাবে পার্স করা হবে, অথবা একটি নির্দিষ্ট পয়েন্ট দশমিক মান, যদি মেট্রিক একটি মুদ্রার প্রকারে কনফিগার করা হয়।

সেটিং এবং সেটিং মান

একটি কাস্টম মাত্রা মান সেট এবং পাঠাতে:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];

// Set the custom dimension value on the tracker using its index.
[tracker set:[GAIFields customDimensionForIndex:1]
       value:@"Premium user"];

[tracker set:kGAIScreenName
       value:@"Home screen"];

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once, so it is set on the Map,
// not the tracker.

// Previous V3 SDK versions.
// [tracker send:[[[GAIDictionaryBuilder createAppView] set:@"premium"
//                                                   forKey:[GAIFields customDimensionForIndex:1]] build]];

// // SDK Version 3.08 and up.
[tracker send:[[[GAIDictionaryBuilder createScreenView] set:@"premium"
                                                     forKey:[GAIFields customDimensionForIndex:1]] build]];

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

একটি কাস্টম মেট্রিক মান সেট এবং পাঠাতে:

// May return nil if a tracker has not yet been initialized with a property ID.
id tracker = [[GAI sharedInstance] defaultTracker];


// Set the custom metric to be incremented by 5 using its index.
[tracker set:[GAIFields customMetricForIndex:1]
       value:[[NSNumber numberWithInt:5] stringValue]];


[tracker set:kGAIScreenName
       value:@"Home screen"];

// Custom metric value is sent with this screen view.
// [tracker send:[[GAIDictionaryBuilder createAppView] build]];     // Previous V3 SDK versions.
[tracker send:[[GAIDictionaryBuilder createScreenView] build]];     // SDK Version 3.08 and up.

বাস্তবায়ন বিবেচনা

এই বিভাগটি কাস্টম মাত্রা বা মেট্রিক্স প্রয়োগ করার সময় মনে রাখতে অতিরিক্ত বিবেচনার রূপরেখা দেয়।

কাস্টম মাত্রা জন্য বিবেচনা

ব্যবহারকারী এবং সেশন-লেভেল স্কোপ সহ মানগুলি অতীতের হিটগুলিতে প্রযোজ্য

  • ব্যবহারকারী বা সেশন-স্তরের সুযোগ সহ কাস্টম মাত্রা মানগুলি অতীতের হিটগুলি সহ বর্তমান সেশনের সমস্ত হিটগুলিতে প্রযোজ্য হবে৷ আপনি যদি বর্তমান সেশনে অতীতের হিটগুলিতে সেশন বা ব্যবহারকারী-স্তরের সুযোগ সহ একটি কাস্টম মাত্রা মান প্রয়োগ করতে না চান, তাহলে একটি হিটে মান প্রয়োগ করার আগে একটি নতুন সেশন শুরু করুন
  • উদাহরণস্বরূপ, আপনি যদি ব্যবহারকারী-স্তরের কাস্টম মাত্রা হিসাবে সদস্যতার ধরন ব্যবহার করেন এবং একজন ব্যবহারকারী একটি সেশনের মাঝখানে তাদের সদস্যপদ আপগ্রেড করেন, তাহলে আপনি নতুন কাস্টম মাত্রা মান সেট করার আগে একটি নতুন সেশন শুরু করতে চাইতে পারেন। এটি নিশ্চিত করে যে আপগ্রেডের পূর্বের হিটগুলি পুরানো সদস্যতার মানের সাথে যুক্ত হবে, যখন নতুন হিটগুলি নতুন মানের সাথে যুক্ত হবে৷

কাস্টম মাত্রা এবং দেখুন (প্রোফাইল) ফিল্টার

  • ব্যবহারকারী বা সেশন-স্তরের কাস্টম মাত্রা মানগুলি বর্তমান এবং/অথবা ভবিষ্যতের সেশনের সমস্ত হিটগুলিতে এখনও প্রয়োগ করা হবে, এমনকি যদি তাদের পাঠানো হিটটি একটি ভিউ (প্রোফাইল) থেকে ফিল্টার করা হয়।
  • একটি কাস্টম মাত্রা মান ফিল্টার করার সময়, হিটগুলি সেই কাস্টম মাত্রা মানের সুযোগ অনুযায়ী ফিল্টার করা হয়। আপনার ডেটা প্রক্রিয়া করা হলে ফিল্টার এবং কাস্টম মাত্রা মানগুলি কীভাবে ইন্টারঅ্যাক্ট করে সে সম্পর্কে আরও জানুন

কাস্টম মেট্রিক্স জন্য বিবেচনা

কাস্টম মেট্রিক মান রিপোর্টে একত্রিত করা হয়

  • কাস্টম মেট্রিক মানগুলি Google Analytics-এ অন্যান্য পূর্ব-নির্ধারিত মেট্রিক্সের মতোই রিপোর্টে একত্রিত হয়। ফলস্বরূপ, আপনার রিপোর্টে মেট্রিকের মোট মোট বৃদ্ধি করতে আপনি 1 এর একটি কাস্টম মেট্রিক মান সেট করবেন।

কাস্টম মেট্রিক্স এবং ভিউ (প্রোফাইল) ফিল্টার

  • যদিও কাস্টম মেট্রিক মানগুলি সাধারণত যখনই সুবিধাজনক হয় সেট করা যেতে পারে, তবে আপনার ভিউ (প্রোফাইল) থেকে ফিল্টার করা হতে পারে এমন হিটগুলিতে কাস্টম মেট্রিক মান সেট করা এড়িয়ে চলুন। যদি একটি হিট একটি ভিউ (প্রোফাইল) ফিল্টার দ্বারা ফিল্টার করা হয়, তাহলে যে কোনো সংশ্লিষ্ট কাস্টম মেট্রিক মানও ফিল্টার করা হবে। কাস্টম মাত্রা এবং মেট্রিক্স এবং দেখুন (প্রোফাইল) ফিল্টার সম্পর্কে আরও জানুন

স্বয়ংক্রিয় স্ক্রিন পরিমাপের সাথে মান নির্ধারণ করা

  • স্বয়ংক্রিয় স্ক্রীন পরিমাপের মাধ্যমে প্রেরিত একটি স্ক্রীন ভিউতে একটি কাস্টম মাত্রা মান প্রয়োগ করতে, ভিউ কন্ট্রোলারের viewDidAppear: পদ্ধতির সময় মান সেট করুন। উদাহরণস্বরূপ, আপনার ভিউ কন্ট্রোলারের .m ফাইলটি এইরকম দেখতে পারে:
#import "myViewController.h"
#import "GAI.h"

@implementation myViewController

-(void)viewDidAppear
{
    id<GAITracker> tracker = [[GAI sharedInstance] defaultTracker];  // Get the tracker object.
    [tracker set:[GAIFields customDimensionForIndex:1]
           value:@"premium"];
    [super viewDidAppear:animated];   // Custom dimension value will be sent with the screen view.

}

// The remainder of the implementation is omitted.

ব্যক্তিগতভাবে শনাক্তযোগ্য তথ্য (PII) মান হিসাবে পাঠাবেন না