শুরু করুন, শুরু করুন

Google মোবাইল বিজ্ঞাপন SDK-কে একটি অ্যাপে একীভূত করা হল বিজ্ঞাপন প্রদর্শন এবং উপার্জনের দিকে প্রথম ধাপ। একবার আপনি SDK ইন্টিগ্রেট করার পরে, আপনি সমর্থিত বিজ্ঞাপন ফর্ম্যাটগুলির এক বা একাধিক প্রয়োগ করতে এগিয়ে যেতে পারেন৷

পূর্বশর্ত

• Xcode 15.3 বা উচ্চতর ব্যবহার করুন
• লক্ষ্য iOS 12.0 বা উচ্চতর

মোবাইল বিজ্ঞাপন SDK আমদানি করুন৷

Google মোবাইল বিজ্ঞাপন SDK আমদানি করতে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন৷

কোকোপডস (পছন্দের)

একটি iOS প্রকল্পে SDK আমদানি করার সবচেয়ে সহজ উপায় হল CocoaPods ব্যবহার করা। আপনার প্রকল্পের Podfile খুলুন এবং আপনার অ্যাপের লক্ষ্যে এই লাইন যোগ করুন:

pod 'Google-Mobile-Ads-SDK'

তারপর কমান্ড লাইন থেকে রান করুন:

pod install --repo-update

আপনি যদি CocoaPods-এ নতুন হয়ে থাকেন, তাহলে কীভাবে Podfiles তৈরি এবং ব্যবহার করবেন সে সম্পর্কে তথ্যের জন্য তাদের অফিসিয়াল ডকুমেন্টেশন দেখুন।

সুইফট প্যাকেজ ম্যানেজার

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

Google মোবাইল বিজ্ঞাপন SDK 9.0.0 সংস্করণ থেকে শুরু করে সুইফট প্যাকেজ ম্যানেজার সমর্থন করে। সুইফট প্যাকেজ আমদানি করতে এই পদক্ষেপগুলি অনুসরণ করুন:

দ্রষ্টব্য: যদি একটি CocoaPods-ভিত্তিক প্রকল্প থেকে স্থানান্তরিত হয়, তাহলে আপনার Xcode প্রকল্প থেকে CocoaPods অপসারণ করতে pod deintegrate চালান। CocoaPods-উত্পন্ন .xcworkspace ফাইলটি পরে নিরাপদে মুছে ফেলা যেতে পারে। আপনি যদি প্রথমবার কোনো প্রোজেক্টে Google Mobile Ads SDK যোগ করেন, তাহলে এই ধাপটি উপেক্ষা করা যেতে পারে।

1. Xcode-এ, File > Add Packages... এ নেভিগেট করে Google Mobile Ads Swift Package ইনস্টল করুন।

2. প্রদর্শিত প্রম্পটে, Google Mobile Ads Swift Package GitHub সংগ্রহস্থলের জন্য অনুসন্ধান করুন:

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

3. আপনি যে Google মোবাইল বিজ্ঞাপন সুইফ্ট প্যাকেজটি ব্যবহার করতে চান তার সংস্করণ নির্বাচন করুন৷ নতুন প্রকল্পের জন্য, আমরা আপ টু নেক্সট মেজর সংস্করণ ব্যবহার করার পরামর্শ দিই।

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

ম্যানুয়াল ডাউনলোড

1. Google মোবাইল বিজ্ঞাপন SDK ডাউনলোড করুন এবং আপনার Xcode প্রকল্পে নিম্নলিখিত ফ্রেমওয়ার্ক Embed & Sign :

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. আপনার প্রকল্পের বিল্ড সেটিংসে:

   • Runpath অনুসন্ধান পাথগুলিতে /usr/lib/swift পাথ যোগ করুন।
   • অন্যান্য লিঙ্কার ফ্ল্যাগে -ObjC লিঙ্কার পতাকা যোগ করুন।

আপনার Info.plist আপডেট করুন

দুটি কী যোগ করতে আপনার অ্যাপের Info.plist ফাইল আপডেট করুন:

1. আপনার একটি স্ট্রিং মান সহ একটি GADApplicationIdentifier কীAd Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########.

2. Google ( cstr6suwn9.skadnetwork ) এর জন্য SKAdNetworkIdentifier মান সহ একটি SKAdNetworkItems কী এবং Google-কে এই মানগুলি প্রদান করা তৃতীয় পক্ষের ক্রেতাদের নির্বাচন করুন ৷

সম্পূর্ণ স্নিপেট

<key>GADApplicationIdentifier</key>
<string>ca-app-pub-3940256099942544~1458002511</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>pwa73g5rt2.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

সর্বোত্তম প্রারম্ভিক কর্মক্ষমতার জন্য, আপনার ফলন গোষ্ঠীগুলিকে নির্দিষ্ট অ্যাপগুলির সাথে যুক্ত করা গুরুত্বপূর্ণ। iOS টার্গেট করে এবং কোনও নির্দিষ্ট অ্যাপের সাথে যুক্ত নয় এমন ইল্ড গ্রুপ কনফিগারেশনগুলি আপনার অ্যাকাউন্টের সমস্ত iOS অ্যাপে পাঠানো হবে, সম্ভাব্য সময়কে দীর্ঘায়িত করবে। আরম্ভ করতে

একটি বাস্তব অ্যাপে, নমুনা অ্যাপ আইডিটি আপনার আসল দিয়ে প্রতিস্থাপন করুন Ad Manager অ্যাপ আইডি । আপনি যদি হ্যালো ওয়ার্ল্ড অ্যাপে SDK নিয়ে পরীক্ষা-নিরীক্ষা করে থাকেন তাহলে আপনি নমুনা আইডি ব্যবহার করতে পারেন।

মোবাইল বিজ্ঞাপন SDK শুরু করুন

বিজ্ঞাপন লোড করার আগে, GADMobileAds.sharedInstance এ startWithCompletionHandler: পদ্ধতিতে কল করুন, যা SDK শুরু করে এবং আরম্ভ করার পরে (বা 30-সেকেন্ডের সময় শেষ হওয়ার পরে) একটি সমাপ্তি হ্যান্ডলারকে কল করে। এটি শুধুমাত্র একবার করা দরকার, আদর্শভাবে অ্যাপ লঞ্চের সময়। আপনার startWithCompletionHandler: যত তাড়াতাড়ি সম্ভব।

সতর্কতা: startWithCompletionHandler: কল করার পরে বিজ্ঞাপনগুলি মোবাইল বিজ্ঞাপন SDK বা মধ্যস্থতা অংশীদার SDK দ্বারা প্রিলোড করা হতে পারে। আপনি যদি ইউরোপীয় অর্থনৈতিক এলাকার (EEA) ব্যবহারকারীদের কাছ থেকে সম্মতি পেতে চান, তাহলে যেকোন অনুরোধ-নির্দিষ্ট ফ্ল্যাগ সেট করুন (যেমন tagForChildDirectedTreatment বা tag_for_under_age_of_consent ), অথবা অন্যথায় বিজ্ঞাপন লোড করার আগে পদক্ষেপ নিন, মোবাইল বিজ্ঞাপন SDK শুরু করার আগে আপনি তা করেছেন তা নিশ্চিত করুন।

আপনার AppDelegate startWithCompletionHandler: পদ্ধতিটিকে কীভাবে কল করবেন তার একটি উদাহরণ এখানে রয়েছে:

উদাহরণ অ্যাপ ডেলিগেট (উদ্ধৃতি)

সুইফট

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

সুইফটইউআই

import GoogleMobileAds

class AppDelegate: UIResponder, UIApplicationDelegate {

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

    GADMobileAds.sharedInstance().start(completionHandler: nil)

    return true
  }
}

@main
struct YourApp: App {
  // To handle app delegate callbacks in an app that uses the SwiftUI lifecycle,
  // you must create an application delegate and attach it to your `App` struct
  // using `UIApplicationDelegateAdaptor`.
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

উদ্দেশ্য-C

@import GoogleMobileAds;

@implementation AppDelegate

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

  [GADMobileAds.sharedInstance startWithCompletionHandler:nil];
  return YES;
}

@end

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

একটি বিজ্ঞাপন বিন্যাস নির্বাচন করুন

মোবাইল বিজ্ঞাপন SDK এখন আমদানি করা হয়েছে এবং আরম্ভ করা হয়েছে এবং আপনি একটি বিজ্ঞাপন বাস্তবায়নের জন্য প্রস্তুত৷ Ad Manager বিভিন্ন বিজ্ঞাপন ফরম্যাট অফার করে, তাই আপনি আপনার অ্যাপের ব্যবহারকারীর অভিজ্ঞতার সাথে সবচেয়ে উপযুক্ত একটি বেছে নিতে পারেন।

SwiftUI বিকাশকারীদের জন্য, আমাদের SwiftUI নির্দেশিকা অনুসরণ করুন।

ব্যানার

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

ব্যানার বিজ্ঞাপন বাস্তবায়ন

ইন্টারস্টিশিয়াল

ইন্টারস্টিশিয়াল বিজ্ঞাপন ইউনিট আপনার অ্যাপে পূর্ণ-পৃষ্ঠার বিজ্ঞাপন দেখায়। এগুলিকে আপনার অ্যাপের ইন্টারফেসে প্রাকৃতিক বিরতি এবং ট্রানজিশনে রাখুন, যেমন একটি গেমিং অ্যাপে লেভেল সমাপ্তির পরে।

ইন্টারস্টিশিয়াল বিজ্ঞাপন প্রয়োগ করুন

নেটিভ

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

গুগল অ্যাড ম্যানেজার নেটিভ বিজ্ঞাপনগুলি বাস্তবায়নের দুটি উপায় অফার করে: কাস্টম রেন্ডারিংয়ের মাধ্যমে নেটিভ স্টাইল এবং স্ট্যান্ডার্ড নেটিভ বিজ্ঞাপন।

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

নেটিভ শৈলী প্রয়োগ করুন নেটিভ বিজ্ঞাপনগুলি প্রয়োগ করুন (কাস্টম রেন্ডারিং)

পুরস্কৃত

পুরস্কৃত বিজ্ঞাপন ইউনিট ব্যবহারকারীদের গেম খেলতে, সমীক্ষা করতে বা ভিডিও দেখার জন্য অ্যাপ-মধ্যস্থ পুরস্কার, যেমন কয়েন, অতিরিক্ত জীবন বা পয়েন্ট অর্জন করতে সক্ষম করে। আপনি বিভিন্ন বিজ্ঞাপন ইউনিটের জন্য বিভিন্ন পুরস্কার সেট করতে পারেন এবং ব্যবহারকারীর প্রাপ্ত পুরস্কারের মান এবং আইটেমগুলি নির্দিষ্ট করতে পারেন।

পুরস্কৃত বিজ্ঞাপন প্রয়োগ করুন

পুরস্কৃত ইন্টারস্টিশিয়াল

পুরস্কৃত ইন্টারস্টিশিয়াল হল একটি নতুন ধরনের প্রণোদনামূলক বিজ্ঞাপন ফর্ম্যাট যা আপনাকে পুরস্কারের অফার করতে দেয়, যেমন কয়েন বা অতিরিক্ত জীবন, এমন বিজ্ঞাপনের জন্য যা প্রাকৃতিক অ্যাপ ট্রানজিশনের সময় স্বয়ংক্রিয়ভাবে প্রদর্শিত হয়।

পুরস্কৃত বিজ্ঞাপনের বিপরীতে, ব্যবহারকারীদের একটি পুরস্কৃত ইন্টারস্টিশিয়াল দেখার জন্য বেছে নেওয়ার প্রয়োজন নেই।

পুরস্কৃত বিজ্ঞাপনে অপ্ট-ইন প্রম্পটের পরিবর্তে, পুরস্কৃত ইন্টারস্টিশিয়ালগুলির জন্য একটি ইন্ট্রো স্ক্রিন প্রয়োজন যা পুরস্কার ঘোষণা করে এবং ব্যবহারকারীরা তা করতে চাইলে অপ্ট-আউট করার সুযোগ দেয়।

পুরস্কৃত ইন্টারস্টিশিয়াল বিজ্ঞাপন প্রয়োগ করুন

অ্যাপ খোলা

অ্যাপ ওপেন হল একটি বিজ্ঞাপন ফর্ম্যাট যা ব্যবহারকারীরা আপনার অ্যাপ খুললে বা ফিরে গেলে দেখা যায়। বিজ্ঞাপনটি লোডিং স্ক্রীনকে ওভারলে করে।

অ্যাপ্লিকেশন খোলা বিজ্ঞাপন বাস্তবায়ন