Android'de Özel Korumalı Alan dokümanlarını okurken, çalıştığınız program sürümünü seçmek için Geliştirici Önizlemesi veya Beta düğmesini kullanın. Talimatlar farklılık gösterebilir.
API'ye özel izinleri bildirmek ve hedeflenen API tarafından yönetilen kaynaklara SDK erişimini yapılandırmak için aşağıdaki talimatları uygulayın.
AdServices API'ye özel izinleri bildirme
Her PPAPI'ye erişim için Reklam Hizmetleri normal izni gerekir. Manifestinizde, uygulamanızda veya SDK'nızda gereken API'lere karşılık gelen uygun erişim izinlerini beyan edin.
Attribution Reporting API:
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_ATTRIBUTION" />
Attribution Reporting API (hata ayıklama raporlarıyla):
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_ATTRIBUTION" />
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_AD_ID" />
Protected Audience / özel kitle API'si:
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_CUSTOM_AUDIENCE" />
Topics API:
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_TOPICS" />
İsteğe bağlı olarak, Attribution Reporting API ile hata ayıklama raporları almak için AD_ID iznini ekleyin:
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_AD_ID" />
Projenizin modül veya SDK'lara bağımlılığı varsa manifest dosyalarında gerekli Reklam Hizmetleri izinlerini zaten beyan etmiş olabilirler. Varsayılan olarak Gradle derlemesi, tüm manifest dosyalarını uygulamanızda paketlenmiş tek bir manifest dosyasında birleştirir. Doğru izinlerin kullanıldığından emin olmak için Birleştirilmiş Manifest görünümünü kullanın.
SDK'lar gibi bağımlılıklar üzerinden herhangi bir iznin uygulamanızla birleştirilmesini engellemeniz gerekiyorsa belirli izinler için remove düğüm işaretçisini ekleyin. Aşağıdaki örnekte Topics izninin birleştirilmesinin nasıl önleneceği gösterilmektedir.
<uses-permission android:name="android.permission.ACCESS_ADSERVICES_TOPICS"
tools:node="remove" />
API'ye Özel Reklam Hizmetlerini yapılandırma
PPAPI erişim izinlerine benzer şekilde, her API'nin reklam hizmetleri yapılandırmasında karşılık gelen bir girişi vardır. Bu yapılandırma, uygulamanızdaki API'ler veya yerleştirilmiş SDK'lar tarafından yönetilen kaynaklara ayrıntılı kontrol erişimi sağlar. Manifestinizde, aşağıdaki örnekte gösterildiği gibi bir adservicesConfig özelliği belirtin:
<application ...>
...
<property android:name="android.adservices.AD_SERVICES_CONFIG"
android:resource="@xml/ad_services_config" />
...
</application>
Manifest'te başvurulan reklam hizmetleri XML kaynağını belirtin (ör. res/xml/ad_services_config.xml). Uygulamanız için geçerli olan ve gizliliği korumaya yönelik her API (veya yerleştirilmiş SDK) için allowAllToAccess özelliğini true olarak ayarlayarak tüm çağrıcılara erişim izni verin.
Alternatif olarak, her bir reklam teknolojisine ayrıntılı API erişimi vermek için allowAdPartnersToAccess özelliğini kullanabilirsiniz. Kayıt yoluyla elde edilen geliştirici kayıt hesabı kimliklerinin listesini sağlamanız gerekir. allowAllToAccess özelliği true olarak ayarlanırsa bu özellik, allowAdPartnersToAccess özelliğinde belirtilen tüm kayıt hesabı kimliklerine göre öncelikli olur.
Ayrıca reklam teknolojisi platformları, uygulama müşterilerinin gizliliği korumaya yönelik gerekli API'lere reklam hizmetleri yapılandırmasında düzgün şekilde erişim izni verdiğinden emin olmalıdır.
Aşağıdaki örnekte, gizliliği korumaya yönelik tüm API'lere herhangi bir kayıt hesabı kimliği erişimine izin vermek için geniş erişimin nasıl belirtileceği gösterilmektedir:
<ad-services-config>
<!-- Attribution API -->
<attribution allowAllToAccess="true" />
<!-- Topics API -->
<topics allowAllToAccess="true" />
<!-- Protected Audience on Android API -->
<custom-audiences allowAllToAccess="true" />
</ad-services-config>
Aşağıdaki örnekte, belirli kayıt hesabı kimlikleri için her bir gizliliği koruyan API'ye ayrıntılı erişimin nasıl belirtileceği gösterilmektedir:
<ad-services-config>
<!-- Attribution API -->
<attribution allowAdPartnersToAccess="ENROLLMENT-ID" allowAllToAccess="false" />
<!-- Topics API →-->
<includes-sdk-library name="ENROLLMENT-ID" />
<topics allowAdPartnersToAccess="ENROLLMENT-ID" allowAllToAccess="false" />
<!-- Protected Audience on Android API -->
<custom-audiences allowAdPartnersToAccess="ENROLLMENT-ID" allowAllToAccess="false" />
</ad-services-config>