Testowanie w Chrome

Aby przygotować się na wycofanie plików cookie innych firm, zapewniamy obsługiwane przez Chrome tryby testowania, które umożliwiają witrynom sprawdzenie, jak witryny działają i funkcje działają bez plików cookie innych firm. W tym przewodniku omówienie trybów testowania, które zamierza udostępnić Chrome, oraz sposobów uzyskiwania do nich dostępu etykiety grupy eksperymentalnej.

Przeglądarka Chrome w tym kontekście oznacza klienta Chrome: Chrome instalacji na urządzeniu. Dane poszczególnych użytkowników katalogu stanowi oddzielnego klienta.

Grupa eksperymentalna: zestaw przeglądarek Chrome, w których działają określone funkcje które są włączone, wyłączone lub skonfigurowane. W kontekście zapewnianym przez Chrome do testowania, czyli zestawu przeglądarek, dla których ustawiono etykiety.

Etykieta: w tym kontekście nagłówek żądania. ustawiona dla przeglądarki należącej do grupy eksperymentalnej. Każda przeglądarka w grupie eksperymentalnej pozostanie w tej grupie przez cały czas trwania eksperymentu. oraz testów przeprowadzanych przy użyciu Chrome. Dzięki temu etykieta dla przeglądarka pozostaje spójna wśród testerów.

Oferujemy 2 różne tryby:

• Tryb A: od listopada 2023 r. organizacje testujące interfejsy PS R&M API można włączyć otrzymywanie spójnych etykiet na podzbiorze Chrome w różnych przeglądarkach, aby umożliwić skoordynowane testowanie przez różnych testerów.
• Tryb B: od 4 stycznia 2024 r. przeglądarka Chrome będzie wyłączona na całym świecie plików cookie innych firm w części przeglądarek Chrome.

Gdzie są pliki cookie innych firm wyłączone w trybie B, pozostaną wyłączone do końca plików cookie innych firm.

Współpracujemy z CMA aby mieć pewność, że te tryby testowania są zgodne ze platformą testowania (oraz ramy czasowe) dla osób trzecich, zgodnie z wytycznych dotyczących testów branżowych. W związku z tym CMA przewiduje, że wyniki testowania w tych trybach mogą zostać wykorzystane do oceny Piaskownicy prywatności. Agencja CMA poinformowała, że mogą w większym stopniu przypisywać do wyników projektu Experimental Design 2, w którym wykorzystuje się etykiety trybu B i etykiety trybu A 1. Zobacz CMA – wytyczne z 26 października więcej informacji na temat projektowania eksperymentalnego 2.

Dostęp do etykiet można uzyskać za pomocą tymczasowej wartości Cookie-Deprecation z nagłówka HTTP lub interfejsu JavaScript API. Zobacz późniejszą sekcję Uzyskiwanie dostępu do etykiet przy użyciu wartości „Wycofanie plików cookie” .

Wyślemy też tę propozycję w zwykły sposób Proces tworzenia aplikacji Blink, na którym kończymy projekt techniczny i etap wydania Chrome. To wdrożenie, które chcielibyśmy wprowadzić, dodatkowe omówienie i zatwierdzenia, co oznacza, że dane te mogą ulec zmianie. Będziemy kontynuować , aby aktualizować tę stronę w miarę postępów planów. Możesz przekazać opinię lub zadać pytania.

Tryb A: oznaczone etykietami grupy przeglądarek

Organizacje biorące udział w testach będą mogły wyrazić zgodę na otrzymywanie stały zestaw etykiet dla podzbioru przeglądarek Chrome, który umożliwia skoordynowanych eksperymentów obejmujących różne technologie reklamowe w tym samym zestawie przeglądarek. Jeśli np. przeglądarka należy do grupy eksperymentalnej label_only_3 (jako jak pokazano w tabeli poniżej), wszystkie technologie reklamowe uczestniczące w programie zobaczyć tę samą etykietę label_only_3 i zastosować odpowiednie współrzędne: użyj wartości PS. interfejsów API R&M, ale nie używaj plików cookie innych firm. Spodziewamy się uczestników za aby mieć pewność, że etykiety są przekazywane innym uczestnikom, aby umożliwić konsekwentnego eksperymentowania w całym procesie wyboru reklamy pomiar skuteczności.

Dzięki temu wielu uczestników może na przykład Protected Audience API, aukcji bez plików cookie innych firm w tej samej grupie przeglądarek. sprzedawcy biorący udział w aukcji przekazują zaobserwowaną etykietę kupującym, ułatwiają skoordynowane testy.

Etykiety nie mają wpływu na działanie tych wystąpień Chrome, łącznie z dostępnością plików cookie innych firm. Etykiety zawierają dla niezależnych, skoordynowanych eksperymentów. do egzekwowania odpowiednich parametrów eksperymentu. Jeśli testujesz efekt usunięcia plików cookie innych firm, odpowiada za wykluczanie danych z plików cookie innych firm w przypadku przeglądarek, które .

Celem jest utworzenie grup reprezentatywnych dla normalnego ruchu w Chrome. Ten oznacza, że powinny być dostępne zarówno pliki cookie innych firm, jak i interfejsy PS R&M API, część użytkowników mogła użyć ustawień lub rozszerzeń, aby zmienić lub wyłączyć funkcje zabezpieczeń.

Etykiety będą zasadniczo trwałe przez całą sesję przeglądania w Chrome, między sesjami. Nie jest to jednak gwarantowane, ponieważ zdarzają się rzadko gdzie całkowite zresetowanie przeglądarki może również spowodować zresetowanie bieżącej etykiety.

Planujemy udostępnić 8, 5% stabilnych przeglądarek Chrome w trybie A. wstępna propozycja dzieli tę populację na dziewięć grup. Mniejsze podgrupy mają zapewnić technikom reklamowym elastyczność w łączeniu etykiet w celu do własnych eksperymentów o różnej wielkości. Grupy się nie nakładają.

Pamiętaj, że etykiety control_1.* powinny być używane jako „Element sterujący 1” jako omówione w wytyczne dotyczące testów branżowych, więc uczestnicy testów nie powinni używać interfejsu Topics API ani używać Protected Audience API aukcji na ten ruch. Etykiety nie wpływają na działanie przeglądarki, uczestnicy nie powinni przekazywać zaobserwowanych tematów ani brać udziału w aukcjach z Protected Audience API. gdy wykryje etykiety grupy control_1.*.

Zapraszamy opinia tego, czy taki wybór grup spełnia potrzeby uczestnictwa organizacji non-profit.

Grupy przeglądarek w trybie A label_only_ są dostępne od listopada 2023 r. Grupy trybu A control_1_* zostały udostępnione od 4 stycznia 2024 r.

Tryb B: wyłącz 1% plików cookie innych firm

Przeglądarka Chrome wyłączyła pliki cookie innych firm w przypadku około 1% wersji stabilnej Chrome przeglądarek od 4 stycznia 2024 r. (oraz w wersji deweloperskiej, Canary i beta). przeglądarek w IV kwartale 2023 r.). Organizacje testujące interfejsy PS R&M API nie muszą włącz ten tryb, ponieważ jest on stosowany jednolicie w całej przeglądarce populacji. Oczywiście istnieje możliwość, że niektóre funkcje witryny jeśli witryna nie wdrożyła jeszcze alternatywnego rozwiązania, takiego jak CHIPS lub Zestawy powiązanych witryn.

Planujemy też udostępnić w trybie B niewielką część ruchu, ma wyłączone interfejsy PS R&M API. innych interfejsów API, takich jak zestawy powiązanych witryn, CHIPS czy Usługa FedCM nie zostanie wyłączona. Mamy nadzieję, że to połączenie będzie pomocne aby uzyskać podstawową wydajność w przeglądarkach bez plików cookie innych firm bez interfejsów API PS R&M.

W ramach trybu B udostępniamy etykiety przeglądarek, których dotyczy problem. etykiety są dostępne jednocześnie z wyłączonymi interfejsami API. Jesteśmy z propozycją podziału populacji na 3 grupy treatment_1.*, przy czym pliki cookie innych firm są wyłączone, ale dostępne są interfejsy PS R&M API oraz control_2, w której są zarówno pliki cookie innych firm, jak i interfejsy API PS R&M wyłączono.

Pomoc w debugowaniu interfejsu Attribution Reporting API i agregacji prywatnej integracje z interfejsami API i ułatwianie uczestnikom testów w lepszym poznaniu szumu. wpływ, raporty na temat debugowania AAR i raporty na temat debugowania prywatnej agregacji być dostępne dla przeglądarek w trybie B, o ile użytkownik nie wyraźnie zablokowało pliki cookie innych firm. Raporty debugowania nie będą dostępne w tych krajach: control_2, ponieważ interfejsy PS R&M API są niedostępne w tym wycinku. Raporty debugowania będą nadal wycofywane wraz z wycofaniem plików cookie innych firm.

• W interfejsie Attribution Reporting API pliki cookie innych firm są wyłączone, źródła raportowania nie będzie możliwe do ustawienia pliku cookie ar_debug i powinna polegać na ustawieniu pól debug_key (w przypadku raportów o sukcesie atrybucji) i pola debug_reporting (do szczegółowych raportów) raportów), aby włączyć lub wyłączyć otrzymywanie raportów na temat debugowania.
• W przypadku interfejsu Private Aggregation API źródło raportowania powinno polegać na wywołaniu enableDebugMode(), aby zarządzać zgodą na otrzymywanie raportów z debugowania. Firmy powinny Zastanów się, jakie zobowiązania prawne mogą mieć zastosowanie w przypadku korzystania z Atrybucja Interfejs API do raportowania i Private Aggregation API, w tym raporty na temat debugowania.

Tryb A działa nadal, a grupy te różnią się od grup trybu A, ponieważ czy użytkownik znajduje się w trybie A, w trybie B lub w żadnym z nich. Uczestnicy testu powinien używać ruchu control_1.* jako grupy kontrolnej reprezentującej stan za pomocą plików cookie innych firm.

Ograniczyliśmy też używanie plików cookie w 20% klientów Chrome Canary, Dev i beta.

Uwzględnienie w jednej z tych grup eksperymentalnych będzie miało taki sam efekt jak ich stabilne odpowiedniki.

Tak jak w przypadku trybu A, nie możemy zagwarantować dostępności interfejsów API PS R&M, ponieważ możesz je wyłączyć w ustawieniach Prywatność i bezpieczeństwo Chrome. Podobnie, nie możemy zagwarantować, że pliki cookie innych firm zostaną wyłączone w każdym grupę control_2, ponieważ użytkownicy mogą korzystać z UI przeglądarki i zezwolić na aplikacje innych firm. pliki cookie danej witryny.

Monitorowanie eksperymentów

Sprawdzaj względną wielkość ruchu w każdej grupie eksperymentalnej i kontrolnej. . treatment_1.1 powinna generować mniej więcej taką samą ilość ruchu jak treatment_1.2 i treatment_1.3.

Zalecamy rozwagę w kwestii ruchu zawierającego etykiety pochodzące z Chrome w wersji starszej niż 120. Jeśli Twój zespół, który zwykle zajmuje się nieprawidłowy ruch identyfikuje klienty użytkownika, które wykazują cechy nieprawidłowego ruchu ruchu, warto odfiltrować je z wyników testów.

Etykiety z okresu przed wprowadzeniem

Do stycznia 2024 r. prowadziliśmy okresy poprzedzające kilka grup eksperymentalnych: okres, na który Chrome ma możliwość dokładnego doboru wymiarów i wybierania statystyk obiektywnych grup. Te okresy wstępne obejmowały wszystkie grupy eksperymentalne, które zostały zaplanowane aby rozpocząć w styczniu: części trybu B i Control_1.*. Nie ma potrzeby działania deweloperskie lub w witrynie. W grupach poprzedzających ten okres w działaniu lub dostępności interfejsu API, ale pamiętaj, że mogą pojawić się etykieta preperiod zwrócona w pewnych sytuacjach. Chociaż przeglądarki otrzymujące Etykieta preperiod może zostać przeniesiona do jednej z grup eksperymentalnych. To nie jest jest gwarantowana, więc nie zalecamy zakładania, że przeglądarki z tą etykietą na pewno będą uwzględnieni w eksperymencie.

Grupa eksperymentalna jest podzbiorem populacji objętej badaniem. jedną z oznaczonych etykietą.

Uzyskiwanie dostępu do etykiet za pomocą wartości „Wycofanie plików cookie”

Na czas trwania trybu A i B wprowadziliśmy tymczasowe Wartość Cookie-Deprecation jest dostępna za pomocą opcjonalnego nagłówka HTTP i kodu JavaScript API, który dostarcza etykietę odpowiedniego trybu A lub B przeglądarki grupy eksperymentalnej (zgodnie z powyższymi wartościami procentowymi), jeśli należy do jednej z ich.

Dostęp do etykiet obejmuje dostęp do informacji przechowywanych na urządzeniu użytkownika. W w niektórych jurysdykcjach (takich jak UE czy Wielka Brytania), zdajemy sobie sprawę, że jest to analogicznie do wykorzystywania plików cookie, a przez to dostęp do etykiet prawdopodobnie wymaga zakończenia. zgody użytkownika. Zanim zaczniesz wysyłać żądania etykiet, wyszukaj poradę prawną dotyczącą tego, czy ten obowiązek uzyskania zgody Cię dotyczy.

Dostęp do nagłówka HTTP Sec-Cookie-Deprecation

Aby odebrać nagłówek żądania Sec-Cookie-Deprecation, witryna musi najpierw ustawić witrynę pliku cookie receive-cookie-deprecation. Ten plik cookie musi używać funkcji Partitioned co oznacza, że wyrażenie zgody na otrzymywanie nagłówka witryny najwyższego poziomu.

Jeśli na przykład 3p-example.site chce otrzymać Sec-Cookie-Deprecation w zasobach umieszczonych w witrynie example.com, a następnie 3p-example.site musi ustaw następujący plik cookie w tym kontekście.

Set-Cookie: receive-cookie-deprecation=1; Secure; HttpOnly; Path=/; SameSite=None; Partitioned;  Max-Age=15552000

Atrybuty plików cookie Secure, HttpOnly, SameSite i Partitioned są obowiązkowe. Pozostałe atrybuty: Domain, Path, Expires i Max-Age mogą ustaw odpowiednio do swoich potrzeb, chociaż Path=/ jest dobrym ustawieniem domyślnym. Przykład tutaj ustawiana jest wartość Max-Age=15552000, tak aby plik cookie nie wygasał dopiero po 180 dni.

Możesz zacząć ustawiać plik cookie receive-cookie-deprecation=1 przed rozpoczęciem okresu testowania obsługiwanego przez Chrome, aby mieć pewność, przeglądarki w grupie eksperymentalnej obejmują Sec-Cookie-Deprecation nagłówka żądania, gdy tylko będzie dostępny.

Jeśli np. przeglądarka należy do grupy example_label_1, kolejne żądania, które zawierają ten plik cookie, będą również zawierać tag Sec-Cookie-Deprecation nagłówek.

Sec-Cookie-Deprecation: example_label_1

Jeśli przeglądarka nie należy do grupy, nie zostanie wysłany żaden nagłówek. Etykiety są powiązane z obecnością pliku cookie, więc po jego usunięciu całkowicie lub całkowicie dla konkretnej witryny, etykiety nie zostaną wysłano. Ponieważ atrybut Partitioned jest przeznaczony do dalszego używania po pliki cookie innych firm zostały całkowicie wycofane, co oznacza, że pliki cookie Partitioned mogą musi być ustawiana, gdy pliki cookie innych firm są blokowane.

Uzyskiwanie dostępu do interfejsu API JavaScriptDeprecationLabel

Dostęp do wartości Cookie-Deprecation możesz też uzyskać za pomocą navigator.cookieDeprecationLabel.getValue() JavaScript API. Zwróci to obietnicę, która przechodzi do ciągu zawierającego odpowiednią etykietę grupy. Dla: Jeśli na przykład przeglądarka należy do grupy example_label_1:

// Feature detect temporary API first
if ('cookieDeprecationLabel' in navigator) {
 // Request value and resolve promise
 navigator.cookieDeprecationLabel.getValue().then((label) => {
   console.log(label);
   // Expected output: "example_label_1"
 });
}

Jeśli przeglądarka nie należy do grupy, interfejs API będzie niedostępny lub wartością jest pusty ciąg znaków, więc pamiętaj o wykrywaniu cech.

Interfejs JavaScript API może być wywoływany niezależnie od obecności Plik cookie receive-cookie-deprecation. Jeśli jednak pliki cookie są całkowicie blokowane, lub konkretnie dla witryny, interfejs API znów będzie niedostępny lub zwróci pusty ciąg znaków.

Tak jak w przypadku każdej wartości przekazywanej przez klienta, upewnij się, że dane z nagłówka lub z JavaScript API przed użyciem.

Demonstracje i testowanie

Od Chrome 120 w kolejnych wersjach dostępne są flagi, które umożliwiają lokalnym programistom sprawdzania żądań i odczytu etykiet.

Flaga chrome://flags/#tpc-phase-out-facilitated-testing pozwala włącz wybór etykiet testowych. Te etykiety mają prefiks od fake_ do odróżniać je od prawdziwych etykiet. Włączenie flagi nie powoduje wyłączenia do dowolnej z grup eksperymentalnych.

Działanie etykiet możesz zobaczyć na stronie goo.gle/cft-demo.

Ponieważ wymuszanie rejestracji jest związane z trafnością i pomiarami Piaskownicy prywatności interfejsów API; może być konieczne zastąpienie wymuszania na potrzeby testów lokalnych za pomocą: chrome://flags/#privacy-sandbox-enrollment-overrides i udostępnianie wersji demonstracyjnej pochodzeniu danych. Możesz też dodać tę flagę wiersza poleceń, jeśli uruchamianie Chrome z terminala: --args --disable-features=EnforcePrivacySandboxAttestations

Menu flag zawiera wiele opcji. Testerzy będą przede wszystkim zainteresowani wpisami oznaczonymi „Force” ponieważ zapewniają one, że eksperyment jest włączone niezależnie od innych konfiguracji urządzeń.

Aby przetestować tylko etykiety grup eksperymentalnych, wybierz „Włączono wymuszanie kontroli 1” lub „Włączono wymuszanie tylko etykiet”. Dzięki temu przeglądarka będzie „fake_control_1.1” lub „fake_label_only_1.1” etykiety.

W Chrome M120 i nowszych możesz też używać tych wpisów.

Aby przetestować blokowanie plików cookie innych firm, wybierz „Włączono wymuszanie traktowania”. Ten będzie wysyłać parametr „fake_treatment_1.1” etykiecie grupy eksperymentalnej, a także zmienić ustawień plików cookie i ich bieżących ustawień, aby blokować pliki cookie innych firm.

Aby przetestować blokowanie plików cookie innych firm bez interfejsów API do wyświetlania reklam prywatnych, wybierz „Wymuś Element sterujący 2”. Spowoduje to wysłanie parametru „fake_control_2” etykieta grupy eksperymentalnej, aktualizacja ustawień plików cookie, zablokować pliki cookie innych firm oraz zablokować nowy z interfejsami API reklam prywatnych.

Zwróć uwagę, że występuje problem polegający na tym, że w przeglądarce nadal jest plików cookie innych firm i ustawienia, które blokuje pliki cookie innych firm, nawet jeśli wyłączyć flagę. Pracujemy nad rozwiązaniem tego problemu, a w międzyczasie możesz przetestować te wartości w osobnym katalogu danych Chrome, uruchamiając Chrome z flagą wiersza poleceń --user-data-dir=<new dir>.

Prześlij opinię

Używamy funkcji „chrome-testing” w repozytorium pomocy dla deweloperów na GitHubie. Zapraszamy opinie i dyskusje na temat pytań początkowych:

• Czy planujesz testy z użyciem trybu A, trybu B czy obu tych trybów?
• Wybieranie rozmiarów etykiet do testowania w Chrome
• Wykorzystanie wskazówek klienta do testowania w Chrome

Możesz też zgłaszanie nowych pytań lub dyskusji. za pomocą „testów obsługiwanych przez Chrome”. szablon.