Informacje o wersji Piaskownicy prywatności na Androida

Piaskownica prywatności na Androida oferuje programy wersji beta dla programistów i programy testów beta. Na będziemy wprowadzać nowe interfejsy API i funkcje w wersji przedpremierowej dla programistów, a także promować ustabilizowanych interfejsów API do programu testów beta. Zachęcamy do przesyłania opinii.

Jeśli jesteś nowym użytkownikiem Piaskownicy prywatności na Androida, zacznij od Programu Przegląd. Aby zacząć dodawać do projektu Piaskownicę prywatności, skonfiguruj środowisko programistyczne i pobierz Piaskownicę prywatności na Androida. na urządzeniu testowym lub emulatorze.

Bieżące wersje

Wersja przedpremierowa VanillaIceCream na Androida

Protected Audience API,

  • Możliwość przekazania uwierzytelnionych reklam kontekstowych do aukcji chronionej dodano. Obejmuje to też filtrowanie wykluczające w przypadku aplikacji już zainstalowanych na urządzenie oraz ograniczenie liczby wyświetleń, lub wygranej. Implementacja różni się od poprzednich iteracji, ponieważ reklamy muszą być podpisane przez zespół technologii reklamowej. Dowiedz się, jak to wdrożyć w przewodniku dla programistów.
  • ContextAds i powiązane z nim metody pobierania metoda ustawiająca w konfiguracji AdSelectionConfig; getPerBuyerSignedContextualAds, setPerBuyerSignedContextualAds
  • Jeśli zostanie przekazana nieuwierzytelniona aplikacja kontekstowa, zostanie ona usunięta z aukcja

Attribution Reporting API.

Aktualizacja Piaskownicy prywatności na Androida w listopadzie 2023 r. (wersja beta)

Ta wersja Piaskownicy prywatności na Androida (beta) zawiera aktualizacje Interfejsy API Piaskownicy prywatności na publicznych urządzeniach z Androidem 14. Pakiet SDK i obrazy urządzeń dostępne do pobrania przy użyciu Menedżera pakietów SDK w Android Studio jako interfejs Android API 34, jest to rozszerzenie na poziomie 10 i działa podobnie jak w wersji przedpremierowej dla programistów. 9 z kilkoma kluczowymi zmianami.

Protected Audience API,

  • Specjaliści ds. technologii reklamowych mogą teraz korzystać z przekazywania niestandardowych list odbiorców, aby dołączać do listy niestandardowych odbiorców w imieniu kupującego, który nie korzysta z urządzenia.
  • Android umożliwia teraz przeprowadzanie aukcji w usługach ustalania stawek i aukcji.
  • Aukcje z Protected Audience API obsługują płatności CPC.
  • Aukcje i raporty z Protected Audience API obsługują teraz nagłówki wersji danych dotyczące zaufanych sygnałów określania stawek.
  • Aukcje z Protected Audience API obsługują filtrowanie limitu wyświetleń na użytkownika w przypadku zdarzeń WIN.
  • Ochrona odbiorców obsługuje teraz integracji z Attribution Reporting API.

Attribution Reporting API.

Środowisko wykonawcze SDK

  • Możliwość wczytywania innych pakietów SDK w środowisku wykonawczym SDK na potrzeby obsługi tych pakietów przypadki użycia zapośredniczenia

Wcześniejsze wydania

Wersja przedpremierowa dla programistów 10

Data wydania: 19 grudnia 2023 r.

Znane ograniczenia

  • Wystąpił problem, który powoduje awarię Usług Google Play w i wielokrotnie informować użytkownika:
    • Ponowne uruchomienie urządzenia może rozwiązać ten problem.
    • Jeśli podczas testowania masz problemy z przekroczeniem limitu czasu wywołań asynchronicznych, spróbuj dodać to polecenie adb, aby wydłużyć próg do czasu oczekiwania:
    • adb shell device_config put adservices fledge_auction_server_overall_timeout_ms 60000;
  • Tylko urządzenie fizyczne: konto Google nie jest obsługiwane. Obserwuj Aby wyświetlić ekran główny urządzenia, wykonaj te czynności:
    • Zainstaluj obraz podglądu na telefonie.
    • korzystać z kreatora konfiguracji bez łączenia się z siecią Wi-Fi ani siecią komórkową.
    • Gdy pojawi się ekran główny, 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], do wyświetlania trafnych reklam promujących instalacje aplikacji. W ramach tego procesu udostępniamy Interfejsy API umożliwiające technikom reklamowym:
    • Selekcjonuj sygnały, przechowując zdarzenia aplikacji w chronionej pamięci na urządzeniu, służą do wyświetlania trafnych reklam promujących instalacje aplikacji.
    • Przeprowadzanie aukcji chronionej w przypadku usług związanych z określaniem stawek i aukcją Zaufane środowiska wykonawcze, w których mają dostęp do swoich sygnałów do wyboru reklam i ustalania stawek.

Attribution Reporting API.

  • Ta wersja Attribution Reporting API:
    • Dodano integrację z Protected Audience, która pozwala na utworzenie niestandardowych list odbiorców wymiarów w zbiorczych raportach zbiorczych.
    • Obsługuje dostawcę Google Cloud jako TEE dla usługi agregacji.
    • Dodaje pole shared_debug_key, aby umożliwić debugowanie w wielu sieciach atrybucja 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 wczesnego rozwoju.
  • Personalizacja na urządzeniu to innowacyjny sposób na personalizowanie produktów. i usług przy jednoczesnej lepszej ochronie prywatności użytkowników. Na urządzeniu Personalizacja stanowi zestaw usług i algorytmów, które są elementami składowymi w tym m.in.:
    • Federated Compute (FC), który umożliwia trenowanie, ocenę i personalizację używające sfederowanego uczenia się. Wykorzystanie sfederowanego dostępu do personalizacji na urządzeniu Obliczenia będą oparte na trenowaniu modelu i (opcjonalnie w razie potrzeby) wnioskowaniu.
    • Korzystając z filtra kukułki, a także dopasowywania krzyżowe danych, które są rozmieszczone w różnych miejscach.
    • Trenowanie rozproszone modele rozproszone za pomocą nowych technik takich jak naprzemienna minimalizacja DP (do trenowania w różnych sytuacjach dane zlokalizowane) i personalizację modeli na Billboardzie.

Podgląd dla programistów 9

Data wydania: 15 sierpnia 2023 r.

Znane ograniczenia

  • Dane z aukcji wygenerowane przez wywołanie interfejsu API określania stawek i aukcji nie są usuwane w DP9.
  • Wywołuję getAdSelectionData i persistAdSelectionResult po uzyskaniu zgody użytkownika spowodowała powodzenie procesu.
  • Funkcja filtrowania wykluczających nie działa z wartością getAdSelectionData i persistAdSelectionResult.

Protected Audience API,

Attribution Reporting API.

  • W tej wersji ulepszyliśmy raporty debugowania dotyczące Attribution Reporting API przez:
    • Obsługa szczegółowych raportów debugowania, które są obsługiwane na w internecie.
    • włączenie raportów debugowania atrybucji w różnych witrynach i aplikacjach (wymaga identyfikatora AdId w przypadku obu typów witryn). rejestracji na stronach internetowych i w aplikacjach).
  • Specjaliści ds. technologii reklamowych mogą konfigurować parametry szumu na potrzeby różnych scenariuszy raportowania.
  • W tej wersji przechodzimy do atrybucji opartej na pochodzeniu, co oznacza, że:
    • Punkt początkowy służy do rejestracji.
    • W jednej witrynie akceptowanych jest wiele źródeł.
    • Nowy limit liczby żądań wynoszący 1 źródło na aplikację źródłową lub rejestrację.
  • Specjaliści ds. technologii reklamowych mogą teraz wyłączyć rejestrację w celu testowania użycia raportów atrybucji przypadków w Twojej okolicy.

Środowisko wykonawcze SDK

  • Pakiet SDK może tylko uruchamiać usługi z listy dozwolonych lub tworzyć z nią powiązania.
  • Pakiet SDK ma dostęp tylko do podzbioru systemu ContentProvider (np. jako com.android.providers.settings.SettingsProvider), gdzie uzyskano dane nie zawiera identyfikatorów i nie może zostać użyta do utworzenia odcisku cyfrowego użytkownika. Te sprawdzanie obejmuje też dostęp do ContentProvider za pomocą ContentResolver.
  • Pakiet SDK ma dostęp tylko do podzbioru chronionych odbiorników (np. jako android.intent.action.AIRPLANE_MODE).
  • Pakiet SDK może uruchomić aktywność należącą do innej aplikacji, ale z ograniczeniami co może być przesyłane w intencji.

Aktualizacja Piaskownicy prywatności na urządzeniach z Androidem w marcu 2023 r. (wersja beta)

Wersja beta Piaskownicy prywatności na Androida z marca 2023 r. zawiera aktualizacje w interfejsach API Piaskownicy prywatności na publicznych urządzeniach z Androidem 13. W tej wersji: API rozszerzeń usług reklamowych 5 i działa podobnie do wersji przedpremierowej dla programistów 6 z kilkoma kluczowymi zmianami.

Znane ograniczenia

  • Zadanie pobierania w tle, które jest uruchamiane okresowo w celu aktualizacji niestandardowych danych FLEDGE powoduje zakłócenie procesu. Z tego powodu FLEDGE jest domyślnie wyłączone.

Ogólne

  • Interfejsu Attribution Reporting API możesz używać od tej wersji. Poprzedni interfejs API wcześniej wyłączone. Jeśli korzystasz z interfejsu Attribution Reporting API w poprzedniej wersji Wersja beta: zanim skorzystasz z tej wersji beta, wyczyść dane aplikacji lub urządzenia wykonując jedną z tych czynności:
    • Na urządzeniu lub emulatorze otwórz Ustawienia i wyczyść dane aplikacji pamięci (nie tylko pamięci podręcznej) na aplikacje używane do testowania.
    • Przywróć ustawienia fabryczne na urządzeniu fizycznym lub emulowanym.
    • W przypadku urządzenia emulowanego wykonaj funkcję Wyczyść dane.
  • Attribution Reporting obsługuje teraz klucze debugowania, dzięki czemu deweloperzy mogą otrzymywać niezmienione raporty i raporty rozszerzone o ochronie prywatności z narzędzia Atrybucja, API. Klucze debugowania dają lepszy wgląd w to, jak są uporządkowane w czasie przechodzenia na Piaskownicę prywatności.
  • W raportowaniu atrybucji wystąpił ostatnio błąd dotyczący reklamy Usługi, w których wystąpiły błędy registerSource i registerTrigger z wyjątki. Jeśli te problemy wystąpiły podczas programowania, poprawka spowodowała i powinny z czasem rozwiązać te problemy.
  • Funkcje podglądu interfejsu Topics API są teraz zgodne z włączoną Piaskownicą prywatności Android Developer Previews. Element wywołujący interfejs Topics API może wyświetlać podgląd tematów bez w tym funkcję pobierania tematów w cotygodniowych obliczeniach epoki lub wpływa na listę zaobserwowanych tematów u rozmówcy. Zapoznaj się z shouldRecordObservation, aby wyświetlić szczegóły.

  • Aby włączyć testy w FLEDGE na Androidzie, zarejestruj się w programie testów beta i użyj tego samego konta Google, aby zalogować się na urządzeniach testowych. W przeciwnym razie próby wywołania interfejsów API powodują IllegalStateException z komunikatem „Usługa jest niedostępna” . FLEDGE powinny zostać przywrócone w kolejnej wersji beta.

    Tymczasem możesz kontynuować testowanie w wersji przedpremierowej dla programistów. FLEDGE API można włączyć ręcznie na urządzeniach z tymi funkcjami: zastrzeżenia:

    FLEDGE API możesz włączyć za pomocą tych poleceń adb. Powoduje to jednak, może ulec awarii w tle, co negatywnie wpływa na stan systemu. danych. Nie jest to trwałe rozwiązanie, ponieważ te wartości mogą zostać zresetowane przez platformy.

    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

Podgląd dla programistów 8

Data wydania: 23 maja 2023 r.

Znane ograniczenia

  • Mimo że filtry limitu wyświetleń na użytkownika wpisanego w polu WIN można dodać do Protected Audience API reklam, typ WIN nie jest jeszcze obsługiwany, a filtry tego typu są zignorowano.
  • Aby generować raporty o wygranych wyświetleniach zwycięskim kupującym w Protected Audience API aukcji, kupujący muszą być zarejestrowani w Piaskownicy prywatności. To wymaganie nie można zastąpić.
  • Aby uzyskać dostęp do ustawień Piaskownicy prywatności na urządzeniu z jej ustawieniami wybierz Ustawienia > Google > Reklamy > Piaskownica prywatności.
  • Nie może wdrażać projektów z emulatorami w Android Studio Giraffe. Inne wersje w Android Studio. W Android Studio zostanie wprowadzona poprawka Żyrafa – 26 maja 2023 r.

Protected Audience API,

Attribution Reporting API.

  • Dodano filtry reguły LUB. Oznacza to, że filtry składają się teraz z zestawu filtrów, czyli listę map filtrów. Jeśli żadna z map filtrów w zestawie nie pasuje do danych filtra źródła, obiekt event_trigger_data jest ignorowany.
  • Okno wygaśnięcia wyświetlenia i okno raportowania na poziomie agregacji i zdarzenia. Interfejsy API zostały odłączone.
  • Dodaliśmy obsługę kluczy deduplikacji w raportach agregowanych.
  • Dodano tabelę scheduled_report_time do raportów zdarzeń, aby zapewnić zgodność z zasadami dotyczącymi prywatności Piaskownica w internecie.
  • Wdrożyliśmy atrybucję międzysieciową bez przekierowań.

Środowisko wykonawcze SDK

Wersja przedpremierowa dla programistów w wersji 7

Data wydania: 26 stycznia 2023 r.

FLEDGE w Androidzie API

  • Nazwa parametru custom_audience_signals została zmieniona w ten sposób: Metody JavaScript:
    • Nazwa generateBid() została zmieniona na custom_audience_bidding_signals.
    • Nazwa scoreAd() została zmieniona na custom_audience_scoring_signals.
    • Nazwa reportWin() została zmieniona na custom_audience_reporting_signals.
  • W tej wersji dodaliśmy nowe zastąpienie: selectAds, które wymaga ustawienia AdSelectionFromOutcomeConfig, aby porównać wyniki w usłudze selectAds. Dzięki temu pakiety SDK technologii reklamowych, które wykorzystują ten interfejs API do uruchamiania zapośredniczenia kaskadowego. Więcej szczegółów są opisane w przewodniku dla programistów.
  • Interfejs selectAds() API obsługuje teraz buforowanie na potrzeby logiki określania stawek i punktacji Kod JavaScript został pobrany podczas procesu wyboru reklamy.
    • Pamięć podręczna może być kontrolowana za pomocą nagłówków Cache-Control zwracanych przez podczas wywoływania pobierania JavaScriptu. Użyj no-cache lub no-store, aby zapobiega zapisywaniu odpowiedzi JavaScript w pamięci podręcznej, a parametr max-age do kontrolowania czasu przechowywania w pamięci podręcznej.
    • Bieżący wpis w pamięci podręcznej (max-age) jest domyślnie ustawiony na 2 dni.

Attribution Reporting on Android API.

  • W tej wersji dodaliśmy obsługę przekierowań w łańcuchu 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 wydania: 9 stycznia 2023 r.

Piaskownica prywatności na Androida w wersji beta 1 to pierwsza dostępność Piaskownicy prywatności Interfejsy API w trybie piaskownicy na urządzeniach publicznych i wprowadzają ulepszenia w kolejnych obszarach.

Ogólne

  • Piaskownica prywatności na Androida Beta 1 jest funkcjonalnie taka sama jak Program Wersja przedpremierowa 5 z kilkoma dodatkowymi funkcjami i ograniczeniami wymienionych poniżej.
  • Aby korzystać z funkcji związanych z reklamami, deweloperzy muszą ukończyć proces rejestracji. interfejsów API (w tym Topics, FLEDGE i Attribution Reporting). Rejestracja proces weryfikacji tożsamości dewelopera i zbierania niezbędnych danych przez interfejsy API.
  • Dzięki Piaskownicy prywatności na Androida (beta) deweloperzy, oraz jeśli są zarejestrowane na liście dozwolonych, mogą otrzymać możliwość do testowania na własnych urządzeniach fizycznych. Aby tworzyć aplikacje w oparciu o stabilne interfejsy API pobierz nowe 4 rozszerzenia usług reklamowych w pakiecie SDK.

Topics API,

Attribution Reporting API.

  • Raportowanie atrybucji zostało wyłączone i nie można go używać w wersji. Dostęp do tego interfejsu API powinien zostać ponownie włączony w następnej wersji beta. Zachęcamy do kontynuowania testów w ramach wersji przedpremierowej dla programistów.

Środowisko wykonawcze SDK

Poniższe ograniczenia powinny zostać usunięte w następnej głównej wersji Androida wersja platformy:

  • Renderowanie reklam w widoku przewijanym takim jak RecyclerView obecnie nie działają poprawnie. Przy zmianie rozmiaru elementu może wystąpić zacinanie się. Użytkownik zdarzenia przewijania dotykiem nie są prawidłowo przekazywane do środowiska wykonawczego.
  • Renderowanie WebView nie jest dostępne w procesie środowiska wykonawczego SDK.
  • Przechowywanie danych według pakietu SDK jest niedostępne.
  • Obsługa interfejsów API getAdId i getAppSetId nie została jeszcze aktywowana.

Podgląd dla programistów 6

Data wydania: 31 października 2022 r.

Piaskownica prywatności na Androida w wersji testowej 6 wprowadza ulepszenia następujące obszary:

Ogólne

  • W ramach przygotowań do wdrożenia w wersji produkcyjnej w wersji 6 Developer Preview pojawiła się flaga , aby domyślnie wyłączyć dostęp do interfejsu Privacy-Preserving API. Do celów testowych włącz dostęp do interfejsu Privacy-Preserving API w wersji przedpremierowej dla programistów, uruchamiając polecenie to polecenie:

    adb shell device_config put adservices global_kill_switch false

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

    • Na urządzeniu z systemem Android należy sprawdzić, czy odpowiednia wersja jest wymieniona w sekcji Ustawienia > Aplikacje > Usługi Google Play.
    • 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. Potem otwórz do Sklepu Google Play > ikonę profilu > Ustawienia > Informacje. W kolumnie Nagłówek Wersja Sklepu Play kliknij Zaktualizuj Sklep Play.
    • Ten krok ma zastosowanie tylko do programowania i testowania i nie będzie potrzebnych po wdrożeniu Piaskownicy prywatności dla użytkowników publicznych.

Topics API,

FLEDGE w Androidzie API

  • Jeśli przeprowadzasz testy z użyciem prawdziwych serwerów, włączenie interfejsu API jest teraz wymuszane. Wykonaj te czynności, aby skonfigurować urządzenie. Te kroki nie są wymagane, jeśli używasz zdalnych zastąpień dostępnych w przykładowej aplikacji.
  • Istotne zmiany:
    • Ciąg Url w parametrach zastąpiono wartością Uri. Dotyczy to wszystkich interfejsów FLEDGE API oraz niestandardowego kodu JavaScript do ustalania stawek i punktacji.
    • Z danych wejściowych interfejsu Custom Audience API usunięto pole owner.
  • Niekompletne listy niestandardowych odbiorców są teraz dostępne w tle odświeżyć.
  • Limit pamięci JavaScript został ustawiony na 10 MB. Dotyczy to określania stawek zasady punktacji.

Attribution Reporting API.

  • Specjaliści ds. technologii reklamowych muszą się zarejestrować, aby móc korzystać z raportów atrybucji API w wersji dla programistów w wersji 6. Zobacz Aby uzyskać więcej informacji, załóż konto Piaskownicy prywatności.
  • W tej wersji wprowadziliśmy klucze debugowania, które umożliwiają programistom odbieranie niezmienione raporty wraz z raportami rozszerzonymi dotyczącymi prywatności z narzędzia Interfejs API do raportowania. Klucze debugowania dają szansę na lepszy wgląd jak są uporządkowane raporty podczas przechodzenia na Piaskownicę prywatności.

Podgląd dla programistów 5

Ogólne

  • Zanim uzyskasz dostęp do interfejsów API Piaskownicy prywatności w wersji Developer Preview 5, musi najpierw włączyć interfejsy API i skonfigurować uprawnienia dla tych interfejsów.
    • Piaskownica prywatności na Androida pozwala użytkownikom na urządzeniach są aktywne interfejsy API chroniące prywatność oraz środowisko wykonawcze SDK. Te ustawienia są domyślnie wyłączone w wersji przedpremierowej dla programistów w wersji 5. Ty może włączyć dostęp przez interfejs API, używając polecenia adb.
    • Aplikacja wywołująca musi określić uprawnienia dotyczące interfejsu API w pliku manifestu powiązane konfiguracje AdServices, które kontrolują dostęp do umieszczonych pakietów SDK.
  • Gdy aplikacje działają na pierwszym planie, muszą wywoływać interfejsy API chroniące prywatność.
  • Usługi AdIdManager i AppSetIdManager nie są obecnie obsługiwane. Będą można włączyć w kolejnej wersji.

Środowisko wykonawcze SDK

  • Usługa sendData() zostanie wycofana w przyszłej wersji.
  • loadSdk() zwraca teraz obiekt IBinder, aby ułatwić komunikację dwukierunkową między pakietem SDK obsługującym środowisko wykonawcze a aplikacjami określonymi w AIDL.
  • Aplikacje mają dostęp do dodatkowych zdarzeń cyklu życia pakietu SDK w czasie działania aplikacji. np. po zakończeniu procesu SDK.

Attribution Reporting API.

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

  • Obsługa raportów dotyczących zaszyfrowanych danych zbiorczych.
  • Obsługa pomiarów w aplikacjach i witrynach
  • Skonsolidowane nagłówki w odpowiedziach źródłowych i aktywujących:
    • Źródło: Attribution-Reporting-Register-Aggregatable-Source jest teraz częścią programu z Attribution-Reporting-Register-Source
    • Reguła: Attribution-Reporting-Register-Event-Trigger, Attribution-Reporting-Register-Aggregatable-Trigger-Data i Do Attribution-Reporting-Register-Aggregatable-Values zostały zebrane w jeden nagłówek o nazwie Attribution-Reporting-Register-Event-Trigger
    • Attribution-Reporting-Redirects to nadal oddzielny nagłówek

FLEDGE w Androidzie API

Ta wersja zawiera kilka nowych funkcji i ulepszeń, a także zmiany:

  • Zmiany powodujące niezgodność:
    • Nazwę konta usługi runAdSelection() zmieniono na selectAds().
    • Zastąpiono parametr parametru AdSelectionConfig.Builder.setAdSelectionSignals() z AdSelectionSignals, która reprezentuje obiekt JSON.
    • Zastąpiono używanie atrybutu String do reprezentowania kupującego/sprzedawcy technologii reklamowych z nazwą obiekt AdTechIdentifier.
    • Dodano zajęcia TestCustomAudienceManager i TestAdSelectionManager do: zastępując zdalne pobieranie JavaScriptu.
    • Właścicielem listy odbiorców niestandardowych musi być nazwa pakietu aplikację do rozmów.
  • Interfejsy FLEDGE API sprawdzają teraz aplikację wywołującą pod kątem zestawu ograniczeń oraz ograniczeń opisanych w przewodniku dla programistów. Oto godne uwagi.
    • selectAds i reportImpression mają teraz limity czasu wykonywania kodu po które zostanie zakończone.
    • Usługi selectAds i reportImpression mają teraz limit używanej pamięci podczas wykonywania kodu JavaScript. Interfejsy API zgłaszają błąd, jeśli pamięć przekracza skonfigurowane limity.
    • selectAds i reportImpression sprawdzają teraz poprawność AdSelectionConfig , by zapewnić poprawność składni pól i upewnić się, że adresy URL w domenie eTLD+1 użytej w polu sprzedawcy.
    • AdServices weryfikuje odbiorców niestandardowych podczas ich tworzenia. Niektóre z weryfikacja obejmuje sprawdzenie, czy okres ważności jest prawidłowy, i stosuje do liczby niestandardowych list odbiorców, które może utworzyć aplikacja, oraz do całkowitego rozmiaru reklamy wyświetlone w wywołaniu joinCustomAudience. Podczas weryfikacji wymusza, aby identyfikatory URI udostępniane do pobierania sygnałów i logiki określania stawek oraz pobieranie w tle jest obsługiwane przez domenę kupującego.
  • Metadane niestandardowych odbiorców są aktualizowane codziennie przez pobieranie w tle .
  • Listy niestandardowych odbiorców są usuwane, gdy „właściciel” aplikacja jest odinstalowana.
  • Dodaliśmy obsługę określania zaufanych sygnałów punktowych i danych dotyczących zaufanego określania stawek podczas wyboru reklamy. Zobacz przykładowy kod, aby sprawdzić format odpowiedzi.
  • Interfejsy FLEDGE API na Androida wymagają komponentu 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 niestandardowej grupy odbiorców, platforma nie działa obecnie zgodnie z oczekiwaniami jest automatycznie aktualizowane w tle, jeśli jakiekolwiek metadane lub wartości AdData są puste lub null. Niestandardowa lista odbiorców nie kwalifikuje się do wyświetlania reklamy do momentu ich aktualizacji dzień później. Przyszła wersja będzie umożliwiaj natychmiastowe pobieranie w tle niepełnych niestandardowych list odbiorców aktualizacje. Bieżący domyślny limit pamięci na potrzeby wykonywania kodu JavaScript to zbyt niskie i może spowodować awarię JavaScriptEngine na urządzenia. Wykonanie JavaScriptu może zostać nieoczekiwanie przerwane wraz z komunikatem komunikat 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 niestandardowych odbiorców, które nie pasują do wymaganej struktury JSON, to: zaktualizowane podczas pobierania w tle.

Topics API,

Aktualizacje narzędzi

Android Studio Canary obsługuje tworzenie plików APK SDK z nowym typem modułu. Zaktualizowaliśmy Przewodnik po środowisku wykonawczym SDK dla programistów i Piaskownicę prywatności przykładowych aplikacji na GitHubie odzwierciedlają te zmiany.

Podgląd dla programistów 4

Data wydania: 14 lipca 2022 r.

Piaskownica prywatności w wersji testowej 4 dla programistów aplikacji na Androida wprowadza ulepszenia. następujące obszary:

Środowisko wykonawcze SDK

  • Aplikacje mogą teraz komunikować się z pakietami SDK z włączonym środowiskiem wykonawczym za pomocą dodanie sendData().
  • W procesie środowiska wykonawczego SDK jest teraz dostępna pamięć lokalna.
  • Pakiet SDK może też renderować samodzielne reklamy wideo lub treści w ramach pakietu SDK. Środowisko wykonawcze.
  • Dodaliśmy wyjaśnienia dotyczące użycia odczuć, aby uwzględnić możliwość używania pod warunkiem, że treści nie znajdują się w innym pakiecie RE-SDK.

Attribution Reporting API.

W tej wersji wprowadziliśmy zmiany, dzięki którym lepiej objaśnimy korzystanie z funkcji Interfejs API do raportowania, np.:

  • Zmiany w formacie raportu zbiorczego w celu zwiększenia czytelności.
  • Zaktualizowano pola nagłówka funkcji filtrowania konwersji i określania stawek.
  • W dokumentacji interfejsu WebApp API dodaliśmy wyjaśnienia dotyczące źródeł aktywuje rejestrację, a także dostępność interfejsu API do uzyskiwania zgody na przetwarzanie danych.

FLEDGE w Androidzie API

Ta wersja zawiera nowe funkcje pomagające w testowaniu i debugowaniu. jako wewnętrzne usprawnienia:

  • Dodaliśmy obsługę zastępowania zdalnych adresów URL przy pobieraniu danych logicznych JavaScript podczas programowania.
  • Ulepszyliśmy raportowanie błędów podczas wyboru reklamy.
  • Nieaktywne grupy odbiorców niestandardowych są teraz odfiltrowywane podczas wyboru reklamy.

Topics API,

W tej wersji wprowadziliśmy kilka istotnych zmian w interfejsie Topics API, z których większość Co ważne:

  • Typ zwrotu interfejsu API getTopics() został zmieniony na nowy Typ obiektu Topic, który zawiera identyfikatory całkowite odpowiadające Tematy w taksonomii oraz informacje o klasyfikatorze i taksonomii wersji. Należy zaktualizować wszystkie istniejące aplikacje za pomocą tego interfejsu API.
  • Interfejs Topics API wymaga teraz nowego, zwykłego uprawnienia.
  • Wprowadzenie „klasyfikatora na urządzeniu” do dynamicznego przypisywania Tematy wybrane na podstawie publicznie dostępnych informacji o aplikacjach.

Znane problemy

  • Pierwsza wersja tych obrazów urządzenia (wersja 6) nie wczytuje się Emulator Androida w wersji 31.2.10. Zaktualizowano obrazy urządzeń dotyczące: został poinformowany 27 lipca 2022 r.

Wersja przedpremierowa dla programistów 3

Data wydania: 9 czerwca 2022 r.

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

Attribution Reporting API.

Interfejs Attribution Reporting API zwiększa prywatność użytkowników, eliminując konieczność zależności identyfikatorów użytkowników z różnych firm i obsługują kluczowe przypadki użycia do pomiaru konwersji w aplikacjach.

Ta wersja zawiera materiały dla programistów, które pomogą Ci przetestować: Funkcje Attribution Reporting API:

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

Aby ułatwić testowanie, udostępniamy przykładową aplikację i referencyjny serwer technologii reklamowych

Znane problemy:

FLEDGE na urządzeniach z Androidem

FLEDGE na Androidzie wprowadza nowy sposób wyświetlania reklam na podstawie niestandardowych odbiorców przez deweloperów aplikacji i interakcjach w niej. To rozwiązanie przechowuje lokalnie informacje i powiązane z nimi reklamy oraz udostępnia platformę do a także zarządzać procesami wyboru reklam.

Ta wersja zawiera materiały dla deweloperów, które pomogą Ci przetestować FLEDGE na urządzeniach z Androidem:

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

Znane problemy:

Wersja przedpremierowa dla programistów 2

Data wydania: 17 maja 2022 r.

Podgląd dla programistów 2 obejmuje wczesne wersje przedpremierowe MeasurementManager interfejsów API do raportowania atrybucji.

  • Aby się zarejestrować, możesz zadzwonić pod numer registerSource() i registerTrigger() zdarzeń reklamowych w aplikacjach i otrzymywać dane raportowania na poziomie zdarzenia dla tej samej aplikacji o pochodzeniu danych. Obecnie stosowana jest atrybucja ostatniego punktu kontaktu. Częstotliwość wysyłania raportów jest zaplanowana zgodnie z definicją podaną w raporcie Windows. Zapoznaj się z interfejsem API MeasurementManager tutaj znajdziesz więcej informacji.

  • Rzeczywiste przesyłanie raportu ma miejsce po ustalonych odstępach czasu, a nie w konkretnym terminie. Interwał przesyłania raportów to domyślnie 4 godziny, ale można to zmienić za pomocą tego narzędzia adb polecenie:

    adb shell device_config put adservices measurement_main_reporting_job_period_ms <duration in milliseconds>

  • Przykładowa aplikacja i referencyjny serwer technologii reklamowych do testowania interfejsów API opublikowanej w przyszłej wersji.

  • Inny interfejs API do raportowania atrybucji MeasurementManager funkcje takie jak raportowanie zbiorcze, atrybucja po instalacji i przekierowania będą dostępne w nadchodzącej wersji.

Wersja przedpremierowa dla programistów 1

Data wydania: 28 kwietnia 2022 r.

Podgląd dla programistów 1 obejmuje wczesne wersje przedpremierowe interfejsów Topics API oraz Środowisko wykonawcze SDK. Funkcje FLEDGE na Androidzie oraz Interfejsy Attribution Reporting API będą dostępne w przyszłą wersję.

  • Topics API,
    • Interfejs API getTopics() zwraca obecnie wartości testowe na podstawie danych offline dla ograniczonej liczby aplikacji. Klasyfikacje na urządzeniu są jeszcze nie zaimplementowano.
    • Za pomocą poleceń adb możesz zastępować przedziały epoki i regułę force-trigger i obliczenia epoki.
    • Więcej informacji znajdziesz w przewodniku dla programistów Topics API.
  • Środowisko wykonawcze SDK
    • Możesz spakować i kompilować pakiety SDK dostępne w czasie działania aplikacji za pomocą Element <sdk-library> w pliku manifestu aplikacji z pakietem SDK. Zainstaluj pakiety SDK RE na obsługiwanym urządzeniu testowym lub emulatorze, tak jak w przypadku instalowania w fazie tworzenia aplikacji.
    • Możesz zintegrować aplikację z pakietami SDK RE, wczytać je w środowisku wykonawczym SDK i sprawdzić wpływ ograniczonego dostępu na kod SDK – uprawnienia, pamięci i komunikacji między aplikacjami. Interfejsy Storage API dla pakietów SDK RE nie są jeszcze zaimplementowanej, więc zostaną udostępnione w przyszłej wersji.
    • Pakiet SDK może renderować banery reklamowe lub treści oparte na WebView w Środowisko wykonawcze SDK.
    • Więcej informacji znajdziesz w przewodniku dla programistów środowiska wykonawczego SDK.
  • Testy Android Lint
    • Sprawdzanie lintowania Androida może nieprawidłowo wyświetlać ostrzeżenia w skompilowanych projektach poziom interfejsu API: TiramisuPrivacySandbox. Na przykład możesz zobaczyć komunikat ostrzegawczy: „Wywołanie wymaga poziomu interfejsu API 33”. Tymczasowo możesz: użyj adnotacji @SuppressLint("NewApi").