Protected Audience, android.adservices.customaudience paketinin bir parçası olarak özel kitlelere katılmak ve özel kitlelerden ayrılmak için bir dizi API sağlar. Hata ayıklama amacıyla özel kitleleri listelemek ve görüntülemek için kullanılabilen CLI komutları bulunur. Bu kılavuzda, reklam teknolojisi geliştiricilerin birleştirilen özel kitlelerinin durumunu incelemek için uygulaması gereken adımlar özetlenmektedir.
Kurulum
Güvenlik ve gizlilik nedeniyle, özel kitleler varsayılan olarak görünmez ve yalnızca hata ayıklama amacıyla doğrudan incelenebilir. Bu komutlar, yalnızca aşağıdaki şartlar karşılanıyorsa görüntülenebilir:
- Sistem genelinde geliştirici seçenekleri etkin
android:debuggable="true"
,CustomAudience
öğesinin birleştirildiği uygulamanın AndroidManifest.xml dosyasında (joinCustomAudience
veyafetchAndJoinCustomAudience
kullanılarak) beyan edilir- Uygulama tarafından önerilen reklamlar için izin açıldı
Adservices kabuk komutlarını etkinleştirme
adservices
işlemini sonlandırmak için cihazınızı yeniden başlatın.adservices
adlı sağlayıcının çalışmadığını onaylayın. Aşağıdaki komut için boş çıkış bekleniyor.
adb shell ps -A | grep adservices
Ardından, adservices
kabuk komutlarını etkinleştirmek için şu komutları çalıştırın:
adb shell setprop debug.adservices.adservices_shell_command_enabled true
adb shell setprop debug.adservices.fledge_is_custom_audience_cli_enabled true
Özel kitleleri listele
Belirli bir özel kitleyi görüntülemek için kitleyi oluşturan paket olarak owner
ve kitleyi yöneten reklam ağının tanımlayıcısı buyer
öğesini belirterek aşağıdaki komutu çalıştırın:
adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>
Çıkış, custom_audiences
dizisini içeren bir JSON nesnesi olur.
Bu dizideki öğelerin yapısı, bir sonraki bölümde açıklanan özel view özel kitle komutunun çıkışıyla eşleşir.
Belirli bir özel kitleyi görüntüleme
Belirli bir özel kitleyi görüntülemek için kitleyi oluşturan paket olarak owner
, kitleyi yöneten reklam ağının tanımlayıcısı buyer
ve kitlenin adı olarak name
öğesini belirten aşağıdaki komutu çalıştırın:
adb shell cmd adservices_manager custom-audience view --owner <owner> --buyer <buyer> --name <name>
Belirli bir özel kitleyi yenileme
Belirli bir özel kitle için tetikleyici günlük güncellemeyi manuel olarak görüntülemek isterseniz kitleyi oluşturan paket olarak owner
, kitleyi yöneten reklam ağı tanımlayıcısı olarak buyer
ve kitle adı olarak name
belirten aşağıdaki komutu çalıştırın:
adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.