Komut satırında özel kitleleri inceleme

Protected Audience, android.adservices.customaudience paketi kapsamında özel kitlelere katılmak ve bu 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 CLI komutları kullanılabilir. Bu kılavuzda, reklam teknolojisi geliştiricilerin birleştirilmiş özel kitlelerinin durumunu incelemek için izlemesi gereken adımlar açıklanmaktadır.

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. Aşağıdaki koşullar geçerliyse bu komutlar kullanılarak yalnızca görünür hale getirilebilir:

• Sistem genelinde geliştirici seçenekleri etkinleştirilmiş olmalıdır.
• android:debuggable="true", CustomAudience öğesinin birleştirildiği uygulamanın AndroidManifest.xml dosyasında (joinCustomAudience veya fetchAndJoinCustomAudience kullanılarak) tanımlanıyor.
• Uygulama tarafından önerilen reklamlar için izin etkinleştirilmiş olmalıdır.

Adservices kabuk komutlarını etkinleştirme

1. adservices işlemini sonlandırmak için cihazınızı yeniden başlatın.
2. adservices simgesinin çalışmadığını onaylayın. Aşağıdaki komut için boş çıktı beklenir.

adb shell ps -A | grep adservices

Ardından, adservices kabuk komutlarını etkinleştirmek için aşağıdaki 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

Liste özel kitleleri

Belirli bir özel kitleyi görüntülemek için aşağıdaki komutu çalıştırın. Bu komutta, owner parametresini kitleyi oluşturan paket, buyer parametresini ise kitleyi yöneten reklam ağının tanımlayıcısı olarak belirtin:

adb shell cmd adservices_manager custom-audience list --owner <owner> --buyer <buyer>

Çıktı, custom_audiences dizisini içeren bir JSON nesnesi olur. Bu dizideki öğelerin yapısı, bir sonraki bölümde açıklanan viewcustomaudience komutunun çıkışıyla eşleşir.

Belirli bir özel kitleyi görüntüleme

Belirli bir özel kitleyi görüntülemek için aşağıdaki komutu çalıştırın. Bu komutta owner, kitleyi oluşturan paket, buyer, kitleyi yöneten reklam ağının tanımlayıcısı ve name, kitlenin adı olarak belirtilir:

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 günlük güncellemeyi manuel olarak tetiklemek üzere aşağıdaki komutu çalıştırın. Komutta, kitleyi oluşturan paket olarak owner, kitleyi yöneten reklam ağının tanımlayıcısı olarak buyer ve kitlenin adı olarak name belirtilmelidir:

adb shell cmd adservices_manager custom-audience refresh --owner <owner> --buyer <buyer> --name <name>
> Successfully updated custom audience.