Filtrowanie reklam promujących instalacje aplikacji na potrzeby Protected Audience API

Uwaga: aby uzyskać wskazówki dotyczące implementacji, postępuj zgodnie z przewodnika dla programistów.

Ź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"] } } }
  Uwaga: możesz odfiltrować reklamy promujące instalacje aplikacji w wielu aplikacjach jednocześnie. Do zrobienia wystarczy wymienić wszystkie nazwy pakietów aplikacji, które powinny zostać poddane ocenie. Jeśli any znajduje się na liście instalacji aplikacji, reklama zostanie odfiltrowana. Sprawdzamy sposoby włączenia szyfrowania lub podpisywania reklam kontekstowych. tych informacji. Prosimy o Twoją opinię na ten temat.

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.

Uwaga: w przypadku reklam kontekstowych dane reklam są przekazywane do funkcji, ponieważ nie są zapisanych już na urządzeniu. Inaczej jest w przypadku reklam remarketingowych, w których dane reklam są oparte na niestandardowych odbiorcach

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ę z ContextualAd obiektów. Te obiekty zawierają domenę eTLD+1 kupującego, stawkę reklamy, URL wskazujący funkcję raportowania reklamy oraz pole AdData 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 format AdData 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 funkcji scoreAds. 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.

.