Odbiorcy niestandardowi

public final class CustomAudience
extends Object implements Parcelable

java.lang.Object
android.adservices.customaudience.CustomAudience


Zawiera informacje niezbędne do tego, by niestandardowy segment odbiorców mógł uczestniczyć w wyborze reklam.

Niestandardowa lista odbiorców to abstrakcyjna grupa użytkowników o podobnych zainteresowaniach. Ten to zbiór danych przechowywanych na urządzeniu, które są niezbędne do wyświetlania reklam kierowane na jedną niestandardową grupę odbiorców.

Podsumowanie

Zagnieżdżone klasy

class CustomAudience.Builder

Kreator CustomAudience obiektów. 

Stałe odziedziczone

Fieldsem

public static final Creator<CustomAudience> CREATOR

Metody publiczne

boolean equals(Object o)

Sprawdza, czy 2 obiekty CustomAudience zawierają te same informacje.

Instant getActivationTime()

Po utworzeniu obiektu CustomAudience opcjonalny czas aktywacji można ustawić w w przyszłości, aby obsługiwać opóźnioną aktywację.

List<AdData> getAds()

Ta lista obiektów AdData to pełna i pełna lista reklam, które zostaną wyświetlane przez ten zasób (CustomAudience) podczas procesu wyboru reklamy.

Uri getBiddingLogicUri()

Zwraca docelowy identyfikator URI używany do pobierania danych logicznych do ustalania stawek, gdy w polu listy odbiorców procesu wyboru reklamy.

AdTechIdentifier getBuyer()

Kupujący jest identyfikowany przez domenę w postaci „kupującyexample.com”.

Uri getDailyUpdateUri()

Ten identyfikator URI wskazuje serwer obsługiwany przez kupującego, który hostuje zaktualizowane dane dotyczące stawek i metadane reklam która ma być używana w procesie wyboru reklamy na urządzeniu.

Instant getExpirationTime()

Gdy upłynie okres ważności, lista niestandardowych odbiorców nie będzie już mogła być codziennie aktualizacji danych o reklamach i stawkach ani udziału w procesie wyboru reklam.

String getName()

Nazwa listy odbiorców niestandardowych to dowolny ciąg znaków podawany przez właściciela i kupującego podczas jej tworzenia. obiektu CustomAudience.

TrustedBiddingData getTrustedBiddingData()

Dane dotyczące zaufanych stawek zawierają identyfikator URI wskazujący zaufany serwer dla kupujących dane o stawkach i listę kluczy, za pomocą których będzie można wysyłać zapytania do serwera.

AdSelectionSignals getUserBiddingSignals()

Kupujący mogą opcjonalnie udostępniać sygnały ustalania stawek przez użytkownika, aby mogli je wykorzystać JavaScript podczas wyboru reklamy w izolowanym środowisku wykonawczym.

int hashCode()

Zwraca hasz danych obiektu CustomAudience.

void writeToParcel(Parcel dest, int flags)

Spłaszcz ten obiekt na działkę.

Metody dziedziczone

Fieldsem

CREATOR

public static final Creator<CustomAudience> CREATOR

Metody publiczne

równa się

Dodano na poziomie API 34.
public boolean equals (Object o)

Sprawdza, czy 2 obiekty CustomAudience zawierają te same informacje.

Parametry
o Object: obiekt referencyjny, z którym ma nastąpić porównanie.

Zwroty
boolean true, jeśli ten obiekt jest taki sam jak obiekt argument; W przeciwnym razie: false.

getAktywacjaTime

public Instant getActivationTime ()

Po utworzeniu obiektu CustomAudience opcjonalny czas aktywacji można ustawić w w przyszłości, aby obsługiwać opóźnioną aktywację. Jeśli to pole nie jest skonfigurowane, interfejs CustomAudience zostanie aktywowany w chwili dołączenia.

Na przykład niestandardowa lista odbiorców dotycząca nieaktywnych użytkowników może zostać aktywowana dopiero po osiągnięciu progu brak aktywności, co oznacza, że reklamy z grupy niestandardowych odbiorców zaczną się wyświetlać w reklamie przez proces wyboru, co może spowodować przekierowanie nieaktywnych użytkowników do aplikacji pierwotnego właściciela.

Maksymalne opóźnienie aktywacji wynosi 60 dni od jego utworzenia.

Jeśli czas aktywacji jest określony, musi ona być wcześniejsza niż data ważności.

Zwroty
Instant sygnaturę czasową Instant, skróconą do milisekund, po której niestandardowy odbiorcy są aktywni Ta wartość może wynosić null.

getAds

public List<AdData> getAds ()

Ta lista obiektów AdData to pełna i pełna lista reklam, które zostaną wyświetlane przez ten zasób (CustomAudience) podczas procesu wyboru reklamy.

Jeśli nie określono tej wartości lub podano pustą listę, CustomAudience nie zostanie uczestniczyć w wyborze reklam, dopóki nie otrzymasz prawidłowej listy reklam w ramach codziennej aktualizacji grupę niestandardowych odbiorców.

Zwroty
List<AdData> List z AdData obiektów reprezentujących reklamy wyświetlane obecnie przez grupa niestandardowych odbiorców Ta wartość nie może być null.

getBidLogicUri

public Uri getBiddingLogicUri ()

Zwraca docelowy identyfikator URI używany do pobierania danych logicznych do ustalania stawek, gdy w polu listy odbiorców procesu wyboru reklamy. W identyfikatorze URI musi być używany protokół HTTPS.

Zwroty
Uri identyfikator URI do pobrania danych logicznych dla ustalania stawek przez kupującego Ta wartość nie może być typu null.

getBuyer

public AdTechIdentifier getBuyer ()

Kupujący jest identyfikowany przez domenę w postaci „kupującyexample.com”.

Zwroty
AdTechIdentifier pole AdTechIdentifier zawierające domenę kupującego listy odbiorców niestandardowych Ta wartość nie może być typu null.

getDailyUpdateUri

public Uri getDailyUpdateUri ()

Ten identyfikator URI wskazuje serwer obsługiwany przez kupującego, który hostuje zaktualizowane dane dotyczące stawek i metadane reklam która ma być używana w procesie wyboru reklamy na urządzeniu. W identyfikatorze URI musi być używany protokół HTTPS.

Zwroty
Uri identyfikator URI codziennej aktualizacji listy odbiorców niestandardowych Ta wartość nie może być typu null.

getExpirationTime

public Instant getExpirationTime ()

Gdy upłynie okres ważności, lista niestandardowych odbiorców nie będzie już mogła być codziennie aktualizacji danych o reklamach i stawkach ani udziału w procesie wyboru reklam. Niestandardowa lista odbiorców zostaną usunięte z pamięci przy następnej codziennej aktualizacji.

Jeśli w momencie tworzenia obiektu CustomAudience nie podasz czasu ważności, domyślnie jest to 60 dni od aktywacji.

Maksymalny okres ważności to 60 dni od początkowej aktywacji.

Zwroty
Instant sygnaturę czasową Instant, skróconą do milisekund, po której niestandardowy należy usunąć odbiorców Ta wartość może wynosić null.

getName

public String getName ()

Nazwa listy odbiorców niestandardowych to dowolny ciąg znaków podawany przez właściciela i kupującego podczas jej tworzenia. obiektu CustomAudience.

Zwroty
String nazwa ciągu znaków listy odbiorców niestandardowych, Ta wartość nie może być typu null.

getTrustedOkreślanie stawek

public TrustedBiddingData getTrustedBiddingData ()

Dane dotyczące zaufanych stawek zawierają identyfikator URI wskazujący zaufany serwer dla kupujących dane o stawkach i listę kluczy, za pomocą których będzie można wysyłać zapytania do serwera. Pamiętaj, że klucze są losowymi identyfikatorami które będą używane tylko do wysyłania zapytań do zaufanego serwera w celu sprawdzenia logiki ustalania stawek kupującego podczas wyświetlania reklamy wyboru.

Jeśli tego nie zrobisz, CustomAudience nie będzie brać udziału w wyborze reklam do dane dotyczące zaufanego określania stawek są dostarczane w ramach codziennej aktualizacji listy niestandardowych odbiorców.

Zwroty
TrustedBiddingData obiekt TrustedBiddingData zawierający zaufane ustalanie stawek za odbiorców niestandardowych dane Ta wartość może wynosić null.

getUserBidSignals,

public AdSelectionSignals getUserBiddingSignals ()

Kupujący mogą opcjonalnie udostępniać sygnały ustalania stawek przez użytkownika, aby mogli je wykorzystać JavaScript podczas wyboru reklamy w izolowanym środowisku wykonawczym.

Jeśli sygnały dotyczące określania stawek przez użytkownika nie są prawidłowym obiektem JSON, który może zostać wykorzystany przez JS kupującego, niestandardowe listy odbiorców nie będą się kwalifikowały do wyboru reklamy.

Jeśli tego nie zrobisz, CustomAudience nie będzie brać udziału w wyborze reklam do sygnały dotyczące określania stawek przez użytkownika są dostarczane w ramach codziennej aktualizacji listy niestandardowych odbiorców.

Zwroty
AdSelectionSignals obiekt AdSelectionSignals reprezentujący sygnały dotyczące określania stawek przez użytkownika w kampanii grupa niestandardowych odbiorców Ta wartość może wynosić null.

kod skrótu

Dodano na poziomie API 34.
public int hashCode ()

Zwraca hasz danych obiektu CustomAudience.

Zwroty
int wartość kodu skrótu dla tego obiektu.

zapisToParcel

Dodano na poziomie API 34.
public void writeToParcel (Parcel dest, 
                int flags)

Spłaszcz ten obiekt na działkę.

Parametry
dest Parcel: ta wartość nie może być typu null.

flags int: dodatkowe flagi informujące o sposobie zapisywania obiektu. Może wynosić 0 lub Parcelable.PARCELABLE_WRITE_RETURN_VALUE. Wartość to 0 lub kombinacja Parcelable.PARCELABLE_WRITE_RETURN_VALUE i android.os.Parcelable.PARCELABLE_ELIDE_DUPLICATES