Başla

Google Mobile Ads SDK'sını bir uygulamaya entegre etmek, reklam görüntüleme ve gelir elde etmenin ilk adımıdır. SDK'yı entegre ettikten sonra, desteklenen reklam biçimlerinden birini veya daha fazlasını uygulayabilirsiniz.

Ön koşullar

• Xcode 14.1 veya daha üstünü kullanın
• iOS 11.0 veya sonraki sürümleri hedefleyin

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

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'

Ardından 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ı, Swift Package Manager'da henüz kullanıma sunulmamıştır. 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 veri taşıyorsanı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, File > Add Packages... (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 Mobil Ads Swift Paketi sürümünü seçin. Yeni projeler için Sonraki Ana Sürüm'ü kullanmanızı öneririz.

İşiniz bittiğinde 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 bilgi için Apple makalesini inceleyin.

Manuel indirme

1. SDK çerçevesini doğrudan indirip sıkıştırmasını açın ve aşağıdaki çerçeveleri Xcode projenize aktarın:

   • GoogleAppMeasurement.xcframework
   • GoogleAppMeasurementIdentitySupport.xcframework
   • GoogleMobileAds.xcframework
   • GoogleUtilities.xcframework
   • nanopb.xcframework
   • PromisesObjC.xcframework
   • UserMessagingPlatform.xcframework

2. -ObjC bağlayıcı işaretini projenizin oluşturma 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-################~##########dizesinin dize değerine sahip 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.

Tam snippet

<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.

Önemli Nokta: Gerçek uygulamalarda, yukarıda belirtilenler yerine gerçekAd Manager uygulama kimliğinizi kullanmanız önemlidir. Ancak bir Hello World uygulamasında SDK ile deneme yapmak istiyorsanız yukarıda gösterilen örnek uygulama kimliğini 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ından sonra) bir tamamlama işleyicisini geri çağırır. Bunun yalnızca bir kez, ideal olarak uygulama lansmanında yapılması yeterlidir. startWithCompletionHandler: adlı satıcıyı en kısa sürede 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 Mobile Ads SDK'sını başlatmadan önce bunu yaptığınızdan emin olun.

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

Örnek AppTemsilci.m (alıntı)

Swift

import GoogleMobileAds

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

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

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

    return true
  }

}

Objective-C

@import GoogleMobileAds;

@implementation AppDelegate

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

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

@end

Uyumlulaştırma kullanıyorsanız tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlayacağından reklamları yüklemeden önce tamamlama işleyicinin çağrılmasını bekleyebilirsiniz.

Reklam biçimi seçin

Mobile Ads SDK'sı içe aktarılıp başlatılır ve bir reklam uygulamaya hazırsınız. Ad Manager Birçok farklı reklam biçimi sunar. Bu sayede uygulamanızın kullanıcı deneyimine en uygun olanı seçebilirsiniz.

Banner

Cihaz ekranının üst veya alt kısmında görünen dikdörtgen reklamlar. Banner reklamlar, kullanıcılar uygulamayla etkileşim kurarken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz, bu tür reklamlar başlangıç için harika bir yerdir.

Banner uygulama

Geçişli

Kullanıcı kapatana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar. En iyi uygulamalar akışı, bir oyunun seviyeleri arasında veya bir görev tamamlandıktan hemen sonra, uygulama akışındaki doğal duraklamalarda kullanılır.

Geçiş reklamlarını uygulama

Yerel biçim

Uygulamanızın görünümü ve tarzıyla uyumlu olan özelleştirilebilir reklamlar. Bu reklamların nasıl ve nereye yerleştirileceğine siz karar verirsiniz. Böylece düzen, uygulamanızın tasarımıyla daha tutarlı olur.

Google Ad Manager, yerel reklamları uygulamak için iki yol sunar: Yerel Stiller ve Özel Oluşturma.

Yerel Stiller, yerel reklamların uygulanmasını mümkün olduğunca kolaylaştırmak için tasarlanmıştır. Bu biçimi kullanmaya yeni başladıysanız mükemmel bir seçimdir. Özel Oluşturma, sunumlarınızı oluştururken sahip olduğunuz özgürlüğü en üst düzeye çıkaracak şekilde tasarlanmıştır.

Yerel Stilleri Uygulama

Özel Oluşturmayı Uygulama

Ödül olarak verildi

Kısa videolar izleyen, oynatılabilir reklamlar ve anketlerle etkileşimde bulunan kullanıcıları ödüllendiren reklamlar. Ücretsiz içerik kullanıcıları üzerinden para kazanmak için uygundur.

Ödüllü reklamları uygulama

Ödüllü reklamları uygulama (yeni API'ler)