Bu kılavuzda, bir arabuluculuk bağdaştırıcısını Flutter uygulamanıza nasıl entegre edeceğiniz gösterilmektedir.
Ön koşullar
Bir reklam biçimi için arabuluculuğu entegre edebilmeniz için söz konusu reklam biçimini uygulamanıza entegre etmeniz gerekir:
Uyumlulaştırmada yeni misiniz? Uyumlulaştırmaya giriş başlıklı makaleyi okuyun.
Google Mobile Ads SDK'sını ilk kullanıma hazırlama
Hızlı başlangıç kılavuzu, Google Mobile Ads SDK'sını nasıl başlatacağınızı gösterir. Bu ilk kullanıma hazırlama çağrısı sırasında arabuluculuk bağdaştırıcıları da ilk kullanıma hazırlanır. İlk reklam isteğinde her reklam ağının tam katılımını doğrulamak için reklamları yüklemeden önce başlatma işleminin tamamlanmasını beklemeniz önemlidir.
Aşağıdaki örnek kodda, reklam isteğinde bulunmadan önce her bağdaştırıcının başlatma durumunu nasıl kontrol edebileceğiniz gösterilmektedir.
void main() {
WidgetsFlutterBinding.ensureInitialized();
MobileAds.instance.initialize()
.then((initializationStatus) {
initializationStatus.adapterStatuses.forEach((key, value) {
debugPrint('Adapter status for $key: ${value.description}');
});
});
runApp(MyApp());
}
Gradle ayarlarınızı güncelleme (yalnızca Android)
Eklentinin Android API'lerini kullanabilmek için settings.gradle
dosyanıza aşağıdaki satırları ekleyin:
def flutterSdkPath = {
def properties = new Properties()
file("local.properties").withInputStream { properties.load(it) }
def flutterSdkPath = properties.getProperty("flutter.sdk")
assert flutterSdkPath != null, "flutter.sdk not set in local.properties"
return flutterSdkPath
}()
includeBuild("$flutterSdkPath/packages/flutter_tools/gradle")
İş ortağı ağları için bağımlılık ekleme
Aracılık bağdaştırıcıları ve bağımlılıkları Android ve iOS projelerinize eklenmelidir. Android'de build.gradle
, iOS'te ise Podfile
dosyanızı güncelleyerek eklenebilirler. Google, GitHub'da hem Android hem de iOS için açık kaynak bağdaştırıcılara sahiptir.
İş ortağı ağlarının her biri için Android ve iOS dokümanlarına göz atarak bu ağların bağdaştırıcısını uygulamanıza nasıl ekleyeceğinizle ilgili ayrıntılı bilgi edinebilirsiniz.
Reklamı hangi reklam ağı bağdaştırıcı sınıfının yüklediğini kontrol etme
Aşağıdaki örnek kod, banner reklam için reklam ağı sınıfı adının nasıl kaydedileceğini gösterir:
final bannerAd = AdManagerBannerAd(
size: [AdSize.banner],
adUnitId: '<your-ad-unit>',
listener: AdManagerBannerAdListener(
onAdLoaded: (ad) {
debugPrint('$ad loaded: ${ad.responseInfo?.mediationAdapterClassName}');
},
),
request: AdManagerAdRequest(),
);
Uyumlaştırma ile banner reklamları kullanma
Uyumlulaştırmada kullanılan banner reklam birimleri için tüm üçüncü taraf reklam kaynağı kullanıcı arayüzlerinde yenilemeyi devre dışı bıraktığınızdan emin olun. Bu, Ad Manager da banner reklam biriminizin yenileme hızına göre yenilemeyi tetiklediğinden çift yenilemeyi önler.
Uyumlulaştırma ile doğal reklamları kullanma
Aşağıda, doğal arabuluculuğu uygularken göz önünde bulundurmanız gereken bazı en iyi uygulamalar verilmiştir.
- Yerel reklam sunumu politikası
- Her reklam ağının kendi politikaları vardır. Uyumlulaştırma kullanırken uygulamanızın, reklamı sağlayan uyumlulaştırılmış ağın politikalarına uyması gerektiğini unutmayın.
ABD eyalet gizlilik yasaları ve GDPR
ABD eyalet gizlilik yasalarına veya Genel Veri Koruma Yönetmeliği'ne (GDPR) uymanız gerekiyorsa Ad Manager'ın Gizlilik ve Mesajlaşma bölümündeki ABD eyalet tüzükleri ayarları veya GDPR ayarları bölümünde yer alan adımları uygulayarak arabuluculuk iş ortaklarınızı ABD eyaletleri veya GDPR reklam iş ortakları listesine ekleyin. Aksi takdirde iş ortakları uygulamanızda reklam yayınlayamaz.
Kısıtlanmış veri işlemeyi (RDP) etkinleştirme ve Google Kullanıcı Mesajlaşma Platformu (UMP) SDK ile GDPR izni alma hakkında daha fazla bilgi edinin.