Źródłem nowych instalacji aplikacji mobilnych są zwykle reklamy promujące instalacje aplikacji. Aby zmaksymalizować ROI z nakładów na reklamę, nie wyświetlaj reklam zachęcających do zainstalowania aplikacji na urządzeniach, na których jest już zainstalowana ta sama aplikacja. W tej propozycji odwołujemy się do to „filtrowanie reklam promujących instalacje aplikacji”.
Ta propozycja przedstawia, w jaki sposób Protected Audience na Androida obsługuje filtrowanie reklam, w szczególności reklam promujących instalacje aplikacji, w sposób zapewniający ochronę prywatności, sposób. Aby wziąć udział w programie, aplikacja na urządzeniu musi wyraźnie wyrazić na to zgodę filtrowanie reklam instalacji. Podczas wyboru reklamy kandydaci są odfiltrowywani na podstawie na liście aplikacji zainstalowanych na urządzeniu.
Lista są widoczne tylko w ramach procesu wyboru reklamy i zależą od po stronie kupującego, aby zasygnalizować, że konkretna reklama powinna zostać odfiltrowana na podstawie aplikacji na urządzeniu.
Aby skonfigurować filtrowanie reklam promujących instalację aplikacji, wykonaj następujące czynności:
Krok 1. Zarejestruj aplikację pod kątem filtrowania reklam promujących instalacje aplikacji
Aby włączyć filtrowanie reklam promujących instalacje aplikacji, deweloper wywołuje metodę
registerForAdFiltering
interfejs API rejestracji aplikacji pochodzący z aplikacji lub z pakietu SDK technologii reklamowych.
z listą adresów eTLD+1 nabywców technologii reklamowych. Pozwoli to kupującym na liście.
tylko tych kupujących, aby filtrować reklamy według stanu instalacji aplikacji
bezpośrednio lub za pomocą pakietu SDK technologii reklamowych. Rejestracja zapewnia pełną kontrolę
deweloperowi, czy jego aplikacja powinna uczestniczyć w reklamach promujących instalacje aplikacji
filtrowaniu.
java
void registerForAdFiltering(List<AdTechIdentifier> buyers);
Krok 2. Poproś o usunięcie reklam promujących instalacje aplikacji
Gdy reklama jest uwzględniana w określaniu stawek, kupujący mogą ją oznaczyć jako są odfiltrowywane na podstawie stanu instalacji aplikacji. W tym celu dodaj nazwa pakietu aplikacji w metadanych reklamy. Żądanie filtrowania reklam promujących instalacje aplikacji to część danych reklam przekazywanych do procesu aukcji z Protected Audience API. Ten dane reklam są tworzone różnie w zależności od tego, czy są to dane kontekstowe, reklama remarketingowa.
- Użycie reklamy kontekstowej, która jest głównym przypadkiem użycia aplikacji do zainstalowania aplikacji. filtrowanie reklam, informacje o filtrowaniu są uwzględnione w danych reklam które kupujący mogą zaoferować sprzedawcom w odpowiedzi na stawkę kontekstową poza w zakresie Protected Audience API. Funkcja Protected Audience API wymaga, aby informacje filtrowane były być zwracana jako część odpowiedzi kontekstowej, tak jak każda inna metadanych dotyczących konkretnej reklamy.
- W przypadku remarketingu funkcja Protected Audience API oczekuje filtrowania
informacje, które mają być uwzględniane na liście odbiorców niestandardowych. Dostępne są 2 możliwości:
aby uwzględnić te dane: podczas dołączania do listy odbiorców i pobierania
nowe dane o odbiorcach w ramach aktualizacji listy odbiorców.
Żądanie odfiltrowywania reklam promujących instalacje aplikacji powinno wyglądać tak:
obiekt JSON
AdData
:json { "render_uri": "https://..", "metadata": {..}, "filters": { "app_install": { "app_package_names": ["app1.package", "app2.package"] } } }
Krok 3. Odfiltruj reklamy promujące instalacje aplikacji podczas wyboru reklamy
W trakcie żądania reklamy kupujący może przekazać wiele reklam sprzedawcy, podając w nim:
filtrowanie informacji, tak by reklamy zainstalowanych aplikacji mogły zostać odfiltrowane.
jest wymagany, aby przekazywać informacje filtrowane w ramach
konfigurację funkcji selectAds
w polu adData
. Android oczekuje
format wiadomości podobny do poniższego.
AdData myAdData = new AdData.Builder()
.setRenderUri(Uri.parse("https://.."))
.setMetadata("{...}")
.setFilters(new AdFilters.Builder()
.setAppInstalledFilter(new AppInstalledFilter.Builder()
.setPackageNames(ImmutableList.of("app1.package", "app2.package"))
.build())
.build())
.build();
AdSelectionConfig myAdSelectionConfig = new AdSelectionConfig.Builder()
.setSeller(AdTechIdentifier.fromString("example-ssp1.com"))
.setDecisionLogicUri(Uri.parse("https://..."))
...
.setContextualAds(ImmutableList.of(new ContextualAd.Builder()
.setBuyer(AdTechIdentifier.fromString("example.com"))
.setReportingUri("https://example.com/reporting")
.setBid(20)
// myAdData could be taken from the JSON above
.setAd(myAdData)
.build()))
.build();
// Invoke ad services API to initiate ad selection workflow.
selectAds(myAdSelectionConfig);
.
Filtrowanie jest przetwarzane w interfejsie API selectAds
. Filtry Protected Audience API
Z reklamy, jeśli aplikacja określona w wiadomości pasuje do aplikacji w technologii reklamowej
kupujących na liście instalacji konkretnej aplikacji. Możliwe są 2 wyniki:
- Aplikacji nie ma na tej liście, co oznacza, że nie została zainstalowana ani otwarta.
- Aplikacja znajduje się na tej liście, co oznacza, że jest zainstalowana i otwarta.
Jeśli Protected Audience API wykryje, że aplikacja już istnieje, reklama zostanie
jest wykluczona z listy reklam używanych w aukcji
scoreAds
.
Co wziąć pod uwagę w kontekście reklam kontekstowych
Dzięki filtrowaniu reklam promujących instalacje aplikacji interfejsy Protected Audience API zaczynają obsługiwać filtrowanie reklam kontekstowych. W sytuacji, w których aukcja obejmuje reklamy kontekstowe i reklamy remarketingowe; lub składające się wyłącznie z reklam kontekstowych.
- Po przeprowadzeniu aukcji
selectAd
kupujący może przekazać listę zContextualAd
obiektów. Te obiekty zawierają domenę eTLD+1 kupującego, stawkę reklamy, URL wskazujący funkcję raportowania reklamy oraz poleAdData
zawierające rzeczywisty URL treści reklamy oraz adres weryfikacyjny podpis należący do kupującego (zobacz Podpisywanie reklam kontekstowych, aby dowiedzieć się więcej). . Pamiętaj, że formatAdData
jest używany zarówno w kontekście, jak i w kontekście reklam remarketingowych. - Na początku aukcji reklamy kontekstowe i remarketingowe
są filtrowane przy użyciu zbioru nazw pakietów określonych w pliku
AdData.adFilters.appInstallFilters.packageNames
Wartości stawek są następnie na reklamy remarketingowe. oceny reklam kontekstowych są określane za pomocą podanej funkcjiscoreAds
. W reklamie z największym wynikiem wygrywa. Pamiętaj, że ten proces działa nawet wtedy, gdy nie reklamy remarketingowe. Jeśli reklama kontekstowa wygrywa aukcję, raportowanie wyświetleń jest wywoływane przez do aplikacji, Protected Audience pobiera i uruchamia funkcję JS o nazwie
reportWin()
z adresu URL raportowania uwzględnionego w kontekstowych danych reklamy. Przypomina to raportowanie reklam remarketingowych zdobywających aukcji.Przykładowa funkcja raportowania JavaScript:
function reportWin(ad_selection_signals, per_buyer_signals, signals_for_buyer, contextual_signals) { let reporting_address = 'https://reporting.example.com'; return {'status': 0, 'results': {'reporting_uri': reporting_address + '?some_signal=' + per_buyer_signals.some_signal} }; }
Podpisywanie reklam kontekstowych
Reklamy kontekstowe, które zawierają filtrowanie instalacji aplikacji, muszą być podpisane przez kupującego. Platforma używa tego podpisu do weryfikacji technologii reklamowej dostarczonej reklamy i filtry instalacji aplikacji związanych z technologią reklamową, które mają być do nich stosowane. To jest ma zapobiegać wykorzystywaniu tożsamości innych technologii reklamowych do z rejestracji w sprawie instalacji aplikacji przez innych dostawców technologii reklamowych.
Piaskownica prywatności pobierze te klucze z podanego punktu końcowego technologii reklamowych podczas rejestracji. Zgodnie ze sprawdzoną metodą klucze muszą być są często aktualizowane, ale nie później niż co 6 miesięcy.
Piaskownica prywatności poprosi zespoły techniczne o potwierdzenie dostępności reklamy w trakcie procesu rejestracji. Więcej informacji: działania wymagane przez obecnych i nowo zarejestrowanych Instrukcje rejestracji
Przewodnik dla programistów z bardziej szczegółowymi instrukcjami implementacji opublikowana w najbliższej przyszłości.
Polecane dla Ciebie
- Uwaga: tekst linku wyświetla się, gdy JavaScript jest wyłączony
- Przewodnik dla programistów dotyczący interfejsu Protected Audience API na Androida
- Informacje o wersji
- Obsługa kierowania na niestandardowych odbiorców za pomocą interfejsu Protected Audience API