Topics, Fenced Frames und Shared Storage. keywords: product:PrivacySandbox, docType:Guide, topicAdSetup, contentTypeSolution, category:Web, apiGroupAds, audienceAdBuyer, audienceAdSeller, audienceAdMeasurementProvider, skill:Beginner
Die Privacy Sandbox umfasst eine Auswahl von Vorschlägen, um Werbenutzungsfälle zu ermöglichen, ohne dass websiteübergreifendes Tracking erforderlich ist. Origin-Tests bieten Entwicklern die Möglichkeit, neue Webtechnologien in der Praxis zu testen und Feedback dazu zu geben. Der Ursprungstest Privacy Sandbox – Relevanz und Analyse bietet einen einzigen Test, mit dem auf Websites einheitliche Tests für Attributionsberichte, die Protected Audience API, Topics, abgegrenzte Frames und den freigegebenen Speicher durchgeführt werden können. Entwickler können sich für diesen einzelnen Ursprungstest registrieren, mit dem sie die Topics API, die Protected Audience API und die Attribution Reporting API testen können. In diesem Leitfaden werden die Konfigurationsschritte für den Zugriff auf die APIs erläutert. Außerdem erfahren Sie, wie Sie Ihre Konfiguration validieren, und es werden weitere Ressourcen für Tests mit den APIs bereitgestellt.
Status des Ursprungstests prüfen
Juni 2023
7% mehr Zugriffe auf Private Aggregation in der Stable-Version
Die Private Aggregation API ist ab Dienstag, dem 6. Juni 2023, für 7% des Chrome Stable-Traffics verfügbar. Die API ist in der Hauptgruppe für den einheitlichen Ursprungstest (5%), in der isolierten Gruppe für Protected Audience (1%) und in der isolierten Gruppe für Shared Storage (1%) verfügbar. Die Zugriffszuweisung für Protected Audience und Shared Storage ändert sich nicht, da Private Aggregation zu bestehenden isolierten Tests hinzugefügt wird.
Traffic-Zuordnung am Dienstag, 6. Juni:
| API | Traffic-Zuordnung | Status |
| Attributionsberichte | Einheitlich – 5% | 6% der stabilen Zugriffe (Stand: 13. März 2023) |
| Isoliert – 1 % – nur ARA | ||
| eingezäunte Frames | Einheitlich – 5% | 7% des stabilen Traffics (Stand: 13. März 2023) |
| Isoliert – 1 % – Shared Storage + Private Aggregation + Fenced Frames only | ||
| Isoliert – 1 % – Protected Audience + Private Aggregation + Fenced Frames only | ||
| Protected Audience | Einheitlich – 5% | 6% der stabilen Zugriffe (Stand: 13. März 2023) |
| Isoliert – 1 % – Protected Audience + Private Aggregation + Fenced Frames only | ||
| Private Aggregation | Einheitlich – 5% | 7% der stabilen Zugriffe (Stand: 6. Juni 2023) |
| Isoliert – 1 % – Protected Audience + Private Aggregation + Fenced Frames only | ||
| Isoliert – 1 % – Shared Storage + Private Aggregation + Fenced Frames only | ||
| Shared Storage | Einheitlich – 5% | 6% der stabilen Zugriffe (Stand: 13. März 2023) |
| Isoliert – 1 % – Shared Storage + Private Aggregation + Fenced Frames only | ||
| Themen | Einheitlich – 5% | 6% der stabilen Zugriffe (Stand: 13. März 2023) |
| Isoliert – 1 % – nur Themen |
Frühere Updates
Hier finden Sie Informationen zu früheren Updates zum Ursprungstest.
April 2023
1% Zunahme der privaten Aggregation in der Stable-Version
Der Ursprungstest für die Private Aggregation API ist ab Montag, dem 17. April, für 1% des einheitlichen Chrome Stable-Experiment-Traffics verfügbar. Die Funktion sendHistogramReport() der Private Aggregation API kann in Worklets der Protected Audience API und der Shared Storage API verwendet werden.
Ab Montag, dem 17. April, sieht die Zugriffszuweisung so aus:
| API | Traffic-Zuordnung | Status |
| Attributionsberichte | Einheitlich – 5% | 6% des stabilen Traffics ab dem 13. März 2023 |
| Isoliert – 1 % – nur ARA | ||
| eingezäunte Frames | Einheitlich – 5% | 7% des Traffics der stabilen Version ab dem 13. März 2023 |
| Isoliert – 1 % – Freigegebener Speicher (URL-Auswahl) + nur abgegrenzte Frames | ||
| Isoliert – 1 % – nur Protected Audience API + eingegrenzte Frames | ||
| Protected Audience API | Einheitlich – 5% | 6% des stabilen Traffics ab dem 13. März 2023 |
| Isoliert – 1 % – nur Protected Audience API + eingegrenzte Frames | ||
| Private Aggregation | Einheitlich – 1% | 1% des Traffics der stabilen Version ab dem 17. April 2023 |
| Gemeinsam genutzter Speicher (URL-Auswahl) | Einheitlich – 5% | 6% des stabilen Traffics ab dem 13. März 2023 |
| Isoliert – 1 % – Freigegebener Speicher (URL-Auswahl) + nur abgegrenzte Frames | ||
| Themen | Einheitlich – 5% | 6% des stabilen Traffics ab dem 13. März 2023 |
| Isoliert – 1 % – nur Themen |
März 2023
Aktualisierung der Zeitachse
Wir hatten ursprünglich angekündigt, dass die isolierten Tests am Montag, dem 13. März 2023, beginnen. Aufgrund der zusätzlichen Zeit, die für die Einrichtung der Tests erforderlich ist, beginnen sie jetzt am Donnerstag, dem 16. März 2023. Am Donnerstag, den 16. März 2023, wird die Protected Audience API von 4 % auf 5 % hochgefahren.
1% der Protected Audience API werden wieder aktiviert
Letzten Monat haben wir den Traffic für den Protected Audience API-Ursprungstest vorübergehend von 5% auf 4% der Chrome-Stable-Version reduziert. Die ersten Tests sind abgeschlossen. Wir planen, die Protected Audience API am Donnerstag, den 16. März 2023, von 4% auf 5% für den einheitlichen Test zu erhöhen.
Die Nutzer, deren Zugriffsrechte wieder aktiviert werden, sind dieselben, deren Zugriffsrechte zuvor eingeschränkt wurden. Die bisherigen Interessengruppen sind jedoch abgelaufen, da seit der Einstellung mehr als 30 Tage vergangen sind.
Isolierte Tests
Um unseren Testprozess zu verbessern und die Messwerte der APIs für den Ursprungstest weiter zu beobachten, erstellen wir zusätzlich zum bestehenden einheitlichen Test separate Tests für jede API. Es werden neue Tests für Attribution Reporting, Topics, eine Kombination aus Protected Audience API und Fenced Frames sowie eine Kombination aus der URL-Auswahl von Shared Storage und Fenced Frames erstellt. In jedem isolierten Test sind für die Nutzer in dieser Gruppe nur die zugewiesenen APIs verfügbar.
| API | Isolierter Test Traffic-Zuordnung |
|---|---|
| Attributionsberichte | 1 % |
| Protected Audience API + Fenced Frames | 1 % |
| Gemeinsam genutzter Speicher (URL-Auswahl) + eingegrenzte Frames | 1 % |
| Themen | 1 % |
Ab Donnerstag, dem 16. März, erhalten Sie zusätzlich zu den 5% der Zugriffe, die Sie über den bestehenden einheitlichen Test erhalten, 1% der Zugriffe über Chrome Stable für die oben aufgeführten APIs. Neue Nutzer werden jedem Test zugewiesen.
Traffic-Zuordnung
Die aktuelle Traffic-Zuweisung für Tests mit einheitlichen Ursprüngen am Dienstag, den 28. Februar, sieht so aus:
| API | Aktuelle Zuordnung der Zugriffe für den einheitlichen Test |
|---|---|
| Attributionsberichte | 5 % |
| eingezäunte Frames | 5 % |
| Protected Audience API | 4 % |
| Gemeinsam genutzter Speicher (URL-Auswahl) | 5 % |
| Themen | 5 % |
Ab Donnerstag, dem 16. März, nachdem die Protected Audience API wieder hochgefahren wurde und die neuen isolierten Tests beginnen, sieht die Zugriffszuweisung so aus:
| API | Neue Traffic-Zuordnung | Status |
|---|---|---|
| Attributionsberichte | Einheitlich – 5% | 6% der Zugriffe über die stabile Version ab dem 16. März 2023 |
| Isoliert – 1 % – nur ARA | ||
| eingezäunte Frames | Einheitlich – 5% | 7% des stabilen Traffics ab dem 16. März 2023 |
| Isoliert – 1 % – Freigegebener Speicher (URL-Auswahl) + nur abgegrenzte Frames | ||
| Isoliert – 1 % – nur Protected Audience API + eingegrenzte Frames | ||
| Protected Audience API | Unified – 5% (4% aktuelle Zuweisung + 1% Aufstockung) | 6% der Zugriffe über die stabile Version ab dem 16. März 2023 |
| Isoliert – 1 % – nur Protected Audience API + eingegrenzte Frames | ||
| Gemeinsam genutzter Speicher (URL-Auswahl) |
Einheitlich – 5% | 6% der Zugriffe über die stabile Version ab dem 16. März 2023 |
| Isoliert – 1 % – Freigegebener Speicher (URL-Auswahl) + nur abgegrenzte Frames | ||
| Themen | Einheitlich – 5% | 6% der Zugriffe über die stabile Version ab dem 16. März 2023 |
| Isoliert – 1 % – nur Themen |
Diese Änderungen wirken sich nicht auf die vorhandene Einrichtung des Testtokens für den Ursprung aus. Sie müssen das Testtoken für den Ursprung auch nicht erneuern oder neu generieren.
Januar 2023
Im Rahmen einer Chrome-Regressionsanalyse reduzieren wir ab dem 26. Januar 2023 vorübergehend den Traffic für den Protected Audience API-Ursprungstest von 5% auf 4% der Chrome-Stable-Version. Wir gehen davon aus, dass die Untersuchung etwa einen Monat dauern wird. Wir benachrichtigen Sie, sobald die Zugriffe wieder auf den Normalwert ansteigen.
Diese Änderung erfolgt automatisch und hat keine Auswirkungen auf Ihre vorhandenen Testtokens für den Ursprung. Bei den Nutzern, die zu den 1% gehören, für die die Zugriffe reduziert werden, bleiben die Interessengruppen in ihren Browsern. Dieselben Nutzer werden auch bei der Wiederaufnahme berücksichtigt und ihre Interessengruppen können wiederverwendet werden. Die Interessengruppen laufen jedoch nach 30 Tagen ab und die Regressionsanalyse kann länger dauern.
Außerdem wird der Ursprungstest der URL Selection API von Shared Storage ab dem 26. Januar 2023 auf 5% der Zugriffe auf Chrome (stabile Version) erhöht.
| API | Hinweise |
|---|---|
| Attributionsberichte | Verfügbar in der stabilen Version, seit dem 26. Oktober 2022 auf 5% erhöht. |
| Themen | Verfügbar in der stabilen Version, seit dem 26. Oktober 2022 auf 5% erhöht. |
| Protected Audience API | Verfügbar in der stabilen Version, ab dem 26. Januar 2023 vorübergehend auf 4% reduziert. |
| Umzäunte Frames | Verfügbar in der stabilen Version, ab dem 9. November 2022 mit 5 %. |
| Shared Storage | Verfügbar in der stabilen Version, ab dem 26. Januar 2023 um 5% erhöht. |
November 2022
Die „selectURL“ API von Shared Storage wird ab dem 9. November bei 1% der Zugriffe auf die stabile Chrome-Version in den Ursprungstest aufgenommen.
Wie bereits im Blogpost Ursprungstest für die Relevanz und Analyse von Anzeigen in der Privacy Sandbox auf 5%erhöhen angekündigt, sind Attributionsberichte und Topics jetzt bei 5 %. Die Protected Audience API und Fenced Frames folgen am 9. November.
| API | Hinweise |
|---|---|
| Attributionsberichte | Verfügbar in der stabilen Version, seit dem 26. Oktober auf 5% erhöht. |
| Themen | Verfügbar in der stabilen Version, seit dem 26. Oktober auf 5% erhöht. |
| Protected Audience API | Verfügbar in der stabilen Version, ab dem 9. November mit 5 %. |
| Umzäunte Frames | Verfügbar in der stabilen Version, ab dem 9. November mit 5 %. |
| Shared Storage | Ab dem 9. November wird die Version in der Stable-Version mit einer Abdeckung von 1% eingeführt. |
Oktober 2022: 5% mehr
Attribution Reporting, Topics, die Protected Audience API und Fenced Frames sind derzeit in der stabilen Chrome-Version verfügbar und werden Teil der erhöhten Zugriffe sein.
Ab dieser Woche erhöhen wir die Anzahl der Zugriffe für die Attribution Reporting API und Topics. Die Protected Audience API und Fenced Frames werden ab dem 9. November mehr genutzt.
Weitere Informationen finden Sie im Blogpost Privacy Sandbox-Ursprungstest für Relevanz- und Mess-APIs auf 5%erhöht.
| API | Hinweise |
|---|---|
| Attributionsberichte | Verfügbar in der stabilen Version, nach dem 26. Oktober auf 5% erhöht. |
| Themen | Verfügbar in der stabilen Version, nach dem 26. Oktober auf 5% erhöht. |
| Protected Audience API | Verfügbar in der stabilen Version, ab dem 9. November mit 5 %. |
| Umzäunte Frames | Verfügbar in der stabilen Version, ab dem 9. November mit 5 %. |
| Shared Storage | Derzeit nur in M105 und höher in Canary, Dev und Beta verfügbar. |
Oktober 2022
- Der Ursprungstest wurde auf Chrome 110 verlängert.
- Im Hilfeartikel Erste Schritte mit den Ursprungstests von Chrome erfahren Sie, wie Sie die Registrierung für einen Ursprungstest verlängern. Dazu gehört auch die Bereitstellung eines neuen Tokens für teilnehmende Ursprünge. Das ist derselbe Vorgang wie bei jeder anderen Verlängerung eines Ursprungstests.
Diese Verlängerung wurde gewährt, damit das Ökosystem im Stable-Kanal Zeit hat, die API-Verbesserungen weiter zu testen und zu validieren und gleichzeitig Feedback gemäß unserem Zeitplan zu geben.
Der Zeitplan für die Privacy Sandbox bleibt unverändert.
Im Testzeitraum enthaltene APIs:
| API | Hinweise |
|---|---|
| Attributionsberichte | Entwicklerleitfaden für den Ursprungstest |
| Protected Audience API | Entwicklerleitfaden für den Ursprungstest |
| Themen | Entwicklerleitfaden für den Ursprungstest |
| Umgrenzte Frames | Weitere Informationen zur Verwendung des Ursprungstests finden Sie in der Anleitung zur Protected Audience API. |
| Shared Storage | Derzeit nur in M105 und höher in Canary, Dev und Beta verfügbar. |
August 2022
- Die Verfügbarkeit von Ursprungstests wird ab Chrome 104 (stabile Version) auf 1% der Desktopnutzer erhöht.
- Sobald die Funktion auch für mobile Nutzer verfügbar ist, werden wir diese Meldung aktualisieren.
- Für die Vorabversionen (Canary, Beta) bleibt der Wert bei 50% der Nutzer.
- APIs sind in iOS Chrome nicht verfügbar.
Mai 2022
Ab Chrome 102 Beta ist der Ursprungstest für 50% der Nutzer verfügbar.
Im Testzeitraum enthaltene APIs:
| API | Hinweise |
|---|---|
| Attributionsberichte | Entwicklerleitfaden für den Ursprungstest |
| Protected Audience API | Entwicklerleitfaden für den Ursprungstest |
| Themen | Entwicklerleitfaden für den Ursprungstest Topics wurde in der ursprünglichen Testversion aufgrund eines Fehlers deaktiviert, der die Browserstabilität beeinträchtigte. |
| Umgrenzte Frames | Eingegrenzte Frames wurden dem ursprünglichen Test hinzugefügt. Informationen zur Verwendung von Tests finden Sie in der Anleitung zur Protected Audience API. |
April 2022
Der Ursprungstest beginnt mit einer begrenzten Anzahl von Nutzern von Chrome 102 Beta.
Im Testzeitraum enthaltene APIs:
| API | Hinweise |
|---|---|
| Attributionsberichte | Individueller Intent to Experiment (I2E)-Beitrag. Attributionsberichte sind auch als individueller Ursprungstest verfügbar. |
| Protected Audience API | Individueller Intent to Experiment (I2E)-Beitrag. Die Protected Audience API ist nur auf dem Computer verfügbar und bietet nur einen Teil der Funktionen. |
| Themen | Individueller Intent to Experiment (I2E)-Beitrag. |
Für den Ursprungstest registrieren und ihn konfigurieren
Wenn Sie den Ursprungstest auf Ihrer Website aktivieren möchten, müssen Sie das zugewiesene Ursprungstest-Token (einen zeitbasierten String für Ihren spezifischen Zugriff auf den Ursprungstest) registrieren und einbetten. Weitere Informationen finden Sie im Hilfeartikel Einstieg in Chrome-Tests für Ursprünge.
Ursprungs-Testtokens werden sofort gewährt und Sie können sie jederzeit widerrufen oder neu erstellen.
Für jede Seite, auf der Sie den Test der Website-Herkunft verwenden möchten, müssen Sie ein Test-Token im HTML-Code oder in der Antwort dieser Seite einfügen.
Verwende ein <meta>-Tag im <head>-Abschnitt der Seite:
<meta http-equiv="origin-trial" content="TOKEN_GOES_HERE">
Alternativ können Sie den folgenden HTTP-Header in die Seitenantwort aufnehmen:
Origin-Trial: TOKEN_GOES_HERE
Mit einem iFrame konfigurieren
Wenn Sie Funktionen für den Ursprungstest in einem iFrame verwenden (z. B. joinAdInterestGroup() der Protected Audience API), muss das Token im iFrame angegeben werden und mit dem Ursprung des iFrames übereinstimmen.
Websiteübergreifendes Tracking mit JavaScript konfigurieren
Wenn Sie Funktionen für originelle Tests über websiteübergreifendes JavaScript verwenden, d. h. Sie sind der Anbieter des Drittanbieter-JavaScripts, das auf der Seite der obersten Ebene enthalten ist, müssen Sie Folgendes tun:
- Wählen Sie bei der Registrierung für den Test der Herkunftsermittlung die Option Drittanbieterabgleich aus.
- Das Feld Web Origin (Web-Ursprung) sollte der Ursprung Ihres Scripts sein.
- Fügen Sie das
<meta>-Tag über Ihr Script in die Seite der obersten Ebene ein (d. h. die Seite mit selbst erhobenen Daten, nicht Ihre eigenen Inhalte). Beispiel:
const otMeta = document.createElement('meta');
otMeta.setAttribute('http-equiv', 'origin-trial');
otMeta.setAttribute('content', 'TOKEN_GOES_HERE');
document.querySelector('head').appendChild(otMeta);
Ursprungstest debuggen
Sie können den Status eines Ursprungstests im Bereich DevTools > Anwendungen prüfen.
- Scrollen Sie nach unten zum Bereich Frames.
- Wählen Sie den Frame aus, in dem Sie das Token einfügen möchten. Beispielsweise der Top-Frame für die Seite der obersten Ebene oder der spezifische iFrame für eingebettete Seiten.
- Scrollen Sie im rechten Bereich nach unten zum Bereich Origin Trials.
- Es sollte ein Eintrag für den
PrivacySandboxAdsAPIs-Testzeitraum angezeigt werden. - Maximieren Sie diesen Eintrag, um den Status des Ursprungstests und Ihrer spezifischen Tokens zu sehen.
Der Ursprungstest ist auf einen Teil der Chrome-Nutzer beschränkt und Ihr Browser gehört möglicherweise nicht zur Testgruppe. Daher wird möglicherweise eine rote TrialNotAllowed-Meldung für PrivacySandboxAdsAPIs angezeigt. Wenn Sie den Eintrag maximieren, um den Tokenstatus zu prüfen, und eine grüne Success-Meldung angezeigt wird, ist die Konfiguration des Ursprungstests korrekt. Berechtigte Nutzer sehen die Nachricht mit dem Wert Enabled.
Wenn Sie eine andere Meldung sehen, finden Sie unter Fehlerbehebung bei Chrome-Ursprungstests eine detaillierte Checkliste, mit der Sie die Konfiguration des Ursprungstests prüfen können.
Elemente erkennen
Wie bei allen Webfunktionen sollten Sie prüfen, ob sie im Browser als verfügbar angezeigt werden, bevor Sie sie verwenden. Dazu prüfen Sie, ob die entsprechende API am richtigen Ort vorhanden ist:
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
}
Voraussetzungen für Nutzer ermitteln
Der Ursprungstest wird für einen Teil der Chrome-Nutzer durchgeführt. Außerdem müssen die entsprechenden Funktionen in den Einstellungen aktiviert sein, damit der Testzeitraum genutzt werden kann:
Browsereinstellungen
Damit ein Nutzer das Probeabo nutzen kann, muss er
Sie verwenden eine Version und einen Kanal von Chrome, auf dem der Ursprungstest ausgeführt wird.
- Aktuelle Konfigurationen finden Sie unter Teststatus des Ursprungs.
Sie müssen sich in der aktiven Testgruppe in Chrome befinden.
Nutzereinstellungen
Außerdem müssen Nutzer folgende Voraussetzungen erfüllen, um am Test teilnehmen zu können:
- Sie haben den Privacy Sandbox-Testmodus unter „Einstellungen“ > „Sicherheit und Datenschutz“ > „Privacy Sandbox“ aktiviert. Sie können ihn auch über
chrome://settings/adPrivacyaufrufen. - Drittanbieter-Cookies sind unter „Einstellungen“ > „Sicherheit und Datenschutz“ > „Cookies und andere Websitedaten“ entweder auf „Alle Cookies zulassen“ oder „Drittanbieter-Cookies im Inkognitomodus blockieren“ gesetzt. Diese Optionen sind auch über
chrome://settings/cookieszugänglich. - Sie befinden sich in einer Standard-Browsersitzung und nicht im Inkognitomodus.
Der Test für die Quelle wird nur für berechtigte Nutzer als aktiv angezeigt. Sie können aber auch die Entwickler-Flags verwenden, um den Test auf Ihrer eigenen Produktionswebsite durchzuführen.
Teilnahme am Ursprungstest verwalten
Die Funktionsweise des Ursprungstests bleibt gleich: Sie erhalten Ursprungstest-Tokens für die Kontexte, in denen Sie mit den APIs experimentieren möchten. Bei einer größeren Testgruppe sollten Sie die Anzahl der Zugriffe, für die Sie den Test aktivieren, aktiv überwachen und steuern.
Ein guter Ansatz ist hier:
- Fügen Sie die Test-Tokens für den Ursprung standardmäßig in allen Kontexten ein, in denen Sie Tests durchführen möchten.
- Verwenden Sie die Funktionserkennung, um nach aktiven APIs zu suchen.
- Wenn die APIs aktiv sind (und der Browser daher für diesen Test infrage kommt), können Sie anhand Ihrer eigenen Testkriterien entscheiden, ob Sie sie verwenden möchten. Wenn Sie beispielsweise bereits eine A/B-Testinfrastruktur haben, mit der Sie einen Prozentsatz des Traffics, Stichproben oder ein anderes Attribut testen können, können Sie an dieser Stelle entscheiden, welche Funktionen Sie aktiv verwenden möchten.
Du kannst die Teilnahme am Ursprungstest für jede Browserinstanz vollständig verhindern, indem du das Token nicht in die Antwort einfügst. Wenn Sie beispielsweise Ihr eigenes Kontingent für einen Test erreicht haben oder während des Tests ein Problem beheben müssen, wird durch das Auslassen des Tokens sichergestellt, dass keine experimentellen Funktionen auf der Seite verfügbar oder aktiv sind.
Test der Herkunft nach geografischer Region
Sie können einen Test für bestimmte Regionen nicht deaktivieren. Ursprungstests sind auf Seiten aktiv, die das Token enthalten, das über HTTP-Header (serverseitig) oder HTML-Meta-Tags (clientseitig) eingefügt wird.
Wenn Sie den Standort des Nutzers ermitteln können, können Sie Code schreiben, um das Ursprungs-Probeabo-Token basierend auf diesen Standortinformationen einzufügen. Sie könnten beispielsweise versuchen, den Standort eines Nutzers anhand von IP-Adressen zu ermitteln. IP-Adressen können gefälscht werden, sodass dies keine Garantie für eine Lösung bietet.
Für eine geografisch spezifische Herkunft kann jedoch eine Berechtigungsrichtlinie festgelegt werden, um zu steuern, welche Funktionen verfügbar sind. us.example.com und uk.example.com sind beispielsweise geografisch spezifische Ursprünge, die gesteuert werden können. Das bedeutet nicht, dass der Test für eine Region deaktiviert wurde.
Bei einer Berechtigungsrichtlinie fügt eine Website ihren Seiten ein kleines Code-Snippet hinzu, das dem Browser Anweisungen gibt. Beim Laden der Seite liest der Browser die Anweisungen in der Berechtigungsrichtlinie und erlaubt oder blockiert Funktionen (oder APIs) gemäß der Berechtigungsrichtlinie. Wenn eine Website eine API in einer bestimmten Region einschränken möchte, kann der Entwickler eine Richtlinie für alle Seiten festlegen, die aus dieser Region angefordert werden.
Token verlängern
Origin-Testzeitraum-Tokens laufen sechs Wochen nach dem Ausstellungsdatum ab (oder am Ende des Testzeitraums, falls dieser früher endet).
Damit du die Funktionen der Testversion für den Ursprung weiterhin nutzen kannst, musst du innerhalb dieses Zeitraums deine neuen Tokens erneuern und bereitstellen.
Das Erneuern von Tokens dauert nur wenige Minuten. Sie können mehrere Tokens für denselben Test auf derselben Seite bereitstellen. Sie können ein erneuertes Token bereitstellen, bevor Ihr vorhandenes Token abläuft, damit es für Nutzer keine Unterbrechung des Dienstes gibt.
Lokal testen
Spezielle Anleitungen für lokale Entwicklertests finden Sie hier:
Die APIs sind standardmäßig deaktiviert und müssen zum Testen mit Flags aktiviert werden. Achten Sie darauf, dass Sie die oben genannten Konfigurationseinstellungen aktiviert haben. Gehen Sie dann so vor:
- Verwenden Sie eine Chrome-Version und einen Chrome-Kanal, in denen die Funktionen verfügbar sind.
- Aktivieren Sie unter
chrome://settings/adPrivacyalle APIs zum Datenschutz bei Werbung.
In den Entwicklerleitfäden finden Sie Informationen zur Verfügbarkeit bestimmter APIs und Funktionen sowie zusätzliche Flags für eine detailliertere Konfiguration.