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

Android'deki Özel Korumalı Alan, Geliştirici Önizleme ve Beta programları sunar. Saat zaman içinde Geliştirici Önizlemesi'nde yeni API'leri ve özellikleri kullanıma sunun ve Beta programına geri döneceğiz. Geri bildirim vermeniz önerilir.

Android'de Özel Korumalı Alan'ı kullanmaya yeni başladıysanız önce Program Genel Bakış. Projenizde Özel Korumalı Alan oluşturmaya başlamak için geliştirme ortamınızı kurun ve Android'de Özel Korumalı Alan'ı edinin test cihazınızda veya emülatörünüzde.

Güncel sürümler

Android VanillaIceCream Önizlemesi

Protected Audience API

  • Kimliği doğrulanmış içeriğe dayalı reklamları Korumalı Açık Artırmaya geçirme özelliği eklendi. Buna, tıklama, gösterim ve görüntüleme sayılarındaki sıklık sınırının kazanamaz. Uygulama, bağlamsal açıdan önceki iterasyonlardan farklıdır reklamların reklam teknolojisi tarafından imzalanması gerekir. Bunu nasıl uygulayacağınızı öğrenin daha fazla bilgi edinin.
  • Bağlamsal Reklamlar, ilgili alıcı ve AdSelectionConfig'de belirleyicidir; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Kimliği doğrulanmamış bağlamsal uygulama iletilirse açık artırma

Attribution Reporting API

  • Uygulama cihazda zaten yüklüyse kaynağı bırakma olanağı
  • Basit esnek etkinlik raporlamasından tam esnek etkinlik raporlarına yapılan güncellemeler

Android'de Özel Korumalı Alan Kasım 2023 Beta güncellemesi

Android'de Özel Korumalı Alan Beta'nın bu sürümü, Herkese açık Android 14 cihazlarda Özel Korumalı Alan API'leri SDK ve cihaz görüntüleri: Android API 34 olarak Android Studio'nun SDK yöneticisi kullanılarak indirilebilir, Uzantı Düzeyi 10 ve işlevsel olarak Geliştirici Önizlemesi'ne benzer 9 olarak listeleyebilirsiniz.

Protected Audience API

  • Reklam teknolojileri artık özel bir kitleye katılmak için özel kitle yetkisi cihaz üzerinde varlık bulunmayan bir alıcı adına kitle.
  • Android artık teklifli sistem ve açık artırma hizmetlerinde açık artırma yapmayı desteklemektedir.
  • Protected Audience açık artırmaları TBM faturalandırmasını destekler.
  • Protected Audience açık artırmaları ve raporları artık veri sürümü başlıklarını destekliyor güvenilir teklif sinyalleri için.
  • Protected Audience açık artırmaları, WIN etkinliklerinde sıklık sınırı filtrelemeyi destekler.
  • Protected Audience artık destekliyor Attribution Reporting API ile entegrasyon.

Attribution Reporting API

SDK Çalışma Zamanı

  • SDK'dan, SDK Çalışma Zamanı'nda diğer SDK'ları desteklemek için diğer SDK'ları yükleyebilmesi uyumlulaştırmanın kullanım alanları

Geçmiş sürümler

Geliştirici Önizlemesi 10

Yayın tarihi: 19 Aralık 2023

Bilinen sınırlamalar

  • Google Play Hizmetleri'nin şurada kilitlenmesine neden olan bir sorun var: ve kullanıcıyı sürekli olarak bilgilendirme:
    • Cihazın yeniden başlatılması bu sorunu çözebilir.
    • Test sırasında eşzamansız çağrıların zaman aşımına uğramasıyla ilgili sorun yaşıyorsanız eşiği uzatmak için aşağıdaki adb komutunu eklemeyi deneyin zaman aşımına uğrayana kadar:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Yalnızca fiziksel cihaz: Google Hesabı ekleme desteklenmez. Takip et Cihazı ana ekrana taşımak için şu adımları uygulayın:
    • Önizleme resmini telefona yükleyin.
    • Kablosuz ağa veya mobil veriye bağlanmadan kurulum sihirbazını tamamlayın.
    • Ana ekrana geldikten sonra kablosuz ağa veya mobil veriye bağlanın.
    • Cihazı yeniden başlatın.

Protected Audience API

  • [Protected App Signals][dp98] adlı yeni özellikleri kullanıma sunuyoruz. Google Analytics 4'te tarama odaklı bir dizi araç kullanıma sunuldu. Bu DPY ile, yıl sonuna kadar Reklam teknolojilerinin şunları yapmasına olanak tanıyan API'ler:
    • Uygulama etkinliklerini cihaz üzerinde korumalı depolama alanında depolayarak sinyalleri seçin. alakalı uygulama yükleme reklamları yayınlamak için kullanılır.
    • Şu aralıkta devam eden teklifli sistem ve açık artırma hizmetlerinde korumalı açık artırma yapma İlgili sinyallerine erişebilecekleri Güvenilir Yürütme Ortamları reklam seçimi ve teklif vermeye yardımcı olur.

Attribution Reporting API

  • Attribution Reporting API'nin bu sürümü:
    • Özel kitleler sağlayan Protected Audience entegrasyonunu ekler toplu özet raporlarında yer alan boyutlara ilişkin boyutları içerir.
    • Toplama Hizmeti için Google Cloud Sağlayıcısı'nı, TEE olarak destekler.
    • Ağlar arası hata ayıklamayı desteklemek için shared_debug_key alanını ekler ilişkilendirmesine yardımcı olur.
    • 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 ilk geliştirme.
  • Cihaz üzerinde kişiselleştirme, ürünleri özelleştirmenin yenilikçi bir yolunu sunuyor ve hizmetler sunarken gelişmiş son kullanıcı gizliliği koruması sağlar. Cihazda Kişiselleştirme, projenizin temelini oluşturan birtakım hizmetler ve algoritmalar Aşağıdakiler dahil ancak bunlarla sınırlı olmamak üzere bunu başarmak için:
    • Eğitim, değerlendirme ve kişiselleştirme olanağı sunan birleşik Compute (FC) yaygın olarak kullanılan bir diğeridir. Cihaz Üzerinde Kişiselleştirme'nin Birleşik Kullanımı İşlem, model eğitimine ve (isteğe bağlı olarak gerekirse) çıkarıma dayanacaktır.
    • Guguklu Filtreye dayalı eşleştirme ve bir yer kaplar.
    • Yeni teknikler kullanılarak seyrek modellerin diferansiyel gizli (DP) eğitimi Örneğin, DP Dönüşümlü Minizasyon gibi (ayrılantılarla ilgili konum verileri) ve model kişiselleştirmeyi de kullanabilirsiniz.

Geliştirici Önizlemesi 9

Yayın tarihi: 15 Ağustos 2023

Bilinen sınırlamalar

  • Teklif Verme ve Açık Artırma API'sinin çağrılmasıyla oluşturulan açık artırma verileri silinmez otomatik olarak oluşturulur.
  • İzin olduğunda getAdSelectionData ve persistAdSelectionResult aranıyor işlemi iptal etti.
  • Negatif filtreleme özelliği getAdSelectionData ile çalışmaz ve persistAdSelectionResult.

Protected Audience API

Attribution Reporting API

  • Bu sürüm, Attribution Reporting API için hata ayıklama raporlarını şu şekilde iyileştirir:
  • Reklam teknolojileri, farklı raporlama senaryoları için gürültü parametrelerini yapılandırabilir.
  • Bu sürüm, kaynak tabanlı ilişkilendirmeye taşınıyor. Bu durum:
    • Kaynak, kayıt için kullanılır.
    • Tek bir site altında birden fazla kaynak kabul edilir.
    • Kaynak uygulama veya kayıt başına bir kaynak şeklinde yeni bir oran sınırı.
  • Reklam teknolojileri artık İlişkilendirme Raporları kullanımını test etmek için kaydı devre dışı bırakabilir vakaları yerel olarak gösterir.

SDK Çalışma Zamanı

  • SDK yalnızca izin verilen hizmetleri başlatabilir veya izin verilenler listesine bağlanabilir.
  • SDK, ContentProvider sisteminin yalnızca bir alt kümesine erişebilir (ör. (com.android.providers.settings.SettingsProvider olarak) yayınlanan, tanımlayıcı içermez ve kullanıcının parmak izini oluşturmak için kullanılamaz. Bu kontroller, ContentResolver kullanılarak ContentProvider hizmetine erişim için de geçerlidir.
  • SDK, yalnızca korunan yayın alıcılarının bir alt kümesine (ör. android.intent.action.AIRPLANE_MODE olarak).
  • SDK, başka bir uygulamaya ait etkinlikleri başlatabilir ancak bazı durumlarda Intent'e neyin gönderilebileceğini anlatacağım.

Android'de Özel Korumalı Alan Mart 2023 Beta güncellemesi

Android'de Özel Korumalı Alan Beta'nın Mart 2023 sürümünde güncellemeler var kullanıma sunduk. Bu sürüm şunları içerir: Reklam Hizmetleri Uzantıları 5 API'leri ve işlevsel olarak Geliştirici Önizlemesi'ne benzer 6.

Bilinen sınırlamalar

  • FLEDGE özelini güncellemek için düzenli olarak çalışan arka plan getirme işi kitleler sürecin çökmesine neden olur. Bu sorun nedeniyle FLEDGE varsayılan olarak devre dışıdır.

Genel (General)

  • Bu sürüm itibarıyla Attribution Reporting API'yi kullanabilirsiniz. API önceki daha önce devre dışı bırakılmış. Daha önce Attribution Reporting API'yi kullandıysanız Beta sürümü, bu Beta sürümünü kullanmadan önce uygulama veya cihaz verilerinizi temizleyin aşağıdaki adımlardan birini uygulayın:
  • İlişkilendirme Raporları artık hata ayıklama anahtarlarını destekliyor. Bu sayede geliştiriciler İlişkilendirme'den değiştirilmemiş raporlar ve gizliliği geliştirilmiş raporlar alabilir API'ye gidin. Hata ayıklama anahtarları, uygulamanızın performansını nasıl Özel Korumalı Alan'a geçişiniz sırasında raporların yapılandırıldığını unutmayın.
  • İlişkilendirme raporlarında yakın zamanda reklam ile ilgili bir hata oluştu registerSource ve registerTrigger değerlerinin başarısız olacağı hizmetler istisnalar olabilir. Geliştirme sırasında bu sorunları yaşadıysanız bir düzeltme ve bu sorunların zaman içinde çözülecektir.
  • Topics API önizleme işlevi artık Android Geliştirici Önizlemeleri. Topics API çağrısı, konuları haftalık dönem hesaplamasına konu alma çağrısı dahil arayan için gözlemlenen konuların listesini etkiliyor. Daha fazla bilgi için shouldRecordObservation alanına bakın.

  • Android'de FLEDGE'de testi etkinleştirmek için Beta sürümüne kaydolun oturum açın ve hesabınızda oturum açmak için aynı Google Hesabı'nı test cihazları. Aksi takdirde, API'leri çağırma girişimleri "Hizmet kullanılamıyor" ifadesini içeren IllegalStateException mesajını alırsınız. FLEDGE sonraki Beta sürümde eski haline getirilmelidir.

    Bu arada, Geliştirici Önizlemeleri'ni kullanarak test yapmaya devam edebilirsiniz. ve FLEDGE aşağıdaki özelliklere sahip cihazlarda manuel olarak etkinleştirilebilir: dikkat edilecek noktalar:

    FLEDGE'i aşağıdaki adb komutlarıyla etkinleştirebilirsiniz. Ancak bu durum, arka planda getirme işleminin kilitlenmesine neden olur. Bu da sistem sağlığını olumsuz etkiler. kullanabilirsiniz. Söz konusu değerler platformu.

    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

Geçmiş sürümler

Geliştirici Önizlemesi 8

Yayın tarihi: 23 Mayıs 2023

Bilinen sınırlamalar

  • Ancak Protected Audience'a WIN türünde sıklık sınırı filtreleri eklenebilir WIN türü henüz desteklenmemektedir ve bu tür filtreler için yoksayıldı.
  • Kazanan gösterimleri, Protected Audience'ın kazanan alıcılarına bildirmek için özel Korumalı Alan'a kayıtlı olması gerekir. Bu şart geçersiz kılınamaz.
  • Özel Korumalı Alan'a sahip bir cihazda Özel Korumalı Alan ayarlarına erişmek için varsa Ayarlar > Google > Reklamlar > Özel Korumalı Alan.
  • Android Studio Giraffe'da emülatörlerle proje dağıtılamıyor. Diğer sürümler Android Studio'nun özellikleri sorunsuz çalışır. Android Studio'da bir düzeltme kullanıma sunulacaktır. 26 Mayıs 2023'teki zürafa.

Protected Audience API

Attribution Reporting API

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 şekilde yeniden adlandırıldı JavaScript yöntemleri:
    • 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üm, mevcut selectAds geçersiz kılma değerini selectAds sonucu karşılaştırmak için AdSelectionFromOutcomeConfig. Bu durumda, şelale uyumlulaştırması çalıştırmak için bu API'den yararlanan reklam teknolojisi SDK'larıdır. Diğer ayrıntılar geliştirici kılavuzunda özetlenmiştir.
  • selectAds() API artık teklif verme ve puanlama mantığı için önbelleğe almayı destekliyor. Reklam seçimi sırasında getirilen JavaScript.
    • Önbellek,Cache-Control tek bir sunucuyu tanımlamak için kullanılır. Şunlar için no-cache veya no-store kullanın: JavaScript yanıtlarının önbelleğe alınmasını ve önbellek süresi.
    • Mevcut önbellek girişi (max-age) varsayılan olarak iki gün olarak ayarlandı.

Android API'de İlişkilendirme Raporları

İlk Beta sürümü, Ocak 2023

Yayın tarihi: 9 Ocak 2023

Android Beta 1'de Özel Korumalı Alan, Gizlilik politikasının ilk kullanılabilirliğini temsil ediyor Korumalı alan API'lerini herkese açık cihazlarda kullanıma sunar ve aşağıda listelenen alanlarda iyileştirmeler yapılmasını sağlar.

Genel (General)

  • Android Beta 1'deki Özel Korumalı Alan, işlevsel olarak Geliştirici Bazı ek özellikler ve sınırlamalarla birlikte Önizleme 5 aşağıda listelenmiştir.
  • Geliştiriciler, reklamlarla alakalı reklamları kullanmak için bir kayıt işlemi tamamlamalıdır. API'ler (Topics, FLEDGE ve Attribution Reporting dahil). Kayıt işlem, geliştirici kimliğini doğrular ve gerekli geliştiriciye özel verileri toplar. yardımcı oluyorum.
  • Şu anda Android'deki Özel Korumalı Alan Beta 1 sürümünde izin verilenler listesine kaydolup gönderilen ayrıntılar bu fırsattan yararlanabilir kendi fiziksel cihazlarında test etmesini sağlar. Şuradaki kararlı API'lere göre geliştirme yapmak için: sürümünü edinmek için yeni SDK Reklam Hizmetleri Uzantıları 4'ü indirin.

Topics API

Attribution Reporting API

  • İlişkilendirme Raporları devre dışı bırakılmıştır ve bu kullanabilirsiniz. Bu API'ye erişim bir sonraki Beta sürümünde yeniden etkinleştirilecektir. Geliştirici Önizlemeleri ile test yapmaya devam etmeniz önerilir.

SDK Çalışma Zamanı

Gelecek büyük Android sürümünde aşağıdaki sınırlamaların düzeltilmesi bekleniyor platform sürümü:

  • RecyclerView gibi kaydırılabilir bir görünümde reklam oluşturma şu anda yapıyor düzgün çalışmaz. Öğe yeniden boyutlandırılırsa olumsuzlukla karşılaşabilirsiniz. Kullanıcı Dokunma kaydırma etkinlikleri çalışma zamanına düzgün bir şekilde iletilmez.
  • WebView oluşturma işlemi, SDK Çalışma Zamanı işleminde kullanılamaz.
  • SDK başına depolama alanı kullanılamıyor.
  • getAdId ve getAppSetId API'leri için destek henüz etkinleştirilmemiştir.

Geliştirici Önizlemesi 6

Yayın tarihi: 31 Ekim 2022

Android Developer Preview 6'daki Özel Korumalı Alan, şu alanlarda:

Genel (General)

  • Üretime sunuma hazırlanmak için Geliştirici Önizlemesi 6'da bir işaret kullanıma sunuldu varsayılan olarak gizliliği koruyan API erişimini devre dışı bırakın. Test amacıyla, Geliştirici Önizlemesi'nde şu komutu kullanın:

    adb shell device_config put adservices global_kill_switch false

  • AdIdManager ve AppSetIdManager API'leri için Google Play Hizmetleri gerekir Sürüm 22.36.16 veya daha yeni bir sürüme sahip olmanız gerekir.

    • Android destekli bir cihazda, doğru sürümün Ayarlar > Uygulamalar > Google Play Hizmetleri.
    • Google Play hizmetlerini doğru sürüme güncellemeniz gerekiyorsa oturum açın . Sonra gidin Google Play Store > profil simgesi > Ayarlar > Hakkında. Play Store sürümü başlığında Play Store'u güncelle'ye dokunun.
    • Bu adım yalnızca geliştirme ve test için geçerlidir ve gerekli olduğunu açıkladık.

Topics API

  • getTopics adlı uygulamanın bir gözlemcidir.
  • GetTopicsRequest sınıfı için başlatma kodunda küçük değişiklikler yapıldı.
  • 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ınmıştır. Cihazınızı yapılandırmak için lütfen bu adımları uygulayın. Bu adımlar örnek uygulama.
  • Zarar Veren Değişiklikler:
    • Parametrelerdeki Url, Uri ile değiştirildi. Bu, tüm FLEDGE API'leri ve özel JavaScript'i kullandığınızdan emin olun.
    • owner alanı, Özel Kitle API'si girişlerinden kaldırıldı.
  • Tamamlanmamış özel kitleler artık arka plan için hemen uygun sayfayı yenileyin.
  • JavaScript bellek sınırı 10 MB olarak ayarlandı. Bu, teklif verme ve puanlama mantığıyla başlayalım.

Attribution Reporting API

  • Reklam teknisyenlerinin İlişkilendirme raporlarını kullanabilmek için kaydolması gerekir Geliştirici Önizlemesi'ndeki API 6. Görüntüleyin Daha fazla bilgi için Özel Korumalı Alan hesabına kaydolun.
  • Bu sürümde sunulan hata ayıklama anahtarları, geliştiricilerin değiştirilmemiş raporlar ve İlişkilendirme'den alınan gizliliği geliştirilmiş raporlar Raporlama API'si. Hata ayıklama anahtarları, Google Haritalar'daki tüm bilgileri Özel Korumalı Alan'a geçiş sırasında raporların nasıl yapılandırılacağını öğreneceksiniz.

Geliştirici Önizlemesi 5

Genel (General)

  • Geliştirici Önizlemesi 5'te Özel Korumalı Alan API'lerine erişmeden önce öncelikle API'leri etkinleştirmeli ve API'ye özel izinleri yapılandırmalısınız.
    • Android'de Ö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 olduğundan emin olun. Bu ayarlar, Geliştirici Önizlemesi 5'te varsayılan olarak devre dışı olacak şekilde ayarlanmıştır. Siz bir adb komutu kullanarak API erişimini etkinleştirebilir.
    • Arayan uygulamanın, manifest dosyasında API'ye özel izinleri belirtmesi ve yerleştirilmiş SDK'lara erişimi kontrol eden ilgili AdServices yapılandırmaları.
  • Uygulamalar ön planda çalışırken gizliliği korumaya yönelik API'leri çağırmalıdır.
  • AdIdManager ve AppSetIdManager şu anda kullanılamıyor. Kendisi sonraki bir sürümde etkinleştirilecektir.

SDK Çalışma Zamanı

  • sendData(), ilerideki bir sürümde kullanımdan kaldırılacaktır.
  • loadSdk(), iki yönlü iletişimi kolaylaştırmak için artık bir IBinder nesnesi döndürüyor Bu özelliği, çalışma zamanı etkin SDK ile AIDL'de tanımlanan uygulamalar arasında birleştirin.
  • Uygulamalar, çalışma zamanı etkin SDK yaşam döngüsü etkinliklerine erişebilir. Örneğin, SDK işleminin sonlandırılması.

Attribution Reporting API

Bu sürüm, Attribution Reporting API'deki ek özellikleri kullanıma sunar. şunları içerir:

  • Ş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 bir parçası / Attribution-Reporting-Register-Source
    • Tetikleyici: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data ve Attribution-Reporting-Register-Aggregatable-Values adlı kullanıcılar isimli tek bir üstbilgide birleştirilir. Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects hâlâ ayrı bir başlıktır

Android API'de FLEDGE

Bu sürüm, birkaç yeni özellik ve iyileştirmenin yanı sıra değişiklikler:

  • Zarar veren değişiklikler:
    • runAdSelection(), selectAds() olarak yeniden adlandırıldı.
    • parametresi AdSelectionConfig.Builder.setAdSelectionSignals() Bir JSON nesnesini temsil eden AdSelectionSignals.
    • String kullanımı, reklam teknolojisi alıcısını/satıcısını temsil etmek için değiştirildi AdTechIdentifier nesnesini tanımlayın.
    • Şunun için TestCustomAudienceManager ve TestAdSelectionManager sınıf eklendi: uzaktan JavaScript getirmeyi geçersiz kılma.
    • Özel kitlenin sahibinin, arama uygulaması.
  • FLEDGE API'leri artık arayan uygulamasını bir dizi kısıtlamaya göre doğrular ve geliştirici kılavuzunda açıklanan sınırlamalara tabidir. Bu alanlar: bazı önemli örneklere göz atalım.
    • Şu süreden sonra selectAds ve reportImpression için artık yürütme süresi sınırları var: Böylece arama sonlandırılır.
    • selectAds ve reportImpression için kullanılan bellek sınırı var yardımcı olur. Bellekte, API'ler hata verdiğinden tüketim yapılandırılmış sınırları aşıyor.
    • selectAds ve reportImpression artık AdSelectionConfig özelliğini doğruluyor nesnesini açıklamaya çalışın. Satıcı alanında kullanılan eTLD+1 altında.
    • AdServices artık özel kitleleri oluşturma sırasında doğruluyor. Bazı son geçerlilik tarihinin geçerli olduğundan ve geçerli olduğundan emin olmak için oluşturabileceği özel kitle sayısını ve bu kitlenin toplam boyutunu joinCustomAudience görüşmesinde sağlanan reklamlar. Doğrulama işlemi de sinyalleri ve teklif mantığı alımı için sağlanan URI'ların ve arka plan getirme işlemlerinin tümü alıcının alanı kapsamındadır.
  • Özel kitle meta verileri, arka plan getirme işlemiyle her gün güncellenir işlemi hakkında daha fazla bilgi edinin.
  • Özel kitleler "sahip" olarak kaldırılır uygulama kaldırılır.
  • Güvenilir Puanlama Sinyallerini ve Güvenilir Teklif Verilerini belirtmek için destek eklendi dikkat edin. Yanıt biçimi için kod örneğine bakın.
  • Android API'leri için FLEDGE, WebView 105.0.5195.58 veya sonraki bir sürüme bağlıdır. Ayrıntılar için geliştirici kılavuzundaki kurulum bilgilerine bakın.

  • Bilinen Sorunlar:

    • Özel bir kitleye katıldığınızda platform şu anda iyi performans göstermiyor meta veriler veya AdData değerlerinden herhangi biri varsa hemen arka plan güncellenir boş veya null. Özel kitle reklam yayınlamaya uygun olmayacak güncellenene kadar seçimlerinizi tekrarlar. Gelecekteki bir sürümde Tamamlanmamış özel kitleleri arka planda getirme için hemen uygun hale getirme güncellemelerine göz atın. JavaScript yürütmesi için geçerli varsayılan bellek sınırı: çok düşük ve normal iş yüklerinin JavaScript'in çökmesine neden olabilir. cihazlar. JavaScript yürütmeniz, hata mesajı: "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Uygun bellek eşiğini yapılandırarak bu sorunu manuel olarak çözebilirsiniz şu komutla kullanın:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • Zorunlu 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üne sahip SDK APK'ları oluşturma desteği sunar. SDK Çalışma Zamanı Geliştirici Kılavuzu güncellendi ve Özel Korumalı Alan GitHub'daki örnek uygulamalar bu güncellemeyi yansıtır.

Geliştirici Önizlemesi 4

Yayın tarihi: 14 Temmuz 2022

Android Geliştirici Önizlemesi 4'teki Özel Korumalı Alan, şu alanlarda:

SDK Çalışma Zamanı

  • Uygulamalar artık çalışma zamanı etkin SDK'larla (RE-SDK'lar) sendData() eklendi.
  • Yerel depolama alanı artık SDK Çalışma Zamanı işleminde kullanılabilir.
  • Bir SDK, SDK'da bağımsız video tabanlı reklamlar veya içerik de oluşturabilir Çalışma zamanı.
  • Yansıma kullanımı ile ilgili açıklamalar eklendi ve yansıtması gerekmez.

Attribution Reporting API

Bu sürümde, İlişkilendirme özelliğinin daha net bir şekilde kullanılmasına yönelik değişiklikler yapıldı. Reporting API, ö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, kaynağı ve kodu açıklamak için açıklamalar eklendi. kaydın yanı sıra gizlilik ve izin API kullanılabilirliği.

Android API'de FLEDGE

Bu sürüm, test ve hata ayıklamaya yardımcı olacak yeni özelliklerin yanı sıra olduğunu söylüyor:

  • JavaScript mantığı almak için uzak URL'leri geçersiz kılma desteği eklendi yardımcı olur.
  • Reklam seçimi sırasında hata raporlama özelliği iyileştirildi.
  • Etkin olmayan özel kitleler artık reklam seçimi sırasında filtrelenir.

Topics API

Bu sürümde, Topics API'de yapılan birçok önemli değişiklik yer almaktadır. Daha da önemlisi:

  • getTopics() API'nin dönüş türü yeni olarak değiştirildi Şuna karşılık gelen tam sayı kimliklerini içeren Topic nesne türü: Sınıflandırmadaki konular, sınıflandırıcı ve sınıflandırma hakkında bilgiler sürümleri vardır. Bu API'yi kullanan mevcut tüm uygulamaları güncellemelisiniz.
  • Topics API için artık yeni bir normal izin gerekiyor.
  • "Cihaz Üzerinde Sınıflandırıcı"nın kullanıma sunulması otomatik olarak atanacak sisteme Herkese açık uygulama bilgilerine dayanan konular.

Bilinen sorunlar

  • Bu cihaz resimlerinin ilk sürümü (düzeltme 6) şurada yüklenmiyor: Android Emulator sürüm 31.2.10. Şu sorunu ele alan güncellenmiş cihaz resimleri: 27 Temmuz 2022 itibarıyla kullanıma sunulmuştur.

Geliştirici Önizlemesi 3

Yayın tarihi: 9 Haziran 2022

Android Geliştirici Önizlemesi 3'teki Özel Korumalı Alan, Android'de Attribution Reporting API ve FLEDGE.

Attribution Reporting API

Attribution Reporting API, üçüncü taraf kullanıcı tanımlayıcılarını kullanır ve ilişkilendirme en iyi uygulamaları paylaşacağız.

Bu sürüm, aşağıdakileri test etmenize yardımcı olacak geliştirici kaynakları içerir: Attribution Reporting API özellikleri:

  • İlişkilendirme kaynağını ve tetikleyici etkinlikleri kaydedin
  • Kaynak öncelikli ve yükleme sonrası ilişkilendirme alıştırması yapma
  • Etkinlik raporları alma
  • Bu sürümde şifrelenmemiş, toplanabilir raporlar alın

Teste yardımcı olması için örnek bir uygulama ve referans reklam teknolojisi sunucusu sağlanmıştır

Bilinen sorunlar:

Android'de FLEDGE

Android'de FLEDGE, özel kitlelere göre reklam göstermenin yeni bir yolunu sunuyor arasındaki etkileşimlerden kaynaklanır. Bu çözüm bilgileri ve ilişkili reklamları yerel olarak depolar ve reklamverenlerin bu hedefe Reklam seçimi iş akışlarını düzenleme.

Bu sürüm, aşağıdaki FLEDGE'i test etmenize yardımcı olacak geliştirici kaynakları içerir şu özellikleri deneyin:

  • Özel bir kitleye katılın veya özel bir kitleden ayrılın ve parametre değerlerinin nasıl etkileyebileceğini gözlemleyin açık artırma sonuçları
  • Uzak uç noktalardan JavaScript açık artırma kodu getir
  • 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 kitle, reklam seçimi başlamadan önce bile unutmayın.

Geliştirici Önizlemesi 2

Yayın tarihi: 17 Mayıs 2022

Geliştirici Önizlemesi 2, MeasurementManager ilişkilendirme raporlama API'leri.

  • Kaydolmak için registerSource() ve registerTrigger() numaralı telefonu arayabilirsiniz Uygulama reklamı etkinlikleri ve uygulamadan uygulamaya geçiş için etkinlik düzeyinde raporlama verileri alma ilişkilendirmesine yardımcı olur. Mevcut uygulamamızda son temasla ilişkilendirme kullanılmaktadır. Raporların, raporlarda tanımlandığı şekilde gönderilmek üzere planlanır. pencerelerini inceleyin. MeasurementManager API'yi inceleyin daha fazla bilgi için.

  • Asıl rapor yükleme işlemi, sabit zaman aralıklarının sonunda gerçekleşir. bir saat olabilir. Raporlama yükleme aralığı varsayılan olarak 4 saattir, ancak aşağıdaki adb ile geçersiz kılınabilir komut:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • API'leri test etmek için örnek bir uygulama ve referans reklam teknolojisi sunucusu gelecekteki bir sürümde yayınlanması gerekir.

  • Diğer MeasurementManager Attribution Reporting API toplu raporlama, yükleme sonrası ilişkilendirme ve yönlendirmeler gibi özellikler sonraki bir sürümde yer alacaktır.

Geliştirici Önizlemesi 1

Yayın tarihi: 28 Nisan 2022

Geliştirici Önizlemesi 1, Topics API'nin ilk önizlemelerini içerir ve SDK Çalışma Zamanı. Android'de FLEDGE ve Attribution Reporting API'leri kullanıma sunulması planlanıyor.

  • Topics API
    • getTopics() API şu anda çevrimdışı verilere dayalı test değerleri döndürüyor . Cihaz üzerinde sınıflandırmalar yerine getirilmemiştir.
    • Epoch aralıklarını geçersiz kılmak ve zorla tetikleyiciyi geçersiz kılmak için adb komutlarını kullanabilirsiniz dönem hesaplaması.
    • Ayrıntılar için Topics geliştirici kılavuzunu okuyun.
  • SDK Çalışma Zamanı
    • Çalışma zamanı özelliğinin etkin olduğu SDK'ları (RE SDK'ları) yeni SDK uygulamanızın manifest dosyasında <sdk-library> öğesi. RE SDK'larını yükleyin yüklediğiniz gibi, desteklenen bir test cihazında veya emülatörde sürekli olarak kullanır.
    • Bir uygulamayı RE SDK'larıyla entegre edip SDK Çalışma Zamanı'na yükleyebilirsiniz. ve kısıtlı erişimin SDK kodu üzerindeki etkisini test etmek ve uygulamadan SDK'ya iletişim kurmanızı sağlar. RE SDK'ları için depolama API'leri ve gelecekteki bir sürümde kullanıma sunulacaktır.
    • Bir SDK, WebView tabanlı banner reklamları veya içeriği SDK Çalışma Zamanı.
    • Daha fazla bilgi için SDK Çalışma Zamanı geliştirici kılavuzunu inceleyin.
  • Android lint kontrolleri
    • Android lint kontrolleri, derlenen projelerde yanlışlıkla uyarı gösterebilir TiramisuPrivacySandbox API düzeyiyle gerçekleştirilir. Örneğin, bir hafta içinde uyarı mesajı: "Çağrı, API düzeyi 33 gerektirir". Geçici olarak @SuppressLint("NewApi") ek açıklamasını kullanarak bu sorunu çözebilirsiniz.