ÖzelKitle

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
→ Yönergeler android.adservices.customaudience.CustomAudience

Özel bir kitlenin reklam seçiminde yer alması için gereken bilgileri temsil eder.

Özel kitle, benzer ilgi alanlarına sahip kullanıcılardan oluşan soyut bir gruptur. Bu sınıf, tek bir özel kitleyi hedefleyen reklamlar yayınlamak için gerekli olan ve bir cihazda depolanan bazı verilerin koleksiyonudur.

Özet

İç içe yerleştirilmiş sınıflar

class CustomAudience.Builder

CustomAudience nesne için oluşturucu. 

Devralınan sabitler

Fields'ın oynadığı filmler

public static final Creator<CustomAudience> CREATOR

Herkese açık yöntemler

boolean equals(Object o)

İki CustomAudience nesnesinin aynı bilgileri içerip içermediğini kontrol eder.

Instant getActivationTime()

CustomAudience nesnesinin oluşturulmasıyla ilgili gecikmeli bir etkinleştirme sunmak için gelecekte isteğe bağlı bir etkinleştirme süresi ayarlanabilir.

List<AdData> getAds()

Bu AdData nesne listesi, reklam seçim işlemi sırasında bu CustomAudience tarafından sunulacak reklamların tam ve eksiksiz bir listesidir.

Uri getBiddingLogicUri()

Bir özel kitle reklam seçim sürecine katıldığında teklif verme mantığını getirmek için kullanılan hedef URI'yi döndürür.

AdTechIdentifier getBuyer()

Alıcı, "buyerexample.com" biçimindeki bir alan adı tarafından tanımlanır.

Uri getDailyUpdateUri()

Bu URI, cihaz üzerinde reklam seçimi sürecinde kullanılacak güncellenmiş teklif verilerini ve reklam meta verilerini barındıran, alıcı tarafından işletilen bir sunucuyu işaret eder.

Instant getExpirationTime()

Geçerlilik bitiş süresi geçtikten sonra özel bir kitle, günlük reklam/teklif veri güncellemelerine veya reklam seçim sürecine katılmaya uygun olmaz.

String getName()

Özel kitlenin adı, CustomAudience nesnesinin oluşturulmasında sahip ve alıcı tarafından sağlanan rastgele bir dizedir.

TrustedBiddingData getTrustedBiddingData()

Güvenilir teklif verme verileri, alıcıların teklif verileri için güvenilir bir sunucuya işaret eden bir URI'den ve sunucuyu sorgulamak için kullanılacak anahtarların listesinden oluşur.

AdSelectionSignals getUserBiddingSignals()

Kullanıcı teklif verme sinyalleri, ayrı bir yürütme ortamında reklam seçimi sırasında alıcı tarafından sağlanan JavaScript tarafından kullanılması için alıcılar tarafından isteğe bağlı olarak sağlanır.

int hashCode()

CustomAudience nesnesi verilerinin karmasını döndürür.

void writeToParcel(Parcel dest, int flags)

Bu nesneyi paket haline getirin.

Devralınan yöntemler

Fields'ın oynadığı filmler

CREATOR

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public static final Creator<CustomAudience> CREATOR

Herkese açık yöntemler

eşittir

API düzeyi 34'te eklendi 
public boolean equals (Object o)

İki CustomAudience nesnesinin aynı bilgileri içerip içermediğini kontrol eder.

Parametreler
o Object: Karşılaştırılacak referans nesne.
İlerlemeler
boolean Bu nesne obj bağımsız değişkeniyle aynıysa true; aksi takdirde false.

getEtkinleştirmeTime

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public Instant getActivationTime ()

CustomAudience nesnesinin oluşturulmasıyla ilgili gecikmeli bir etkinleştirme sunmak için gelecekte isteğe bağlı bir etkinleştirme süresi ayarlanabilir. Bu alan ayarlanmazsa CustomAudience özelliği katılım sırasında etkinleştirilir.

Örneğin, etkin olmayan kullanıcılara yönelik özel bir kitle, belirli bir etkin olmama eşiğine ulaşılıncaya kadar etkinleştirilemez. Bu noktada özel kitlenin reklamları, reklam seçim sürecine katılır ve eski kullanıcıları orijinal sahip uygulamasına yönlendirir.

Etkinleştirme süresi, ilk oluşturulma tarihinden itibaren 60 gündür.

Belirtilmişse etkinleştirme zamanı, son kullanma zamanından önce bir anında olmalıdır.

İlerlemeler
Instant Instant zaman damgası, milisaniye olarak kısaltıldı ve ardından özel kitle etkin hale geldi. Bu değer, null olabilir.

Reklamları alma

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public List<AdData> getAds ()

Bu AdData nesne listesi, reklam seçim işlemi sırasında bu CustomAudience tarafından sunulacak reklamların tam ve eksiksiz bir listesidir.

Belirtilmezse veya boş bir liste sağlanırsa CustomAudience, özel kitle için günlük güncellemeyle geçerli bir reklam listesi sağlanana kadar reklam seçimine katılmaz.

İlerlemeler
List<AdData> şu anda özel kitle tarafından sunulan reklamları temsil eden AdData nesneden List tanesi Bu değer null olamaz.

Teklif VermeMiğlesiUri'si

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public Uri getBiddingLogicUri ()

Bir özel kitle reklam seçim sürecine katıldığında teklif verme mantığını getirmek için kullanılan hedef URI'yi döndürür. URI, HTTPS kullanmalıdır.

İlerlemeler
Uri alıcı teklif verme mantığını getirmek için kullanılan URI Bu değer null olamaz.

Alıcı Alma

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public AdTechIdentifier getBuyer ()

Alıcı, "buyerexample.com" biçimindeki bir alan adı tarafından tanımlanır.

İlerlemeler
AdTechIdentifier özel kitlenin alıcısının alanını içeren bir AdTechIdentifier Bu değer null olamaz.

GünlükGüncellemeUri'sini alma

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public Uri getDailyUpdateUri ()

Bu URI, cihaz üzerinde reklam seçimi sürecinde kullanılacak güncellenmiş teklif verilerini ve reklam meta verilerini barındıran, alıcı tarafından işletilen bir sunucuyu işaret eder. URI, HTTPS kullanmalıdır.

İlerlemeler
Uri özel kitlenin günlük güncelleme URI'si Bu değer null olamaz.

Son geçerlilik tarihi

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public Instant getExpirationTime ()

Geçerlilik bitiş süresi geçtikten sonra özel bir kitle, günlük reklam/teklif veri güncellemelerine veya reklam seçim sürecine katılmaya uygun olmaz. Bu özel kitle, sonraki günlük güncellemede bellekten silinir.

CustomAudience oluşturulduktan sonra geçerlilik süresi belirtilmezse geçerlilik süresi varsayılan olarak etkinleştirme tarihinden itibaren 60 gün olarak ayarlanır.

Maksimum geçerlilik süresi, ilk etkinleştirmeden itibaren 60 gündür.

İlerlemeler
Instant Instant zaman damgası, milisaniye olarak kısaltıldı. Bu tarihten sonra özel kitle kaldırılacak. Bu değer, null olabilir.

Adını Al

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public String getName ()

Özel kitlenin adı, CustomAudience nesnesinin oluşturulmasında sahip ve alıcı tarafından sağlanan rastgele bir dizedir.

İlerlemeler
String özel kitlenin Dize adı Bu değer null olamaz.

Güvenil Teklif VermeVerileri

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public TrustedBiddingData getTrustedBiddingData ()

Güvenilir teklif verme verileri, alıcıların teklif verileri için güvenilir bir sunucuya işaret eden bir URI'den ve sunucuyu sorgulamak için kullanılacak anahtarların listesinden oluşur. Anahtarların, yalnızca reklam seçimi sırasında alıcının teklif verme mantığı için güvenilir sunucuyu sorgulamak amacıyla kullanılacak rastgele tanımlayıcılar olduğunu unutmayın.

Belirtilmezse CustomAudience, özel kitle için günlük güncelleme yoluyla güvenilir teklif verileri sağlanana kadar reklam seçimine katılmaz.

İlerlemeler
TrustedBiddingData özel kitlenin güvenilir teklif verme verilerini içeren bir TrustedBiddingData nesnesi Bu değer, null olabilir.

getUserTeklifSinyalleri

API düzeyi 34'e eklendi
Ayrıca Reklam Hizmetleri Uzantıları 4'e de eklendi 
public AdSelectionSignals getUserBiddingSignals ()

Kullanıcı teklif verme sinyalleri, ayrı bir yürütme ortamında reklam seçimi sırasında alıcı tarafından sağlanan JavaScript tarafından kullanılması için alıcılar tarafından isteğe bağlı olarak sağlanır.

Kullanıcı teklif sinyalleri, alıcının JS'si tarafından kullanılabilecek geçerli bir JSON nesnesi değilse özel kitle, reklam seçimi için uygun olmaz.

Belirtilmezse CustomAudience, özel kitle için günlük güncellemeyle kullanıcı teklif sinyalleri sağlanana kadar reklam seçimine katılmaz.

İlerlemeler
AdSelectionSignals Özel kitle için kullanıcı teklif sinyallerini temsil eden AdSelectionSignals nesnesi Bu değer null olabilir.

karmaKodu

API düzeyi 34'te eklendi 
public int hashCode ()

CustomAudience nesnesi verilerinin karmasını döndürür.

İlerlemeler
int bu nesne için bir karma kod değeri.

Pakete yaz

API düzeyi 34'te eklendi 
public void writeToParcel (Parcel dest, 
                int flags)

Bu nesneyi paket haline getirin.

Parametreler
dest Parcel: Bu değer null olamaz.
flags int: Nesnenin nasıl yazılması gerektiğiyle ilgili ek işaretler. 0 veya Parcelable.PARCELABLE_WRITE_RETURN_VALUE olabilir. Değer 0 veya Parcelable.PARCELABLE_WRITE_RETURN_VALUE ile android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES birleşimidir