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

AppLovin'i Uyumlulaştırma ile entegre etme

Bu kılavuzda, reklam öğelerinizi yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl AppLovin'in uyumlulaştırma, hem şelale hem teklif entegrasyonlarını kapsar. AppLovin'in nasıl ekleneceği açıklanmaktadır reklam biriminin uyumlulaştırma yapılandırmasına ve AppLovin SDK'sının nasıl entegre edileceğine bağdaştırıcıyı da bir Android uygulamaya bağlayabilirsiniz.

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 hariç) banner'lar) yalnızca uyumlulaştırmada desteklenir. Teklifli sistem hiçbir türü desteklemez banner reklamlar.

Şartlar

Android API düzeyi 21 veya üstü

[Teklif verme için]: AppLovin bağdaştırıcısı 9.4.2.0 veya sonraki sürümler (en son sürüm önerilir)

En son Google Mobile Ads SDK'sı
Arabuluculuğu tamamlama Başlangıç kılavuzu

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

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

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ısını içe aktarın

Android Studio entegrasyonu (önerilir)

Uygulama düzeyindeki build.gradle.kts dosyanıza aşağıdaki uygulamayı ekleyin ve yapılandırmaları içerir. AppLovin SDK'sının en son sürümlerini kullanın ve adaptör:

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

Manuel entegrasyon

İndirin: AppLovin Android SDK'sı, applovin-sdk-x.y.z.jar dosyasını çıkarıp projenize ekleyin.
Şuraya gidin: AppLovin bağdaştırıcı yapıları Google'ın Maven deposunda. En son sürümü seçin ve AppLovin bağdaştırıcısının .aar dosyasını indirin ve bu dosyayı projenize ekleyin.

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

AB Kullanıcı Rızası ve GDPR

Google AB Kullanıcı İzni kapsamında Politika uyarınca, belirli bilgilerin ifşa edildiğinden emin olmalısınız. Avrupa Ekonomik Alanı'ndaki (AEA) kullanıcıların cihaz tanımlayıcılarının ve kişisel verilerin kullanımı. Bu politika AB eGizlilik Yönergesi ve Genel Veri Koruma şartları Düzenleme (GDPR). Rıza isterken her reklam ağını tanımlamanız gerekir kişisel verileri toplayabilecek, alabilecek veya kullanabilen uyumlulaştırma zincirinizde her ağın kullanımıyla ilgili bilgi sağlar. Google şu anda Kullanıcının izin seçimini bu tür ağlara otomatik olarak iletmelidir.

AppLovin, SDK 12.0.0 sürümünden itibaren izin dizesinin . paylaşılan tercihler ve izin durumunu buna göre ayarlayın.

AppLovin SDK'sının 12.0.0+ sürümünü kullanmıyorsanız veya izin dizesini . paylaşılan tercihler , setHasUserContent ve setIsAgeRestrictedUser yöntem. Aşağıdaki örnek kod, AppLovin SDK'sı için kullanıcı rızası alma bilgileri sağlayın. Bu seçenekleri ayarlamadan önce yapmanız gerekir Google Mobile Ads SDK'sını başlatma .

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 yer aldığı biliniyorsa aşağıdaki işareti de true olarak ayarla.

Java

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context);

Kotlin

AppLovinPrivacySettings.setIsAgeRestrictedUser(true, context)

AppLovin'in gizlilik ayarlarına göz atın konulu videomuzu izleyin.

ABD eyalet gizlilik yasaları

ABD eyalet gizlilik yasaları kullanıcılara, doğru zamanda "indirimi" devre dışı bırakmak "kişisel bilgilerinin” (kanunların bu konudaki hariç tutmanın, öne çıkan bir "Do Not Sell My Personal My Personal (Kişisel Bilgilerimi Kesinlikle Satmayın) Bilgiler" bağlantısını ile başlar. İlgili içeriği oluşturmak için kullanılan ABD eyalet gizliliği yasalara uygunluk rehberi, yasalarca belirlenen kısıtlanmış veri işleme kullanılabilir ancak Google, bu ayarı her reklama uygulayamaz. ağda yer alır. Bu nedenle, reklam ağlarının her birini kişisel satışlarına katılabilecek uyumlulaştırma zincirinizde ağlarla ilgili bilgileri takip edin ve bu ağların yönlendirmelerini izleyerek uygunluk açısından önemlidir.

AppLovin SDK'sında, yayıncıların abonelik veya erişim izni vermek için kullandığı setDoNotSell yöntemi kişisel bilgilerin satılmasına izin vermez.

Aşağıdaki örnek kod, bu izin bilgilerinin AppLovin SDK'sı Bu seçenekleri ayarlamadan önce yapmanız gerekir Google Mobile Ads SDK'sını başlatma .

Java

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

AppLovinPrivacySettings.setDoNotSell(true, context);

Kotlin

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

AppLovinPrivacySettings.setDoNotSell(true, context)

AppLovin'in Gizlilik belgelerini inceleyin konulu videomuzu izleyin.

5. Adım: Gerekli kodu ekleyin

AppLovin entegrasyonu için ek koda gerek yoktur.

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

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 özel parametreler

AppLovin adaptörü, şuralarda sesi devre dışı bırakabilen setMuteAudio() özelliğini destekler: video reklamlar. 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

Uygulamanız kullanıma sunulur sunulmaz AppLovin SDK'sını başlatmak AppLovin, uygulama başlar başlamaz etkinlikleri izleyebilme olanağı sunuyor.

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 reklam yanıtındaki temel hatayı . ResponseInfo.getAdapterResponses() şu sınıflarda:

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

AppLovin bağdaştırıcısı tarafından oluşturulan kodlar ve beraberindeki mesajlar Reklam yüklenemedi:

Hata kodu	Neden
-1009 - -1, 204	AppLovin SDK'sı hata döndürdü. Görüntüleyin AppLovin'in belgeleri inceleyebilirsiniz.
101	İstenen reklam boyutu, AppLovin tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103	Bağlam boş.
104	AppLovin teklif jetonu boş.
105	Aynı alt bölge için birden fazla reklam istendi. AppLovin, alt bölge başına aynı anda yalnızca 1 reklam yükleyebilir.
106	Reklam görüntülenmeye hazır değil.
108	AppLovin Adapter, istenen reklam biçimini desteklemiyor.