UMP SDK সেট-আপ করা

প্ল্যাটফর্ম বেছে নিন: Android iOS Unity Flutter Android (পুরনো)

Google User Messaging Platform (UMP) SDK হল একটি গোপনীয়তা ও মেসেজিং টুল যা আপনাকে গোপনীয়তা সংক্রান্ত পছন্দ ম্যানেজ করতে সাহায্য করে। আরও তথ্যের জন্য, গোপনীয়তা ও মেসেজিং সম্পর্কে দেখুন।

মেসেজের ধরন তৈরি করুন

আপনার AdMob অ্যাকাউন্টের গোপনীয়তা ও মেসেজিং ট্যাবের মধ্যে উপলভ্য ব্যবহারকারীর মেসেজের ধরন থেকে একটি বেছে নিয়ে ব্যবহারকারীর মেসেজ তৈরি করুন। UMP SDK আপনার প্রোজেক্টে সেট করা AdMob অ্যাপ্লিকেশন আইডি থেকে তৈরি করা গোপনীয়তা মেসেজ দেখানোর চেষ্টা করে।

আরও বিবরণের জন্য, গোপনীয়তা ও মেসেজিং সম্পর্কে দেখুন।

ব্যবহারকারীর সম্মতি সংক্রান্ত তথ্য পান

Update() ব্যবহার করে, অ্যাপ চালু করার সময় প্রতিবার ব্যবহারকারীর সম্মতি সংক্রান্ত তথ্যের আপডেট অনুরোধ করা উচিত। এই অনুরোধ নিম্নলিখিত বিষয়গুলি চেক করে:

• সম্মতি প্রয়োজন কিনা। যেমন, প্রথমবার সম্মতি প্রয়োজন অথবা আগের সম্মতির মেয়াদ শেষ হয়ে গেছে।
• গোপনীয়তা বিকল্পের এন্ট্রি পয়েন্ট প্রয়োজন কিনা। কিছু গোপনীয়তা মেসেজের ক্ষেত্রে অ্যাপকে ব্যবহারকারীদের যেকোনও সময় তাদের গোপনীয়তা বিকল্প পরিবর্তন করার অনুমতি দিতে হয়।

void Start()
{
    // Create a ConsentRequestParameters object.
    ConsentRequestParameters requestParameters = new ConsentRequestParameters();

    // Request an update of the user's consent information.
    ConsentInformation.Update(requestParameters, OnConsentInfoUpdated);
}
UMPSnippets.cs

সতর্কতা: আমরা অন্য কোনও উপায়ে সম্মতির স্ট্যাটাস চেক করার সাজেশন দিই না, যেমন আপনার অ্যাপের ক্যাশে বা আগে থেকে সেভ করা সম্মতির স্ট্রিং। এইসব পদ্ধতি ব্যবহারকারীর পুরনো সম্মতি ডেটা দেখাতে পারে।

গোপনীয়তা মেসেজ ফর্ম লোড করে দেখান

আপনি সবচেয়ে আপ-টু-ডেট সম্মতির স্ট্যাটাস পাওয়ার পরে, ব্যবহারকারীর সম্মতি সংগ্রহ করার জন্য প্রয়োজনীয় যেকোনও ফর্ম লোড করতে LoadAndShowConsentFormIfRequired() কল করুন। লোড হওয়ার পরে, ফর্মগুলি অবিলম্বে উপস্থিত হয়।

গুরুত্বপূর্ণ পয়েন্ট: বিজ্ঞাপনের অনুরোধ করার আগে কোনও গোপনীয়তা মেসেজ ফর্মে ব্যবহারকারীর সম্মতি সংগ্রহ করার প্রয়োজন না হলে, কলব্যাক অবিলম্বে চালু করা হয়।

ConsentForm.LoadAndShowConsentFormIfRequired((FormError formError) =>
{
    if (formError != null)
    {
        // Consent gathering failed.
        Debug.LogError("Error loading/showing consent form: " + formError.Message);
    }

    // ...
});
UMPSnippets.cs

গোপনীয়তা সংক্রান্ত বিকল্প

কিছু গোপনীয়তা মেসেজ ফর্ম প্রকাশক-রেন্ডার করা গোপনীয়তা বিকল্প এন্ট্রি পয়েন্ট থেকে দেখানো হয়, যার ফলে ব্যবহারকারীরা যেকোনও সময় তাদের গোপনীয়তা বিকল্প ম্যানেজ করতে পারেন। গোপনীয়তা বিকল্পের এন্ট্রি পয়েন্টে আপনার ব্যবহারকারীরা কোন মেসেজ দেখতে পাবেন সেই সম্পর্কে আরও জানতে, ব্যবহারকারীর মেসেজের উপলভ্য ধরন দেখুন।

গোপনীয়তা বিকল্পের এন্ট্রি পয়েন্ট প্রয়োজন কিনা তা চেক করুন

Update() কল করার পরে, আপনার অ্যাপের জন্য গোপনীয়তা বিকল্পের এন্ট্রি পয়েন্ট প্রয়োজন কিনা তা নির্ধারণ করতে PrivacyOptionsRequirementStatus চেক করুন। এন্ট্রি পয়েন্ট প্রয়োজন হলে, আপনার অ্যাপে একটি দৃশ্যমান এবং ইন্টার‍্যাক্ট করা যায় এমন UI এলিমেন্ট যোগ করুন যা গোপনীয়তা বিকল্প ফর্ম দেখায়। গোপনীয়তা এন্ট্রি পয়েন্টের প্রয়োজন না হলে, আপনার UI এলিমেন্টকে এমনভাবে কনফিগার করুন যাতে সেটি দেখা না যায় এবং ইন্টার‍্যাক্ট করা না যায়।

void UpdatePrivacyButton()
{
    if (_privacyButton != null)
    {
        // Enable the button only if a privacy options entry point is required.
        _privacyButton.interactable =
            ConsentInformation.PrivacyOptionsRequirementStatus == PrivacyOptionsRequirementStatus.Required;
    }
}
UMPSnippets.cs

গোপনীয়তা সংক্রান্ত বিকল্পের প্রয়োজনীয়তার স্ট্যাটাসের সম্পূর্ণ তালিকা দেখতে, ConsentInformation.PrivacyOptionsRequirementStatus দেখুন।

গোপনীয়তা সংক্রান্ত বিকল্পের ফর্ম দেখান

ব্যবহারকারী আপনার এলিমেন্টের সাথে ইন্টার‍্যাক্ট করলে, গোপনীয়তা সংক্রান্ত বিকল্পের ফর্ম দেখান:

public void ShowPrivacyOptionsForm()
{
    ConsentForm.ShowPrivacyOptionsForm((FormError showError) =>
    {
        if (showError != null)
        {
            Debug.LogError("Error showing privacy options form: " + showError.Message);
        }
    });
}
UMPSnippets.cs

ব্যবহারকারীর সম্মতি নিয়ে বিজ্ঞাপন দেখানোর অনুরোধ করা

বিজ্ঞাপনের অনুরোধ করার আগে, আপনি ব্যবহারকারীর থেকে সম্মতি পেয়েছেন কিনা তা চেক করতে CanRequestAds() ব্যবহার করুন:

ConsentInformation.CanRequestAds()

সম্মতি সংগ্রহ করার সময় আপনি বিজ্ঞাপনের অনুরোধ করতে পারবেন কিনা তা চেক করার জন্য নিম্নলিখিত জায়গাগুলি তালিকাভুক্ত করা হয়েছে:

• বর্তমান সেশনে UMP SDK সম্মতি সংগ্রহ করার পরে।
• আপনি Update()-কে কল করার ঠিক পরেই। UMP SDK হয়ত আগের অ্যাপ সেশনে সম্মতি পেয়েছে।

গুরুত্বপূর্ণ: CanRequestAds() সবসময় false রিটার্ন করে যতক্ষণ না আপনি Update() কল করছেন

সম্মতি সংগ্রহ করার প্রসেস চলাকালীন কোনও সমস্যা হলে, আপনি বিজ্ঞাপন দেখানোর অনুরোধ করতে পারবেন কিনা তা চেক করে দেখুন। UMP SDK আগের অ্যাপ সেশন থেকে সম্মতির স্ট্যাটাস ব্যবহার করে।

অপ্রয়োজনীয় বিজ্ঞাপনের অনুরোধের কাজ আটকানো

সম্মতি সংগ্রহ করার পরে এবং Update() কল করার পরে আপনি CanRequestAds() চেক করার সময়, আপনার লজিক যাতে অপ্রয়োজনীয় বিজ্ঞাপনের অনুরোধ প্রতিরোধ করে তা নিশ্চিত করুন, যার ফলে দুটি চেকই true রিটার্ন করতে পারে। যেমন, বুলিয়ান ভেরিয়েবল ব্যবহার করে।

পরীক্ষা করা

আপনি যদি ডেভেলপ করার সময় আপনার অ্যাপে ইন্টিগ্রেশন পরীক্ষা করতে চান, তাহলে আপনার টেস্ট ডিভাইস প্রোগ্রাম্যাটিকভাবে রেজিস্টার করতে এই ধাপগুলি অনুসরণ করুন। আপনার অ্যাপ রিলিজ করার আগে, এইসব টেস্ট ডিভাইস আইডি সেট করে এমন কোড মুছে দিতে ভুলবেন না।

1. Update()-এ কল করুন।

2. নিচের উদাহরণের মতো মেসেজের জন্য লগ আউটপুট চেক করুন, যা আপনার ডিভাইস আইডি এবং কীভাবে এটি টেস্ট ডিভাইস হিসেবে যোগ করতে হয় তা দেখায়:

   Android

   Use new ConsentDebugSettings.Builder().addTestDeviceHashedId("33BE2250B43518CCDA7DE426D04EE231")
   to set this as a debug device.
   

   iOS

   <UMP SDK>To enable debug mode for this device,
   set: UMPDebugSettings.testDeviceIdentifiers = @[2077ef9a63d2b398840261c8221a0c9b]
   

3. আপনার ক্লিপবোর্ডে টেস্ট ডিভাইসের আইডি কপি করুন।

4. DebugGeography.TestDeviceHashedIds-এ কল করতে আপনার কোড পরিবর্তন করুন এবং আপনার টেস্ট ডিভাইস আইডির তালিকা পাস করুন।

   void Start()
   {
       var debugSettings = new ConsentDebugSettings
       {
           TestDeviceHashedIds =
           new List<string>
           {
               "TEST-DEVICE-HASHED-ID"
           }
       };
   
       // Create a ConsentRequestParameters object.
       ConsentRequestParameters request = new ConsentRequestParameters
       {
           ConsentDebugSettings = debugSettings,
       };
   
       // Check the current consent information status.
       ConsentInformation.Update(request, OnConsentInfoUpdated);
   }
   

ভৌগোলিক অঞ্চল ফোর্স করা

UMP SDK আপনার অ্যাপের আচরণ পরীক্ষা করার একটি উপায় প্রদান করে, যেন ডিভাইসটি বিভিন্ন অঞ্চলে অবস্থিত, যেমন ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA), যুক্তরাজ্য (UK) এবং সুইজারল্যান্ড DebugGeography ব্যবহার করে। মনে রাখবেন যে ডিবাগ সেটিংস শুধুমাত্র টেস্ট ডিভাইসে কাজ করে।

void Start()
{
    var debugSettings = new ConsentDebugSettings
    {
        // Geography appears as in EEA for debug devices.
        DebugGeography = DebugGeography.EEA,
        TestDeviceHashedIds = new List<string>
        {
            "TEST-DEVICE-HASHED-ID"
        }
    };

    // Create a ConsentRequestParameters object.
    ConsentRequestParameters request = new ConsentRequestParameters
    {
        ConsentDebugSettings = debugSettings,
    };

    // Check the current consent information status.
    ConsentInformation.Update(request, OnConsentInfoUpdated);
}

সম্মতির স্ট্যাটাস রিসেট করুন

UMP SDK-এর মাধ্যমে আপনার অ্যাপ পরীক্ষা করার সময়, SDK-এর স্ট্যাটাস রিসেট করলে আপনার সুবিধা হতে পারে, যাতে আপনি ব্যবহারকারীর প্রথমবার ইনস্টল করার অভিজ্ঞতা সিমুলেট করতে পারেন। এটি করার জন্য SDK Reset() পদ্ধতি প্রদান করে।

ConsentInformation.Reset();

সতর্কতা: এই পদ্ধতিটি শুধুমাত্র পরীক্ষার উদ্দেশ্যে ব্যবহার করার জন্য তৈরি করা হয়েছে। প্রোডাকশন কোডে Reset() কল করা উচিত নয়।

GitHub-এ উদাহরণ

এই পৃষ্ঠায় কভার করা UMP SDK ইন্টিগ্রেশনের সম্পূর্ণ উদাহরণ HelloWorld-এ দেখুন।