Use um worklet de armazenamento compartilhado para identificar clientes conhecidos.
A API Shared Storage é um modelo Proposta de sandbox para uso geral, armazenamento entre sites, compatível com muitas possíveis casos de uso. Um exemplo é a identificação de clientes conhecidos, disponível para teste no Chrome 104.0.5086.0 e posterior.
Você pode armazenar se o usuário se registrou em seu site no Armazenamento compartilhado, Em seguida, renderize um elemento separado com base no status armazenado do usuário (se o usuário um "conhecido" cliente).
Definir clientes conhecidos
Para tentar identificar clientes conhecidos no armazenamento compartilhado, confirme se você está usando o Chrome 104.0.5086.0 ou posterior. Ative todas as APIs de privacidade de anúncios em chrome://settings/adPrivacy
.
Também é possível ativar o armazenamento compartilhado com a sinalização --enable-features=PrivacySandboxAdsAPIsOverride,OverridePrivacySandboxSettingsLocalTesting,SharedStorageAPI,FencedFrames
na linha de comando.
Teste exemplos de código
Convém renderizar um elemento diferente dependendo se o usuário foi visto em um site diferente. Por exemplo, um provedor de pagamento pode querer renderizar um "Register" ou "Compre agora" com base no registro do usuário no site do provedor de pagamento. O armazenamento compartilhado pode ser usado para definir o status do usuário e personalizar a experiência do usuário com base nesse status.
Neste exemplo:
known-customer.js
está incorporado em um frame. Esse script define as opções para o botão "Registrar" em um site ou "Compre agora".known-customer-worklet.js
é a worklet de armazenamento compartilhado que determina se o usuário é conhecido. Se o usuário for conhecido, as informações serão retornadas. Se o usuário é desconhecido, essas informações são retornadas para exibir o botão "Registrar" e o usuário será marcado como conhecido para o futuro.
// The first URL for the "register" button is rendered for unknown users.
const BUTTON_URLS = [
{ url: `https://${advertiserUrl}/ads/register-button.html` },
{ url: `https://${advertiserUrl}/ads/buy-now-button.html` },
];
async function injectButton() {
// Load the worklet module
await window.sharedStorage.worklet.addModule('known-customer-worklet.js');
// Set the initial status to unknown ('0' is unknown and '1' is known)
window.sharedStorage.set('known-customer', 0, {
ignoreIfPresent: true,
});
// Run the URL selection operation to choose the button based on the user status
const fencedFrameConfig = await window.sharedStorage.selectURL('known-customer', BUTTON_URLS, {
resolveToConfig: true
});
// Render the opaque URL into a fenced frame
document.getElementById('button-slot').src = fencedFrameConfig;
}
injectButton();
class SelectURLOperation {
async run(urls) {
const knownCustomer = await sharedStorage.get('known-customer');
// '0' is unknown and '1' is known
return parseInt(knownCustomer);
}
}
register('known-customer', SelectURLOperation);
Casos de uso
Estes são apenas alguns dos possíveis casos de uso do Shared Storage. Vamos continuar adicionando exemplos conforme recebemos feedback e descobrimos novos casos de uso.
Seleção de conteúdo
Selecione e exiba conteúdo diferente em sites diferentes em frames limitados com base nas informações coletadas no armazenamento compartilhado. A porta de saída desses casos de uso é a seleção de URL.
- Rotação de criativos: armazene dados, como ID do criativo, contagens de visualizações e interação do usuário, para determinar quais criativos os usuários veem em diferentes sites.
- Teste A/B: é possível atribuir um usuário a um grupo de experimentos e, em seguida, armazenar esse grupo no armazenamento compartilhado para acesso em vários sites.
- Experiências personalizadas do usuário: compartilhe conteúdo personalizado e calls-to-action com base no status de registro ou em outros estados do usuário.
Gerar relatórios de resumo
Colete informações com o Armazenamento compartilhado e gere um relatório de resumo agregado e barulhento. A porta de saída desses casos de uso é a API Private Aggregation.
- Medição de alcance único: muitos criadores de conteúdo e anunciantes querem saber quantas pessoas únicas tiveram acesso ao conteúdo. Use o armazenamento compartilhado para registrar a primeira vez que um usuário visualizou seu anúncio, vídeo incorporado ou publicação e evitar a contagem duplicada desse mesmo usuário em sites diferentes. Em seguida, use a API Private Aggregation para gerar um relatório de resumo do seu alcance.
- Medição de informações demográficas: os produtores de conteúdo geralmente querem entender as informações demográficas do público. Você pode usar o Shared Storage para registrar dados demográficos do usuário em um contexto em que você os tenha, como seu site próprio, e usar relatórios agregados para gerar relatórios em muitos outros sites, como conteúdo incorporado.
- Medição de frequência K+: às vezes, é descrita como "frequência efetiva". Geralmente, há um número mínimo de visualizações antes que um usuário reconheça ou se lembre de determinado conteúdo (geralmente no contexto de visualizações de anúncios). Você pode usar o armazenamento compartilhado para criar relatórios de usuários únicos que visualizaram um conteúdo pelo menos K vezes.
Engajamento e compartilhamento de feedback
A proposta da API Shared Storage está em discussão e desenvolvimento e, portanto, está sujeita a mudanças.
Queremos saber sua opinião sobre a API Shared Storage.
- Proposta: analise a proposta detalhada.
- Discussão: participe da discussão em andamento para fazer perguntas e compartilhar seus insights.
Fique por dentro
- Lista de e-mails: inscreva-se na nossa lista de e-mails para receber as atualizações e os anúncios mais recentes relacionados à API Shared Storage.
Precisa de ajuda?
- Suporte para desenvolvedores: entre em contato com outros desenvolvedores e receba respostas para suas perguntas no repositório de suporte para desenvolvedores do Sandbox de privacidade.