Bu kılavuzda, uyumlulaştırma aracılığıyla Pangle'dan reklam yüklemek ve görüntülemek için Google Mobile Ads SDK'sının nasıl kullanılacağı gösterilmektedir. Bu sayede teklifli sistem entegrasyonları kapsamaktadır. Bu makalede, Pangle'ın bir reklam biriminin uyumlulaştırma yapılandırmasına nasıl ekleneceği ve Pangle SDK'sının ve bağdaştırıcının bir uygulamaya nasıl entegre edileceği ele alınmaktadır. Unity
Desteklenen entegrasyonlar ve reklam biçimleri
Pangle için Ad Manager uyumlulaştırma bağdaştırıcısı aşağıdaki özelliklere sahiptir:
Entegrasyon | |
---|---|
Teklif verme | |
Şelale | 1 |
Formatlar | |
Banner | |
Geçiş reklamı | |
Ödüllü | |
Ödüllü geçiş reklamı |
Şartlar
- En son Google Mobile Ads SDK'sı
- Unity 5.6 veya üzeri
- Android'de dağıtmak için
- Android API düzeyi 21 veya sonraki sürümler
- iOS'te dağıtmak için
- 12.0 veya sonraki bir iOS dağıtım hedefi
- Google Mobile Ads SDK'sı ile yapılandırılmış Unity çalışan bir proje. Ayrıntılar için Başlayın bölümüne bakın.
- Uyumlulaştırmayı tamamlayın Başlangıç kılavuzu
1. adım: Pangle kullanıcı arayüzünde yapılandırmaları ayarlayın
Pangle hesabınıza kaydolun veya giriş yapın.
Yeni uygulama ekleme
Uygulamalar sekmesine gidin ve Uygulama Ekle düğmesini tıklayın.
Uygulama oluşturmak istediğiniz işletim sistemini seçin ve formun geri kalanını doldurun. Ardından Gönder'i tıklayın.
Yapay Zeka
iOS
Uygulamanızın uygulama kimliğini not edin.
Yapay Zeka
iOS
Reklam yerleşimi oluşturma
Uygulamanız oluşturulduktan sonra reklam yerleşiminizi oluşturmak için Ekle düğmesini tıklayın.
Yapay Zeka
iOS
Teklif verme
Reklam biçiminizi ve Reklam yerleşimi adınızı seçin, ardından Fiyatlandırma Türü olarak Uygulama İçi Teklif'i seçin. Formun geri kalanını doldurun ve Gönder'i tıklayın.
Reklam yerleşiminiz oluşturulduktan sonra Reklam Yerleşim Kimliği'ni not edin.
Yapay Zeka
iOS
Şelale
Fiyatlandırma Türü olarak Reklam Biçimi ile Reklam Yerleşimi Adı ve Genel BGBM'yi seçin. Formun geri kalanını doldurun ve Gönder'i tıklayın.
Reklam yerleşiminiz oluşturulduktan sonra Reklam Yerleşim Kimliği'ni not edin.
Yapay Zeka
iOS
Pangle Reporting API anahtarını bulma
Teklif verme
Bu adım, teklifli sistem entegrasyonları için gerekli değildir.
Şelale
Sayfanın sol alt köşesindeki Kullanıcı Kimliği'ni not edin.
Entegrasyonlar > SDK ve API > Pangle Reporting API 2.0'ı tıklayın. Rol Kimliği ve Güvenlik Anahtarı'na dikkat edin.
Test modunu etkinleştirme
Pangle test reklamlarını etkinleştirmeyle ilgili Pangle'ın Test reklamı ekleme kılavuzundaki talimatları uygulayın.
2. adım: Pangle talebini Ad Manager kullanıcı arayüzünde ayarlayın
Reklam biriminiz için uyumlulaştırma ayarlarını yapılandırma
3. Adım: Pangle SDK'sını ve bağdaştırıcısını içe aktarın
OpenUPM-CLI
OpenUPM-CLI yüklüyse projenizin kök dizininden aşağıdaki komutu çalıştırarak Unity için Google Mobile Ads Pangle Uyumlulaştırma Eklentisi'ni projenize yükleyebilirsiniz:
openupm add com.google.ads.mobile.mediation.pangle
OpenUPM
Unity Paket Yöneticisi Ayarlarını açmak için Unity proje düzenleyicinizde Düzenle > Proje Ayarları > Paket Yöneticisi'ni seçin.
Kapsamlı Kayıt Daireleri sekmesinde, OpenUPM'yi aşağıdaki ayrıntılarla kapsamlı bir kayıt dairesi olarak ekleyin:
- Ad:
OpenUPM
- URL:
https://package.openupm.com
- Kapsamlar:
com.google
Ardından, Pencere > Paket Yöneticisi'ne giderek Unity Paket Yöneticisi'ni açın ve açılır menüden Kayıtlarım'ı seçin.
Google Mobile Ads Pangle Uyumlulaştırması paketini seçin ve Yükle'yi tıklayın.
Unity Paketi
Değişiklik günlüğündeki indirme bağlantısını kullanarak Pangle için Google Mobile Ads uyumlulaştırma eklentisinin en son sürümünü indirin ve zip dosyasından GoogleMobileAdsPangleMediation.unitypackage
öğesini çıkarın.
Unity proje düzenleyicinizde Öğeler > Paket İçe Aktar > Özel Paket'i seçin ve indirdiğiniz GoogleMobileAdsPangleMediation.unitypackage
dosyasını bulun. Tüm dosyaların seçili olduğundan emin olun ve İçe aktar'ı tıklayın.
Ardından, Öğeler > Harici Bağımlılık Yöneticisi >
Android Çözümleyici > Zorla Çöz'ü seçin. External Dependency Manager kitaplığı, bağımlılık çözümlemesini sıfırdan gerçekleştirir ve bildirilen bağımlılıkları Unity uygulamanızın Assets/Plugins/Android
dizinine kopyalar.
4. adım: Gerekli kodu ekleyin
Yapay Zeka
Pangle entegrasyonu için ek kod gerekmez.
iOS
SKAdNetwork entegrasyonu
SKAdNetwork tanımlayıcılarını projenizin Info.plist
dosyasına eklemek için Pangle'ın belgelerini inceleyin.
5. Adım: Uygulamanızı test edin
Test reklamlarını etkinleştirme
Test cihazınızı AdMob'a kaydettiğinizden ve Pangle kullanıcı arayüzünde test modunu etkinleştirdiğinizden emin olun.
Test reklamlarını doğrulama
Pangle'dan test reklamları aldığınızı doğrulamak için Pangle (Teklif Verme) ve Pangle (Şelale) reklam kaynaklarını kullanarak reklam inceleyicide tek reklam kaynağı testini etkinleştirin.
Hata kodları
Adaptör Pangle'den reklam alamıyorsa yayıncılar aşağıdaki sınıflar altında ResponseInfo
kullanarak reklam yanıtındaki temel hatayı kontrol edebilir:
Yapay Zeka
com.pangle.ads
com.google.ads.mediation.pangle.PangleMediationAdapter
iOS
GADMediationAdapterPangle
Bir reklam yüklenemezse Pangle adaptörü tarafından oluşturulan kodlar ve bunlarla ilişkili mesajlar aşağıda verilmiştir:
Yapay Zeka
Hata kodu | Alan | Neden |
---|---|---|
101 | com.google.ads.mediation.pangle | Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya yerleşim kimliği). |
102 | com.google.ads.mediation.pangle | İstenen reklam boyutu, Pangle tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
103 | com.google.ads.mediation.pangle | Eksik veya geçersiz teklif yanıtı. |
-1-60000 | com.pangle.ads | Pangle SDK'sı hata döndürdü. Daha fazla ayrıntı için Pangle'in dokümanlarına bakın. |
iOS
Hata kodu | Alan | Neden |
---|---|---|
101 | com.google.ads.mediation.pangle | Geçersiz sunucu parametreleri (ör. eksik uygulama kimliği veya yerleşim kimliği). |
102 | com.google.ads.mediation.pangle | İstenen reklam boyutu, Pangle tarafından desteklenen bir banner boyutuyla eşleşmiyor. |
-1-60000 | Pangle SDK'sı tarafından gönderildi | Pangle SDK'sı hata döndürdü. Daha fazla ayrıntı için Pangle'in dokümanlarına bakın. |
Pangle Unity Uyumlulaştırma Eklentisi Değişiklik Günlüğü
Sürüm 4.4.0
- Pangle Android bağdaştırıcısı 6.3.0.2.0 sürümünü destekler.
- Pangle iOS adaptörünün 6.3.0.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.3.0 sürümü ile derlenmiş ve test edilmiştir.
4.3.3 sürümü
- Pangle Android bağdaştırıcısı 6.2.0.7.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 6.2.0.9.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.1 sürümü ile oluşturulup test edilmiştir.
4.3.2 sürümü
- Pangle Android bağdaştırıcısının 6.2.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 6.2.0.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümüyle geliştirilip test edilmiştir.
4.3.1 sürümü
- Pangle Android bağdaştırıcısı 6.2.0.5.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 6.2.0.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.
4.3.0 sürümü
- Pangle Android bağdaştırıcısı 6.2.0.4.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 6.2.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.
4.2.1 sürümü
- Pangle Android bağdaştırıcısı 6.1.0.7.0 sürümünü destekler.
- Pangle iOS adaptörünün 6.1.0.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.
4.2.0 sürümü
DummyClient
,PlaceholderClient
olarak yeniden adlandırıldı.- Pangle Android bağdaştırıcısı 6.1.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 6.1.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.2.0 sürümü ile derlenmiş ve test edilmiştir.
4.1.0 sürümü
- Pangle Android bağdaştırıcısı 6.0.0.8.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 6.1.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.1 sürümü ile oluşturulup test edilmiştir.
Sürüm 4.0.1
- Pangle Android bağdaştırıcısı 6.0.0.5.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 6.0.0.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.
Sürüm 4.0.0
- Pangle Android bağdaştırıcısı 6.0.0.5.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 6.0.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.
3.0.0 sürümü
- Pangle Android bağdaştırıcısı 6.0.0.3.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 5.9.0.9.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.
2.8.1 sürümü
- Pangle Android bağdaştırıcısı 5.9.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 5.9.0.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.8.0
- Pangle Android bağdaştırıcısının 5.9.0.4.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 5.9.0.7.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümüyle geliştirilip test edilmiştir.
2.7.0 sürümü
- Pangle Android bağdaştırıcısı 5.9.0.2.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 5.8.0.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.1.0 sürümü ile oluşturulup test edilmiştir.
2.6.0 sürümü
- Pangle Android bağdaştırıcısı 5.8.0.9.0 sürümünü destekler.
- Pangle iOS adaptörünün 5.8.0.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 9.0.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 2.5.0
- Pangle Android bağdaştırıcısının 5.7.0.1.0 sürümünü destekler.
- Pangle iOS adaptörünün 5.7.0.7.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.6.0 sürümüyle geliştirilip test edilmiştir.
2.4.0 sürümü
- Pangle Android bağdaştırıcısının 5.5.0.9.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 5.5.0.9.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.6.0 sürümü ile oluşturulup test edilmiştir.
Sürüm 2.3.0
- Pangle Android bağdaştırıcısı 5.3.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 5.3.1.2.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.4.1 sürümü ile derlenmiş ve test edilmiştir.
2.2.0 sürümü
- Pangle Android bağdaştırıcısı 5.2.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 5.2.0.9.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 8.3.0 sürümü ile derlenmiş ve test edilmiştir.
2.1.0 sürümü
- Pangle Android bağdaştırıcısı 5.1.0.9.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 5.1.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 8.1.0 sürümü ile oluşturulup test edilmiştir.
2.0.0 sürümü
- Bağdaştırıcı içeriği
GoogleMobileAds/Mediation/Pangle/
hedefine taşındı. - Bağdaştırıcı ad alanı,
GoogleMobileAds.Mediation.Pangle
kullanacak şekilde yeniden düzenlendi. - Pangle Android bağdaştırıcısının 5.0.0.7.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 5.0.0.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.1 sürümü ile oluşturulup test edilmiştir.
1.5.1 sürümü
- Pangle Android bağdaştırıcısının 4.9.0.7.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 4.9.0.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.4.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.5.0
- Pangle Android bağdaştırıcısı 4.9.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 4.9.0.7.0 sürümünü destekler.
- Google Mobile Ads Unity eklentisi 7.3.1 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.4.0
- Pangle Android bağdaştırıcısı 4.8.1.0.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 4.8.1.0.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.3.1 sürümü ile oluşturulup test edilmiştir.
1.3.1 sürümü
- Pangle Android bağdaştırıcısının 4.7.0.6.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 4.7.0.6.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.3.0
Pangle
sınıfındaki aşağıdaki yöntemler yeniden adlandırıldı:SetGDPR()
->SetGDPRConsent()
SetCCPA()
->SetDoNotSell()
- Pangle Android bağdaştırıcısı 4.7.0.5.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısının 4.7.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.2.0 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.2.0
- Pangle Android bağdaştırıcısının 4.5.0.6.1 sürümünü destekler.
- Pangle iOS adaptörünün 4.5.2.8.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.1.0 sürümü ile derlenmiş ve test edilmiştir.
Sürüm 1.1.0
- Pangle Android bağdaştırıcısının 4.5.0.3.0 sürümünü destekler.
- Pangle iOS bağdaştırıcısı 4.5.1.3.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.2 sürümüyle geliştirilip test edilmiştir.
Sürüm 1.0.0
- İlk sürüm!
- Pangle Android adaptörü 4.3.0.8.0 sürümünü destekler.
- Pangle iOS adaptörünün 4.3.0.5.0 sürümünü destekler.
- Google Mobil Reklamlar Unity eklentisi 7.0.0 sürümü ile derlenmiş ve test edilmiştir.