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

Android Beta'daki Özel Korumalı Alan programı, kararlı API'ler sağlar. Tüm API'ler için Android 13 ve üzeri mobil cihazlarda ve Attribution Reporting API (ARA) için Android 12 ve üzeri sürümlerde sınırlı üretim testi için çözümler oluşturmak ve test etmek üzere Beta programı sürümlerini kullanabilirsiniz. İlk olarak cihazların küçük bir yüzdesini destekleyeceğiz ve bu sayıyı zaman içinde artıracağız. Katılımcı kuruluşlar, sınırlı sayıda cihaz için 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 uygulamalarda çalışma zamanı özellikli SDK dağıtımını test edebilecekleri kapalı bir Beta sürüm sunuyoruz.

Beta sürümünü kullanmak için geliştiricilerin, çözümlerini API düzeyi 33 SDK uzantı güncellemesiyle derlemeleri 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 sürüm yöntemi, büyük sürümler arasında kararlı Android özelliklerinin yayınlanmasını sağlar. Google Play sistem güncellemelerini kullanarak yeni API'leri birden fazla API düzeyindeki uygulamalara sunan yeni bir sürümlendirme mekanizmasına sahiptir. Android SDK'sındaki Ö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

Android için Özel Korumalı Alan'ı kullanmaya başlamak üzere aşağıdaki adımları uygulayın:

1. adım: Beta programına kaydolun

  • Kaydolma: Reklamlarla ilgili API'leri kullanmak için kayıt işlemini tamamlayın.
  • Kaydolun: Beta programına katılmak için register gerekir. Kaydolarak şunları yapabilirsiniz:
    • Şirket içi test amacıyla kendi cihazlarınızı etkinleştirebilirsiniz.
    • Google Play Store'da, gizliliği korumaya yönelik API'leri doğrudan entegre edebilen veya API'leri kullanan SDK çözümlerini entegre edebilen sınırlı sayıda yayınlanmış uygulama belirtin.
    • Google Play Store'u kullanarak çalışma zamanı etkin SDK dağıtımını test edin. Yalnızca cihaz üzerinde 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'daki Android SDK'sında Özel Korumalı Alan'ı kurun.

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

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

4. adım: Cihaz veya emülatör resmi oluşturun

Uçtan uca test yapmak için desteklenen bir Android 13 cihazıyla etkileşim kurmanız veya uygun SDK uzantısı için bir 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ışmasını sağlamak için ayarları yapılandırın.

Bilinen sorunları giderme

Android 12 ve önceki sürümleri çalıştıran cihazlarda PP API entegrasyonuyla ilgili bilinen sorunlardan kaçınmak için bu cihazların reklam hizmetleri API'leriyle entegrasyon yapan geliştiriciler aşağıdakileri yapmalıdır:

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

Hangi geliştirici kaynakları kullanılabilir?

Android Beta programındaki Özel Korumalı Alan 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 son Ad Services uzantısını ve emülatör sistem resimlerini indirebilirsiniz. Geliştirme ortamınızı ayarlama ve API erişimini ayarlama hakkında daha fazla bilgi edinin.

API Referansı

API referansının tamamına erişebilirsiniz.

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 edilir. Bu sayede en son özelliklere ve güvenlik yamalarina sahip olursunuz. Ayrıca, ortamınızın bağımlılıklarınızın en son sürümleriyle uyumlu olmasını sağlarsınız. Yeni sürümler hakkında bildirim almak için e-posta güncellemelerine kaydolun.