Callbacks e Endpoints do aviso de cookies - AdOpt

O banner de cookies da AdOpt oferece aos usuários uma maneira rápida e fácil de gerenciar seu consentimento e se informar sobre a finalidade para a qual os dados estão sendo usados.

No entanto, muitas vezes é necessário que seu site ou webapp seja notificado sobre esse consentimento — seja para bloquear a coleta de determinados dados ou para alterar as informações exibidas na tela.

Por meio de callbacks em JavaScript, o Banner da AdOpt pode notificar o seu site ou webapp sobre uma nova configuração de consentimento.

O callback é criado sobrescrevendo a função:

<script>
  window.adoptCB = function (consent) {
    console.log('callback do adopt:', consent);
  };
</script>

O formato do argumento do callback segue o formato:

{
  visitorId: "ID do visitante",
  disclaimerId: "ID do aviso",
  websiteId: "ID do website do aviso",
  tags: [
    // Array com as informações de todas as tags
  ],
  language: "Idioma que o aviso está sendo exibido",
  legislation: "Legislação de exibição"
}

Exemplo de resposta:

{
  cookieId: "123abc",
  optInTags: ["456def", "789ghi"],
  optOutTags: ["012jkl", "345mno"]
}

Endpoint de dados do site

Com os IDs das tags para as quais o visitante deu (ou negou) consentimento, você pode consultar um endpoint com os dados do seu site e relacionar os IDs aos nomes das tags.

https://disclaimer-api.goadopt.io/api/tag/disclaimer-info/<website_code>

O website_code aqui é o mesmo utilizado na tag que você colocou no site.

Essa chamada retornará um callback no formato:

{
  disclaimer: { /* configurações visuais do aviso */ },
  terms: { /* url dos seus Termos de Uso */ },
  policy: { /* url da sua Política de Privacidade */ },
  tags: [
    { id:"6332f834-41df-4cc5-a3bf-dffe359112c5", name:"Adopt", tag_category_id:2 }
    /* Array de objetos Tag */
  ]
}

Exemplo de resposta:

{
  disclaimer: {
    colors: {
      primaryColor: "#4BBAD7",
      secondaryColor: "#0a1f33",
      bgColor: "#000",
      textColor: "#fafbfc",
      position: "left",
      buttonPosition: "left"
    }
  },
  terms: {
    url: "https://goadopt.io/terms"
  },
  policy: {
    url: "https://goadopt.io/terms"
  },
  tags: [
    {
      id: "6332f834-4a0f-4cc5-a3bf-dffe345112c5",
      name: "Yahoo",
      tag_category_id: 2
    },
    {
      id: "43d4ece5-fa7c-4369-ab23-a2393f745es3",
      name: "Cloudflare",
      tag_category_id: 4
    },
    {
      id: "a4409b60-80ca-4bf8-af0d-f6cc124502b3",
      name: "Hariken",
      tag_category_id: 1
    },
    {
      id: "z81efe08-c88b-40db-b39d-0a580945ebc6",
      name: "Facebook",
      tag_category_id: 2
    },
    {
      id: "fg0ff14a-cdd8-42e1-aba3-3df22145c27c",
      name: "Google Tag Manager",
      tag_category_id: 5
    }
  ]
}