Un meccanismo di disattivazione per il periodo di tolleranza della prova relativo al ritiro dei cookie di terze parti

Per i siti che partecipano a una delle prove relative al ritiro dei cookie di terze parti, Chrome fornisce un periodo di tolleranza per riattivare temporaneamente i cookie di terze parti. Durante il periodo di tolleranza, i siti possono accedere ai cookie di terze parti in Chrome, anche se non hanno ancora eseguito il deployment dei token di prova.

Chrome fornisce inoltre un meccanismo per consentire ai siti di disattivare il periodo di tolleranza per una percentuale di utenti. Il meccanismo di disattivazione consentirà ai siti di eseguire le proprie implementazioni graduali per aiutarli a passare dal fare affidamento sul periodo di tolleranza per testare il deployment dei token di prova di ritiro e passare a soluzioni a lungo termine.

Perché gli sviluppatori hanno bisogno del meccanismo di disattivazione

Quando un sito o un servizio viene approvato per le prove di ritiro proprietari o di terze parti, Chrome fornisce un token di prova e avvia un periodo di tolleranza per concedere il tempo necessario al deployment dei token. Il periodo di tolleranza continua a rimanere in vigore fino alla scadenza, anche dopo il deployment dei token. Questo può essere problematico per verificare se il deployment del token di prova relativo al ritiro è riuscito.

Gli sviluppatori possono impostare un flag di Chrome per disattivare il periodo di tolleranza per testare localmente il deployment dei token, ma ciò non è appropriato per i test su larga scala. Per consentire ai siti di eseguire il test dei token di produzione, Chrome fornisce ora un meccanismo per disattivare il periodo di tolleranza per una percentuale di utenti.

Configura le percentuali di disattivazione del periodo di tolleranza

Per partecipare alla disattivazione, fornisci un file di configurazione pubblicamente accessibile nella directory .well-known del tuo sito all'indirizzo /.well-known/tpcd/grace-period.json. Il file grace-period.json fornisce le percentuali di disattivazione per uno o entrambi i periodi di tolleranza della prova per il ritiro:

  • FirstPartyOptOutPercentage
  • ThirdPartyOptOutPercentage

I valori possono essere 0, 25, 50 o 100. Ad esempio:

{
  "ThirdPartyOptOutPercentage": 25
}

Test del deployment

Se vuoi usufruire della disattivazione del periodo di tolleranza, ti consigliamo di iniziare eseguendo il deployment di grace-period.json il prima possibile, con un valore di 0 per una o entrambe le chiavi. In questo modo puoi verificare se Chrome sta elaborando il file come previsto, senza influire sull'attivazione del periodo di tolleranza. Potrai quindi iniziare ad aumentare la percentuale quando sarà tutto pronto. In futuro prevediamo di fornire agli sviluppatori strumenti per eseguire query sullo stato di attivazione del periodo di tolleranza per i siti a cui accedono dal browser.

Il file grace-period.json deve avere un formato corretto per avere effetto. Per evitare errori, controlla il file con lo strumento di convalida della disattivazione del periodo di tolleranza.

Eseguire il debug del meccanismo di disattivazione

I server di Google controllano regolarmente il file grace-period.json (se presente) su ogni sito per cui è attivo il periodo di tolleranza. Le percentuali di disattivazione possono quindi essere distribuite su tutti i client di Chrome, anche se il completamento dell'operazione potrebbe richiedere da 24 a 48 ore. Chrome fornirà uno strumento che consente agli sviluppatori di siti di controllare lo stato di attivazione del periodo di tolleranza dal riquadro Problemi di Chrome DevTools per capire quando è attiva la disattivazione.

Esempi

Esempio di terze parti

Nell'esempio seguente, third-party.example si è registrato alla prova per il ritiro di terze parti ed è stato attivato il periodo di tolleranza. Il sito ospita il seguente file all'indirizzo third-party.example/well-known/tpcd/grace-period.json:

{
  "ThirdPartyOptOutPercentage": 25
}

Una volta attivato questo file, il periodo di tolleranza verrà disattivato per il 25% dei client Chrome che accedono a siti o servizi da third-party.example. Per i client Chrome soggetti alla Protezione antitracciamento, i cookie di terze parti del sito third-party.example saranno limitati, a meno che non sia attiva la prova relativa al ritiro di terze parti.

Esempio proprietario

Nell'esempio seguente, first-party.example si è registrato alla prova relativa al ritiro dei dati proprietari ed è stato attivato il periodo di tolleranza. Il sito ospita il seguente file all'indirizzo first-party.example/well-known/tpcd/grace-period.json:

{
  "FirstPartyOptOutPercentage": 50
}

Una volta attivato, il periodo di tolleranza verrà disattivato per il 50% dei client Chrome che visitano il loro sito. Per uno qualsiasi di questi client Chrome che fa parte del gruppo Protezione antitracciamento, i cookie di terze parti

Scopri di più

Se hai domande relative al meccanismo di disattivazione, segnala un problema nel repository di assistenza di Privacy Sandbox.