Implemente o serviço de Opt-in como o único ponto de referência usado pelas soluções da Experience Cloud (referido como Categorias no Opt-in) para determinar se os cookies devem ser criados no dispositivo de um visitante.
O serviço de Opt-in é uma biblioteca JavaScript fornecida com a Experience Cloud ID (ECID) e existe no Visitor JS no adobe
objeto global como o adobe.optIn
objeto. O serviço de Opt-in instalado permite especificar se um visitante pode aderir às soluções da Adobe de uma só vez ou apresentar as soluções em sequência para fornecer permissões para cada uma delas. O recurso de gerenciamento de consentimento do serviço de Opt-in permite implementar com várias configurações para suas necessidades de privacidade específicas.
O serviço de Opt-in permite especificar se um visitante pode aderir às soluções da Adobe de uma só vez ou apresentar as soluções em sequência para fornecer permissões para cada uma delas. Quando o processo de aprovação é concluído e registrado pelo cliente, as aprovações do visitante da CMP pode ser recuperadas por todas as soluções da Adobe, que respondem com as chamadas de consentimento relacionadas.
ECID versão 4.0.
Baixe a versão mais recente da ECID.
Bibliotecas de suporte:
Familiarize-se com a estrutura de gerenciamento de consentimento que você usará com a aceitação e tome conhecimento de qualquer pré-requisito adicional.
Os requisitos de privacidade da sua empresa serão específicos quanto à maneira como você permanece em conformidade com o GDPR. Saiba quais bibliotecas as equipes de privacidade da sua empresa aceitam usar em um estado de pré-consentimento.
Se stiver usando o Adobe Launch, aproveite a Extensão de aceitação para configurar o serviço de aceitação.
As preferências de Opt-in de um visitante são relativas a uma solução da Adobe Experience Cloud, sendo que cada solução é representada como uma categoria. As categorias são fornecidas pelo adobe.OptInCategories
objeto, no qual, por exemplo, o componente ECID é referido como adobe.OptInCategories
. ECID
. Esta é a definição de adobe.OptInCategories
:
As configurações de Opt-in são mantidas por categoria, sendo que cada solução da Experience Cloud é representada por uma categoria:
adobe.OptInCategories = {
AAM: "aam",
TARGET: "target",
ANALYTICS: "aa",
ECID: "ecid",
};
O serviço de Opt-in permite definir as preferências de permissão dos visitantes para cada soluções da Adobe usada no site. Inclui uma biblioteca para salvar as configurações de um visitante por categoria aprovada e oferece suporte a um fluxo sequencial, no qual o processo de aprovação recebe as preferências “confirmar” ou “negar” para cada categoria, uma a uma. Você pode definir soluções/categorias para aderir como um todo ou como soluções individuais.
Todas as bibliotecas do lado do cliente das soluções da Adobe dependem do serviço de Opt-in e não gerarão cookies se uma permissão não for concedida a elas. O Opt-in é compatível com várias abordagens para fornecer e atualizar as configurações de consentimento para o visitante atual. Essa seção fornece exemplos para definir as preferências do serviço de Opt-in. Consulte a Referência da API de Opt-in para obter uma lista completa de funções e parâmetros.
As configurações do serviço de Opt-in são fornecidas na getInstance()
função do JS do visitante, que instancia o adobe
objeto global. Abaixo encontram-se as configurações do JS do visitante para o serviço de Opt-in.
Exemplo de configuração de Opt-in na inicialização do Visitor
objeto global
// FORMAT: Object<adobe.OptInCategories enum: boolean>
var preOptInApprovalsConfig = {};
preOptInApprovals[adobe.OptInCategories.ANALYTICS] = true;
// FORMAT: Object<adobe.OptInCategories enum: boolean>
// If you are storing the OptIn permissions on your side (in a cookie you manage or in a CMP),
// you have to provide those permissions through the previousPermissions config.
// previousPermissions will overwrite preOptInApprovals.
var previousPermissionsConfig = {};
previousPermissionsConfig[adobe.OptInCategories.AAM] = true;
previousPermissionsConfig[adobe.OptInCategories.ANALYTICS] = false;
Visitor.getInstance("YOUR_ORG_ID", {
"doesOptInApply": true, // NOTE: This can be a function that evaluates to true or false.
"preOptInApprovals": preOptInApprovalsConfig,
"previousPermissions": previousPermissionsConfig,
"isOptInStorageEnabled": true
});
Lidar com alterações no consentimento
A qualquer momento durante a experiência de um visitante no site, ele pode definir preferências pela primeira vez ou alterar suas preferências usando o CMP. Quando o JS do Visitante é inicializado com as configurações iniciais, as permissões do visitante podem ser alteradas. Consulte Alterações no consentimento para obter uma lista das funções de consentimento gerenciadas.
O serviço de Opt-in é compatível com um fluxo de trabalho no qual as permissões podem ser coletadas por mais de um ciclo de solicitação e as preferências são fornecidas uma a uma. Usando as seguintes funções e fornecendo true para shouldWaitForComplete
, a solução poderá coletar o consentimento para uma ou para um subconjunto do total de categorias e, em seguida, coletar o consentimento para a próxima categoria ou subconjunto de categorias. Começando na primeira chamada, a propriedade adobe.optIn.status
estará pendente até que adobe.optIn.complete()
seja chamado no fim do fluxo. Uma vez coletado, o status é definido para complete.
adobe.optIn.approve(['AAM', 'ECID'], true);
adobe.optIn.deny(['ANALYTICS'], true);
adobe.optIn.complete();
Consulte as configurações do fluxo de trabalho.
Conforme os visitantes fazem alterações em suas permissões, será necessário obter informações sobre as permissões resultantes para sincronizar o armazenamento de consentimentos com as alterações feitas no serviço de Opt-in. Inspecione as preferências do visitante usando as funções de permissões, por exemplo:
Exemplo de fetchPermissions
optIn.fetchPermissions(function (permissions) {
// Here you can check if your category has been approved or not.
// We recommend using optIn.isApproved() to check for permissions because it abstracts out the details of knowing exactly how the permissions list looks like.
if (adobe.optIn.isApproved(MY_CATEGORY) {
sendBeacon(); // Or something
}
});
OR: You can pass in shouldAutoSubscribe as true, your callback will be used to subscribe to all OptIn events going forward:
function callback() {
if (adobe.optIn.isApproved(MY_CATEGORY) {
sendBeacon(); // Or something
}
}
optIn.fetchPermissions(callback, true);
Consulte a documentação da API para obter mais informações sobre essas e outras funções, propriedades ou configurações mencionadas neste documento.
O serviço de Opt-in fornece uma opção para armazenar as preferências de consentimento adequadas a um ambiente de desenvolvimento ou a um ambiente em que não seja viável usar um CRM. Especificar a propriedade de configuração isOptInStorageEnabled
como true aciona o serviço de Opt-in para criar um cookie no sistema do visitante no seu domínio.
O adobe.optIn
objeto não tem estado e não fornece um mecanismo de armazenamento. Em vez disso, você precisa gerenciar as configurações de consentimento da Adobe na sua Plataforma de gerenciamento de consentimento (CMP) existente se ela permitir o armazenamento de dados personalizados. Ou você pode armazenar as preferências do visitante em um cookie em seu navegador. Existem duas opções para fornecer as preferências do usuário para o serviço de Opt-in:
approve()
função do serviço para fornecer as configurações depois de serem carregadas com sucesso.