Android'deki Özel Korumalı Alan, Geliştirici Önizleme ve Beta programları sunar. Zaman içinde Geliştirici Önizlemesi'nde yeni API'ları ve özellikleri tanıtacak, stabilize edilmiş API'leri de Beta programına yükselteceğiz. Geri bildirim önerilir.
Android'deki Özel Korumalı Alan konusunda yeniyseniz Programa Genel Bakış ile başlayın. Projenize Özel Korumalı Alan oluşturmaya başlamak için geliştirme ortamınızı ayarlayın ve test cihazınızda ya da emülatörünüzde Android'de Özel Korumalı Alan'ı edinin.
Mevcut sürümler
Android VanillaIceCream Önizlemesi
Protected Audience API
- Kimliği doğrulanmış içeriğe dayalı reklamları, Korumalı Açık Artırmaya iletme özelliği eklendi. Buna, cihaza önceden yüklenmiş olan uygulamalar için negatif filtrelemenin yanı sıra tıklama, gösterim, görüntüleme veya kazanç sayısına uygulanan sıklık sınırı da dahildir. İçeriğe dayalı reklamların reklam teknolojisi tarafından imzalanması gerektiğinden uygulama, önceki yinelemelerden farklıdır. Bunu nasıl uygulayacağınızı geliştirici kılavuzundan öğrenebilirsiniz.
- İçeriğe Dayalı Reklamlar, AdSelectionConfig'deki ilgili alıcı ve ayarlayıcıyla birlikte SignedBağlam şeklinde yeniden adlandırıldı
- Kimliği doğrulanmayan bir bağlamsal uygulama geçerse uygulama açık artırmadan kaldırılır.
Attribution Reporting API
- Uygulama cihazda zaten yüklüyse kaynak bırakma olanağı
- Basit esnek etkinlik raporlamasından tam esnek etkinlik raporlamasına yapılan güncellemeler
Android'de Özel Korumalı Alan için Kasım 2023 Beta güncellemesi
Android Beta'daki Özel Korumalı Alan'ın bu sürümü, herkese açık Android 14 cihazlardaki Özel Korumalı Alan API'leriyle ilgili güncellemeleri içerir. SDK ve cihaz resimleri, Android Studio'nun SDK yöneticisi kullanılarak Android API 34, Uzantı Düzeyi 10 olarak indirilebilir ve birkaç önemli değişikliğin yanı sıra işlevsel olarak Developer Preview 9'a benzer.
Protected Audience API
- Reklam teknolojileri artık cihazda varlığı olmayan bir alıcı adına özel bir kitleye katılmak için özel kitle yetkisini kullanabilir.
- Android artık teklifli sistem ve açık artırma hizmetlerinde açık artırma çalıştırmayı destekliyor.
- Korunan Kitle açık artırmaları TBM faturalandırmasını destekler.
- Korunan Kitle açık artırmaları ve raporları artık güvenilir teklif sinyalleri için veri sürümü başlıklarını destekliyor.
- Korunan Kitle açık artırmaları, WIN etkinliklerinde sıklık sınırı filtrelemeyi destekler.
- Protected Audience artık Attribution Reporting API ile entegrasyonu desteklemektedir.
Attribution Reporting API
- Attribution Reporting API artık Protected Audience ile entegrasyonu desteklemektedir
SDK Çalışma Zamanı
- Uyumlulaştırma kullanım alanlarını desteklemek için SDK'dan SDK Çalışma Zamanı içinde diğer SDK'ları yükleme özelliği
Eski sürümler
Geliştirici Önizlemesi 10
Yayın tarihi: 19 Aralık 2023
Bilinen sınırlamalar
- Google Play Hizmetleri'nin arka planda kilitlenmesine ve kullanıcıyı sürekli olarak bilgilendirmesine neden olan bir sorun var:
- Cihazı yeniden başlatmak bu sorunu hafifletebilir.
- Test sırasında, eşzamansız çağrının zaman aşımına uğramasıyla ilgili sorun yaşıyorsanız eşiği zaman aşımına kadar uzatmak için aşağıdaki adb komutunu eklemeyi deneyin:
adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
- Yalnızca fiziksel cihaz: Google Hesabı ekleme desteklenmez. Cihazı
ana ekrana getirmek için aşağıdaki adımları uygulayın:
- Önizleme resmini telefona yükleyin.
- Kablosuz ağa veya mobil veriye bağlanmadan kurulum sihirbazının adımlarını tamamlayın.
- Ana ekrana geldiğinizde kablosuz ağa veya mobil veriye bağlanın.
- Cihazı yeniden başlatın.
Protected Audience API
- Alakalı uygulama yükleme reklamları sunmayı desteklemek için [Korunan Uygulama Sinyalleri][dp98] adlı yeni özellikleri kullanıma sunuyoruz. Bu DP ile reklam teknolojisinin şunları yapmasını sağlayacak API'leri yayınlıyoruz:
- Uygulama etkinliklerini, alakalı uygulama yükleme reklamları yayınlamak için kullanılan korumalı cihaz üzerinde depolama alanında depolayarak sinyalleri seçin.
- Güvenilir Yürütme Ortamlarında çalışan Teklif Verme ve Açık Artırma hizmetleri için, reklam seçimi ve teklif vermeye yardımcı olması amacıyla ilgili sinyallerine erişebilecekleri bir Korumalı Açık Artırma düzenleyin.
Attribution Reporting API
- Attribution Reporting API'nin bu sürümü:
- Toplu özet raporlarında özel kitle boyutlarını etkinleştiren Korunan Kitle entegrasyonunu ekler.
- Toplama Hizmeti için TEE olarak Google Cloud Sağlayıcı'yı destekler.
- Yönlendirmeler olmadan ağlar arası ilişkilendirmede hata ayıklamayı desteklemek için shared_debug_key alanını ekler.
- Ayrıntılı hata ayıklama raporu isteklerine sürüm üstbilgileri ekler.
Cihaz Üzerinde Kişiselleştirme
- Araştırmacılar için ilk sürüm ve erken geliştirme.
- Cihaz Üzerinde Kişiselleştirme, gelişmiş son kullanıcı gizliliği koruması sağlarken ürün ve hizmetleri özelleştirmek için yenilikçi bir yol sunar. Cihaz Üzerinde Kişiselleştirme, bunu başarmak için yapı taşları olarak bir dizi hizmet ve algoritma sağlar. Bu hizmetler ve algoritmalardan bazıları şunlardır:
- Birleşik Öğrenim'i kullanarak modellerin eğitilmesi, değerlendirilmesi ve kişiselleştirilmesine olanak tanıyan Birleşik Compute (FC) Cihaz Üzerinde Kişiselleştirme'nin Birleşik İşlem kullanımı, model eğitimine ve (gerekirse isteğe bağlı olarak) çıkarımına dayanır.
- Guguklu Filtresi, birbirinden farklı şekilde konumlandırılmış veriler arasında eşleme ve çapraz eşleme temel alır.
- DP Alternatif Küçültme gibi yeni teknikler kullanılarak seyrek modeller için diferansiyel Özel (DP) eğitim (farklı konumlarda bulunan veriler üzerinde eğitim için) ve ilan tahtası DP'sinde model kişiselleştirme.
Geliştirici Önizlemesi 9
Yayın tarihi: 15 Ağustos 2023
Bilinen sınırlamalar
- Bidding and Açık Artırma API'sinin çağrılmasıyla oluşturulan açık artırma verileri DP9'da otomatik olarak silinmez.
- İzin iptal edildiğinde
getAdSelectionData
vepersistAdSelectionResult
çağrıldığında işlem kilitlenir. - Negatif filtreleme özelliği
getAdSelectionData
vepersistAdSelectionResult
ile çalışmaz.
Protected Audience API
- Reklam teknolojileri artık özel kitle yetkisini kullanarak bir özel kitleyi cihaz üzerinde arayana katılabilir.
- Android artık teklifli sistem ve açık artırma hizmetlerinde açık artırma çalıştırmayı destekliyor. Protected Kitle açık artırmaları ise TBM faturalandırmasını destekliyor.
- Report Engagements API'nin adı
reportEvent
olarak değişti. - Sıklık sınırı yöntemi ve sayaç türleri yeniden adlandırıldı.
- Hata ayıklama raporlaması bir açık artırmanın neden kaybolduğu hakkında bilgi almak veya JavaScript mantığındaki sorunları tanımlamak için kullanılabilir.
Attribution Reporting API
- Bu sürüm, Attribution Reporting API için hata ayıklama raporlarını aşağıdaki şekillerde iyileştirmiştir:
- Web'de desteklenen ayrıntılı hata ayıklama raporlarını destekleme.
- Web ve uygulamalar arası ilişkilendirme hata ayıklama raporlarını etkinleştirme (hem web hem de uygulama kaydında AdId kullanılmasını gerektirir).
- Reklam teknolojileri, gürültü parametrelerini farklı raporlama senaryoları için yapılandırabilir.
- Bu sürüm, kaynağa dayalı ilişkilendirmeye taşınır. Diğer bir deyişle:
- Kaynak, kayıt için kullanılır.
- Tek bir site altında birden çok kaynak kabul edilir.
- Kaynak uygulama veya kayıt başına bir kaynak olacak şekilde yeni hız sınırı.
- Reklam teknolojileri artık İlişkilendirme Raporlaması kullanım alanlarını yerel olarak test etmek için kaydı devre dışı bırakabilir.
SDK Çalışma Zamanı
- SDK yalnızca hizmet listesi başlatabilir veya izin verilenler listesine bağlanabilir.
- SDK, yalnızca
ContentProvider
sisteminin bir alt kümesine (ör.com.android.providers.settings.SettingsProvider
) erişebilir. Bu durumda, elde edilen veriler tanımlayıcı içermez ve kullanıcının parmak izini oluşturmak için kullanılamaz. Bu denetimler,ContentResolver
kullanılarakContentProvider
erişimi için de geçerlidir. - SDK, korunan yayın alıcılarının yalnızca bir alt kümesine (ör.
android.intent.action.AIRPLANE_MODE
) erişebilir. - SDK, başka bir uygulamaya ait bir etkinliği başlatabilir, ancak Intent'te nelerin gönderilebileceğine dair sınırlar vardır.
Android'de Özel Korumalı Alan, Mart 2023 Beta güncellemesi
Android Beta'daki Özel Korumalı Alan'ın Mart 2023 sürümü, herkese açık Android 13 cihazlardaki Özel Korumalı Alan API'leriyle ilgili güncellemeleri içerir. Bu sürüm Ad Services Extensions 5 API'leri içerir ve birkaç önemli değişiklikle işlevsel olarak Developer Preview 6'ya benzer.
Bilinen sınırlamalar
- FLEDGE özel kitlelerini güncellemek için düzenli olarak çalışan arka plan getirme işi, sürecin çökmesine neden olur. Bu sorun nedeniyle FLEDGE varsayılan olarak devre dışıdır.
Genel
- Bu sürümden itibaren Attribution Reporting API'yi kullanabilirsiniz. API daha önce devre dışı bırakılmıştı. Attribution Reporting API'yi önceki Beta sürümünde kullandıysanız bu Beta sürümünü kullanmadan önce aşağıdaki adımlardan birini uygulayarak uygulama veya cihaz verilerinizi temizleyin:
- Bir cihazda veya emülatörde Ayarlar'a gidin ve test için kullanılan tüm uygulamalar için uygulamaya özel depolama alanını temizleyin (yalnızca önbelleği değil).
- Fiziksel veya emüle edilmiş cihazınızı fabrika ayarlarına sıfırlayın.
- Öykünülen bir cihazda Verileri Sil işlevi gerçekleştirin.
- İlişkilendirme Raporlama, artık geliştiricilerin İlişkilendirme API'sinden değiştirilmemiş raporlar ve gizliliği geliştirilmiş raporlar almasına olanak tanıyan hata ayıklama anahtarlarını desteklemektedir. Hata ayıklama anahtarları, Özel Korumalı Alan'a geçiş yaparken raporların nasıl yapılandırıldığına dair daha fazla görünürlük elde etme fırsatı sunar.
- Yakın zamanda İlişkilendirme Raporlarında, Reklam Hizmetleri'nde
registerSource
veregisterTrigger
ile ilgili istisnaların geçerli olduğu bir hata ile karşılaşıldı. Geliştirme sırasında bu sorunlarla karşılaştıysanız bir düzeltme kullanıma sunulmuştur ve bu sorunların zaman içinde çözülmesi gerekir. - Topics API önizleme işlevi artık Android Geliştirici Önizlemeleri'ndeki Özel Korumalı Alan ile eşdeğerdir. Topics API çağrısı, haftalık dönem hesaplamasına konu alma çağrısını dahil etmeden veya arayan için gözlemlenen konuların listesini etkilemeden konuları önizleyebilir. Ayrıntılar için
shouldRecordObservation
alanına bakın. Android'de FLEDGE'de testi etkinleştirmek için Beta programına kaydolun ve test cihazlarınızda oturum açmak için aynı Google Hesabı'nı kullanın. Aksi takdirde API'leri çağırma girişimleri, "Hizmet kullanılamıyor" mesajıyla bir
IllegalStateException
hatasına neden olur. FLEDGE'in bir sonraki Beta sürümünde yeniden etkinleştirilmesi gerekir.Bu sırada, Geliştirici Önizlemelerini kullanarak testler devam edebilir ve önerilir. FLEDGE, aşağıdaki uyarıların dikkate alındığı cihazlarda manuel olarak etkinleştirilebilir:
FLEDGE'i aşağıdaki adb komutlarıyla etkinleştirebilirsiniz. Ancak bu durum, arka planda getirme işleminin çökmesine neden olarak sistem durumu metriklerini olumsuz etkiler. Bu değerler platform tarafından sıfırlanabileceğinden bu kalıcı bir çözüm değildir.
adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true
Eski sürümler
Geliştirici Önizlemesi 8
Yayın tarihi: 23 Mayıs 2023
Bilinen sınırlamalar
- Korunan Kitle reklamlarına
WIN
türü sıklık sınırı filtreleri eklenebilir ancakWIN
türü henüz desteklenmemektedir ve bu tür filtreler yoksayılır. - Kazanan gösterimleri, Korunan Kitle açık artırmalarını kazanan alıcılara raporlayabilmek için alıcıların Özel Korumalı Alan'a kayıtlı olması gerekir. Bu koşul geçersiz kılınamaz.
- Özel Korumalı Alan bulunan bir cihazda Özel Korumalı Alan ayarlarına erişmek için Ayarlar > Google > Reklamlar > Özel Korumalı Alan'a gidin.
- Android Studio Giraffe'ta emülatörlerle projeler dağıtılamıyor. Android Studio'nun diğer sürümleri sorunsuz çalışacaktır. 26 Mayıs 2023'te Android Studio Giraffe'a bir düzeltme yayınlanacak.
Protected Audience API
- FLEDGE'in adı Protected Audience API olarak değiştirildi.
- Korunan Kitle, Mart 2023 Beta sürümünde varsayılan olarak devre dışı bırakılmıştır. Bu sorun çözüldü ve Korunan Kitle artık sınırlı sayıda kullanıcının kullanımına sunuldu.
- Aşağıdaki yeni özellikler eklendi:
- Sıklık sınırı
- Etkileşim raporlama
- Açık artırmaya içeriğe dayalı reklamları dahil etme
- Uygulama yükleme negatif reklam filtrelemesi
- Önceden oluşturulmuş URI'lar, açık artırma sürecinde JavaScript'leri yerine reklam teknolojileri tarafından kullanılmak üzere önceden tanımlanmış mantık kitaplığı
- Teklif verme ve puanlama JavaScript işlevleri için sürüm oluşturma
Attribution Reporting API
- Eklenen VEYA tetikleyici filtreleri. Bu, artık filtrelerin, filtre eşlemelerinin listesi olan
bir filtre grubundan oluştuğu anlamına gelir. Gruptaki filtre eşlemelerinden hiçbiri kaynağın filtre verileriyle eşleşmiyorsa
event_trigger_data
nesnesi yoksayılır. - Toplama ve etkinlik düzeyindeki API'ler için gösterim geçerlilik süresi ve raporlama aralığı ayrıldı.
- Birleştirilebilir raporlarda tekilleştirme anahtarları için destek eklendi.
scheduled_report_time
, Web için Özel Korumalı Alan ile benzerlik sağlamak üzere etkinlik raporlarına eklendi.- Yönlendirme olmadan ağlar arası ilişkilendirme uygulandı.
SDK Çalışma Zamanı
- Uygulama süreci ve SDK Çalışma Zamanı süreci için SDK ile SDK iletişimi uygulandı.
- Özelleştirilmiş SDK Etkinliği desteği
Geliştirici Önizlemesi 7
Yayın tarihi: 26 Ocak 2023
Android API'de FLEDGE
custom_audience_signals
parametresi aşağıdaki JavaScript yöntemlerinde yeniden adlandırılmıştır:generateBid()
,custom_audience_bidding_signals
olarak yeniden adlandırıldı.scoreAd()
,custom_audience_scoring_signals
olarak yeniden adlandırıldı.reportWin()
,custom_audience_reporting_signals
olarak yeniden adlandırıldı.
- Bu sürümde,
selectAds
sonuçlarını karşılaştırmak içinAdSelectionFromOutcomeConfig
gereken yeni birselectAds
geçersiz kılması eklendi. Bu, bu API'den yararlanan reklam teknolojisi SDK'larının şelale uyumlulaştırması çalıştırmasını sağlar. Daha ayrıntılı bilgiyi geliştirici kılavuzunda bulabilirsiniz. selectAds()
API artık reklam seçim işlemi sırasında getirilen JavaScript ve teklif verme ve puanlama mantığı için önbelleğe almayı desteklemektedir.- Önbellek, JavaScript getirme çağrısı sırasında sunucular tarafından döndürülen
Cache-Control
üst bilgileriyle kontrol edilebilir. JavaScript yanıtlarının önbelleğe alınmasını önlemek içinno-cache
veyano-store
, önbellek süresini kontrol etmek için de maksimum süreyi kullanın. - Geçerli önbellek girişi
max-age
, varsayılan olarak iki gün olarak ayarlanmıştır.
- Önbellek, JavaScript getirme çağrısı sırasında sunucular tarafından döndürülen
Android API'de İlişkilendirme Raporları
- Bu sürümde,
registerSource()
veregisterTrigger()
için zincirleme yönlendirme desteği eklendi. API tüketicisi artık sunucu yanıtı olarak HTTP yönlendirmesi kullanabilir.
İlk Beta sürümü, Ocak 2023
Yayın tarihi: 9 Ocak 2023
Android Beta 1'deki Özel Korumalı Alan, herkese açık cihazlarda Özel Korumalı Alan API'lerinin ilk kullanılabilirliğini temsil etmekte ve sonraki alanlarda iyileştirmeler yapmaktadır.
Genel
- Android Beta 1'deki Özel Korumalı Alan, işlevsel olarak Geliştirici Önizleme 5'e eşdeğerdir. Bazı ek özellikler ve sınırlamalar aşağıda verilmiştir.
- Geliştiricilerin reklamlarla ilgili API'lerden (Topics, FLEDGE ve İlişkilendirme Raporları dahil) yararlanmak için kayıt işlemini tamamlamaları gerekir. Kayıt işlemi, geliştirici kimliğini doğrular ve API'lerin ihtiyaç duyduğu geliştiriciye özel verileri toplar.
- Android Beta 1 sürümünde Özel Korumalı Alan, izin verilenler listesine kaydolup ayrıntılarını gönderen geliştiriciler, kendi fiziksel cihazlarında test etme fırsatına sahip olabilir. Sürümdeki kararlı API'lere göre geliştirme yapmak için yeni SDK Ad Services Extensions 4'ü indirin.
Topics API
- Android Topics Sınıflandırıcı Colab, geliştiricilerin sınıflandırıcı modelinin nasıl çalıştığını daha iyi anlamalarını sağlar.
Attribution Reporting API
- İlişkilendirme Raporlama devre dışı bırakıldı ve bu sürümde kullanılamıyor. Bu API'ye erişim bir sonraki Beta sürümünde yeniden etkinleştirilmelidir. Geliştirici Önizlemeleri ile teste devam etmeniz önerilir.
SDK Çalışma Zamanı
Bir sonraki ana Android platformu sürümünde aşağıdaki sınırlamaların düzeltilmesi beklenmektedir:
RecyclerView
gibi kaydırılabilir bir görünümde reklam oluşturma şu anda düzgün çalışmıyor. Öğe yeniden boyutlandırılırsa duraklamalar yaşanabilir. Kullanıcı dokunma kaydırma etkinlikleri, çalışma zamanına doğru şekilde iletilmiyor.- SDK Çalışma Zamanı sürecinde
WebView
oluşturma seçeneği kullanılamaz. - SDK başına depolama alanı kullanılamaz.
getAdId
vegetAppSetId
API'leri için destek henüz etkinleştirilmedi.
Geliştirici Önizlemesi 6
Yayın tarihi: 31 Ekim 2022
Android Developer Preview 6'daki Özel Korumalı Alan, aşağıdaki alanlarda iyileştirmeler sağlar:
Genel
Üretimi kullanıma sunma hazırlığında Geliştirici Önizleme 6, varsayılan olarak Gizliliği Koruma API erişimini devre dışı bırakmak için bir işaret sundu. Test amacıyla, aşağıdaki komutu çalıştırarak Geliştirici Önizlemesi'nde Privacy-Preserving API erişimini etkinleştirin:
adb shell device_config put adservices global_kill_switch false
AdIdManager
veAppSetIdManager
API'leri için Google Play Hizmetleri'nin 22.36.16 veya daha yeni bir sürümü gereklidir.- Android destekli bir cihazda, doğru sürümün Ayarlar > Uygulamalar > Google Play Hizmetleri altında listelendiğinden emin olun.
- Google Play Hizmetleri'ni uygun sürüme güncellemeniz gerekiyorsa Android test cihazınızda veya emülatörünüzde bir Google Hesabı ile oturum açın. Ardından Google Play Store > profil simgesi > Ayarlar > Hakkında'ya gidin. Play Store sürümü başlığı altında Play Store'u güncelle'ye dokunun.
- Bu adım yalnızca geliştirme ve test için geçerlidir ve Özel Korumalı Alan herkese açık kullanıcıların kullanımına sunulduktan sonra gerekli değildir.
Topics API
getTopics
adlı kullanıcının gözlemci olarak kaydedilip kaydedilmeyeceği ayarını değiştirmek için bir Preview API eklendi.GetTopicsRequest
sınıfı için başlatma kodunda küçük değişiklikler.- Konu entegrasyon kılavuzu yayınlandı.
Android API'de FLEDGE
- Gerçek sunucularda test yapıyorsanız API'nin etkinleştirilmesi artık zorunlu kılınır. Cihazınızı yapılandırmak için lütfen bu adımları uygulayın. Örnek uygulamada bulunan uzaktan geçersiz kılma işlemlerini kullanıyorsanız bu adımlar gerekli değildir.
- Zarar Veren Değişiklikler:
- Parametrelerdeki
Url
değeriUri
ile değiştirildi. Bu, tüm FLEDGE API'leri ve teklif verme ve puanlama mantığı için özel JavaScript'ler için geçerlidir. owner
alanı, Custom Audience API girişlerinden kaldırıldı.
- Parametrelerdeki
- Tamamlanmamış özel kitleler artık arka planda yenileme için anında uygundur.
- JavaScript bellek sınırı 10 MB olarak ayarlandı. Bu, teklif ve puanlama mantığı için geçerlidir.
Attribution Reporting API
- Reklam teknolojileri, Developer Preview 6'daki Attribution Reporting API'yi kullanabilmek için önce kaydolmalıdır. Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolma bölümüne bakın.
- Bu sürümde, geliştiricilerin Attribution Reporting API'den gizliliği geliştirilmiş raporların yanı sıra değiştirilmemiş raporlar almasına olanak tanıyan hata ayıklama anahtarları kullanıma sunuldu. Hata ayıklama anahtarları, Özel Korumalı Alan ile geçiş yaparken raporların nasıl yapılandırıldığına dair daha fazla görünürlük elde etme şansı tanır.
Geliştirici Önizlemesi 5
Genel
- Geliştirici Önizlemesi 5'te Özel Korumalı Alan API'lerine erişebilmek için önce API'leri etkinleştirmeniz ve API'ye özel izinleri yapılandırmanız gerekir.
- Android'deki Özel Korumalı Alan için tasarlanan tasarımlar, kullanıcıların gizliliği korumaya yönelik API'lerin ve SDK Çalışma Zamanı'nın cihazlarında etkin olup olmadığını kontrol etmelerine olanak tanır. Bu ayarlar Geliştirici Önizleme 5'te varsayılan olarak devre dışı bırakılmıştır. API erişimini adb komutu kullanarak etkinleştirebilirsiniz.
- Arayan uygulama, manifest dosyasında API'ye özel izinleri ve yerleştirilmiş SDK'lara erişimi kontrol eden ilgili
AdServices
yapılandırmalarını belirtmelidir.
- Uygulamalar, ön planda çalışırken gizliliği koruyan API'leri çağırmalıdır.
AdIdManager
veAppSetIdManager
şu anda kullanılamıyor. Sonraki bir sürümde etkinleştirilecektir.
SDK Çalışma Zamanı
sendData()
desteği gelecekteki bir sürümde sonlandırılacaktır.loadSdk()
, artık çalışma zamanı özellikli SDK ile AIDL'de tanımlanan uygulamalar arasında iki yönlü iletişimi kolaylaştırmak için bir IBinder nesnesi döndürüyor.- Uygulamalar, SDK sürecinin sonlandırılması gibi çalışma zamanı özellikli ek SDK yaşam döngüsü olaylarına erişebilir.
Attribution Reporting API
Bu sürüm, Attribution Reporting API'de aşağıdakiler gibi ek özellikler sunar:
- Şifrelenmiş toplama raporu desteği.
- Uygulamalar arası ve web ölçüm desteği.
- Kaynakta birleştirilmiş başlıklar ve tetikleyici kayıt yanıtları:
- Kaynak:
Attribution-Reporting-Register-Aggregatable-Source
, artıkAttribution-Reporting-Register-Source
bünyesinde - Tetikleyici:
Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data
veAttribution-Reporting-Register-Aggregatable-Values
,Attribution-Reporting-Register-Event-Trigger
adlı tek bir başlıkta birleştirildi Attribution-Reporting-Redirects
hâlâ ayrı bir başlık
- Kaynak:
Android API'de FLEDGE
Bu sürüm, birçok yeni özellik ve iyileştirmenin yanı sıra önemli değişiklikler içeriyor:
- Zarar veren değişiklikler:
runAdSelection()
,selectAds()
olarak yeniden adlandırıldı.AdSelectionConfig.Builder.setAdSelectionSignals()
parametresi, bir JSON nesnesini temsil edenAdSelectionSignals
ile değiştirildi.- Reklam teknolojisi alıcısını/satıcısını temsil etmek için
String
kullanımı,AdTechIdentifier
nesnesiyle değiştirildi. - Uzak JavaScript getirmeyi geçersiz kılma için
TestCustomAudienceManager
veTestAdSelectionManager
sınıfları eklendi. - Özel kitlenin sahibinin, arama uygulamasının paket adı olması gerekir.
- FLEDGE API'leri artık arayan uygulamasını geliştirici kılavuzunda açıklanan bir dizi kısıtlama ve sınırlamaya göre doğrular. Aşağıda bazı önemli örnekler verilmiştir.
selectAds
vereportImpression
için artık yürütme süresi sınırları söz konusudur. Bu sınırdan sonra çağrı sonlandırılır.selectAds
vereportImpression
artık JavaScript yürütmesi sırasında harcanan bellekle ilgili bir sınıra sahiptir. Bellek tüketimi yapılandırılan sınırları aşarsa API'ler hata verir.selectAds
vereportImpression
artık alanların sözdizimsel olarak geçerli olduğundan ve URL'lerin satıcı alanında kullanılan eTLD+1'in altında olduğundan emin olmak içinAdSelectionConfig
nesnesini doğrular.AdServices
, özel kitleleri oluşturma sırasında artık doğruluyor. Bu doğrulamalardan bazıları, geçerlilik süresinin geçerli olduğunun doğrulanmasını içerir ve bir uygulamanın oluşturabileceği özel kitle sayısı vejoinCustomAudience
çağrısında sağlanan reklamların toplam boyutuna bir sınır uygular. Doğrulama ayrıca sinyaller, teklif mantığı alma ve arka plan getirme için sağlanan URI'lerin tümünün alıcı alanında olmasını zorunlu kılar.
- Özel kitle meta verileri, bir arka planda getirme işlemi ile günlük olarak güncellenir.
- Özel kitleler, "sahip" uygulamasının yüklemesi kaldırıldığında kaldırılır.
- Reklam seçimi sırasında Güvenilir Puanlama Sinyallerini ve Güvenilir Teklif Verilerini belirtme desteği eklendi. Yanıt biçimi için kod örneğine bakın.
- Android API'leri için FLEDGE, WebView 105.0.5195.58 veya sonraki sürümüne bağlıdır. Ayrıntılar için geliştirici kılavuzundaki kurulum bilgilerine bakın.
Bilinen Sorunlar:
Özel bir kitleye katılırken meta verilerden veya
AdData
değerlerinden herhangi biri boş ya danull
ise platform şu anda arka plan güncellemelerini hemen gerçekleştirmez. Özel kitle, bir gün sonra güncellenene kadar reklam seçimleri için uygun olmayacaktır. Gelecekteki bir sürümde, tamamlanmamış özel kitleler arka planda getirme güncellemeleri için hemen uygun hale gelecektir. JavaScript yürütmesi için geçerli varsayılan bellek sınırı çok düşüktür ve normal iş yüklerinin cihazlarda JavaScript Engine'i kilitlemesine neden olabilir. JavaScript yürütmeniz beklenmedik bir şekilde"Fatal javascript OOM in CALL_AND_RETRY_LAST"
hata mesajıyla sonlandırılabilir.Aşağıdaki komutla uygun bellek eşiğini yapılandırarak bu sorunu manuel olarak çözebilirsiniz:
adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"
Gerekli JSON yapısıyla eşleşmeyen özel kitle reklamları, arka planda getirme sırasında güncellenir.
Topics API
- Mobil uygulamaların sınıflandırmasına ilişkin sınıflandırma güncellendi.
- Atanmış konuları görüntülemek için Ayarlar kullanıcı arayüzünün kullanıma sunulmasıyla birlikte tasarım teklifi ve örnek uygulamalar güncellendi.
Araçlar Güncellemeleri
Android Studio Canary, yeni bir modül türüyle SDK APK'ları oluşturma desteğine sahiptir. SDK Çalışma Zamanı Geliştirici Kılavuzu güncellendi ve GitHub'daki Özel Korumalı Alan örnek uygulamaları bu güncellemeyi yansıtmaktadır.
Geliştirici Önizlemesi 4
Yayın tarihi: 14 Temmuz 2022
Android Developer Preview 4'te Özel Korumalı Alan, aşağıdaki alanlarda iyileştirmeler sağlar:
SDK Çalışma Zamanı
- Uygulamalar artık
sendData()
eklenerek çalışma zamanı etkin SDK'lar (RE-SDK'lar) ile iletişim kurabilir. - Yerel depolama, artık SDK Çalışma Zamanı sürecinde kullanılabilir.
- Bir SDK, bağımsız video tabanlı reklamlar veya SDK Çalışma Zamanında içerik de oluşturabilir.
- İçeriğin başka bir RE-SDK'da olmadığı sürece yansıma özelliğinin kullanılabilmesini sağlamak için yansıma kullanımıyla ilgili açıklamalar eklendi.
Attribution Reporting API
Bu sürümde, Attribution Reporting API'nin kullanımının daha anlaşılır olmasını sağlayacak değişiklikler yapılmaktadır. Örneğin:
- Okunabilirliği iyileştirmek için toplu rapor biçiminde yapılan değişiklikler.
- Dönüşüm Filtreleme ve Teklif Verilebilirlik özellikleri için başlık alanları güncellendi.
- WebApp API referansına, kaynak ve tetikleyici kaydının yanı sıra gizlilik ve izin API'si kullanılabilirliğini açıklamak için açıklamalar eklendi.
Android API'de FLEDGE
Bu sürümde, test ve hata ayıklamaya yardımcı olacak yeni özelliklerin yanı sıra dahili iyileştirmeler de bulunmaktadır:
- Geliştirme sırasında JavaScript mantığı almak için uzak URL'leri geçersiz kılma desteği eklendi.
- Reklam seçimi sırasında iyileştirilmiş hata raporlama.
- Etkin olmayan özel kitleler artık reklam seçimi sırasında filtreleniyor.
Topics API
Bu sürüm, Topics API'de yapılan bazı önemli değişiklikleri içerir. Bunlardan en önemlisi:
getTopics()
API'sinin döndürme türü, Sınıflandırmadaki Konulara karşılık gelen tam sayı kimlikleri ile sınıflandırıcı ve Sınıflandırma sürümleriyle ilgili bilgileri içeren yeniTopic
nesne türüyle değiştirildi. Bu API'yi kullanan mevcut tüm uygulamalarınızı güncellemeniz gerekir.- Topics API için artık yeni bir normal izin gerekiyor.
- Herkese açık uygulama bilgilerine dayanarak Konuları dinamik bir şekilde atamak için "Cihaz Üzerinde Sınıflandırıcı" sisteminin kullanıma sunulması.
Bilinen sorunlar
Bu cihaz görüntülerinin ilk sürümü (düzeltme 6), Android Emulator sürüm 31.2.10'da yüklenmiyor. Sorunu gideren güncellenmiş cihaz resimleri 27 Temmuz 2022 itibarıyla kullanıma sunulmuştur.
Geliştirici Önizlemesi 3
Yayın tarihi: 9 Haziran 2022
Android Developer Preview 3'teki Özel Korumalı Alan, Android'de Attribution Reporting API ve FLEDGE için işlev ekler.
Attribution Reporting API
Attribution Reporting API, taraflar arası kullanıcı tanımlayıcılarına bağımlılığı ortadan kaldırarak kullanıcı gizliliğini iyileştirir ve uygulamalar arasında ilişkilendirme ve dönüşüm ölçümüyle ilgili temel kullanım alanlarını destekler.
Bu sürüm, aşağıdaki Attribution Reporting API özelliklerini test etmenize yardımcı olacak geliştirici kaynakları içerir:
- İlişkilendirme kaynağını ve tetikleyici etkinlikleri kaydetme
- Kaynak öncelikli ve yükleme sonrası ilişkilendirme alıştırması yapın
- Etkinlik raporlarını alma
- Bu sürümde şifrelenmemiş olan toplanabilir raporlar alın.
Teste yardımcı olması için örnek bir uygulama ve referans reklam teknoloji sunucusu sağlanmıştır
Bilinen sorunlar:
- Attribution Reporting API, toplu raporları henüz tasarım teklifine göre şifrelememektedir. Test amacıyla, şifreleme uygulanana kadar rapor yükleri temiz metin olarak gönderilir.
Android'de FLEDGE
Android'de FLEDGE, uygulama geliştiricileri tarafından tanımlanan özel kitlelere ve uygulamalarındaki etkileşimlere göre reklam göstermenin yeni bir yolunu sunar. Bu çözüm, bilgileri ve ilişkili reklamları yerel olarak depolar ve reklam seçimi iş akışlarını düzenlemek için bir çerçeve sunar.
Bu sürüm, Android'de aşağıdaki FLEDGE'i test etmenize yardımcı olacak geliştirici kaynakları içerir:
- Özel bir kitleye katılın veya bir kitleden ayrılın ve parametre değerlerinin açık artırma sonuçlarını nasıl etkileyebileceğini gözlemleyin
- Uzak uç noktalardan JavaScript açık artırma kodunu getirme
- Cihaz üzerinde reklam açık artırmalarını yapılandırma ve başlatma
- Gösterim raporlamasını yönetme
- Teste yardımcı olması için örnek bir uygulama ve sahte sunucu yapılandırması sağlanmıştır
Bilinen sorunlar:
- Özel kitleler, "etkinleştirme zamanından" önce bile reklam seçimine katılabilir.
Geliştirici Önizlemesi 2
Yayın tarihi: 17 Mayıs 2022
Geliştirici Önizlemesi 2, MeasurementManager
ilişkilendirme raporlama API'lerinin erken önizlemelerini içerir.
- Uygulama reklam etkinliklerini kaydetmek ve uygulamadan uygulamaya ilişkilendirme amacıyla etkinlik düzeyinde raporlama verileri almak için
registerSource()
veregisterTrigger()
çağrılarını çağırabilirsiniz. Mevcut uygulamamızda son temas ilişkilendirme yöntemi kullanılıyor. Raporların, raporlama aralıkları ile tanımlandığı gibi gönderilmesi planlanır. Daha fazla bilgi içinMeasurementManager
API referansına bakın. Gerçek rapor yüklemesi, tam olarak planlanan zaman yerine sabit zaman aralıklarının sonunda gerçekleşir. Raporlama yükleme aralığı varsayılan olarak 4 saattir ancak aşağıdaki adb komutuyla geçersiz kılınabilir:
adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>
Test API'leri için örnek bir uygulama ve referans reklam teknoloji sunucusu gelecekteki bir sürümde yayınlanacaktır.
Toplu raporlama, yükleme sonrası ilişkilendirme ve yönlendirmeler gibi diğer
MeasurementManager
ilişkilendirme raporlama API'si özellikleri sonraki bir sürümde kullanıma sunulacaktır.
Geliştirici Önizlemesi 1
Yayın tarihi: 28 Nisan 2022
Geliştirici Önizlemesi 1, Topics API ve SDK Çalışma Zamanı'nın erken önizlemelerini içerir. Android'de FLEDGE ve Attribution Reporting API'leri işlevleri gelecekteki bir sürümde kullanıma sunulacaktır.
- Topics API
getTopics()
API, şu anda sınırlı sayıda uygulama için çevrimdışı sınıflandırmaya dayalı test değerleri döndürmektedir. Cihaz üzerinde sınıflandırmalar henüz uygulanmamıştır.- Dönem aralıklarını ve zorla tetikleyici sıfır hesaplamasını geçersiz kılmak için adb komutlarını kullanabilirsiniz.
- Ayrıntılar için Konular geliştirici kılavuzunu okuyun.
- SDK Çalışma Zamanı
- SDK uygulamanızın manifest dosyasındaki yeni
<sdk-library>
öğesini kullanarak çalışma zamanı özellikli SDK'ları (RE SDK'ları) paketleyip oluşturabilirsiniz. RE SDK'larını, normalde geliştirme sırasında yüklediğiniz gibi, desteklenen bir test cihazına veya emülatöre yükleyin. - Bir uygulamayı RE SDK'larıyla entegre edebilir, SDK Çalışma Zamanı'nda yükleyebilir ve kısıtlı erişimin SDK kodu (izinler, bellek ve uygulamadan SDK'ya iletişimler) üzerindeki etkisini test edebilirsiniz. RE SDK'ları için Storage API'leri henüz uygulanmamıştır ve gelecekteki bir sürümde kullanıma sunulacaktır.
- SDK'lar, SDK Çalışma Zamanı'nda
WebView
tabanlı banner reklamlar veya içerikler oluşturabilir. - Daha fazla bilgi için SDK Çalışma Zamanı geliştirici kılavuzunu okuyun.
- SDK uygulamanızın manifest dosyasındaki yeni
- Android lint kontrolleri
- Android lint kontrolleri,
TiramisuPrivacySandbox
API düzeyiyle derlenen projelerde yanlış bir şekilde uyarılar gösterebilir. Örneğin, şu uyarı mesajını görebilirsiniz: "Çağrı için API düzeyi 33 gerekir".@SuppressLint("NewApi")
ek açıklamasını kullanarak bu sorunu geçici olarak giderebilirsiniz.
- Android lint kontrolleri,