Android Özel Korumalı Alan sürüm notları

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

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][b25] ile benzerdir.

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][b26] 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[b27].

Attribution Reporting API

  • Attribution Reporting API artık [Protected Audience ile entegrasyonu] desteklemektedir[b28]

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 ve persistAdSelectionResult çağrıldığında işlem kilitlenir.
  • Negatif filtreleme özelliği getAdSelectionData ve persistAdSelectionResult ile çalışmaz.

Protected Audience API

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ılarak ContentProvider 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 ve registerTrigger 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 ancak WIN 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

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ı

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çin AdSelectionFromOutcomeConfig gereken yeni bir selectAds 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çin no-cache veya no-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.

Android API'de İlişkilendirme Raporları

  • Bu sürümde, registerSource() ve registerTrigger() 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

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 ve getAppSetId 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 ve AppSetIdManager 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ğeri Uri 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ı.
  • 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ı sağlar.

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 ve AppSetIdManager ş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ık Attribution-Reporting-Register-Source bünyesinde
    • Tetikleyici: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data ve Attribution-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

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 eden AdSelectionSignals 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 ve TestAdSelectionManager 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 ve reportImpression 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 ve reportImpression 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 ve reportImpression 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çin AdSelectionConfig 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ı ve joinCustomAudience ç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 da null 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

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 yeni Topic 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:

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() ve registerTrigger() ç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çin MeasurementManager 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.
  • 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.