Başla

Google Mobile Ads SDK'sını bir uygulamaya entegre etmek, reklam gösterme ve gelir elde etmenin ilk adımıdır. SDK'yı entegre ettikten sonra, desteklenen reklam biçimlerinden birini veya daha fazlasını uygulama işlemine geçebilirsiniz.

Ön koşullar

• Xcode 15.3 veya sonraki bir sürümü kullanın
• iOS 12.0 veya sonraki sürümleri hedefleyin

Mobile Ads SDK'sını içe aktarın

Google Mobile Ads SDK'sını içe aktarmak için aşağıdaki yöntemlerden birini kullanın.

CocoaPods (tercih edilen)

SDK'yı bir iOS projesine aktarmanın en basit yolu CocoaPods'u kullanmaktır. Projenizin Podfile dosyasını açın ve şu satırı uygulamanızın hedefine ekleyin:

pod 'Google-Mobile-Ads-SDK'

Daha sonra komut satırından şu komutu çalıştırın:

pod install --repo-update

CocoaPods'u kullanmaya yeni başladıysanız Podfile dosyası oluşturma ve kullanma hakkında bilgi edinmek için resmi belgelerine bakın.

Swift Paket Yöneticisi

Önemli Bilgi: Uyumlulaştırma bağdaştırıcısı kitaplıkları, henüz Swift Package Manager'da kullanılamaz. Uyumlulaştırmayı kullanıyorsanız CocoaPods ile entegrasyon yapmanızı öneririz.

Google Mobile Ads SDK'sı, 9.0.0 sürümünden itibaren Swift Package Manager'ı destekler. Swift paketini içe aktarmak için aşağıdaki adımları uygulayın:

Not: CocoaPods tabanlı bir projeden taşıma işlemi gerçekleştiriyorsanız Xcode projenizden CocoaPods'u kaldırmak için pod deintegrate komutunu çalıştırın. CocoaPods tarafından oluşturulan .xcworkspace dosyası daha sonra güvenli bir şekilde silinebilir. Google Mobile Ads SDK'sını bir projeye ilk kez ekliyorsanız bu adım yoksayılabilir.

1. Xcode'da Dosya > Paket Ekle... seçeneğine giderek Google Mobile Ads Swift Paketini yükleyin.

2. Görüntülenen istemde Google Mobile Ads Swift Package GitHub deposunu arayın:

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

3. Kullanmak istediğiniz Google Mobile Ads Swift Paketi sürümünü seçin. Yeni projeler için En Yeni Ana Sürüm'ü kullanmanızı öneririz.

Bitirdiğinizde Xcode paket bağımlılıklarınızı çözümlemeye ve bunları arka planda indirmeye başlar. Paket bağımlılıklarını ekleme hakkında daha fazla ayrıntı için Apple makalesini inceleyin.

Manuel indirme

1. Google Mobile Ads SDK'sını ve Embed & Sign aşağıdaki çerçeveleri Xcode projenize indirin:

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

2. -ObjC bağlayıcı işaretini, projenizin derleme ayarlarında Diğer Bağlayıcı İşaretleri'ne ekleyin:

   

Info.plist dosyanızı güncelleyin

İki anahtar eklemek için uygulamanızın Info.plist dosyasını güncelleyin:

1. Ad Manager app ID found in the Ad Manager UI and of the form ca-app-pub-################~##########öğenizin dize değerini içeren bir GADApplicationIdentifier anahtarı.

2. Google (cstr6suwn9.skadnetwork) için SKAdNetworkIdentifier değerlerine sahip bir SKAdNetworkItems anahtarı ve bu değerleri Google'a sağlayan belirli üçüncü taraf alıcılar.

Snippet'i tamamla

<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>4pfyvq9l8r.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>5a6flpkh64.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>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.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>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.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>n6fk4nfna4.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>eh6m2bh4zr.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>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ecpz2srf59.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>mlmmfzh3r3.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>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>zq492l623r.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

Optimum başlatma performansı için getiri gruplarınızı, kullanıldıkları belirli uygulamalarla ilişkilendirmeniz önemlidir. iOS'i hedefleyen ve belirli bir uygulamayla ilişkili olmayan getiri grubu yapılandırmaları, hesabınızdaki tüm iOS uygulamalarına gönderilir. Bu da başlatma için gereken süreyi uzatabilir.

Gerçek bir uygulamada, örnek uygulama kimliğini gerçekAd Manager uygulama kimliğinizle değiştirin. Bir Hello World uygulamasında SDK ile yalnızca deneniyorsanız örnek kimliği kullanabilirsiniz.

Mobile Ads SDK'sını başlatma

Reklamları yüklemeden önce GADMobileAds.sharedInstance üzerinde startWithCompletionHandler: yöntemini çağırın. Bu yöntem, SDK'yı başlatır ve başlatma işlemi tamamlandığında (veya 30 saniyelik zaman aşımının ardından) bir tamamlama işleyicisini geri çağırır. Bunun yalnızca bir kez, ideal olarak uygulamanın lansmanında yapılması yeterlidir. En kısa sürede startWithCompletionHandler: numaralı telefonu aramalısınız.

Uyarı: Reklamlar, startWithCompletionHandler: çağrısının ardından Mobile Ads SDK'sı veya uyumlulaştırma iş ortağı SDK'ları tarafından önceden yüklenebilir. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılardan izin almanız, isteğe özel işaretler (tagForChildDirectedTreatment veya tag_for_under_age_of_consent gibi) ayarlamanız veya reklamları yüklemeden önce başka bir işlem yapmanız gerekiyorsa bu işlemi Mobile Ads SDK'sını başlatmadan önce yaptığınızdan emin olun.

AppDelegate öğenizde startWithCompletionHandler: yöntemini nasıl çağıracağınıza dair bir örneği aşağıda bulabilirsiniz:

Örnek AppDelegate (alıntı)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

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

    return true
  }
}

SwiftUI

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()
      }
    }
  }
}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

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

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

@end

Not: Uyumlulaştırma kullanıyorsanız tüm uyumlulaştırma bağdaştırıcılarının başlatıldığından emin olmak için reklamları yüklemeden önce tamamlama işleyicisi çağrılana kadar bekleyin.

Reklam biçimi seçin

Mobile Ads SDK'sı içe aktarılıp başlatıldı. Artık bir reklamı uygulamaya hazırsınız. Ad Manager Birçok farklı reklam biçimi sunduğu için uygulamanızın kullanıcı deneyimine en uygun olan biçimi seçebilirsiniz.

SwiftUI geliştiricileri için SwiftUI kılavuzumuzu takip edin.

Banner

Banner reklam birimleri, uygulama düzeninin bir kısmını kaplayan dikdörtgen reklamlar gösterir. Belirli bir süre sonra otomatik olarak yenilenebilirler. Bu, uygulamanızda aynı ekranda kalsalar bile kullanıcıların düzenli aralıklarla yeni bir reklam görüntüledikleri anlamına gelir. Ayrıca, bu reklamlar aynı zamanda uygulanması en basit reklam biçimidir.

Banner reklamları uygulama

Geçişli

Geçiş reklamı birimleri, uygulamanızda tam sayfa reklamlar gösterir. Bunları, uygulamanızın arayüzündeki doğal ara ve geçişlere (ör. bir oyun uygulamasında seviye tamamlandıktan sonra) yerleştirin.

Geçiş reklamlarını uygulama

Yerel biçim

Yerel reklamlar, başlıklar ve harekete geçirici mesajlar gibi öğelerin uygulamalarınızda sunulma şeklini özelleştirebileceğiniz reklamlardır. Reklam stilini kendiniz belirleyerek, zengin bir kullanıcı deneyimine katkıda bulunabilecek, doğal ve göze batmayan bir reklam sunusu oluşturabilirsiniz.

Google Ad Manager, yerel reklamları uygulamak için iki yol sunar: yerel stiller ve özel oluşturma aracılığıyla standart yerel reklamlar.

Yerel stiller, yerel reklamların uygulanmasını kolaylaştırmak için tasarlanmıştır. Biçim konusunda yeniyseniz mükemmel bir seçimdir. Özel oluşturma, sunu oluşturma özgürlüğünüzü en üst düzeye çıkaracak şekilde tasarlanmıştır.

Yerel stilleri uygulama Yerel reklamları uygulama (özel oluşturma)

Ödül olarak verildi

Ödüllü reklam birimleri, kullanıcıların oyun oynayarak, anket yaparak veya video izleyerek jeton, ek can veya puan gibi uygulama içi ödüller kazanmalarını sağlar. Farklı reklam birimleri için farklı ödüller belirleyebilir ve kullanıcının aldığı ödül değerlerini ve öğelerini belirtebilirsiniz.

Ödüllü reklamları uygulama

Ödüllü geçiş reklamı

Ödüllü geçiş reklamı, doğal uygulama geçişleri sırasında otomatik olarak görünen reklamlar için jeton veya ekstra can gibi ödüller sunmanıza olanak tanıyan, teşvik edilen yeni bir reklam biçimidir.

Ödüllü reklamların aksine kullanıcıların ödüllü geçiş reklamını izlemeyi etkinleştirmesi gerekmez.

Ödüllü reklamlardaki etkinleştirme istemi yerine ödüllü geçiş reklamlarında ödülü bildiren ve kullanıcılara isterlerse devre dışı bırakma fırsatı sunan bir giriş ekranı gerekir.

Ödüllü geçiş reklamlarını uygulama

Uygulama açılışı

Uygulama açılışı, kullanıcılar uygulamanızı açtığında veya uygulamanıza geri döndüğünde gösterilen bir reklam biçimidir. Reklam, yükleme ekranının üzerinde yer alır.

Uygulama açılış reklamlarını uygulama