Bu sayfa, Cloud Translation API ile çevrilmiştir.

AppLovin'i uyumlulaştırma ile entegre etme

Bu kılavuzda, hem şelale hem de teklif entegrasyonlarını kapsayan AdMob Uyumlulaştırma'yı kullanarak AppLovin'den reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu makalede, AppLovin'in bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve AppLovin SDK'sının ve bağdaştırıcının bir iOS uygulamasına nasıl entegre edileceği ele alınmaktadır.

Desteklenen entegrasyonlar ve reklam biçimleri

AppLovin için uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:

Entegrasyon
Teklif verme
Şelale
Formatlar
Banner	¹
Geçiş reklamı
Ödüllü
Yerel biçim

¹ Banner reklamlar (MREC banner'ları hariç) yalnızca uyumlulaştırmada desteklenir. Teklifli sistem, banner reklam türlerini desteklemez.

Şartlar

iOS dağıtım hedefi 12.0 veya daha yeni bir sürüm olmalıdır.
[Teklif verme için]: Desteklenen tüm reklam biçimlerini teklif vermeye entegre etmek üzere AppLovin bağdaştırıcısı 6.3.0.0 veya sonraki bir sürümü kullanın (en son sürüm önerilir).

En son Google Mobile Ads SDK'sı
Uyumlulaştırmayı tamamlama Başlangıç kılavuzu

1. adım: AppLovin kullanıcı arayüzünde yapılandırmaları ayarlayın

AppLovin hesabınıza kaydolun veya oturum açın.

AdMob reklam biriminizi ayarlamak için AppLovin SDK Anahtarınız ve Rapor Anahtarınız gerekir. Bu değerleri bulmak için AppLovin kullanıcı arayüzü > Hesap > Anahtarlar'a gidin ve her iki değeri de görün.

Yalnızca teklifli sistemi entegre etmeyi planlıyorsanız uyumlulaştırma ayarlarınızı yapılandırmaya geçebilirsiniz.

Uyumlulaştırma için uygulama seçme

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

AppLovin kullanıcı arayüzünde, kayıtlı uygulamalarınıza gitmek için Para kazanma bölümündeki Uygulamalar'ı seçin. Mevcut uygulamalar listesinden uyumlulaştırmayla kullanmak istediğiniz uygulamayı seçin.

Alt bölge oluştur

Teklif verme

Bu adım, teklifli sistem entegrasyonları için gerekli değildir.

Şelale

Kayıtlı bölge kimliklerinize ulaşmak için AppLovin kullanıcı arayüzünde Para kazanma bölümünün altında Bölgeler'i seçin. Uygulamanız için gerekli bölgeleri zaten oluşturduysanız 2. Adım'a geçin. Yeni bir bölge kimliği oluşturmak için Bölge Oluştur'u tıklayın.

Zone ID adını girin, Platform olarak Android'i seçin ve Reklam Türü'nü belirleyin.

Fiyatlandırma'yı Sabit BGBM veya AppLovin tarafından optimize edildi'yi seçerek yapılandırın. Sabit BGBM seçeneği için BGBM'ler ülke bazında yapılandırılabilir. Ardından Kaydet'i tıklayın.

Bölge oluşturulduktan sonra bölge kimliğini Bölge Kimliği sütununda bulabilirsiniz.

Test modunu etkinleştirme

AppLovin test reklamlarını etkinleştirmeyle ilgili olarak AppLovin'in MAX Test Modu kılavuzundaki talimatları uygulayın.

2. Adım: AdMob kullanıcı arayüzünde AppLovin talebini ayarlayın

Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma

Reklam biriminizin uyumlulaştırma yapılandırmasına Applovin'i eklemeniz gerekir.

Öncelikle AdMob hesabınızda oturum açın. Ardından Uyumlulaştırma sekmesine gidin. Değiştirmek istediğiniz mevcut bir uyumlulaştırma grubunuz varsa düzenlemek için ilgili uyumlulaştırma grubunun adını tıklayın ve Applovin'i reklam kaynağı olarak ekleme bölümüne geçin.

Yeni bir uyumlulaştırma grubu oluşturmak için Uyumlulaştırma Grubu Oluştur'u seçin.

Reklam biçiminizi ve platformunuzu girip Devam'ı tıklayın.

Uyumlulaştırma grubunuza bir ad verin ve hedeflenecek konumları seçin. Ardından, uyumlulaştırma grubu durumunu Etkin olarak ayarlayın ve Reklam Birimi Ekle'yi tıklayın.

Bu uyumlulaştırma grubunu mevcut AdMob reklam birimlerinizden bir veya daha fazlasıyla ilişkilendirin. Ardından Bitti'yi tıklayın.

Artık reklam birimleri kartının, seçtiğiniz reklam birimleriyle doldurulduğunu göreceksiniz:

Applovin'u reklam kaynağı olarak ekleme

Teklif verme

Reklam Kaynakları bölümündeki Teklifli Sistem kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Applovin'u seçin.
Applovin ile iş ortaklığı sözleşmesi imzalama ve teklifli sistem iş ortaklığı oluşturma başlıklı makaleleri inceleyin.

Kabul ediyorum'u, ardından Devam'ı tıklayın.

AppLovin için zaten bir eşlemeniz varsa bunu seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen SDK Anahtarı'nı girin. Ardından Bitti'yi tıklayın.

Şelale

Reklam Kaynakları bölümündeki Şelale kartının altında Reklam Kaynağı Ekle'yi seçin. Ardından Applovin'u seçin.

Applovin'u seçin ve Optimize anahtarını etkinleştirin. Applovin için reklam kaynağı optimizasyonunu ayarlamak üzere önceki bölümde elde edilen Rapor Anahtarı'nı girin. Ardından Applovin için bir eBGBM değeri girin ve Devam'ı tıklayın.

Applovin için zaten bir eşlemeniz varsa bu eşlemeyi seçebilirsiniz. Aksi takdirde Eşleme ekle'yi tıklayın.

Ardından, önceki bölümde elde edilen SDK Anahtarı ve Bölge Kimliği ile birlikte uygulamanızın Gruptaki Uygulama Kimliğini girin. Ardından Bitti'yi tıklayın.

Not: Reklam kaynağı optimizasyonunun, bir uyumlulaştırma ağı için eBGBM'yi doğru şekilde hesaplayacak kadar veri toplaması birkaç gün sürer. Bu süre zarfında reklam kaynağı optimizasyon durumu PENDING olduğundan ağ için manuel olarak bir eBGBM değeri ayarlamanız gerekir. eBGBM hesaplandığında reklam kaynağı, eBGBM'yi sizin adınıza otomatik olarak güncellemeye başlar.

Applovin Corp.'u GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine ekleme

AdMob kullanıcı arayüzündeki GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine Applovin Corp.'u eklemek için GDPR ayarlarındaki ve ABD eyalet düzenlemeleri ayarlarındaki adımları uygulayın.

3. Adım: AppLovin SDK'sını ve bağdaştırıcısını içe aktarın

CocoaPods'u kullanma (önerilir)

Projenizin Podfile dosyasına aşağıdaki satırı ekleyin:
```
pod 'GoogleMobileAdsMediationAppLovin'
```
Komut satırından şunu çalıştırın:
```
pod install --repo-update
```

Manuel entegrasyon

AppLovin iOS SDK'sının en son sürümünü indirin ve projenize ApplovinSDK.framework bağlantısını ekleyin.
AppLovin bağdaştırıcının en son sürümünü Değişiklik Günlüğü'ndeki indirme bağlantısından indirip projenize bağlayınApplovinAdapter.framework.
Projenize aşağıdaki çerçeveleri ekleyin:
- AdSupport
- AVFoundation
- CoreGraphics
- CoreMedia
- CoreTelephony
- StoreKit
- SystemConfiguration
- UIKit
- WebKit
- libz.tbd

4. Adım: AppLovin SDK'sında gizlilik ayarlarını uygulayın

AB Kullanıcı Rızası ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı (AEA)'ndaki kullanıcılara cihaz tanımlayıcıları ve kişisel verilerin kullanımıyla ilgili belirli açıklamaların yapılmasını ve izinlerin alınmasını sağlamanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. İzin alırken, uyumlulaştırma zincirinizde kişisel veri toplayabilecek, alabilecek veya kullanabilecek her reklam ağını tanımlamanız ve her ağın kullanımı hakkında bilgi vermeniz gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak iletememektedir.

AppLovin, SDK 12.0.0 sürümünden beri UserDefaults izin dizesini okumayı ve izin durumunu buna göre ayarlamayı desteklemektedir.

AppLovin SDK 12.0.0 ve sonraki sürümlerini kullanmıyorsanız veya izin dizesini UserDefaults içine yazan bir CMP kullanmıyorsanız setHasUserContent yöntemini kullanabilirsiniz. Aşağıdaki örnekte, izin bilgileri AppLovin SDK'sına iletilmektedir. Bu seçeneklerin AppLovin SDK'sına doğru şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce bu seçenekleri ayarlamanız gerekir.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setHasUserConsent(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setHasUserConsent:YES];

Daha fazla bilgi için AppLovin'in gizlilik ayarlarına göz atın.

Alt kullanıcıları bildirme

AppLovin SDK 13.0.0'dan itibaren AppLovin, yaş kısıtlamalı kullanıcı işaretlerini artık desteklemiyor ve AppLovin SDK'sını geçerli yasalar uyarınca tanımlanan "çocuk" ile bağlantılı olarak başlatamaz veya kullanamazsınız. Daha fazla bilgi için AppLovin'in Çocuk Verileri veya Çocuklara Yönelik Hizmetleri ya da Yalnızca Çocukları Hedefleyen Uygulamaları Kullanma Yasağı ile ilgili belgelerine bakın.

AppLovin bağdaştırıcısı 13.0.0.1 veya sonraki sürümler, Google Mobile Ads SDK'sı ile aşağıdaki ayarlardan birini açıklayan uygulamalarda AppLovin uyumlulaştırmasını otomatik olarak devre dışı bırakır:

AppLovin bağdaştırıcısı 12.6.1.0 veya önceki bir sürümü kullanıyorsanız AppLovin SDK'sı ile yaş kısıtlamalı kullanıcı işaretini ayarlama hakkında AppLovin'in dokümanlarına bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, kişisel bilgilerinin "satışının" (bu terimlerin yasalardaki tanımlarına uygun şekilde) kapsamı dışında kalma seçeneği sunmayı zorunlu kılıyor. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Kesinlikle Satmayın" gibi bir bağlantıyla sunulur. ABD eyalet gizlilik yasaları uygunluk kılavuzu, Google reklam sunumu için kısıtlanmış veri işlemeyi etkinleştirme olanağı sunar ancak Google bu ayarı uyumlulaştırma zincirinizdeki her reklam ağına uygulayamaz. Bu nedenle, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilir her reklam ağını tanımlamanız ve uyumluluğu sağlamak için bu ağların her birinin talimatlarını uygulamanız gerekir.

AppLovin SDK'sı, yayıncıların kişisel bilgilerin satışını devre dışı bırakmasına olanak tanıyan setDoNotSell yöntemini içerir.

Aşağıdaki örnekte bu izin bilgileri AppLovin SDK'sına iletilmektedir. Bu seçeneklerin AppLovin SDK'sına düzgün şekilde yönlendirilmesini sağlamak için Google Mobile Ads SDK'sını başlatmadan önce bu seçenekleri ayarlamanız gerekir.

Swift

import AppLovinSDK
// ...

ALPrivacySettings.setDoNotSell(true)

Objective-C

#import <AppLovinSDK/AppLovinSDK.h>
// ...

[ALPrivacySettings setDoNotSell:YES];

Daha fazla bilgi için AppLovin'in Gizlilik belgelerine bakın.

5. adım: Gerekli kodu ekleyin

SKAdNetwork entegrasyonu

SKAdNetwork tanımlayıcılarını projenizin Info.plist dosyasına eklemek için AppLovin'in dokümanlarını inceleyin.

6. adım: Uygulamanızı test edin

Test reklamlarını etkinleştirme

AdMob için test cihazınızı kaydettiğinizden ve Applovin kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.

Test reklamlarını doğrulama

Applovin'dan test reklamları aldığınızı doğrulamak için Applovin (Teklifli Sistem) ve Applovin (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

AppLovin bağdaştırıcısı, video reklamlarda sesi devre dışı bırakmak için isteğe bağlı bir ekstra olan muteAudio'ü destekler. Bu parametreyi GADMAdapterAppLovinExtras sınıfını kullanarak bağdaştırıcının aktarabilir ve her reklam isteğinde ayarlamanız gerekir. Bunu nasıl ayarlayacağınız aşağıda açıklanmıştır:

Swift

let request = GADRequest()
let extras = GADMAdapterAppLovinExtras()
extras.muteAudio = false
request.register(extras)

Objective-C

GADRequest *request = [GADRequest request];
GADMAdapterAppLovinExtras * extras = [[GADMAdapterAppLovinExtras alloc] init];
extras.muteAudio = NO;
[request registerAdNetworkExtras:extras];

Optimizasyonlar

AppLovin SDK'sını uygulamanız başlatılır başlatılmaz başlatmak, AppLovin'in uygulama başlatılır başlatılmaz etkinlikleri izlemesini sağlar.

Swift

let sdk = ALSdk.shared(withKey: "sdkKey")
sdk?.initializeSdk()

Objective-C

ALSdk *sdk = [ALSdk sharedWithKey:@"sdkKey"];
[sdk initializeSdk];

Hata kodları

Adaptör AppLovin'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında GADResponseInfo.adNetworkInfoArray kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

GADMAdapterAppLovin
GADMAdapterAppLovinRewardBasedVideoAd
GADMediationAdapterAppLovin

Bir reklam yüklenemezse AppLovin bağdaştırıcısı tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:

Hata kodu	Neden
-1009 ila -1, 204	AppLovin SDK'sı bir hata döndürdü. Daha fazla ayrıntı için AppLovin'in belgelerine göz atın.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
102	AdMob kullanıcı arayüzünde yapılandırılan AppLovin sunucu parametreleri eksik/geçersiz.
103	AppLovin reklamı gösterilemedi.
104	Aynı bölge için birden fazla reklam istendi. AppLovin, her bölge için aynı anda yalnızca 1 reklam yükleyebilir.
105	AppLovin SDK anahtarı bulunamadı.
107	Teklif jetonu boş.
108	AppLovin bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
110	AppLovin, başarılı bir yükleme geri çağırma gönderdi ancak sıfır reklam yükledi.
111	AppLovin SDK'sının örneği alınamadı.
112	Kullanıcı çocuksa