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 uyumlulaştırma özelliğini 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 reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve AppLovin SDK'sı ile bağdaştırıcısının bir uygulamaya nasıl entegre edileceği Android ele alınmıştır.

Desteklenen entegrasyonlar ve reklam biçimleri

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

Entegrasyon
Teklif
Şelale
Formatlar
Banner	¹
Geçişli
Ödül olarak verildi
Yerel biçim

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

Koşullar

Android API düzeyi 19 veya üstü

[Teklifli sistem için]: AppLovin adaptörü 9.4.2.0 veya sonraki sürümler (en son sürüm önerilir)

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

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

To set up your Ad Manager ad unit, you'll need your AppLovin SDK Key and Report Key. To find them, go to the AppLovin UI > Account > Keys to see both values.

If you plan on just integrating bidding, you can proceed to configure your mediation settings.

Select app for mediation

Bidding

This step isn't required for bidding integrations.

Waterfall

On the AppLovin UI, select Applications under the Monetization section to get to your registered apps. Select the app you'd like to use with mediation from the list of available apps.

Create a zone

Bidding

This step isn't required for bidding integrations.

Waterfall

On the AppLovin UI, select Zones under the Monetization section to get to your registered zone IDs. If you have already created the required zones for your app, skip ahead to Step 2. To create a new zone ID, click Create Zone.

Enter the name of Zone ID, select Android as the Platform, and choose the Ad Type.

Configure Pricing for the zone by selecting either Flat CPM or Optimized by AppLovin. CPMs can be configured on a per country basis for the Flat CPM option. Then, click Save.

Once the zone is created, the zone ID can be found under the Zone ID column.

Turn on test mode

Follow the instructions in AppLovin's MAX Test Mode guide on how to enable AppLovin test ads.

2. Adım: Kullanıcı arayüzünde AppLovin talebini Ad Manager ayarlayın

Ad Manager hesabınızda oturum açın.

Şirketlere AppLovin Ekle

Teklif

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

Şelale

Yönetici > Şirketler'e gidin ve ardından Tüm şirketler sekmesinde Yeni şirket düğmesini tıklayın. Reklam ağı'nı seçin.

Reklam ağı olarak AppLovin'i seçin, benzersiz bir Ad girin ve Uyumlulaştırma'yı etkinleştirin. Otomatik veri toplama'yı açın ve önceki bölümde belirtilen Report Key değerini girin.

Kullanıcı adı veya şifre girmenize gerek yoktur. İşlem tamamlandığında Kaydet'i tıklayın.

Güvenli sinyal paylaşımını etkinleştirin

Teklif

Yönetici > Genel ayarlar'a gidin. Ad Exchange hesap ayarları sekmesine gidip Güvenli sinyal paylaşımı'nı inceleyip etkinleştirin. Save'i (Kaydet) tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Teklifli sistemi AppLovin yapılandırın

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklifi sekmesinin altında Yeni teklif veren'i tıklayın.

Teklif veren olarak AppLovin simgesini seçin.

Bu teklif verenin sinyal kitaplığını izin verilen sinyaller listesine ekle ve Sinyallerin bu teklif verenle paylaşılmasına izin ver seçeneklerini açık duruma getirin. Ardından Devam'ı tıklayın.

Devam'ı tıklayın.

Done'ı (Bitti) tıklayın.

Şelale

Bu adım, şelale entegrasyonları için gerekli değildir.

Reklam birimi eşlemesini yapılandır

Teklif

Yayınlama > Teklif Verenler'e gidin ve SDK Teklif Verme sekmesi altındaAppLovin şirketini seçin.

Reklam birimi eşleme sekmesine gidin ve Yeni reklam birimi eşleme'yi tıklayın.

Belirli reklam birimi'ni seçin. Bir reklam birimi ve biçim seçin, Envanter türü olarak Mobil uygulamayı ve Mobil uygulamanızı seçin. Ardından, bir önceki bölümde aldığınızSDK Key kodunu girin. Son olarak Kaydet'i tıklayın.

Şelale

Yayınlama > Getiri grupları'na gidin ve Yeni getiri grubu düğmesini tıklayın. Mobil uygulamanızı seçin.

Aşağı kaydırın ve Getiri iş ortağı ekle'yi tıklayın.

Önceki bölümde AppLovin şirket için oluşturduğunuzu seçin. Entegrasyon türü olarak Mobil SDK uyumlulaştırması'nı, Platform olarak Android'yi ve Durum olarak Etkin'i seçin.

Önceki bölümde belirtilen Application ID of your app along with the SDK Key and the Zone ID değerini ve Varsayılan BGBM değerini girin. Kaydet'i tıklayın.

Not: Otomatik veri toplama özelliğinin bir uyumlulaştırma ağı için Dinamik BGBM değerini doğru şekilde hesaplayabilmesi için verileri toplaması birkaç gün sürer. eBGBM hesaplandığında sizin adınıza otomatik olarak güncellenir.

GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine AppLovin Corp. ekle

GDPR ayarları ve ABD eyalet yönetmelikleri ayarları bölümündeki adımları uygulayarak Ad Manager kullanıcı arayüzünde GDPR ve ABD eyalet düzenlemeleri reklam iş ortakları listesine AppLovin Corp. ekleyin.

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

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulama bağımlılıklarını ve yapılandırmaları ekleyin. AppLovin SDK'sının ve bağdaştırıcının en son sürümlerini kullanın:

dependencies {
    implementation("com.google.android.gms:play-services-ads:23.0.0")
    implementation("com.google.ads.mediation:applovin:12.3.0.0")
}

Manuel entegrasyon

AppLovin Android SDK'yı indirin, applovin-sdk-x.y.z.jar dosyasını çıkarın ve projenize ekleyin.
Google'ın Maven deposunda AppLovin bağdaştırıcı yapıları'na gidin. En son sürümü seçin, AppLovin adaptörünün .aar dosyasını indirin ve projenize ekleyin.

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

AB İzni ve GDPR

Google AB Kullanıcı Rızası Politikası uyarınca, Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcılara cihaz tanımlayıcılarının ve kişisel verilerin kullanımıyla ilgili belirli açıklamalar yapılması ve bu kullanıcılardan izin alınması gerekir. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) gereksinimlerini yansıtmaktadır. İzin isterken, uyumlulaştırma zincirinizde kişisel verileri toplayabilen, alabilen veya kullanabilen ve her bir ağın kullanımı hakkında bilgi verebilecek her bir reklam ağını tanımlamanız gerekir. Google şu anda kullanıcının izin seçimini bu tür ağlara otomatik olarak aktaramamaktadır.

AppLovin, SDK 12.0.0 sürümünden itibaren paylaşılan tercihler bölümündeki izin dizesini okumayı ve izin durumunu buna göre ayarlamayı destekliyor.

AppLovin SDK'sının 12.0.0 veya sonraki bir sürümünü kullanmıyorsanız veya kullanıcı rızası dizesini paylaşılan tercihlere yazan bir CMP kullanmıyorsanız setHasUserContent ve setIsAgeRestrictedUser yöntemlerini kullanabilirsiniz. Aşağıdaki örnek kod, izin bilgilerinin AppLovin SDK'sına nasıl aktarılacağını gösterir. Bu seçeneklerin, AppLovin SDK'sına doğru şekilde yönlendirildiğinden emin olmak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanmalıdır.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setHasUserConsent(true, context)

Ayrıca, kullanıcının yaş kısıtlamalı bir kategoride olduğu biliniyorsa aşağıdaki işareti true olarak da ayarlayabilirsiniz.

Java

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Kotlin

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

Daha fazla bilgi için AppLovin'in gizlilik ayarlarına bakın.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, "kişisel bilgilerini" "satma" (yasaların bu terimleri tanımladığı şekilde) özelliğinin kapsamı dışında kalma hakkı sunmayı zorunlu kılıyor. Bu seçenek, "satan" tarafın ana sayfasında belirgin bir şekilde görünen "Kişisel Bilgilerimi Satma" bağlantısıyla sunuluyor. ABD eyalet gizlilik yasalarına uygunluk kılavuzu, Google reklam yayını 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 bilgi satışına dahil olabilecek tüm reklam ağlarını belirlemeniz 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 izin veren setDoNotSell yöntemini içerir.

Aşağıdaki örnek kod, bu izin bilgilerinin AppLovin SDK'sına nasıl iletileceğini gösterir. Bu seçeneklerin, AppLovin SDK'sına doğru şekilde yönlendirildiğinden emin olmak için Google Mobile Ads SDK'sını başlatmadan önce ayarlanmalıdır.

Java

import com.applovin.sdk.AppLovinPrivacySettings;
// ...

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

import com.applovin.sdk.AppLovinPrivacySettings
// ...

AppLovinPrivacySettings.setDoNotSell(true, context)

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

5. Adım: Gerekli kodu ekleyin

AppLovin entegrasyonu için ek koda gerek yoktur.

6. Adım: Uygulamanızı test etme

Test reklamlarını etkinleştir

Ad Manager 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

AppLovinreklam kaynağından test reklamları aldığınızı doğrulamak için AppLovin (Bidding) and AppLovin (Waterfall) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Ağa özgü parametreler

AppLovin adaptörü, video reklamlarda sesi devre dışı bırakabilen setMuteAudio() özelliğini destekler. Bu yöntem, bir AppLovinExtras.Builder() nesnesinden çağrılabilir:

Java

Bundle extras = new AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build();

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter.class, extras)
   .build();

Kotlin

val extras = AppLovinExtras.Builder()
   .setMuteAudio(true)
   .build()

val request = AdManagerAdRequest.Builder()
   .addNetworkExtrasBundle(ApplovinAdapter::class.java, extras)
   .build()

Optimizasyonlar

AppLovin SDK'sını uygulamanızın kullanıma sunulduğu anda başlatmak, AppLovin'in etkinlikleri uygulama başlar başlamaz izlemesine olanak tanır.

Java

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk();

Kotlin

AppLovinSdk.getInstance("sdkKey", null, context).initializeSdk()

Hata kodları

Bağdaştırıcı AppLovin'den reklam alamazsa yayıncılar, aşağıdaki sınıfların altında ResponseInfo.getAdapterResponse() kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:

com.google.ads.mediation.applovin.ApplovinAdapter
com.google.ads.mediation.applovin.AppLovinMediationAdapter

Aşağıda, bir reklam yüklenemediğinde AppLovin bağdaştırıcısı tarafından atılan kodlar ve eşlik eden mesajlar verilmiştir:

Hata kodu	Neden
-1009 ila -1, 204	AppLovin SDK'sı bir hata döndürdü. Daha fazla bilgi için AppLovin'in dokümanlarına göz atın.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	Bağlam değeri null.
104	AppLovin teklif jetonu boş.
105	Aynı alt bölge için birden fazla reklam istendi. AppLovin, bölge başına aynı anda yalnızca 1 reklam yükleyebilir.
106	Reklam görüntülenmeye hazır değil.
108	AppLovin Bağdaştırıcısı, istenen reklam biçimini desteklemiyor.
-1009 ila -1, 204	AppLovin SDK'sı bir hata döndürdü. Daha fazla bilgi için AppLovin'in dokümanlarına göz atın.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
102	Kullanıcı arayüzünde yapılandırılan AppLovin sunucu parametreleri Ad Manager eksik/geçersiz.
103	AppLovin reklamı gösterilemedi.
104	Aynı alt bölge için birden fazla reklam istendi. AppLovin, bölge başına 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, yükleme için başarılı bir geri çağırma gönderdi ancak hiç reklam yüklemedi.