Piaskownica prywatności zawiera różne propozycje, które pozwalają korzystać z reklam bez konieczności śledzenia w witrynach. Testowanie origin daje deweloperom możliwość oceny nowych technologii internetowych i przekazania opinii na ich temat za pomocą testów w świecie rzeczywistym. W poprzednich testach origin witryny mogły testować różne interfejsy API. W przypadku interfejsów API Topics, FLEDGE i Attribution Reporting udostępniamy test z jednym źródłem, który umożliwia witrynom przeprowadzanie ujednoliconych eksperymentów z użyciem interfejsów API tworzących początkową wersję pełnego cyklu życia reklam. Te interfejsy API można testować w Chrome 101 Beta i nowszych wersjach. W wersji beta Chrome 101 wprowadziliśmy też zmiany w opcjach dla użytkowników w miarę ulepszania opcji konfiguracyjnych.
Jako deweloper możesz zarejestrować się w wersji próbnej pojedynczego źródła, która umożliwi Ci testowanie interfejsów API Topics, FLEDGE i Attribution Reporting. Ten przewodnik zawiera omówienie etapów konfiguracji dostępu do interfejsów API, sposoby sprawdzania poprawności konfiguracji oraz dodatkowe zasoby do testowania interfejsów API.
Co obejmuje testowanie origin?
Testowanie origin ma na celu umożliwienie znaczących testów w całym cyklu życia reklam w wielu witrynach. W ramach tego procesu testowania origin obejmują:
- Topics umożliwia obserwowanie tematów przeglądarki i uzyskiwanie do nich dostępu za pomocą
document.browsingTopics()
. - FLEDGE – do zarządzania grupami zainteresowań przeglądarki oraz określaniu stawek i wyboru reklam na podstawie tych grup i innych sygnałów.
- W tej wersji próbnej origin FLEDGE jest dostępny na komputerach i obejmuje określony podzbiór wszystkich proponowanych funkcji. Więcej informacji znajdziesz w szczegółach testowania origin FLEDGE.
- Chronione klatki do renderowania nieprzejrzystego adresu URL zwycięzcy aukcji reklam FLEDGE.
- Raportowanie atrybucji – umożliwia pomiar i raportowanie skuteczności w całym cyklu życia reklamy.
- W ramach Attribution Reporting raporty zbiorcze muszą być przetwarzane i agregowane przez usługę agregacyjną, aby można było wygenerować raporty podsumowujące. Wkrótce opublikujemy dodatkowe narzędzia i przewodniki dotyczące testowania wersji lokalnych i źródłowych.
- Jeśli zdarzyło Ci się już brać udział w wcześniejszych testach origin w raportach atrybucji, pamiętaj, że musisz uwzględnić w nich najnowsze zmiany w interfejsie API. Więcej informacji znajdziesz w przewodniku po migracji.
Ta konfiguracja umożliwia ujednolicone testowanie wszystkich tych interfejsów API, ale możesz też wybierać aspekty do wdrożenia – tyle, ile zaspokoi Twoje potrzeby.
W jaki sposób deweloperzy mogą zarejestrować się w programie testowania origin?
Zarejestruj się na okres próbny trafności i pomiarów Piaskownicy prywatności. Z poniższymi tagami HTML umieść token próbny na każdej stronie, na której chcesz uruchomić kod API:
<meta>
w sekcji<head>
strony najwyższego poziomu:<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
- Nagłówek HTTP w odpowiedzi strony najwyższego poziomu:
Origin-Trial: TOKEN_GOES_HERE
Niektóre funkcje dostępne w ramach testowania origin są przeznaczone do użytku w kontekście innych witryn, na przykład gdy świadczysz usługę jako firma zewnętrzna w witrynie najwyższego poziomu. Jeśli musisz włączyć testowanie origin w tych dodatkowych kontekstach, wybierz opcję „Dopasowanie innych firm”.
Aby włączyć testowanie origin z kodu JavaScript innej firmy, umieść w skrypcie tag <meta>
na stronie najwyższego poziomu (czyli na stronie własnej, a nie własnej). Na przykład:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Więcej informacji znajdziesz w przewodniku wprowadzającym do wersji próbnej origin Chrome.
Jak deweloperzy testują swoje aplikacje lokalnie?
Szczegółowe wskazówki dotyczące testowania poszczególnych interfejsów API przez deweloperów znajdziesz w osobnej dokumentacji dla deweloperów dotyczącej Topics, FLEDGE i Attribution Reporting. Interfejsy API nie są domyślnie włączone i muszą być włączone za pomocą flag do testowania.
Aby włączyć interfejsy API do testowania, musisz:
- Używaj Chrome 101 beta lub nowszej.
- FLEDGE wymaga Chrome na komputery.
- Interfejsy API są niedostępne w wersjach Chrome na iOS.
- Włącz interfejsy API za pomocą flagi
chrome://flags/#privacy-sandbox-ads-apis
.- Ta flaga wymusza włączanie interfejsów API, aby ułatwić testowanie. Jeśli chcesz zreplikować kwalifikującego się użytkownika wersji próbnej origin, w którym jego dodatkowe ustawienia mogą nadal wyłączać interfejsy API, uruchom Chrome za pomocą flag interfejsu wiersza poleceń:
--enable-features=BrowsingTopics,InterestGroupStorage,AllowURNsInIframes,PrivacySandboxAdsAPIs
. - Poszczególne interfejsy API mogą mieć więcej dodatkowych flag umożliwiających bardziej szczegółową konfigurację. Szczegółowe informacje znajdziesz w poszczególnych przewodnikach.
- Dodatkowe flagi mogą kolidować z tą flagą, dlatego zalecamy ustawienie tej flagi tylko w przypadku wystąpienia problemów.
- Ta flaga wymusza włączanie interfejsów API, aby ułatwić testowanie. Jeśli chcesz zreplikować kwalifikującego się użytkownika wersji próbnej origin, w którym jego dodatkowe ustawienia mogą nadal wyłączać interfejsy API, uruchom Chrome za pomocą flag interfejsu wiersza poleceń:
- Włącz wersje próbne Piaskownicy prywatności w ustawieniach Chrome: Ustawienia > Bezpieczeństwo i prywatność > Piaskownica prywatności. Ta opcja jest też dostępna na stronie
chrome://settings/adPrivacy
. - Włącz pliki cookie innych firm w ustawieniach Chrome: Ustawienia >
Bezpieczeństwo i prywatność. Ustaw opcję Pliki cookie i inne dane witryn na „Zezwalaj na wszystkie pliki cookie” lub „Blokuj pliki cookie innych firm w trybie incognito”. Ta funkcja jest też dostępna na stronie
chrome://settings/cookies
. - być w standardowej sesji przeglądania, Nie korzystaj z trybu incognito.
Jak deweloperzy mogą sprawdzić, czy wersja próbna origin jest prawidłowo skonfigurowana?
W sekcji Rozwiązywanie problemów z testami origin Chrome znajdziesz szczegółową listę kontrolną, która pomaga sprawdzić konfigurację testowania origin.
![Narzędzia deweloperskie pokazujące stan testowania origin w sekcji Aplikacje](https://developers.google.cn/static/privacy-sandbox/assets/images/blog/devtools-showing-origin-t-ca92b0341055a.png?authuser=3&hl=pl)
Narzędzia deweloperskie wyświetlają stan testowania origin na karcie Aplikacje w sekcji Ramki.
Chociaż testowanie origin będzie się wyświetlać jako aktywne tylko kwalifikującym się użytkownikom, jak opisano poniżej, możesz też używać flag programisty do testowania własnej witryny produkcyjnej.
Którzy użytkownicy mogą skorzystać z wersji próbnej origin?
Z założenia testy origin są przeznaczone tylko na niewielkiej części całego ruchu w Chrome. Dlatego zawsze należy zakładać, że nawet po włączeniu w witrynie testu origin użytkownik może nie mieć aktywnego interfejsu API. Aktywna grupa eksperymentalna w wersji próbnej origin będzie dotyczyła niewielkiego odsetka użytkowników i prawdopodobnie w miarę postępu będzie się rozwijać. Pamiętaj, że odsetek użytkowników Chrome biorących udział w eksperymencie może nie odpowiadać odsetkowi użytkowników włączonych w Twojej witrynie.
Jeśli jednak chcesz przeprowadzać ujednolicone testy w różnych witrynach, ten zbiór kwalifikujących się użytkowników powinien pozostać w większości spójny. Jeśli np. użytkownik kwalifikuje się do okresu próbnego po wyświetleniu reklamy w witrynie wydawcy uczestniczącego w programie, ten sam użytkownik powinien nadal kwalifikować się do skorzystania z wersji próbnej origin, jeśli dokona konwersji w witrynie reklamodawcy uczestniczącego w programie.
Aby to zrobić, użytkownik musi:
- korzystasz z Chrome w wersji 101 beta lub nowszej.
- FLEDGE wymaga Chrome na komputery.
- w przypadku wersji Chrome na iOS nie są dostępne żadne wersje próbne origin.
- w trakcie aktywnego okresu próbnego origin.
- włączyć okresy próbne Piaskownicy prywatności w sekcji Ustawienia > Bezpieczeństwo i prywatność > Piaskownica prywatności. Ta opcja jest też dostępna na stronie
chrome://settings/adPrivacy
. - włączyć pliki cookie innych firm w sekcji Ustawienia > Bezpieczeństwo i prywatność >
Pliki cookie i inne dane witryn mają wartość „Zezwalaj na wszystkie pliki cookie” lub „Blokuj pliki cookie innych firm w trybie incognito”. Dostęp do tych plików można też uzyskać na stronie
chrome://settings/cookies
. - muszą korzystać ze standardowej sesji przeglądania, a nie w trybie incognito;
- należeć do aktywnej grupy eksperymentalnej w Chrome.
W jaki sposób deweloperzy powinni wykrywać obsługę interfejsu API?
Podobnie jak w przypadku każdej funkcji platformy internetowej, zanim skorzystasz z tej funkcji, musisz ją najpierw sprawdzić.
Tematy
Poszukaj funkcji browsingTopics()
w document
i zasadach dotyczących uprawnień](https://developer.chrome.com/articles/permissions-policy/#featurepolicyallowsfeature) dla atrybutu „browsing-topics”.
if ('browsingTopics' in document && document.featurePolicy.allowsFeature('browsing-topics')) {
// Topics enabled
}
FLEDGE
Jeśli chcesz dołączyć do grupy zainteresowań reklam, sprawdź, czy jest w niej dostępna funkcja joinAdInterestGroup
w navigator
i zasady dotyczące uprawnień „join-ad-interest-group”.
if ('joinAdInterestGroup' in navigator && document.featurePolicy.allowsFeature('join-ad-interest-group')) {
// FLEDGE interest group enabled
}
Jeśli chcesz przeprowadzić aukcję, zapoznaj się z funkcją runAdAuction
w narzędziu navigator
i zasadami uprawnień „udział w aukcji reklam”.
if ('runAdAuction' in navigator && document.featurePolicy.allowsFeature('run-ad-auction')) {
// FLEDGE auction enabled
}
Raportowanie atrybucji
Odszukaj obiekt attributionReporting
w window
i zasadę uprawnień dla „Attribution-reporting”.
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting API enabled
}
Gdzie deweloperzy mogą przekazywać opinie i otrzymywać pomoc?
Strona przeglądu opinii zawiera szczegółowe informacje o różnych sposobach przesyłania opinii na temat różnych aspektów Piaskownicy prywatności. Znajdują się tam osobne sekcje Topics, FLEDGE i Attribution Reporting. Zawierają one osobne linki dla poszczególnych interfejsów API.
Regularnie publikujemy też informacje o postępach w ramach serii Piaskownicy prywatności, w której znajdziesz podsumowanie ważnych wiadomości.