Meta Audience Network'ü teklifli sistemle entegre etme

Bu kılavuzda, teklifli sistem entegrasyonlarını kapsayan uyumlulaştırma özelliğini kullanarak Meta Audience Network'ten reklam yüklemek ve göstermek için Google Mobile Ads SDK for React Native aracını nasıl kullanacağınız gösterilmektedir. Bu açıklamalar, Meta Audience Network'ün bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceğini ve Meta Audience Network ile bağdaştırıcısının bir React Native yerel uygulamasına nasıl entegre edileceğini kapsar.

Desteklenen entegrasyonlar ve reklam biçimleri

Meta Audience Network için AdMob uyumlulaştırma adaptörünün özellikleri şöyledir:

Entegrasyon
Teklif verme
Şelale  1
Formatlar
Uygulama Açma
Banner
Geçiş reklamı
Ödüllü
Ödüllü geçiş reklamı
Yerel biçim

1 Meta Audience Network, 2021'de yalnızca teklifli sistem kullanmaya başladı.

Ön koşullar

Devam etmeden önce aşağıdakileri doğrulayın:

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

Kaydolun ve İşletme Yöneticisi başlangıç sayfasında oturum açın.

Başlayın'ı, ardından Yeni hesap oluştur'u tıklayın.

Zorunlu alanları işletme bilgilerinizle doldurun ve Sonraki'yi tıklayın.

Bir mülk oluşturun

Gerekli bilgileri doldurduktan sonra uygulamanız için bir mülk oluşturmanız istenir. Uygulamanız için mülkün istediğiniz adını girin ve İleri'yi tıklayın.

Ardından, para kazanmak istediğiniz platformu seçin.

Uygulama ayrıntılarınızı ekleyip Sonraki'yi tıklayın.

Android

iOS

Yeni bir ödeme hesabı ekle'yi tıklayarak ödeme hesabınızı oluşturun. Ödeme bilgilerinizi girmek için yeni bir sayfaya yönlendirilirsiniz. Gerekli bilgileri doldurup Sonraki'yi tıklayın.

Uyumlulaştırma platformu olarak Google AdMob'u seçin ve Yerleşim oluştur'u tıklayın.

Bir biçim seçin, formu doldurun ve Oluştur'u tıklayın.

Yerleşim kimliğini not edin.

Bitti'yi tıklayın.

app-ads.txt dosyanızı güncelleme

Uygulamalar İçin Yetkili Satıcılar app-ads.txt, uygulama reklamı envanterinizin yalnızca yetkili olarak tanımladığınız kanallar üzerinden satılmasını sağlamaya yardımcı olan bir IAB Tech Lab girişimidir. Reklam gelirinde önemli ölçüde kayıp yaşanmasını önlemek için bir app-ads.txt dosyası uygulamanız gerekir. Bunu henüz yapmadıysanız uygulamanız için bir app-ads.txt dosyası oluşturun.

Meta Audience Network için app-ads.txt uygulamasını kullanmak istiyorsanız app-ads.txt ile Yetkili Satıcıları Tanımlama başlıklı makaleyi inceleyin.

Test modunu etkinleştirme

Meta Audience Network test reklamlarını etkinleştirme hakkında ayrıntılı talimatlar için Audience Network Uygulamasını Test Etme kılavuzuna bakın.

2. adım: AdMob kullanıcı arayüzünde Meta Audience Network talebini ayarlayın

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

Android

Talimatlar için Android kılavuzundaki 2. adıma bakın.

iOS

Talimatlar için iOS kılavuzundaki 2. adıma bakın.

Meta'yı GDPR ve ABD eyalet yönetmelikleri reklam iş ortakları listesine ekleme

Meta'yı AdMob kullanıcı arayüzündeki AB ve ABD eyalet tüzükleri reklam iş ortakları listesine eklemek için AB tüzükleri ayarları ve ABD eyalet tüzükleri ayarları bölümündeki adımları uygulayın.

3. adım: Meta Audience Network SDK'sını ve bağdaştırıcısını içe aktarın

Projenizin kök dizininde, Meta Audience Network için Google Mobile Ads SDK for React Native uyumlulaştırma bağdaştırıcısını yükleyin. Aşağıdakileri tamamlayın:

  1. gma-sdk-react-native/adapters/meta/ dizinindeki Google Mobile Ads SDK for React Native bağdaştırıcı tar dosyasını projenizin local_packages/ dizinine kopyalayın. adapters klasörünüz yoksa Ön koşullar bölümüne bakın.

    mkdir -p local_packages
cp EXTRACT_DIR/gma-sdk-react-native/adapters/meta/gma-mediation-meta-0.1.0.tgz local_packages/

    EXTRACT_DIR ifadesini, arşivi çıkardığınız dizinin yoluyla değiştirin.

  2. Tercih ettiğiniz paket yöneticisini kullanarak bağdaştırıcı paketini yükleyin:

    npm

    npm install ./local_packages/gma-mediation-meta-0.1.0.tgz

    yumak

    yarn add ./local_packages/gma-mediation-meta-0.1.0.tgz

4. adım: Meta Audience Network SDK'sındaki gizlilik ayarlarını uygulayın

Google AB Kullanıcı Rızası Politikası'na uymak için Avrupa Ekonomik Alanı (AEA), Birleşik Krallık ve İsviçre'deki kullanıcılarınıza belirli açıklamalar yapmanız ve yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanılmasının yanı sıra, kişisel verilerin reklam kişiselleştirme amacıyla toplanması, paylaşılması ve kullanılması için kullanıcıların iznini almanız gerekir. Bu politika, AB eGizlilik Yönergesi ve Genel Veri Koruma Yönetmeliği (GDPR) şartlarını yansıtmaktadır. Uyumlulaştırma zincirinizdeki her reklam kaynağına rıza bilgisinin iletildiğini doğrulamak sizin sorumluluğunuzdadır.

GDPR ve Meta reklamcılığı hakkında bilgi edinmek için Meta'nın kılavuzunu inceleyin.

ABD eyalet gizlilik yasaları

ABD eyaletlerindeki gizlilik yasaları, kullanıcılara "kişisel bilgilerinin" "satışının" (yasaların bu terimleri tanımladığı biçimiyle) kapsamı dışında kalma hakkı tanınmasını zorunlu kılar. Kapsam dışında kalma seçeneği, "satan" tarafın ana sayfasında belirgin bir şekilde gösterilen "Kişisel Bilgilerimi Satma" bağlantısıyla sunulur. ABD eyalet gizlilik yasalarına uygunluk rehberi, Google reklamları sunmak 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, uyumluluğu sağlamak için, uyumlulaştırma zincirinizde kişisel bilgilerin satışına katılabilecek tüm reklam ağlarını belirlemeli ve bu ağların her birinden gelen yönergeleri uygulamanız gerekir.

Kaliforniya'daki kullanıcılar için Meta'nın veri işleme seçeneklerini inceleyin.

5. adım: Gerekli kodu ekleme

Android

Meta Audience Network entegrasyonu için ek kod gerekmez.

iOS

SKAdNetwork entegrasyonu

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

Reklam izleme etkin

iOS 14 veya sonraki sürümler için derleme yapıyorsanız Meta Audience Network'ün Reklam İzleme İşareti'ni ayarlama talimatlarını inceleyin.

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

Test reklamlarını etkinleştirme

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

Test reklamlarını doğrulama

Meta Audience Network'ten test reklamları aldığınızı doğrulamak için Meta Audience Network (Teklifli Sistem) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.

İsteğe bağlı adımlar

Android 9'da önbelleğe alma

Android

Android 9'dan (API düzeyi 28) itibaren şifresiz metin desteği varsayılan olarak devre dışı bırakılmıştır. Bu durum, Meta Audience Network SDK'sının medya önbelleğe alma işlevini etkiler ve kullanıcı deneyimi ile reklam gelirini etkileyebilir. Uygulamanızdaki ağ güvenliği yapılandırmasını güncellemek için Meta'nın belgelerini inceleyin.

iOS

iOS entegrasyonları için geçerli değildir.

Hata kodları

Adaptör Audience Network'ten reklam alamıyorsa aşağıdaki sınıflarda ResponseInfo kullanarak reklam yanıtındaki temel hatayı kontrol edebilirsiniz:

Android

com.google.ads.mediation.facebook.FacebookAdapter
com.google.ads.mediation.facebook.FacebookMediationAdapter

iOS

GADMAdapterFacebook
GADMediationAdapterFacebook

Bir reklam yüklenemediğinde Meta Audience Network bağdaştırıcısı tarafından verilen kodlar ve ilgili mesajlar şöyledir:

Android

Hata kodu Neden
101 Sunucu parametreleri geçersiz (ör. yerleşim kimliği eksik).
102 İstenen reklam boyutu, Meta Audience Network tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 Yayıncı, Activity bağlamıyla reklam isteğinde bulunmalıdır.
104 Meta Audience Network SDK'sı başlatılamadı.
105 Yayıncı, birleştirilmiş doğal reklamlar için istekte bulunmadı.
106 Yüklenen doğal reklam, beklenenden farklı bir nesnedir.
107 Kullanılan Context nesnesi geçersiz.
108 Yüklenen reklamda gerekli doğal reklam öğeleri eksik.
109 Teklif yükünden doğal reklam oluşturulamadı.
110 Meta Audience Network SDK'sı, geçiş reklamını/ödüllü reklamını sunamadı.
111 Meta Audience Network AdView nesnesi oluşturulurken istisna oluştu.
1000-9999 Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için Meta Audience Network'ün belgelerini inceleyin.

iOS

Hata kodu Neden
101 Sunucu parametreleri geçersiz (ör. yerleşim kimliği eksik).
102 İstenen reklam boyutu, Meta Audience Network tarafından desteklenen bir banner boyutuyla eşleşmiyor.
103 Meta Audience Network reklam nesnesi başlatılamadı.
104 Meta Audience Network SDK'sı, geçiş reklamını/ödüllü reklamını sunamadı.
105 Banner reklamın kök görünüm denetleyicisi: nil.
106 Meta Audience Network SDK'sı başlatılamadı.
1000-9999 Meta Audience Network, SDK'ya özgü bir hata döndürdü. Daha fazla ayrıntı için Meta Audience Network'ün belgelerini inceleyin.

Sürüm 0.1.0

  • İlk sürüm.