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. Z tego przewodnika dowiesz się, jakie tryby testowania zamierzamy udostępnić w Chrome, i jak uzyskać dostęp do etykiet grup eksperymentalnych.

Przeglądarka Chrome w tym kontekście oznacza klienta Chrome: Chrome instalacji na urządzeniu. Każdy katalog danych użytkownika jest oddzielnym klientem.

Grupa eksperymentalna: zestaw przeglądarek Chrome, w których włączono, wyłączono lub skonfigurowano określone funkcje. W kontekście testowania wspomaganego przez Chrome – zestaw 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 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ółpracowaliśmy z CMA, aby upewnić się, że te tryby testowania są zgodne z ramami testowania (i harmonogramem) dla firm zewnętrznych określonymi w wytycznych dotyczących testowania w branży. W związku z tym CMA przewiduje, że wyniki testowania w tych trybach mogą zostać wykorzystane do oceny Piaskownicy prywatności. CMA wskazało, że przywiązuje większą wagę do wyników z eksperymentalnej wersji 2, która używa etykiet trybu B i etykiet kontrolnych trybu A. Więcej informacji o wersji 2 projektu eksperymentalnego znajdziesz w wytycznych CMA z 26 października.

Dostęp do etykiet można uzyskać za pomocą tymczasowej wartości Sec-Cookie-Deprecation z nagłówka HTTP lub interfejsu JavaScript API. Szczegółowe informacje o wdrożeniu znajdziesz w sekcji Dostęp do etykiet za pomocą wartości Sec-Cookie-Deprecation.

Prześlemy też tę propozycję w ramach zwykłego procesu rozwoju Blinka, w którym zostanie sfinalizowane techniczne zaprojektowanie i osiągnięcie kamienia milowego w 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 kontynuować 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 na przykład przeglądarka należy do grupy eksperymentalnej label_only_3 (jak pokazano w tabeli poniżej), wszystkie uczestniczące technologie reklamowe będą mogły zobaczyć tę samą etykietę label_only_3 i odpowiednio się do niej dostosować: używać interfejsów PS R&M, ale nie używać 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.

Umożliwia to np. wielu uczestnikom prowadzenie aukcji Protected Audience bez plików cookie innych firm w konsekwentnej 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 instancji Chrome, w tym na dostępność plików cookie innych firm. Etykiety zawierają dla niezależnych, skoordynowanych eksperymentów. do egzekwowania odpowiednich parametrów eksperymentu. Jeśli testujesz wpływ usuwania plików cookie innych firm, każdy uczestnik jest odpowiedzialny za wykluczanie danych plików cookie innych firm w przypadku przeglądarek z taką etykietą.

Celem jest tworzenie grup, które są reprezentatywne 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 są zwykle trwałe w całości sesji przeglądania w Chrome oraz w kolejnych sesjach. Nie jest to jednak gwarantowane, ponieważ w rzadkich przypadkach całkowite zresetowanie przeglądarki może 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. Ponieważ etykiety nie wpływają na działanie przeglądarki, uczestnicy nie powinni przekazywać tematów obserwowanych ani przeprowadzać aukcji Protected Audience, gdy wykryją etykiety grupy control_1.*.

Zapraszamy do wysłania opinii na temat tego, czy ta grupa organizacji spełnia potrzeby organizacji biorących udział w programie.

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

Od 4 stycznia 2024 r. Chrome wyłączył pliki cookie innych firm w przypadku około 1% przeglądarek Chrome stabilnej (a także w Chrome deweloperskiej, Canary i beta 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. Jeśli witryna nie wdrożyła jeszcze alternatywnego rozwiązania, takiego jak CHIPS lub powiązane zestawy witryn, może to mieć wpływ na niektóre funkcje witryny.

Dodatkowo planujemy kierować niewielką część ruchu w ramach trybu B do interfejsów PS R&M API, które mają wyłączone. Inne interfejsy API, takie jak zestawy powiązanych witryn, CHIPS i FedCM, nie zostaną wyłączone. 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 też etykiety dla 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ą wycofywane wraz z wycofaniem plików cookie innych firm.

• W przypadku interfejsu Attribution Reporting API, ponieważ pliki cookie innych firm są wyłączone, źródło raportowania nie będzie mogło ustawić pliku cookie ar_debug i powinno zamiast tego ustawić pola debug_key (w przypadku raportów o skuteczności atrybucji) i pola debug_reporting (w przypadku szczegółowych raportów), aby wyrazić zgodę na otrzymywanie raportów debugowania lub zrezygnować z ich otrzymywania.
• W przypadku interfejsu Private Aggregation API źródło raportowania powinno polegać na wywołaniu metody enableDebugMode(), aby kontrolować otrzymywanie raportów 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 testów powinni użyć ruchu control_1.* jako grupy kontrolnej, która reprezentuje stan obecny z plikami cookie innych firm.

Chrome ograniczył też pliki cookie w 20% klientów Chrome Canary, deweloperskiej i beta.

Uwzględnienie w jednej z tych grup eksperymentalnych będzie miało taki sam skutek jak w przypadku ich odpowiedników w wersji stabilnej.

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. Nie ma też pewności, że pliki cookie innych firm są wyłączone dla wszystkich członków grupy control_2, ponieważ użytkownicy mogą uzyskać dostęp do interfejsu przeglądarki, aby zezwolić na pliki cookie innych firm w witrynie.

Monitorowanie eksperymentu

Sprawdzaj względną wielkość ruchu w każdej grupie eksperymentalnej i kontrolnej. . Wartość treatment_1.1 powinna być zbliżona do wartości 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 zespół, który zwykle zajmuje się nieprawidłowym ruchem, wykryje przeglądarki użytkowników wykazujące cechy nieprawidłowego ruchu, warto odfiltrować je z wyników testów.

Etykiety przed okresem

Do stycznia 2024 r. mieliśmy okresy wstępne w przypadku kilku grup eksperymentalnych. Ten okres przed pozwala Chrome na dokładne dobór wymiarów i danych statystycznych obiektywnych grup. Te okresy wstępne obejmowały wszystkie grupy eksperymentalne zaplanowane na styczeń: grupy eksperymentalne w trybie B i grupy eksperymentalne 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 z oznaczeniem preperiod mogą zostać przeniesione do jednej z grup eksperymentalnych, nie jest to gwarantowane. Nie należy więc zakładać, że przeglądarki z tym oznaczeniem z pewnością uczestniczą w eksperymencie.

Grupa eksperymentalna to podzbiór badanej populacji, w tym przypadku jedna z oznaczonych grup.

Dostęp do etykiet za pomocą wartości Sec-Cookie-Deprecation

Na czas trwania trybu A i B wprowadziliśmy tymczasową wartość Sec-Cookie-Deprecation, do której można uzyskać dostęp za pomocą nagłówka HTTP i interfejsu API JavaScriptu. Umożliwia ona określenie etykiety grupy eksperymentalnej trybu A lub B przeglądarki (zdefiniowanej przez powyższe wartości procentowe), jeśli przeglądarka należy do jednej z nich.

Dostęp do etykiet wymaga dostępu 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 otrzymać nagłówek żądania Sec-Cookie-Deprecation, witryna musi najpierw ustawić plik cookie receive-cookie-deprecation. Plik cookie musi zawierać atrybut Partitioned, co oznacza, że zgoda na otrzymywanie nagłówka musi być wyrażana osobno dla każdej 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ą wymagane. Atrybuty Domain, Path, Expires i Max-Age możesz ustawić tak, aby najlepiej odpowiadały Twoim potrzebom. Domyślnie używany jest tag Path=/. W tym przykładzie parametr Max-Age=15552000 ma wartość 180, co oznacza, że plik cookie nie wygaśnie przed upływem 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 znajduje się w grupie example_label_1, kolejne żądania zawierające ten plik cookie będą też zawierać nagłówek Sec-Cookie-Deprecation.

Sec-Cookie-Deprecation: example_label_1

Jeśli przeglądarka nie należy do grupy, nagłówek nie zostanie wysłany. 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 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.

Dostęp do interfejsu cookieDeprecationLabel JavaScript API

Do wartości Sec-Cookie-Deprecation można też uzyskać dostęp za pomocą interfejsu JavaScript API navigator.cookieDeprecationLabel.getValue(). Zwraca obietnicę, która przekształca się w ciąg znaków zawierający odpowiednią etykietę grupy. Na potrzeby 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 pliku cookie receive-cookie-deprecation. Jeśli jednak pliki cookie są całkowicie zablokowane lub zablokowane tylko w przypadku danej witryny, interfejs API znowu 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 tej opcji nie powoduje dołączenia przeglądarki do żadnej grupy eksperymentalnej.

Etykiety możesz zobaczyć w akcji na stronie goo.gle/cft-demo.

Rejestracja jest wymagana w przypadku interfejsów API Piaskownicy prywatności służących do pomiaru trafności i relewantności. W przypadku testów lokalnych może być konieczne zastąpienie wymuszania za pomocą parametru chrome://flags/#privacy-sandbox-enrollment-overrides i podania adresu URL witryny origin demo. Możesz też dodać tę flagę wiersza poleceń, jeśli uruchamianie Chrome z terminala: --args --disable-features=EnforcePrivacySandboxAttestations

W menu flagi jest kilka opcji. Testerzy będą zainteresowani głównie wpisami oznaczonymi jako „Wymuś”, ponieważ zapewniają one włączenie zachowania eksperymentalnego niezależnie od innych konfiguracji urządzenia.

Aby przetestować tylko etykiety grup eksperymentalnych, wybierz „Włączona kontrola wymuszona 1” lub „Włączona kontrola wymuszona – tylko etykiety”. Dzięki temu przeglądarka będzie „fake_control_1.1” lub „fake_label_only_1.1” etykiety.

W Chrome M120 lub nowszej możesz też używać tych wpisów.

Aby przetestować blokowanie plików cookie innych firm, wybierz „Włączono wymuszanie traktowania”. Spowoduje to wysłanie etykiety grupy eksperymentalnej „fake_treatment_1.1”, ale też zmodyfikuje stronę ustawień plików cookie i obecne ustawienie plików cookie, aby blokować pliki cookie innych firm.

Aby przetestować blokowanie plików cookie innych firm bez interfejsów API reklam prywatnych, wybierz „Wymuś grupę kontrolną 2”. Spowoduje to wysłanie etykiety grupy eksperymentalnej „fake_control_2”, zaktualizuje stronę ustawień plików cookie, zablokuje pliki cookie innych firm i wyłączy nowe interfejsy API reklam prywatnych.

Pamiętaj, że w przypadku tej flagi przeglądarka będzie nadal wyświetlać nową stronę ustawień plików cookie, która blokuje pliki cookie innych firm, nawet jeśli ją wyłączysz. 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
• Używanie wskazówek klienta do testowania przy użyciu Chrome

Możesz też zadawać nowe pytania lub prowadzić dyskusje w repozytorium za pomocą szablonu „Testowanie przy użyciu Chrome”.