Informacje o wersji Piaskownicy prywatności na Androida

Piaskownica prywatności na Androida oferuje programy przedpremierowe i beta dla deweloperów. Z czasem wprowadzimy w wersji przedpremierowej dla programistów nowe interfejsy API i funkcje, a ustabilizowane interfejsy API zostaną wprowadzone do programu testów beta. Czekamy na opinie.

Jeśli dopiero zaczynasz korzystać z Piaskownicy prywatności na Androida, najpierw przeczytaj artykuł Omówienie programu. Aby rozpocząć tworzenie Piaskownicy prywatności w swoim projekcie, skonfiguruj środowisko programistyczne i pobierz Piaskownicę prywatności na Androida na urządzeniu testowym lub w emulatorze.

Bieżące wersje

Android VanillaIceCream – wersja przedpremierowa

Protected Audience API,

  • Dodaliśmy możliwość przekazywania uwierzytelnionych reklam kontekstowych do aukcji chronionej. Obejmuje to również filtrowanie wykluczających w przypadku aplikacji już zainstalowanych na urządzeniu oraz ograniczenie liczby wyświetleń, wyświetleń, obejrzeń lub wygranych. Implementacja różni się od poprzednich iteracji, ponieważ reklamy kontekstowe muszą być podpisane przez technologię reklamową. Informacje o tym, jak to zrobić, znajdziesz w przewodniku dla programistów.
  • Nazwa elementu kontekstowegoAds została zmieniona na SignedContextualAds wraz z powiązanym elementem pobierającym i setkowym w AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Jeśli nieuwierzytelniona aplikacja kontekstowa zostanie przekazana, zostanie usunięta z aukcji.

Attribution Reporting API.

Aktualizacja wersji beta Piaskownicy prywatności na urządzeniach z Androidem z listopada 2023 r.

Ta wersja Piaskownicy prywatności na Androida (beta) zawiera aktualizacje interfejsów API Piaskownicy prywatności na publicznych urządzeniach z Androidem 14. Pakiet SDK i obrazy urządzeń są dostępne do pobrania za pomocą menedżera pakietów SDK w Android Studio jako Android API 34 (rozszerzenie na poziomie 10). Jego działanie jest podobne do wersji [wersja dla programistów 9][b25], ale z kilkoma kluczowymi modyfikacjami.

Protected Audience API,

  • Technologie reklamowe mogą teraz korzystać z opcji [przekazywanie dostępu do list niestandardowych odbiorców][b26], by dołączyć do niestandardowej listy odbiorców w imieniu kupującego, który nie jest obecny na urządzeniu.
  • Android umożliwia teraz przeprowadzanie aukcji w ramach usług określania stawek i aukcji.
  • Aukcje w ramach Protected Audience API obsługują płatności CPC.
  • Aukcje i raporty w ramach Protected Audience API obsługują teraz nagłówki wersji danych na potrzeby zaufanych sygnałów ustalania stawek.
  • Aukcje w ramach Protected Audience API obsługują filtrowanie limitu wyświetleń na użytkownika w przypadku zdarzeń wygranych.
  • Protected Audience obsługuje teraz [integrację z interfejsem Attribution Reporting API][b27].

Attribution Reporting API.

  • Interfejs Attribution Reporting API obsługuje teraz [integrację z interfejsem Protected Audience][b28]

Środowisko wykonawcze SDK

  • Możliwość wczytywania innych pakietów SDK z poziomu pakietu SDK w środowisku wykonawczym SDK w celu obsługi przypadków użycia zapośredniczenia.

Wcześniejsze wydania

Przedpremierowa wersja dla programistów 10

Data premiery: 19 grudnia 2023 r.

Znane ograniczenia

  • Występuje problem, który powoduje awarię Usług Google Play w tle i wielokrotne informowanie użytkownika o tych problemach:
    • Ponowne uruchomienie urządzenia może rozwiązać ten problem.
    • Jeśli masz problemy z przekroczeniem limitu czasu asynchronicznych wywołań asynchronicznych podczas testowania, spróbuj dodać to polecenie adb, aby wydłużyć próg do przekroczenia limitu czasu:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Tylko urządzenie fizyczne: dodawanie konta Google nie jest obsługiwane. Aby wyświetlić ekran główny urządzenia, wykonaj te czynności:
    • Zainstaluj obraz podglądu na telefonie.
    • Przejdź przez kreator konfiguracji bez łączenia się z Wi-Fi lub siecią mobilnej transmisji danych.
    • Na ekranie głównym połącz się z Wi-Fi lub skorzystaj z mobilnej transmisji danych.
    • Zrestartuj urządzenie.

Protected Audience API,

  • Wprowadzamy nowe funkcje [Protected App Signals][dp98], które umożliwiają wyświetlanie trafnych reklam promujących instalacje aplikacji. W ramach tych zmian udostępniamy interfejsy API, które umożliwiają technikom reklamowym:
    • Dobieraj sygnały, przechowując zdarzenia w aplikacji w chronionej pamięci na urządzeniu, które służą do wyświetlania odpowiednich reklam promujących instalacje aplikacji.
    • Prowadź aukcję chronioną w przypadku usług określania stawek i aukcji działających w zaufanych środowiskach wykonawczych, w których mają dostęp do odpowiednich sygnałów, aby ułatwić wybór reklamy i określanie stawek.

Attribution Reporting API.

  • W tej wersji interfejsu Attribution Reporting API:
    • Dodaje integrację Protected Audience API, która umożliwia stosowanie niestandardowych wymiarów odbiorców w raportach zbiorczych.
    • Obsługuje dostawcę Google Cloud jako TEE dla usługi agregacji.
    • Dodaje pole shared_debug_key, aby umożliwić debugowanie na potrzeby atrybucji międzysieciowej bez przekierowań.
    • Dodaje nagłówki wersji w żądaniach szczegółowych raportów na temat debugowania.

Personalizacja na urządzeniu

  • Wstępna wersja dla badaczy i praca na wczesnym etapie rozwoju.
  • Personalizacja na urządzeniu to innowacyjny sposób dostosowywania produktów i usług, zapewniając jednocześnie lepszą ochronę prywatności użytkowników. Personalizacja na urządzeniu udostępnia zestaw usług i algorytmów, które pozwalają to osiągnąć, w tym między innymi:
    • Compute sfederowane (FC), które umożliwia trenowanie, ocenę i personalizację modeli za pomocą sfederowanego uczenia się. Wykorzystanie sfederowanych obliczeń na urządzeniu będzie opierać się na trenowaniu modelu i (opcjonalnie w razie potrzeby) wnioskowaniu.
    • filtr z kukułką wykorzystujący dopasowanie i dopasowanie krzyżowe, które jest w odrębnym miejscu uwzględnionych w danych.
    • Trenowanie różnicowo prywatne (DP) modeli rozproszonych przy użyciu nowych technik, takich jak naprzemienna minimalizacja danych (DP) (do trenowania danych znajdujących się w rozproszeniu) oraz personalizacja modelu w ramach billboardu DP. ### Przedpremierowa wersja dla programistów 9

Data premiery: 15 sierpnia 2023 r.

Znane ograniczenia

  • Dane o aukcjach wygenerowane przez wywołanie interfejsu API określania stawek i aukcji nie są automatycznie usuwane w DP9.
  • Wywołanie getAdSelectionData i persistAdSelectionResult po anulowaniu zgody powoduje przerwanie procesu.
  • Funkcja filtrowania wykluczającego nie działa z getAdSelectionData i persistAdSelectionResult.

Protected Audience API,

Attribution Reporting API.

  • W tej wersji ulepszyliśmy raporty debugowania interfejsu Attribution Reporting API o tematy:
    • obsługa szczegółowych raportów debugowania, które są obsługiwane w przeglądarce;
    • włączenie raportów debugowania dotyczących atrybucji w internecie i aplikacjach (wymaga to AdId zarówno w przypadku rejestracji witryny, jak i rejestracji aplikacji).
  • Technologie reklamowe mogą konfigurować parametry szumu na potrzeby różnych scenariuszy raportowania.
  • W tej wersji przechodzimy na atrybucję opartą na pochodzeniu, co oznacza, że:
    • Do rejestracji jest używany punkt początkowy.
    • W ramach jednej witryny akceptowanych jest wiele źródeł.
    • Nowy limit liczby żądań do 1 punktu początkowego na aplikację źródłową lub rejestrację.
  • Technologie reklamowe mogą teraz wyłączać rejestrację na potrzeby testowania przypadków użycia Attribution Reporting lokalnie.

Środowisko wykonawcze SDK

  • Pakiet SDK może uruchamiać się tylko z listy dozwolonych lub tworzyć z nimi powiązania.
  • Pakiet SDK ma dostęp tylko do podzbioru systemu ContentProvider (np. com.android.providers.settings.SettingsProvider), w którym uzyskane dane nie zawierają identyfikatorów i nie można ich użyć do utworzenia odcisku cyfrowego użytkownika. Te mechanizmy kontroli dotyczą również dostępu do ContentProvider za pomocą ContentResolver.
  • Pakiet SDK ma dostęp tylko do podzbioru chronionych odbiorników (np. android.intent.action.AIRPLANE_MODE).
  • Pakiet SDK może uruchamiać aktywność należącą do innej aplikacji, ale z ograniczeniami dotyczącymi tego, co można wysyłać w intencji.

Aktualizacja wersji beta Piaskownicy prywatności na urządzeniach z Androidem z marca 2023 r.

Opublikowana w marcu 2023 r. wersja beta Piaskownicy prywatności na Androida zawiera aktualizacje interfejsów API Piaskownicy prywatności na publicznych urządzeniach z Androidem 13. Ta wersja zawiera interfejsy API rozszerzeń usług reklamowych 5 i jest podobna do wersji przedpremierowej dla programistów 6, ale wprowadziła kilka ważnych zmian.

Znane ograniczenia

  • Zadanie pobierania w tle, które jest uruchamiane okresowo, aby zaktualizować niestandardowe listy odbiorców FLEDGE, powoduje awarię procesu. Z tego powodu FLEDGE jest domyślnie wyłączony.

Ogólne

  • Od tej wersji możesz używać interfejsu Attribution Reporting API. Interfejs API został wcześniej wyłączony. Jeśli interfejs Attribution Reporting API był używany w poprzedniej wersji beta, wyczyść dane aplikacji lub urządzenia, zanim skorzystasz z tej wersji beta, wykonując jedną z tych czynności:
    • Na urządzeniu lub w emulatorze otwórz Ustawienia i wyczyść pamięć podręczną aplikacji (nie tylko pamięć podręczną) wszystkich aplikacji używanych do testowania.
    • Przywróć ustawienia fabryczne na urządzeniu fizycznym lub emulowanym.
    • W przypadku emulowanego urządzenia wykonaj funkcję Wyczyść dane.
  • Attribution Reporting obsługuje teraz klucze debugowania, które umożliwiają deweloperom otrzymywanie z interfejsu Attribution API niezmienionych raportów i raportów o ulepszonej prywatności. Klucze debugowania dają lepszy wgląd w strukturę raportów podczas przechodzenia na Piaskownicę prywatności.
  • W funkcji Attribution Reporting wystąpił niedawno błąd w usługach reklamowych, w których registerSource i registerTrigger powodowały wyjątki. Jeśli problemy wystąpiły w trakcie tworzenia aplikacji, oznacza to, że wprowadzono poprawkę, która powinna zniknąć z czasem.
  • W wersji przedpremierowej dla programistów aplikacji na Androida funkcje podglądu w interfejsie Topics API są teraz takie same jak w Piaskownicy prywatności. Element wywołujący interfejs Topics API może wyświetlać podgląd tematów bez uwzględniania wywołania pobierania tematu w obliczeniach cotygodniowej epoki i nie ma wpływu na listę obserwowanych tematów przez element wywołujący. Więcej informacji znajdziesz w polu shouldRecordObservation.

  • Aby włączyć testowanie we FLEDGE na Androidzie, zarejestruj się w programie wersji beta i zaloguj się na urządzeniach testowych za pomocą tego samego konta Google. W przeciwnym razie próby wywołania interfejsów API powodują błąd IllegalStateException z komunikatem „Usługa jest niedostępna”. FLEDGE powinien zostać przywrócony w kolejnej wersji beta.

    W międzyczasie zalecamy kontynuowanie testowania w wersji przedpremierowej dla programistów. Można też ręcznie włączyć FLEDGE na urządzeniach, na których obowiązują te zasady:

    FLEDGE możesz włączyć za pomocą tych poleceń adb. Powoduje to jednak awarię procesu pobierania w tle, co negatywnie wpływa na wskaźniki stanu systemu. Nie jest to trwałe rozwiązanie, ponieważ platforma może zresetować te wartości.

    adb shell device_config set_sync_disabled_for_tests persistent
adb shell setprop debug.adservices.fledge_select_ads_kill_switch false
adb shell setprop debug.adservices.fledge_custom_audience_service_kill_switch false
adb shell device_config put adservices fledge_background_fetch_enabled true

Wcześniejsze wydania

Przedpremierowa wersja dla programistów 8

Data premiery: 23 maja 2023 r.

Znane ograniczenia

  • Filtry limitu wyświetleń na użytkownika o nazwie WIN można dodawać do reklam w ramach Protected Audience API, jednak typ WIN nie jest jeszcze obsługiwany, a filtry tego typu są ignorowane.
  • Aby raportować wygrane wyświetlenia kupującym w aukcjach Protected Audience, kupujący muszą być zarejestrowani w Piaskownicy prywatności. Tego wymogu nie można zastąpić.
  • Aby uzyskać dostęp do ustawień Piaskownicy prywatności na urządzeniu, na którym jest dostępna Piaskownica prywatności, kliknij Ustawienia > Google > Reklamy > Piaskownica prywatności.
  • W Android Studio Giraffe nie można wdrażać projektów z emulatorami. Inne wersje Androida Studio powinny działać bez problemów. Poprawka zostanie wprowadzona 26 maja 2023 r. w Android Studio Giraffe.

Protected Audience API,

Attribution Reporting API.

  • Dodano filtry reguły LUB. Oznacza to, że filtry składają się teraz z zestawu map, który jest listą map filtrów. Jeśli żadna z mapowań filtrów w zestawie nie pasuje do danych filtra źródła, obiekt event_trigger_data jest ignorowany.
  • Okres ważności wyświetleń i okno raportowania w przypadku interfejsów API na poziomie zdarzenia i agregacji zostały odłączone.
  • Dodaliśmy obsługę kluczy deduplikacji w raportach zbiorczych.
  • Dodaliśmy scheduled_report_time do raportów o zdarzeniach, aby zachować zgodność z Piaskownicą prywatności w internecie.
  • Wdrożyliśmy atrybucję międzysieciową bez przekierowań.

Środowisko wykonawcze SDK

Przedpremierowa wersja dla programistów 7

Data premiery: 26 stycznia 2023 r.

FLEDGE w interfejsie Android API

  • Zmieniliśmy nazwę parametru custom_audience_signals w tych metodach JavaScript:
    • Nazwa zasobu generateBid() została zmieniona na custom_audience_bidding_signals.
    • Nazwa zasobu scoreAd() została zmieniona na custom_audience_scoring_signals.
    • Nazwa zasobu reportWin() została zmieniona na custom_audience_reporting_signals.
  • Ta wersja dodaje nowe zastąpienie selectAds, które wymaga AdSelectionFromOutcomeConfig, aby porównać wyniki w trybie selectAds. Umożliwia to pakietom SDK technologii reklamowych, które korzystają z tego interfejsu, do uruchamiania zapośredniczenia kaskadowego. Więcej informacji znajdziesz w przewodniku dla programistów.
  • Interfejs selectAds() API obsługuje teraz buforowanie na potrzeby logiki określania stawek i wyników pobieranej podczas procesu wyboru reklamy.
    • Pamięć podręczną można kontrolować za pomocą nagłówków Cache-Control zwracanych przez serwery podczas wywołania pobierania kodu JavaScript. Użyj no-cache lub no-store, aby zapobiec buforowaniu odpowiedzi JavaScript, i max-age, aby kontrolować czas trwania pamięci podręcznej.
    • Obecny wpis pamięci podręcznej max-age jest domyślnie ustawiony na 2 dni.

Raportowanie atrybucji w interfejsie Android API

  • W tej wersji dodaliśmy obsługę przekierowań łańcuchów połączeń w przypadku registerSource() i registerTrigger(). Konsument interfejsu API może teraz używać przekierowania HTTP jako odpowiedzi serwera.

Pierwsza wersja beta, styczeń 2023 r.

Data premiery: 9 stycznia 2023 r.

Piaskownica prywatności na urządzeniach z Androidem w wersji beta 1 to pierwsze udostępnienie interfejsów API Piaskownicy prywatności na urządzeniach publicznych. Wprowadziliśmy też ulepszenia w obszarach wymienionych poniżej.

Ogólne

  • Piaskownica prywatności na urządzeniach z Androidem w wersji beta 1 jest odpowiednikiem wersji przedpremierowej dla programistów 5 z pewnymi dodatkowymi funkcjami i ograniczeniami wymienionymi poniżej.
  • Aby korzystać z interfejsów API związanych z reklamami (w tym Topics, FLEDGE i Attribution Reporting), deweloperzy muszą przejść proces rejestracji. Proces rejestracji weryfikuje tożsamość dewelopera i gromadzi potrzebne interfejsy API.
  • Dzięki Piaskownicy prywatności na urządzeniach z Androidem Beta 1 deweloperzy, którzy zapisali się na listę dozwolonych i przesłali na nią informacje, mogą skorzystać z tej możliwości. Aby tworzyć aplikacje w oparciu o stabilne interfejsy API w tej wersji, pobierz nowe Rozszerzenia usług reklamowych w pakiecie SDK 4.

Topics API,

Attribution Reporting API.

  • Funkcja Attribution Reporting została wyłączona i nie można jej używać w tej wersji. Dostęp do tego interfejsu API należy ponownie włączyć w następnej wersji beta. Zachęcamy do dalszego testowania wersji przedpremierowej dla programistów.

Środowisko wykonawcze SDK

Te ograniczenia powinny zostać usunięte w następnej większej wersji platformy Androida:

  • Renderowanie reklam w widoku przewijanym, takim jak RecyclerView, nie działa obecnie prawidłowo. Jeśli zmienisz rozmiar elementu, może wystąpić zacinanie. Zdarzenia przewijania polegające na dotknięciu użytkownika nie są prawidłowo przekazywane do środowiska wykonawczego.
  • Renderowanie WebView nie jest dostępne w procesie środowiska wykonawczego SDK.
  • Pamięć na pakiety SDK jest niedostępna.
  • Obsługa interfejsów API getAdId i getAppSetId nie została jeszcze aktywowana.

Przedpremierowa wersja dla programistów 6

Data premiery: 31 października 2022 r.

Piaskownica prywatności w wersji przedpremierowej dla programistów aplikacji na Androida 6 wprowadza ulepszenia w tych obszarach:

Ogólne

  • W ramach przygotowań do wdrożenia w wersji produkcyjnej dla programistów w wersji deweloperskiej 6 wprowadzono flagę, która pozwala domyślnie wyłączyć dostęp do interfejsu API z zachowaniem prywatności. Do celów testowych włącz dostęp do interfejsu API z zachowaniem prywatności w wersji przedpremierowej dla programistów, uruchamiając to polecenie:

    adb shell device_config put adservices global_kill_switch false

  • Interfejsy API AdIdManager i AppSetIdManager wymagają Usług Google Play w wersji 22.36.16 lub nowszej.

    • Na urządzeniu z Androidem sprawdź, czy w sekcji Ustawienia > Aplikacje > Usługi Google Play jest wymieniona prawidłowa wersja.
    • Jeśli musisz zaktualizować Usługi Google Play do odpowiedniej wersji, zaloguj się na urządzeniu testowym Androida lub w emulatorze, używając konta Google. Następnie kliknij Sklep Google Play > ikona profilu > Ustawienia > Informacje. Pod nagłówkiem Wersja Sklepu Play kliknij Zaktualizuj Sklep Play.
    • Ten krok ma zastosowanie tylko do programowania i testowania i nie będzie potrzebny po udostępnieniu Piaskownicy prywatności użytkownikom publicznym.

Topics API,

FLEDGE w interfejsie Android API

  • W przypadku testów na rzeczywistych serwerach włączenie interfejsu API jest teraz wymuszane. Wykonaj te czynności, aby skonfigurować urządzenie. Te czynności nie są wymagane, jeśli używasz zdalnych zastąpień w przykładowej aplikacji.
  • Zmiany istotne:
    • Parametr Url został zastąpiony wartością Uri. Dotyczy to wszystkich interfejsów API FLEDGE oraz niestandardowego kodu JavaScript na potrzeby logiki określania stawek i wyników.
    • Z danych wejściowych niestandardowego interfejsu API usunięto pole owner.
  • Niekompletne grupy niestandardowych odbiorców mogą od razu zostać odświeżone w tle.
  • Limit pamięci JavaScript został ustawiony na 10 MB. Dotyczy to logiki ustalania stawek i wyników.

Attribution Reporting API.

  • Technologie reklamowe muszą się zarejestrować, aby móc korzystać z interfejsu Attribution Reporting API w wersji przedpremierowej dla programistów w wersji 6. Więcej informacji znajdziesz w artykule Rejestrowanie konta Piaskownicy prywatności.
  • W tej wersji wprowadziliśmy klucze debugowania, które umożliwiają deweloperom otrzymywanie niezmienionych raportów razem z raportami o ulepszonej prywatności, które korzystają z interfejsu Attribution Reporting API. Klucze debugowania dają lepszy wgląd w strukturę raportów podczas przechodzenia z Piaskownicy prywatności.

Przedpremierowa wersja dla programistów 5

Ogólne

  • Aby uzyskać dostęp do interfejsów API Piaskownicy prywatności w wersji Developer Preview 5, musisz najpierw włączyć te interfejsy i skonfigurować uprawnienia dotyczące interfejsów API.
    • Projekty Piaskownicy prywatności na Androida pozwalają użytkownikom kontrolować, czy interfejsy API chroniące prywatność oraz środowisko wykonawcze SDK są aktywne na ich urządzeniach. W wersji przedpremierowej dla programistów te ustawienia są domyślnie wyłączone. Dostęp do interfejsu API możesz włączyć za pomocą polecenia adb.
    • Aplikacja wywołująca musi określać uprawnienia związane z interfejsem API w pliku manifestu i powiązane konfiguracje AdServices, które kontrolują dostęp do umieszczonych pakietów SDK.
  • Gdy działają na pierwszym planie, aplikacje muszą wywoływać interfejsy API chroniące prywatność.
  • AdIdManager i AppSetIdManager nie są obecnie otwarte. Zostaną one włączone w jednej z kolejnych wersji.

Środowisko wykonawcze SDK

  • W przyszłej wersji interfejs sendData() zostanie wycofany.
  • loadSdk() zwraca teraz obiekt IBinder, aby umożliwić dwukierunkową komunikację między pakietem SDK działającym w czasie działania a aplikacjami zdefiniowanymi w AIDL.
  • Aplikacje mają dostęp do dodatkowych zdarzeń cyklu życia pakietu SDK w środowisku wykonawczym, takich jak zakończenie procesu korzystania z pakietu SDK.

Attribution Reporting API.

W tej wersji wprowadziliśmy dodatkowe funkcje interfejsu Attribution Reporting API, w tym:

  • Obsługa raportu agregacji szyfrowania.
  • Obsługa pomiarów w witrynach i aplikacjach.
  • Skonsolidowane nagłówki w źródle i odpowiedziach aktywujących rejestrację:
    • Źródło: Attribution-Reporting-Register-Aggregatable-Source należy teraz do Attribution-Reporting-Register-Source
    • Reguła Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data i Attribution-Reporting-Register-Aggregatable-Values zostały połączone w jeden nagłówek o nazwie Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects nadal jest osobnym nagłówkiem

FLEDGE w interfejsie Android API

Ta wersja zawiera kilka nowych funkcji i ulepszeń, a także zmiany powodujące niezgodność:

  • Zmiany powodujące niezgodność:
    • Nazwę konta usługi runAdSelection() zmieniono na selectAds().
    • Zastąpiono parametr AdSelectionConfig.Builder.setAdSelectionSignals() ciągiem AdSelectionSignals, który reprezentuje obiekt JSON.
    • Zastąpiono funkcję String reprezentowaniem kupującego/sprzedawcy technologii reklamowych obiektem AdTechIdentifier.
    • Dodano klasy TestCustomAudienceManager i TestAdSelectionManager do zastępowania zdalnego pobierania kodu JavaScript.
    • Właścicielem listy niestandardowych odbiorców musi być nazwa pakietu aplikacji wywołującej.
  • Interfejsy FLEDGE API weryfikują teraz aplikację wywołującą pod kątem zestawu ograniczeń i ograniczeń opisanych w przewodniku dla programistów. Oto kilka godnych uwagi przykładów.
    • Harmonogramy selectAds i reportImpression są teraz objęte limitami czasu wykonywania. Po tym czasie wywołanie zostanie zakończone.
    • W selectAds i reportImpression obowiązuje teraz limit pamięci zużywanej podczas wykonywania JavaScriptu. Jeśli zużycie pamięci przekracza skonfigurowane limity, interfejsy API zgłaszają błąd.
    • selectAds i reportImpression weryfikują teraz obiekt AdSelectionConfig, aby sprawdzić, czy pola mają poprawną składnię i czy adresy URL znajdują się w domenie eTLD+1 użytej w polu sprzedawcy.
    • AdServices weryfikuje teraz grupy niestandardowych odbiorców podczas tworzenia. Weryfikacja obejmuje m.in. sprawdzenie, czy termin ważności jest prawidłowy, czy ograniczenie liczby niestandardowych list odbiorców, które może utworzyć aplikacja, oraz łącznego rozmiaru reklam podanych w wywołaniu joinCustomAudience. Weryfikacja powoduje też, że identyfikatory URI podawane na potrzeby sygnałów, pobierania logiki ustalania stawek i pobierania w tle znajdują się w domenie kupującego.
  • Niestandardowe metadane odbiorców są aktualizowane codziennie w ramach procesu pobierania w tle.
  • Listy niestandardowych odbiorców są usuwane po odinstalowaniu aplikacji „właściciel”.
  • Dodaliśmy obsługę określania zaufanych sygnałów wyników i danych dotyczących zaufanego określania stawek podczas wyboru reklamy. Format odpowiedzi znajdziesz w przykładowym kodzie.
  • FLEDGE dla interfejsów API Androida zależy od WebView w wersji 105.0.5195.58 lub nowszej. Szczegółowe informacje znajdziesz w informacjach o konfiguracji w przewodniku dla programistów.

  • Znane problemy:

    • Gdy dołączasz do grupy niestandardowych odbiorców, platforma nie przeprowadza obecnie aktualizacji w tle od razu, jeśli którakolwiek z wartości metadanych lub AdData jest pusta lub null. W przypadku tej niestandardowej listy odbiorców nie będzie można wybierać reklam, dopóki nie zostanie ona zaktualizowana jednego dnia później. W przyszłości niepełne listy niestandardowych odbiorców będą od razu kwalifikować się do aktualizacji pobierania w tle. Obecny domyślny limit pamięci dla wykonywania JavaScriptu jest zbyt niski i może spowodować awarię działania JavaScriptEngine na urządzeniach przez normalne zadania. Wykonanie JavaScriptu może nieoczekiwanie zakończyć się z powodu komunikatu o błędzie "Fatal javascript OOM in CALL_AND_RETRY_LAST".

      Możesz rozwiązać ten problem ręcznie, konfigurując odpowiedni próg pamięci za pomocą tego polecenia:

      adb shell "device_config put adservices fledge_js_isolate_enforce_max_heap_size 10485760"

    • Reklamy kierowane na niestandardowych odbiorców, które nie pasują do wymaganej struktury JSON, są aktualizowane podczas pobierania w tle.

Topics API,

Aktualizacje narzędzi

Android Studio w wersji Canary obsługuje tworzenie plików APK z pakietami SDK z nowym typem modułu. Przewodnik po środowisku wykonawczym SDK został zaktualizowany. Informacje na ten temat znajdują się w przykładowych aplikacjach Piaskownicy prywatności na GitHubie.

Przedpremierowa wersja dla programistów 4

Data premiery: 14 lipca 2022 r.

Piaskownica prywatności w wersji przedpremierowej dla programistów aplikacji na Androida 4 wprowadza ulepszenia w tych obszarach:

Środowisko wykonawcze SDK

  • Aplikacje mogą teraz komunikować się z pakietami SDK z włączonym środowiskiem wykonawczym (RE-SDK) dzięki dodaniu interfejsu sendData().
  • W procesie środowiska wykonawczego SDK dostępna jest teraz pamięć lokalna.
  • Pakiet SDK może też renderować samodzielne reklamy wideo lub treści w środowisku wykonawczym SDK.
  • Dodaliśmy wyjaśnienia dotyczące korzystania z odczuć, aby uwzględnić możliwość korzystania z refleksji pod warunkiem, że treści nie znajdują się w innym pakiecie SDK RE-SDK.

Attribution Reporting API.

W tej wersji wprowadziliśmy zmiany, które mają poprawić przejrzystość korzystania z interfejsu Attribution Reporting API. Oto niektóre z nich:

  • Zmiany w formacie raportów zbiorczych w celu zwiększenia czytelności.
  • Zaktualizowano pola nagłówka w funkcjach filtrowania konwersji i możliwości ustalania stawek.
  • W materiałach referencyjnych interfejsu WebApp API dodaliśmy wyjaśnienia, aby wyjaśnić źródła i reguły rejestracji oraz dostępność interfejsu API do zarządzania prywatnością i uzyskiwania zgody na przetwarzanie danych.

FLEDGE w interfejsie Android API

Ta wersja zawiera nowe funkcje, które ułatwiają testowanie i debugowanie, a także ulepszenia wewnętrzne:

  • Dodaliśmy obsługę zastępowania zdalnych adresów URL w celu pobierania logiki JavaScript w trakcie programowania.
  • Ulepszyliśmy raportowanie błędów podczas wyboru reklamy.
  • Nieaktywni niestandardowi odbiorcy są teraz odfiltrowywani podczas wyboru reklamy.

Topics API,

Ta wersja wprowadza kilka istotnych zmian w interfejsie Topics API, które są najważniejsze:

  • Typ zwracany interfejsu API getTopics() został zmieniony na nowy typ obiektu Topic, który zawiera identyfikatory całkowite odpowiadające tematom w taksonomii oraz informacje o wersjach klasyfikatora i taksonomii. Należy zaktualizować wszystkie istniejące aplikacje przy użyciu tego interfejsu API.
  • Interfejs Topics API wymaga teraz nowych, zwykłych uprawnień.
  • Wprowadzenie systemu klasyfikacji na urządzeniu do dynamicznego przypisywania tematów na podstawie publicznie dostępnych informacji o aplikacji.

Znane problemy

  • Pierwsza wersja tych obrazów urządzeń (wersja 6) nie wczytuje się w Emulatorze Androida w wersji 31.2.10. Zaktualizowane obrazy urządzeń, które przedstawiają ten problem, są dostępne od 27 lipca 2022 r.

Przedpremierowa wersja dla programistów 3

Data premiery: 9 czerwca 2022 r.

Piaskownica prywatności w wersji przedpremierowej dla programistów aplikacji na Androida 3 dodaje funkcje interfejsu Attribution Reporting API i FLEDGE na Androida.

Attribution Reporting API.

Interfejs Attribution Reporting API poprawia prywatność użytkowników, eliminując zależności od takich identyfikatorów (własnych i pochodzących od firm zewnętrznych), oraz obsługuje kluczowe przypadki atrybucji i pomiaru konwersji w różnych aplikacjach.

Ta wersja zawiera zasoby dla programistów, które pomogą Ci testować te funkcje interfejsu Attribution Reporting API:

  • Rejestrowanie źródła atrybucji i zdarzeń aktywujących
  • Atrybucja z priorytetem źródła i po instalacji
  • Otrzymywanie raportów o zdarzeniach
  • Otrzymuj raporty zbiorcze, które nie są zaszyfrowane w tej wersji

Do testowania zapewniamy przykładową aplikację i serwer technologii reklam referencyjnych

Znane problemy:

FLEDGE na Androidzie

FLEDGE na Androidzie wprowadza nowy sposób wyświetlania reklam na podstawie niestandardowych grup odbiorców zdefiniowanych przez deweloperów aplikacji i interakcji w ich aplikacjach. To rozwiązanie przechowuje informacje i powiązane reklamy lokalnie oraz zapewnia platformę do zarządzania procesami wyboru reklam.

Ta wersja zawiera zasoby dla programistów, które pomogą Ci przetestować te funkcje FLEDGE na Androidzie:

  • Dołącz do niestandardowej listy odbiorców lub ją opuść i obserwuj, jak wartości parametrów mogą wpływać na wyniki aukcji.
  • Pobieraj kod aukcji JavaScript ze zdalnych punktów końcowych
  • Konfigurowanie i inicjowanie aukcji reklam na urządzeniu
  • Obsługa raportów wyświetleń
  • Dla ułatwienia testowania udostępniamy przykładową aplikację i przykładową konfigurację serwera

Znane problemy:

Przedpremierowa wersja dla programistów 2

Data premiery: 17 maja 2022 r.

Wersja przedpremierowa dla programistów 2 zawiera wczesne wersje testowe interfejsów API do raportowania atrybucji MeasurementManager.

  • Możesz wywoływać metody registerSource() i registerTrigger(), aby rejestrować zdarzenia reklamowe w aplikacji i otrzymywać dane do raportu na poziomie zdarzenia na potrzeby atrybucji między aplikacją a aplikacją. Obecnie w Google stosujemy atrybucję ostatniego punktu kontaktu. Wysłanie raportów jest zaplanowane zgodnie z definicją w oknach raportowania. Więcej informacji znajdziesz w dokumentacji interfejsu API MeasurementManager.

  • Rzeczywiste przesyłanie raportu ma miejsce pod koniec ustalonych przedziałów czasu, a nie dokładnie o zaplanowanej godzinie. Interwał przesyłania raportów wynosi domyślnie 4 godziny, ale można go zastąpić tym poleceniem adb:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Przykładowa aplikacja i serwer technologii reklam referencyjnej do testowania interfejsów API zostaną opublikowane w kolejnej wersji.

  • Inne funkcje interfejsu API do raportowania atrybucji w MeasurementManager, takie jak raportowanie zbiorcze, atrybucja po instalacji i przekierowania, będą dostępne w jednej z kolejnych wersji.

Przedpremierowa wersja dla programistów 1

Data premiery: 28 kwietnia 2022 r.

Wersja przedpremierowa dla programistów 1 obejmuje wczesne wersje przedpremierowe interfejsów Topics API i SDK Runtime. Funkcje FLEDGE na Androida i interfejsów Attribution Reporting API zostaną udostępnione w jednej z przyszłych wersji.

  • Topics API
    • Interfejs getTopics() API zwraca obecnie wartości testowe na podstawie klasyfikacji offline niektórych aplikacji. Klasyfikacje na urządzeniu nie zostały jeszcze wdrożone.
    • Do zastępowania przedziałów czasu i obliczania epoki wymuszonej możesz używać poleceń adb.
    • Więcej informacji znajdziesz w przewodniku dla programistów Topics.
  • Środowisko wykonawcze SDK
    • Możesz tworzyć pakiety SDK działające w czasie działania aplikacji (RE SDK) i tworzyć pakiety, korzystając z nowego elementu <sdk-library> w pliku manifestu aplikacji. Zainstaluj pakiety SDK RE na obsługiwanym urządzeniu testowym lub emulatorze, tak jak w przypadku instalacji aplikacji na etapie programowania.
    • Możesz zintegrować aplikację z pakietami SDK RE, wczytać je w środowisku wykonawczym SDK i przetestować wpływ ograniczonego dostępu na kod pakietu SDK – uprawnienia, pamięć i komunikację między aplikacją a pakietem SDK. Interfejsy API do przechowywania danych w pakietach RE SDK nie zostały jeszcze wdrożone i zostaną udostępnione w przyszłej wersji.
    • Pakiet SDK może renderować banery reklamowe lub treści oparte na interfejsie WebView w środowisku wykonawczym SDK.
    • Więcej informacji znajdziesz w przewodniku dla programistów dotyczącym środowiska wykonawczego SDK.
  • Sprawdzanie lintowań na urządzeniach z Androidem
    • W projektach skompilowanych z poziomem interfejsu API TiramisuPrivacySandbox mogą występować błędy w sprawdzaniu lint Androida. Możesz na przykład zobaczyć komunikat z ostrzeżeniem: „Wywołanie wymaga poziomu interfejsu API 33”. Możesz tymczasowo rozwiązać ten problem, używając adnotacji @SuppressLint("NewApi").