Tematy, ramki ograniczone i wspólna pamięć masowa.keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
Piaskownica prywatności zawiera wybór propozycji umożliwiających stosowanie reklam bez konieczności śledzenia między witrynami. Testy Origin umożliwiają deweloperom testowanie nowych technologii internetowych w rzeczywistych warunkach i przekazywanie opinii na ich temat. Test origin Piaskownicy prywatności: trafność i pomiar umożliwia witrynom prowadzenie eksperymentów obejmujących Attribution Reporting API, Protected Audience API, Topics, Fenced Frames i Shared Storage. Deweloperzy mogą zarejestrować się w tym programie testowania origin, który umożliwia testowanie interfejsów Topics, Protected Audience API i Attribution Reporting API. W tym przewodniku znajdziesz instrukcje konfiguracji dostępu do interfejsów API, informacje o sprawdzaniu konfiguracji oraz dodatkowe materiały do testowania interfejsów API.
Sprawdzanie stanu wersji próbnej
Czerwiec 2023 r.
Private Aggregation 7% ramp-up in Stable
Od wtorku 6 czerwca 2023 r. interfejs Private Aggregation API będzie dostępny dla 7% ruchu w Chrome Stable. Interfejs API będzie dostępny w głównej grupie testowania origin (5%), grupie odizolowanej Protected Audience (1%) i grupie odizolowanej Shared Storage (1%). Przydział ruchu w przypadku list odbiorców chronionych i dzielonego miejsca na dane nie ulegnie zmianie, ponieważ prywatna agregacja zostanie dodana do dotychczasowych eksperymentów izolowanych.
Podział ruchu we wtorek 6 czerwca:
| API | Przydzielanie ruchu | Status |
| Attribution Reporting | Ujednolicony – 5% | 6% stabilnego ruchu na dzień 13 marca 2023 r. |
| Isolated - 1% - ARA only | ||
| Ramki chronione | Ujednolicony – 5% | 7% stabilnego ruchu z 13 marca 2023 r. |
| Isolated - 1% - Shared Storage + Private Aggregation + Fenced Frames only | ||
| Isolated - 1% - Protected Audience + Private Aggregation + Fenced Frames only | ||
| Protected Audience | Ujednolicony – 5% | 6% stabilnego ruchu na dzień 13 marca 2023 r. |
| Isolated - 1% - Protected Audience + Private Aggregation + Fenced Frames only | ||
| Agregacja prywatna | Ujednolicony – 5% | 7% stabilnego ruchu z 6 czerwca 2023 r. |
| Isolated - 1% - Protected Audience + Private Aggregation + Fenced Frames only | ||
| Isolated - 1% - Shared Storage + Private Aggregation + Fenced Frames only | ||
| Pamięć współdzielona | Ujednolicony – 5% | 6% stabilnego ruchu na dzień 13 marca 2023 r. |
| Isolated - 1% - Shared Storage + Private Aggregation + Fenced Frames only | ||
| Tematy | Ujednolicony – 5% | 6% stabilnego ruchu na dzień 13 marca 2023 r. |
| Izolowane – 1% – tylko tematy |
Wcześniejsze aktualizacje
Sprawdź poprzednie informacje o próbnym okresie korzystania z usługi.
Kwiecień 2023 r.
Prywatna agregacja z wzrostem o 1% w wersji stabilnej
Testowanie origin interfejsu Private Aggregation API będzie dostępne w 1% ruchu w Chrome Stable w ramach zjednoczonej eksperymentalnej wersji przeglądarki od poniedziałku 17 kwietnia. Funkcja sendHistogramReport()
prywatnej agregacji jest dostępna do użycia w workletach Protected Audience API
i Shared Storage.
Od poniedziałku 17 kwietnia przydział ruchu będzie wyglądał tak:
| API | Przydzielanie ruchu | Status |
| Attribution Reporting | Ujednolicony – 5% | 6% ruchu z grupy Stabilna od 13 marca 2023 r. |
| Isolated - 1% - ARA only | ||
| Ramki chronione | Ujednolicony – 5% | 7% stabilnego ruchu od 13 marca 2023 r. |
| Izolowane – 1% – Pamięć współdzielona (wybór adresu URL) + tylko ramki ogrodzone | ||
| Izolowane – 1% – tylko Protected Audience API i Fenced Frames | ||
| Protected Audience API | Ujednolicony – 5% | 6% ruchu z grupy Stabilna od 13 marca 2023 r. |
| Izolowane – 1% – tylko Protected Audience API i Fenced Frames | ||
| Agregacja prywatna | Unified - 1% | 1% ruchu stabilnego od 17 kwietnia 2023 r. |
| Pamięć współdzielona (wybór adresu URL) | Ujednolicony – 5% | 6% ruchu z grupy Stabilna od 13 marca 2023 r. |
| Izolowane – 1% – Pamięć współdzielona (wybór adresu URL) + tylko ramki ogrodzone | ||
| Tematy | Ujednolicony – 5% | 6% ruchu z grupy Stabilna od 13 marca 2023 r. |
| Izolowane – 1% – tylko tematy |
Marzec 2023 r.
Aktualizacja osi czasu
Początkowo informowaliśmy, że rozpoczniemy eksperymenty w pojedynczych krajach w poniedziałek, 13 marca 2023 r., ale ze względu na konieczność dodatkowego czasu na ich konfigurację nowe eksperymenty rozpoczniemy w czwartek, 16 marca 2023 r. W czwartek, 16 marca 2023 r., zwiększymy również z 4% na 5% interfejs Protected Audience API.
Wzrost do 1% w ramach Protected Audience API
W zeszłym miesiącu tymczasowo zmniejszyliśmy ruch w ramach testowania origin interfejsu Protected Audience API z 5% do 4% wersji stabilnej Chrome. Wstępne testy zostały zakończone. W czwartek, 16 marca 2023 r., planujemy zwiększyć udział interfejsu Protected Audience API w ramach eksperymentu z 4% do 5%.
Użytkownicy, którzy zostaną objęci zwiększeniem, będą stanowić ten sam zbiór użytkowników, który został objęty zmniejszeniem. Jednak ich poprzednie grupy zainteresowań wygasły, ponieważ od zakończenia wdrażania minęło ponad 30 dni.
Eksperymenty izolowane
Aby ulepszyć proces testowania i nadal obserwować dane interfejsów API w wersji próbnej, obok dotychczasowego eksperymentu tworzymy oddzielne eksperymenty dla każdego interfejsu API. Utworzymy nowe eksperymenty dotyczące raportowania atrybucji, Topics, kombinacji Protected Audience API i Fenced Frames oraz kombinacji operacji wyboru adresu URL z Shared Storage i Fenced Frames. W każdym eksperymencie odizolowanym użytkownicy z tej grupy będą mieli dostęp tylko do przypisanych interfejsów API.
| Interfejs API | Przydzielanie ruchu w eksperymencie z odizolowanym ruchem |
|---|---|
| Attribution Reporting | 1% |
| Protected Audience API i Fenced Frames | 1% |
| Pamięć współdzielona (wybór adresu URL) + ramki ograniczone | 1% |
| Tematy | 1% |
Od czwartku, 16 marca, zaczniesz otrzymywać dodatkowy 1% ruchu z Chrome Stable dla wymienionych powyżej interfejsów API (oprócz 5% ruchu, który otrzymujesz w ramach dotychczasowego eksperymentu z ujednoliceniem). Nowi użytkownicy będą przydzielani do każdego eksperymentu.
Przydzielanie ruchu
Aktualny podział ruchu w ramach ujednoliconych próbnych wersji pochodzenia (stan na wtorek, 28 lutego) przedstawia się następująco:
| Interfejs API | Przydzielanie ruchu w bieżącym eksperymencie z ujednolonym podejściem |
|---|---|
| Attribution Reporting | 5% |
| Ramki chronione | 5% |
| Protected Audience API | 4% |
| Pamięć współdzielona (wybór adresu URL) | 5% |
| Tematy | 5% |
Począwszy od czwartku 16 marca, gdy interfejs Protected Audience API zostanie ponownie włączony, a nowe eksperymenty zostaną rozpoczęte, przydział ruchu będzie wyglądał tak:
| Interfejs API | Nowe przydzielanie ruchu | Stan |
|---|---|---|
| Attribution Reporting | Ujednolicony – 5% | 6% stabilnego ruchu od 16 marca 2023 r. |
| Isolated - 1% - ARA only | ||
| Ramki chronione | Ujednolicony – 5% | 7% stabilnego ruchu od 16 marca 2023 r. |
| Izolowane – 1% – Pamięć współdzielona (wybór adresu URL) + tylko ramki ogrodzone | ||
| Izolowane – 1% – tylko Protected Audience API i Fenced Frames | ||
| Protected Audience API | Ujednolicone – 5% (4% obecnego przydziału + 1% zwiększenia) | 6% stabilnego ruchu od 16 marca 2023 r. |
| Izolowane – 1% – tylko Protected Audience API i Fenced Frames | ||
| Pamięć współdzielona (wybór adresu URL) |
Ujednolicony – 5% | 6% stabilnego ruchu od 16 marca 2023 r. |
| Izolowane – 1% – Pamięć współdzielona (wybór adresu URL) + tylko ramki ogrodzone | ||
| Tematy | Ujednolicony – 5% | 6% stabilnego ruchu od 16 marca 2023 r. |
| Izolowane – 1% – tylko tematy |
Te zmiany nie wpłyną na dotychczasową konfigurację tokena próbnego pochodzenia. Nie musisz odnawiać ani generować nowego tokena próbnego pochodzenia.
Styczeń 2023 r.
W ramach analizy regresji w Chrome od 26 stycznia 2023 r. tymczasowo zmniejszymy ruch w ramach testowania origin interfejsu Protected Audience API z 5% do 4% wersji stabilnej Chrome. Szacujemy, że dochodzenie potrwa około miesiąca. Powiadomimy Cię, gdy ruch zostanie przywrócony.
Ta zmiana zostanie wprowadzona automatycznie i nie wpłynie na istniejące tokeny próbne pochodzenia. W przypadku użytkowników, którzy generują ruch z 1%, a którzy będą objęci zmniejszeniem, grupy zainteresowań pozostaną w ich przeglądarkach. Ci sami użytkownicy będą wchodzić w skład grupy użytkowników, którzy wrócą do kampanii, a ich grupy zainteresowań mogą być ponownie używane. Grupy zainteresowań wygasają jednak po 30 dniach, a badanie regresji może potrwać dłużej.
Od 26 stycznia 2023 r. testowanie origin interfejsu Shared Storage URL Selection API obejmie 5% ruchu w Chrome Stable.
| Interfejs API | Uwagi |
|---|---|
| Raporty atrybucji | Dostępna w wersji stabilnej, od 26 października 2022 r. zwiększona do 5%. |
| Tematy | Dostępna w wersji stabilnej, od 26 października 2022 r. zwiększona do 5%. |
| Protected Audience API | Dostępna w wersji stabilnej. Od 26 stycznia 2023 r. tymczasowo zmniejszona do 4%. |
| Ramki chronione | Dostępny w wersji stabilnej. Od 9 listopada 2022 r. będzie to 5%. |
| Shared Storage | Dostępna w wersji stabilnej. Od 26 stycznia 2023 r. będzie zwiększana o 5%. |
Listopad 2022 r.
Od 9 listopada interfejs API selectURL z Shared Storage będzie testowany w ramach origin na 1% ruchu w Chrome Stable.
Zgodnie z poprzednią zapowiedzią w artykule Zwiększanie udziału testów origin w ramach Piaskownicy prywatności w celu zwiększenia trafności i dokładności interfejsy Attribution Reporting i Topics są teraz dostępne w 5% witryn, a 9 listopada dołączy do nich Protected Audience API i Fenced Frames.
| Interfejs API | Uwagi |
|---|---|
| Raporty atrybucji | Dostępna w wersji stabilnej, od 26 października zwiększona do 5%. |
| Tematy | Dostępna w wersji stabilnej, od 26 października zwiększona do 5%. |
| Protected Audience API | Dostępne w wersji stabilnej. Od 9 listopada odsetek ten wzrośnie do 5%. |
| Ramki chronione | Dostępne w wersji stabilnej. Od 9 listopada odsetek ten wzrośnie do 5%. |
| Shared Storage | Będzie dostępna w wersji stabilnej od 9 listopada, zaczynając od 1%. |
Październik 2022 r.: wzrost o 5%
Raportowanie atrybucji, Topics, Protected Audience API i Fenced Frames są obecnie dostępne w wersji Chrome Stable i będą uwzględniane w zwiększonym ruchu.
Od tego tygodnia zaczniemy zwiększać natężenie ruchu w przypadku raportowania atrybucji i interfejsu Topics API, a od 9 listopada – interfejsu Protected Audience API i ramek ograniczonych treści.
Więcej informacji znajdziesz w poście na blogu Wzrost udziału w danych pochodzących z Piaskownicy prywatności w celu zwiększenia trafności i dokładności.
| Interfejs API | Uwagi |
|---|---|
| Raporty atrybucji | Dostępne w wersji stabilnej. Po 26 października wzrośnie do 5%. |
| Tematy | Dostępne w wersji stabilnej. Po 26 października wzrośnie do 5%. |
| Protected Audience API | Dostępne w wersji stabilnej. Od 9 listopada odsetek ten wzrośnie do 5%. |
| Ramki chronione | Dostępne w wersji stabilnej. Od 9 listopada odsetek ten wzrośnie do 5%. |
| Shared Storage | Obecnie funkcja jest dostępna tylko w wersjach M105+ Canary, Dev i Beta. |
Październik 2022 r.
- Testowanie wersji próbnej origin zostało rozszerzone na Chrome 110.
- W artykule Pierwsze kroki z testowaniem origin w Chrome znajdziesz informacje o tym, jak odnowić rejestrację w testowaniu origin. Obejmuje to udostępnienie nowego tokena uczestniczącym źródłom, co jest procesem stosowanym w przypadku każdego innego rozszerzenia okresu próbnego.
Rozszerzenie zostało przyznane, aby dać czas ekosystemowi na dalsze testowanie i weryfikowanie ulepszeń interfejsu API oraz przekazywanie opinii zgodnie z naszą dotychczasową publiczną wersją harmonogramu.
Ogólna oś czasu Piaskownicy prywatności pozostaje bez zmian.
Interfejsy API uwzględnione w okresie próbnym:
| Interfejs API | Uwagi |
|---|---|
| Raporty atrybucji | Przewodnik dla programistów dotyczący okresu próbnego wersji źródłowej |
| Protected Audience API | Przewodnik dla programistów dotyczący okresu próbnego wersji źródłowej |
| Tematy | Przewodnik dla programistów dotyczący okresu próbnego wersji źródłowej |
| Ramki chronione | Więcej informacji o testowaniu origin interfejsu Protected Audience API znajdziesz w instrukcji dotyczącej tego interfejsu. |
| Miejsce na dane współdzielone | Obecnie funkcja jest dostępna tylko w wersjach M105+ Canary, Dev i Beta. |
Sierpień 2022 r.
- Dostępność wersji próbnej Origin zostanie rozszerzona do 1% użytkowników komputerów z Chrome 104 w wersji stabilnej.
- Aktualizacje będą się pojawiać, gdy funkcja będzie dostępna dla użytkowników mobilnych.
- Na kanałach przedstabilnych (Canary i beta) pozostaje 50% użytkowników.
- Interfejsy API są niedostępne w Chrome na iOS.
Maj 2022 r.
Dostępność testowania origin zostanie rozszerzona do 50% użytkowników Chrome 102 w wersji beta.
Interfejsy API uwzględnione w okresie próbnym:
| Interfejs API | Uwagi |
|---|---|
| Raporty atrybucji | Przewodnik dla programistów dotyczący okresu próbnego wersji źródłowej |
| Protected Audience API | Przewodnik dla programistów dotyczący okresu próbnego wersji źródłowej |
| Tematy | Przewodnik dla programistów dotyczący okresu próbnego usługi Origin Tematy zostały na krótko wyłączone w wersji próbnej na potrzeby testów na potrzeby źródeł z powodu błędu, który wpływał na stabilność przeglądarki. |
| Ramki chronione | Do wersji próbnej źródła zostały dodane klatki ograniczone. Informacje o eksperymentach znajdziesz w instrukcji Protected Audience API. |
Kwiecień 2022 r.
Testy Origin rozpoczną się wśród ograniczonej liczby użytkowników Chrome 102 w wersji beta.
Interfejsy API uwzględnione w okresie próbnym:
| Interfejs API | Uwagi |
|---|---|
| Raporty atrybucji | Indywidualny wpis Intend to Experiment (I2E). Raportowanie atrybucji jest też dostępne jako próbna wersja dla pojedynczego źródła. |
| Protected Audience API | Indywidualny wpis Intend to Experiment (I2E). Interfejs Protected Audience API jest dostępny tylko na komputerach i zawiera podzbiór funkcji. |
| Tematy | Indywidualny wpis Intend to Experiment (I2E). |
Rejestrowanie się w wersji próbnej i konfigurowanie usługi pochodzenia
Aby aktywować w swojej witrynie trial wersji źródłowej, musisz zarejestrować i osadzać przypisany token trialu wersji źródłowej (ciąg znaków oparty na czasie, który umożliwia dostęp do trialu wersji źródłowej). Więcej informacji znajdziesz w artykule Pierwsze kroki z testami pochodzenia w Chrome.
Tokeny wersji próbnej origin są przyznawane natychmiast i możesz je w każdej chwili cofnąć lub utworzyć ponownie.
W przypadku każdej strony, na której chcesz użyć wersji próbnej pochodzenia, musisz dołączyć token wersji próbnej do kodu HTML lub odpowiedzi tej strony.
Użyj tagu <meta> w sekcji <head> strony:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
Możesz też umieścić w odpowiedzi strony ten nagłówek HTTP:
Origin-Trial: TOKEN_GOES_HERE
Konfigurowanie za pomocą elementu iframe
Jeśli korzystasz z funkcji testowania origin w ramach elementu iframe (np. interfejsu Protected Audience APIjoinAdInterestGroup()), musisz podać token w ramach elementu iframe i dostosować go do jego origin.
Konfigurowanie funkcji cross-site za pomocą kodu JavaScript
Jeśli korzystasz z funkcji próbnego wyświetlania treści z użyciem kodu JavaScript w wielu witrynach, czyli jesteś dostawcą kodu JavaScript firmy zewnętrznej, który jest zawarty na stronie najwyższego poziomu, musisz:
- Podczas rejestracji w próbnym okresie korzystania z usługi Origin wybierz opcję Spójność z danymi zewnętrznymi.
- Pole „Początek w sieci” powinno wskazywać źródło skryptu.
- Za pomocą skryptu wstrzyknij tag
<meta>na stronie najwyższego poziomu (czyli na stronie własnego źródła, a nie na stronie z Twoimi treściami). 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);
Debugowanie testowania origin
Stan próbnej wersji pochodzenia możesz sprawdzić w panelu Narzędzia dla programistów > Aplikacje.
- Przewiń w dół do panelu Kadry.
- Wybierz kadr, w którym chcesz ustawić token. Może to być na przykład górny frame strony najwyższego poziomu lub konkretny element iframe w przypadku stron osadzonych.
- W panelu po prawej stronie przewiń w dół do sekcji Testy wersji Origin.
- Powinien pojawić się wpis dotyczący okresu próbnego
PrivacySandboxAdsAPIs. - Rozwiń ten wpis, aby zobaczyć stan próbnego okresu korzystania z usługi i stan poszczególnych tokenów.
Testowanie wersji źródłowej jest ograniczone do niewielkiej liczby użytkowników Chrome, a Twoja przeglądarka może nie należeć do grupy eksperymentalnej. W rezultacie możesz zobaczyć czerwony komunikat TrialNotAllowed w przypadku PrivacySandboxAdsAPIs. Gdy rozwiniesz wpis, aby sprawdzić stan tokena, jeśli zobaczysz zielony komunikat Success, konfiguracja próby pochodzenia jest prawidłowa. Uprawnieni użytkownicy zobaczą wiadomość ustawioną na Enabled.
Jeśli widzisz inne komunikaty, zapoznaj się z artykułem Rozwiązywanie problemów z testami wersji próbnej Chrome, aby sprawdzić konfigurację testu wersji próbnej.
Wykrywanie funkcji
Podobnie jak w przypadku wszystkich funkcji internetowych, przed użyciem danej funkcji w przeglądarce należy sprawdzić, czy jest ona dostępna. Aby to zrobić, sprawdź, czy odpowiedni interfejs API znajduje się we właściwym miejscu:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// Attribution Reporting enabled
}
if ('runAdAuction' in navigator) {
// Protected Audience API enabled
}
if ('browsingTopics' in document) {
// Topics enabled
}
if ('HTMLFencedFrameElement' in window) {
// Fenced Frames enabled
}
if ('sharedStorage' in window) {
// Shared Storage enabled
}
if (window?.sharedStorage?.selectURL instanceof Function) {
// optionally check specifically for the selectURL function in Shared Storage
}
Sprawdzanie, czy użytkownik spełnia wymagania
Okres próbny jest dostępny dla niewielkiej liczby użytkowników Chrome. Aby kwalifikować się do udziału w próbnym okresie korzystania, użytkownik musi też mieć włączone w ustawieniach odpowiednie funkcje:
Ustawienia przeglądarki
Aby kwalifikować się do okresu próbnego, użytkownik musi:
Używaj wersji i kanału Chrome, w których odbywa się testowanie wersji źródłowej.
- Informacje o bieżących konfiguracjach znajdziesz w sekcji Stan próbnego korzystania z pochodzącego.
należeć do aktywnej grupy eksperymentalnej w Chrome.
Ustawienia użytkownika
Aby kwalifikować się do korzystania z okresu próbnego, użytkownik musi też:
- Włącz okres próbny Piaskownicy prywatności w sekcji Ustawienia > Bezpieczeństwo i prywatność > Piaskownica prywatności, do której można też przejść z poziomu
chrome://settings/adPrivacy. - pliki cookie innych firm są włączone w sekcji Ustawienia > Bezpieczeństwo i prywatność > Pliki cookie i inne dane witryn i są ustawione na „Zezwól na wszystkie pliki cookie” lub „Blokuj pliki cookie innych firm w trybie incognito”, co można sprawdzić w sekcji
chrome://settings/cookies. - znajdować się w standardowej sesji przeglądania, a nie w trybie incognito.
Okres próbny wersji źródłowej będzie widoczny jako aktywny tylko dla kwalifikujących się użytkowników, ale możesz też użyć flag dla deweloperów, aby przetestować wersję produkcyjną na własnej stronie.
Zarządzanie udziałem w okresie próbnym dostawcy
Mechanika okresu testowania origin pozostaje taka sama: otrzymujesz tokeny okresu testowania origin w kontekstach, w których chcesz eksperymentować z interfejsami API. W przypadku rozszerzonej populacji testowej musisz aktywnie monitorować i kontrolować poziom ruchu, w którym decydujesz się włączyć wersję próbną.
Dobrym podejściem jest:
- Domyślnie dołącz tokeny wersji próbnej w pochodzących ścieżkach w wszystkich kontekstach, w których chcesz przeprowadzić eksperyment.
- Użyj wykrywania funkcji, aby sprawdzić aktywne interfejsy API.
- Jeśli interfejsy API są aktywne (a tym samym przeglądarka kwalifikuje się do tego eksperymentu), zdecyduj, czy chcesz ich używać, na podstawie własnych kryteriów eksperymentu. Jeśli na przykład masz już infrastrukturę testów A/B, aby eksperymentować z procentem ruchu, próbkowaniem lub innym atrybutem, możesz w tym momencie zdecydować, których funkcji będziesz aktywnie używać.
Możesz całkowicie uniemożliwić udział w okresie próbnym pochodzenia w przypadku dowolnej instancji przeglądarki, nie dołączając tokena do odpowiedzi. Jeśli np. przekroczysz limit eksperymentalny lub musisz rozwiązać problem podczas testu, nieuwzględnienie tokenu spowoduje, że na stronie nie będzie dostępna żadna funkcja eksperymentalna.
Kontrola testowania origin według regionu geograficznego
Nie możesz zrezygnować z wersji próbnej pochodzenia w przypadku określonych regionów. Testy pochodzenia są aktywne na stronach, które zawierają token dołączony za pomocą nagłówków HTTP (po stronie serwera) lub metatagów HTML (po stronie klienta).
Jeśli możesz określić lokalizację użytkownika, możesz napisać kod, aby uwzględnić token wersji próbnej na podstawie tych informacji o lokalizacji. Możesz na przykład próbować określić lokalizację użytkownika na podstawie adresu IP. Adresy IP mogą być podmieniane, więc nie jest to gwarantowane rozwiązanie.
Źródło o charakterze geograficznym może jednak ustawić zasady dostępu, aby kontrolować, które funkcje są dostępne. Na przykład us.example.com i uk.example.com to źródła o określonej lokalizacji geograficznej, które można kontrolować. Nie oznacza to, że region zrezygnował z testowania origin.
W przypadku zasad dotyczących uprawnień witryna dodaje do stron niewielki fragment kodu, który zawiera instrukcje dla przeglądarki. Gdy strona się wczyta, przeglądarka odczytuje instrukcje dotyczące zasad dotyczących uprawnień i zezwoli na funkcje (lub interfejsy API) lub je zablokuje zgodnie z zasadami dotyczącymi uprawnień. Jeśli witryna chce ograniczyć dostęp do interfejsu API w określonym regionie, deweloper może ustawić zasady dotyczące wszystkich stron z tego regionu.
Odnawianie tokena
Tokeny okresu próbnego Origin wygasają po 6 tygodniach od daty ich wydania (lub na koniec okresu próbnego, jeśli nastąpi to wcześniej).
Aby mieć nieprzerwany dostęp do funkcji wersji próbnej, musisz odnowić i wdrożyć nowe tokeny w tym okresie.
Odnowienie tokenów zajmuje tylko kilka minut, a na tej samej stronie możesz wdrożyć wiele tokenów dla tej samej wersji próbnej. Możesz wdrożyć odnowiony token przed wygaśnięciem dotychczasowego tokena, aby nie przerywać usługi użytkownikom.
Testowanie lokalnie
Szczegółowe wskazówki dotyczące testowania przez lokalnych deweloperów:
Interfejsy API są domyślnie wyłączone i trzeba je włączyć za pomocą flag na potrzeby testowania. Upewnij się, że masz włączone te same ustawienia konfiguracji, a potem:
- Używaj wersji i kanału Chrome, w których te funkcje są dostępne.
- Włącz wszystkie interfejsy API dotyczące ochrony prywatności w reklamach w sekcji
chrome://settings/adPrivacy.
Więcej informacji o dostępności poszczególnych interfejsów API i funkcji oraz dodatkowych flagach, które umożliwiają bardziej szczegółową konfigurację, znajdziesz w przewodnikach dla deweloperów.