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ı uygulamaya geçebilirsiniz.

Ön koşullar

• Xcode 14.1 veya sonraki bir sürümü kullanın
• iOS 11.0 veya sonraki sürümleri hedefleyin

Mobile Ads SDK'sını içe aktarı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'

Ardından komut satırından şunu çalıştırın:

pod install --repo-update

CocoaPods'u kullanmaya yeni başladıysanız Pod dosyaları oluşturma ve kullanma hakkında bilgi edinmek için resmi belgelerine göz atı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ılamamaktadı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 geçiş yapı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 Package'ı 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 Sonraki Ana Sürüm'ü kullanmanızı öneririz.

Bitirdiğinizde Xcode paket bağımlılıklarınızı çözümlemeye ve 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-################~##########öğesinin 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.

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>

En uygun 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 Bilgi: Gerçek bir uygulamada, yukarıda listelenen 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. Bu işlemin yalnızca bir kez, ideal olarak uygulama lansmanında yapılması gerekir. Mümkün olan en kısa sürede startWithCompletionHandler: numaralı telefonu arayın.

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) belirlemeniz ya da reklamları yüklemeden önce başka bir işlem yapmanız gerekiyorsa bunu Mobile Ads SDK'sını başlatmadan önce yaptığınızdan emin olun.

AppDelegate etiketinizde startWithCompletionHandler: yönteminin nasıl çağrılacağına dair bir örnek:

Ö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 reklamları yüklemeden önce tamamlama işleyicinin çağrılmasını bekleyebilirsiniz. Bu işlem, tüm uyumlulaştırma bağdaştırıcılarının başlatılmasını sağlar.

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 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şimde bulunurken ekranda kalır ve belirli bir süre sonra otomatik olarak yenilenebilir. Mobil reklamcılıkta yeniyseniz, bu, başlamak için harika bir yerdir.

Banner uygulama

Geçişli

Kullanıcı tarafından kapatılana kadar bir uygulamanın arayüzünü kaplayan tam ekran reklamlar. En iyi uygulama akışındaki doğal duraklamalarda (ör. bir oyunun seviyeleri arasında ya da bir görev tamamlandıktan hemen sonra) kullanılır.

Geçiş reklamı uygulama

Yerel biçim

Uygulamanızın görünümü ve tarzıyla uyumlu olan özelleştirilebilir reklamlardır. 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. Biçimle ilgili yeniyseniz mükemmel bir seçimdir. Özel Oluşturma, sunumlarınızı oluştururken sahip olduğunuz özgürlüğü en üst düzeye çıkarmak için tasarlanmıştır.

Yerel Stilleri Uygulama

Özel Oluşturmayı Uygulama

Ödül olarak verildi

Kısa videoları izleyen, ayrıca 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 idealdir.

Ödüllü reklamları uygulama

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