Komut satırında özel kitleleri inceleme

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 veya fetchAndJoinCustomAudience kullanılarak) beyan edilir
  • Uygulama tarafından önerilen reklamlar için izin açıldı

Adservices kabuk komutlarını etkinleştirme

  1. adservices işlemini sonlandırmak için cihazınızı yeniden başlatın.
  2. 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.