গ্লোবাল সেটিংস

প্ল্যাটফর্ম নির্বাচন করুন: অ্যান্ড্রয়েড (বিটা) অ্যান্ড্রয়েড আইওএস ইউনিটি

GADMobileAds ক্লাসটি Google Mobile Ads SDK দ্বারা সংগৃহীত নির্দিষ্ট কিছু তথ্য নিয়ন্ত্রণের জন্য গ্লোবাল সেটিংস প্রদান করে।

ভিডিও বিজ্ঞাপনের ভলিউম নিয়ন্ত্রণ

দ্রষ্টব্য: ভিডিও ভলিউম নিয়ন্ত্রণ শুধুমাত্র গুগল বিজ্ঞাপনের ক্ষেত্রে প্রযোজ্য এবং এটি মিডিয়েশন নেটওয়ার্কে পাঠানো হয় না।

আপনার অ্যাপে যদি নিজস্ব ভলিউম কন্ট্রোল থাকে, যেমন কাস্টম মিউজিক বা সাউন্ড ইফেক্টের ভলিউম, তাহলে Google Mobile Ads SDK কে অ্যাপের ভলিউমের তথ্য জানালে ভিডিও বিজ্ঞাপনগুলো অ্যাপের ভলিউম সেটিংস মেনে চলে। এর ফলে ব্যবহারকারীরা প্রত্যাশিত অডিও ভলিউমে ভিডিও বিজ্ঞাপনগুলো পান।

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

অ্যাপ ওপেন, ব্যানার, ইন্টারস্টিশিয়াল, রিওয়ার্ডেড, এবং রিওয়ার্ডেড ইন্টারস্টিশিয়াল অ্যাড ফরম্যাটের জন্য, আপনি applicationVolume প্রপার্টি সেট করে Google Mobile Ads SDK তে আপেক্ষিক অ্যাপ ভলিউম রিপোর্ট করতে পারেন। বৈধ অ্যাড ভলিউমের মান 0.0 (সাইলেন্ট) থেকে 1.0 (বর্তমান ডিভাইসের ভলিউম) পর্যন্ত হয়ে থাকে। SDK-তে আপেক্ষিক অ্যাপ ভলিউম কীভাবে রিপোর্ট করবেন তার একটি উদাহরণ নিচে দেওয়া হলো:

সুইফট

func viewDidLoad() {
  super.viewDidLoad()
  // Set app volume to be half of the current device volume.
  MobileAds.shared.applicationVolume = 0.5
  ...
}

উদ্দেশ্য-সি

- (void)viewDidLoad {
  [super viewDidLoad];
  // Set app volume to be half of the current device volume.
  GADMobileAds.sharedInstance.applicationVolume = 0.5;
  ...
}

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

অ্যাপ ওপেন, ব্যানার, ইন্টারস্টিশিয়াল, রিওয়ার্ডেড, এবং রিওয়ার্ডেড ইন্টারস্টিশিয়াল বিজ্ঞাপন ফরম্যাটের জন্য, আপনি applicationMuted প্রপার্টি সেট করে Google Mobile Ads SDK জানাতে পারেন যে অ্যাপের ভলিউম মিউট করা হয়েছে:

সুইফট

MobileAds.shared.applicationMuted = true

উদ্দেশ্য-সি

GADMobileAds.sharedInstance.applicationMuted = YES;

ডিফল্টরূপে, applicationVolume মান 1 (বর্তমান ডিভাইস ভলিউম) এবং applicationMuted মান NO সেট করা থাকে।

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

স্থানীয় বিজ্ঞাপন

মিউট সেটিংস নিয়ন্ত্রণ করার নির্দেশাবলীর জন্য GADVideoOptions দেখুন। নেটিভ বিজ্ঞাপনের জন্য কাস্টম ভলিউম নিয়ন্ত্রণের সুবিধা নেই।

অডিও সেশন

অডিও সেশন আপনাকে আপনার অ্যাপের অডিও আচরণ সম্পর্কে সিস্টেমের কাছে আপনার উদ্দেশ্য প্রকাশ করার সুযোগ দেয়। অডিও সেশন সম্পর্কে অতিরিক্ত তথ্য Apple-এর Audio Session Programming Guide- এ পাওয়া যাবে। Google Mobile Ads SDK অডিও পরিচালনার জন্য audioVideoManager প্রপার্টি ব্যবহার করা যায়।

আপনি যদি আপনার অ্যাপে অডিও ব্যবহার না করেন, তাহলে এই API-গুলো ব্যবহার করার প্রয়োজন নেই। Google Mobile Ads SDK অডিও চালানোর সময় স্বয়ংক্রিয়ভাবে অডিও সেশন ক্যাটাগরি পরিচালনা করে। যদি আপনি আপনার অ্যাপে অডিও চালান এবং Google Mobile Ads SDK কখন ও কীভাবে অডিও চালাবে তার উপর আরও কঠোর নিয়ন্ত্রণ চান, তাহলে আপনি এই API-গুলো ব্যবহার করতে পারেন।

অডিও ভিডিও ম্যানেজারে, আপনি যদি অডিও সেশন ক্যাটাগরি পরিচালনার দায়িত্ব নিজে নিতে চান, তাহলে audioSessionIsApplicationManaged প্রপার্টিটি YES এ সেট করতে পারেন।

আপনি যদি অডিও সেশন ক্যাটাগরি পরিচালনা করতে চান, তাহলে আপনি GADAudioVideoManagerDelegate ইমপ্লিমেন্ট করতে পারেন এবং বিজ্ঞাপনের ভিডিও ও অডিও প্লেব্যাক ইভেন্টের নোটিফিকেশন পাওয়ার জন্য অডিও ভিডিও ম্যানেজারে delegate প্রপার্টি সেট করতে পারেন। এরপর আপনাকে Apple-এর Audio Session Programming Guide অনুযায়ী অডিও সেশন ক্যাটাগরিটি প্রাসঙ্গিক ক্যাটাগরিতে পরিবর্তন করতে হবে।

মূল বিষয়: ডিফল্টরূপে, বিজ্ঞাপন মিউট করে চালানোর সময় SDK অডিও সেশন ক্যাটাগরিকে AVAudioSessionCategoryAmbient এ সেট করে। এই পরিস্থিতিতে আপনি যদি চান আপনার অ্যাপ AVAudioSessionCategoryOptionDuckOthers ব্যবহার করুক, তাহলে আপনাকে অবশ্যই GADAudioVideoManagerDelegate প্রোটোকলটি ইমপ্লিমেন্ট করতে হবে এবং audioSessionIsApplicationManaged YES এ সেট করতে হবে।

আপনার অ্যাপটি যদি উপরের API-গুলো ব্যবহার করে গান বাজায়, তবে প্রস্তাবিত পদ্ধতিটি দেখানোর জন্য এখানে একটি সরলীকৃত কোড নমুনা দেওয়া হলো:

সুইফট

func setUp() {
  MobileAds.shared.audioVideoManager.delegate = self
  MobileAds.shared.audioVideoManager.audioSessionIsApplicationManaged = false
}

// MARK: - GADAudioVideoManagerDelegate
func audioVideoManagerWillPlayAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  MyAppObject.shared.pauseAllMusic()
}

func audioVideoManagerDidStopPlayingAudio(_ audioVideoManager: GADAudioVideoManager) {
  // The Google Mobile Ads SDK is notifying your app that it has stopped playing
  // audio. Depending on your design, you could resume music here.
  MyAppObject.shared.resumeAllMusic()
}

উদ্দেশ্য-সি

- (void)setUp {
  GADMobileAds.sharedInstance.audioVideoManager.delegate = self;
  GADMobileAds.sharedInstance.audioVideoManager.audioSessionIsApplicationManaged = NO;
}

#pragma mark - GADAudioVideoManagerDelegate

- (void)audioVideoManagerWillPlayAudio:(GADAudioVideoManager *)audioVideoManager {
  // Google Mobile Ads SDK is notifying your app that it will play audio. You
  // could optionally pause music depending on your apps design.
  [MyAppObject.sharedInstance pauseAllMusic];
}

- (void)audioVideoManagerDidStopPlayingAudio:(GADAudioVideoManager *)audioVideoManager {
    // Google Mobile Ads SDK is notifying your app that it has stopped playing
    // audio. Depending on your design, you could resume music here.
  [MyAppObject.sharedInstance resumeAllMusic];
}

দুর্ঘটনা প্রতিবেদন

Google Mobile Ads SDK একটি আইওএস অ্যাপে ঘটা ব্যতিক্রমগুলো পরীক্ষা করে এবং এসডিকে-র কারণে ঘটলে সেগুলো রেকর্ড করে রাখে। এরপর এসডিকে-র পরবর্তী সংস্করণগুলোতে এই ব্যতিক্রমগুলোর সমাধান করা হয়।

ক্র্যাশ রিপোর্টিং ডিফল্টরূপে সক্রিয় থাকে। আপনি যদি SDK-সম্পর্কিত ব্যতিক্রমগুলি রেকর্ড করতে না চান, তাহলে disableSDKCrashReporting মেথডটি কল করে এই বৈশিষ্ট্যটি নিষ্ক্রিয় করতে পারেন। এই মেথডটি কল করার সেরা সময় হলো অ্যাপটি চালু হওয়ার সময়:

সুইফট

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

  func application(_ application: UIApplication,
      didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {

    MobileAds.shared.disableSDKCrashReporting()
    return true
  }
}

উদ্দেশ্য-সি

@import GoogleMobileAds;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

  [GADMobileAds disableSDKCrashReporting];
  return YES;
}

@end

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

আপনার অ্যাপের বিশেষ কোনো প্রয়োজন থাকলে, আপনি ঐচ্ছিক NSUserDefaults gad_has_consent_for_cookies সেট করতে পারেন। gad_has_consent_for_cookies প্রেফারেন্সটি শূন্যতে সেট করা থাকলে Google Mobile Ads SDK সীমিত বিজ্ঞাপন (LTD) চালু করে।

সুইফট

UserDefaults.standard.set(0, forKey: "gad_has_consent_for_cookies")

উদ্দেশ্য-সি

NSUserDefaults.standardUserDefaults().setObject(Int(0),
    forKey: "gad_has_consent_for_cookies");