Passar para o conteúdo principal

Carregamento dinâmico de configurações via código personalizado

Escrito por Manon Manso

Este artigo faz parte da série Adapte seu banner a cada versão do seu site.

Antes de seguir o guia abaixo, certifique-se de ter lido o artigo de apresentação geral Escolha o método adequado para carregar o banner Axeptio correto.

  • Via idioma do navegador:

// Modificar o valor 000000000000000 pelo seu id 
window.axeptioSettings = { clientId: '000000000000000', cookiesVersion: { type: "browser_locale", cases: {
default: "-en", "fr-FR": "-fr",
"it-IT": "-it", } }};(function(d, s) { var t = d.getElementsByTagName(s)[0], e = d.createElement(s); e.async = true; e.src = "//static.axept.io/sdk.js"; t.parentNode.insertBefore(e, t);})(document, "script");
  • Via uma função personalizada:
    Por exemplo, com base no parâmetro "lang" da página

// Modificar o valor 000000000000000 pelo seu id 
window.axeptioSettings = {
clientId: '000000000000000',
cookiesVersion: {
type: "custom_function",
config: {
function: () => {
return document.documentElement.lang;
}
},
cases: {
default: "-en",
"fr-FR": "-fr",
"it-IT": "-it",
}
}
};

(function(d, s) {
var t = d.getElementsByTagName(s)[0], e = d.createElement(s);
e.async = true; e.src = "//static.axept.io/sdk.js";
t.parentNode.insertBefore(e, t);
})(document, "script");

O nome da versão a informar para cada caso (nos exemplos acima: "-en", "-fr", "-it") pode ser encontrado aqui:

Caso especial de sites sem recarregamento: gerenciar a atualização dinâmica da configuração do Axeptio

Em certos sites modernos, como aplicações de página única (SPA), onde a mudança de idioma não recarrega a página, o banner Axeptio permanece congelado no idioma inicial.

Para gerenciar este caso, é possível usar uma função JavaScript do SDK Axeptio que permite modificar o idioma do widget em tempo real, sem recarregar a página.

Esta manipulação requer um pouco de código e se destina a um público com conhecimentos técnicos. Para a maioria dos sites convencionais onde o idioma está vinculado à URL e causa um recarregamento, esta etapa não é necessária.

Onde você faz sua alteração de idioma em Javascript, você precisará adicionar a função Axeptio axeptioSDK.setCookiesVersion(), para alterar a versão do widget dinamicamente.

Esta função recebe como parâmetro o identificador da versão a ser carregada.

Por exemplo, tenho aqui três versões:

Capture_d_e_cran_2022-08-25_a__15.34.42.png

Os identificadores das minhas três versões são "it-version", "fr-version" e "en-version".

Se eu traduzir meu site para o italiano, basta chamar a função axeptioSDK.setCookiesVersion('it-version').

Respondeu à sua pergunta?