Android için Özel Korumalı Alan'ı kullanmaya başlama

Android'de Özel Korumalı Alan Beta programı, kararlı API'ler sağlar. 2023 boyunca birkaç Beta sürümü planlıyoruz. Android 13 mobil cihazlarda sınırlı üretim testi için çözümler oluşturup test etmek amacıyla Beta programı sürümlerini kullanabilirsiniz. Cihazların küçük bir yüzdesini desteklemeye başlayıp zamanla bu sayıyı artıracağız. Katılmak isteyen kuruluşlar sınırlı sayıda cihaza erişim isteğinde bulunabilir ve Özel Korumalı Alan API'lerini kullanan tüm uygulamaları kaydedebilir.

SDK Çalışma Zamanı için geliştiricilerin, belirli uygulamalara Çalışma Zamanı özellikli SDK dağıtımını test etmeleri amacıyla kapalı Beta'mız mevcuttur.

Beta sürümünü kullanmak için geliştiricilerin çözümlerini bir API düzeyi 33 SDK uzantısı güncellemesi ile derlemesi gerekir.

Android SDK Uzantıları

Beta sürümlerindeki kararlı API'ler, yeni Android SDK Uzantıları sürüm yöntemi kullanılarak yayınlanır. Bu yayınlama yöntemi, kararlı Android özelliklerinin ana sürümler arasında yayınlanmasını sağlar. Bu araç, Google Play sistem güncellemelerini kullanarak yeni API'leri uygulamalara birden fazla API düzeyinde sunan yeni bir sürüm oluşturma mekanizmasına sahiptir. Android SDK'sında Özel Korumalı Alan uzantısı, Reklam Hizmetleri Uzantıları olarak adlandırılır. Android SDK Uzantıları hakkında daha fazla bilgi edinin.

Başlayın

Başlamak için aşağıdaki adımları uygulayın:

1. Adım: Beta programına kaydolun ve kaydolun

  • Kaydolma: Reklamlarla ilgili API'leri kullanmak için kayıt işlemini tamamlayın.
  • Kaydolma: Beta programına katılmak için register gerekir. Kaydolarak şunları yapabilirsiniz:
    • Dahili test amacıyla kendi cihazlarınızı etkinleştirin.
    • Google Play Store'da, gizliliği korumaya yönelik API'leri doğrudan entegre edebilecek veya API'leri kullanan SDK çözümlerini entegre edebilecek sınırlı sayıda yayınlanmış uygulama belirtin.
    • Google Play Store'u kullanarak çalışma zamanı özellikli SDK dağıtımını test edin. Yalnızca cihazda SDK Çalışma Zamanı'nı test etmeniz gerekiyorsa bu adım gerekli değildir.

2. Adım: Geliştirme ortamınızı ayarlayın

Android Studio'da, Android SDK'sında Özel Korumalı Alan'ı ayarlayın.

3. Adım: AdServices izinlerini yapılandırın

Hedeflenen API tarafından yönetilen kaynaklara API'ye özel izinler tanımlayın ve SDK erişimini yapılandırın.

4. Adım: Bir cihaz veya emülatör görüntüsü ayarlayın

Uçtan uca test gerçekleştirmek için desteklenen bir Android 13 cihazla etkileşimde bulunmanız veya uygun SDK Uzantısı için emülatör resmi kullanmanız gerekir.

5. Adım: Cihazları Android'de Özel Korumalı Alan'ı kullanacak şekilde yapılandırın

Android'de Özel Korumalı Alan'ın cihazlarda çalıştırılmasını etkinleştirmek (veya devre dışı bırakmak) için ayarları yapılandırın.

Bilinen sorunları giderme

Android 12 ve önceki sürümlere sahip cihazlarda reklam hizmetleri API'leriyle entegrasyon yapan geliştiriciler, Android 12 ve önceki sürümlerde PP API Entegrasyonu ile ilgili bilinen sorunları önlemek için aşağıdakileri yapmalıdır:

  1. İstemci uygulamasının manifest dosyasında <uses-library> extservices etiketinin bulunduğunu doğrulayın. İlgili etiket aşağıdaki gibidir:
<uses-library
  android:name="android.ext.adservices"
  android:required="false" />
  1. androidx.privacysandbox.ads jetpack kitaplığını kullanıyorsanız 1.1.0-beta05 veya sonraki bir sürümü kullandığınızdan emin olun.

Hangi geliştirici kaynakları kullanılabilir?

Android'deki Özel Korumalı Alan Beta programı, aşağıdaki araçları ve kaynakları içerir.

SDK ve emülatör sistem görüntüleri

Android Studio'yu kullanarak SDK Yöneticisi üzerinden en yeni Reklam Hizmetleri Uzantısını ve emülatör sistem resimlerini indirebilirsiniz. Geliştirme ortamınızı kurma ve API erişimini ayarlama hakkında daha fazla bilgi edinin.

API Referansı

API referansının tamamı kullanılabilir.

Destek ve geri bildirim

Android'de Özel Korumalı Alan ile test ve geliştirme yaparken sürüm notlarını inceleyin ve sorunları bildirip geri bildirimde bulunmak için sorun izleyiciyi kullanın.

Geliştirme ortamınızı güncel tutun

Geliştirme ortamınızı en son sürümle güncel tutmanızı önemle tavsiye ederiz. Bu, en yeni özelliklere ve güvenlik yamalarına sahip olmanızı ve ortamınızın bağımlılıklarınızın en yeni sürümleriyle uyumlu olmasını sağlar. Yeni sürümlerden haberdar olmak için e-posta güncellemelerine kaydolun.