Integrar o suporte ao IAB TCF 2.0 com o SDK da Web da plataforma

Este guia mostra como integrar a Estrutura de transparência e consentimento interativa do Advertising Bureau, versão 2.0 (IAB TCF 2.0) com o SDK da Web da Adobe Experience Platform sem usar tags. Para obter uma visão geral da integração com a TCF do IAB 2.0, leia a visão geral. Para obter um guia sobre como integrar com tags, leia o guia da TCF do IAB 2.0 para tags.

Introdução

Este guia usa a interface __tcfapi para acessar as informações de consentimento. Pode ser mais fácil integrar diretamente com seu provedor de gerenciamento de nuvem (CMP). No entanto, as informações neste guia ainda podem ser úteis, pois os CMPs geralmente fornecem funcionalidade semelhante à API TCF.

Para usar o IAB TCF 2.0 com tags e a extensão SDK da Web da Adobe Experience Platform, é necessário ter um esquema XDM disponível. Se você não tiver configurado nenhum deles, comece visualizando esta página antes de continuar.

Além disso, este guia requer que você tenha uma compreensão funcional do SDK da Web da Adobe Experience Platform. Para obter uma atualização rápida, leia a visão geral do SDK da Web da Adobe Experience Platform e a documentação de Perguntas frequentes.

Ativação do consentimento padrão

Se quiser tratar todos os usuários desconhecidos da mesma forma, defina defaultConsent como pending ou out. Isso enfileira ou descarta os Eventos de experiência até que as preferências de consentimento sejam recebidas.

Definindo o consentimento padrão com base em gdprApplies

Algumas CMPs fornecem a capacidade de determinar se o Regulamento Geral sobre a Proteção de Dados (GDPR) se aplica ao cliente. Se você quiser assumir o consentimento para clientes aos quais o GDPR não se aplica, poderá usar o sinalizador gdprApplies na chamada de API TCF.

O exemplo a seguir mostra uma maneira de fazer isso:

var alloyConfiguration = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    alloyConfiguration.defaultConsent = tcData.gdprApplies ? "pending" : "in";
    window.alloy("configure", alloyConfiguration);
  }
});

Neste exemplo, o comando configure é chamado depois que tcData é obtido da API TCF. Se gdprApplies for verdadeiro, o consentimento padrão será definido como pending. Se gdprApplies for falso, o consentimento padrão será definido como in. Preencha a variável alloyConfiguration com sua configuração.

Uso do evento setConsent

A API da TCF do IAB 2.0 fornece um evento para quando o consentimento é atualizado pelo cliente. Isso ocorre quando o cliente define inicialmente suas preferências e quando o cliente atualiza suas preferências.

O exemplo a seguir mostra uma maneira de fazer isso:

const identityMap = { ... };
window.__tcfapi('addEventListener', 2, function (tcData, success) {
  if (success && tcData.eventStatus === 'useractioncomplete') {
    window.alloy("setConsent", {
      identityMap,
      consent: [
        {
          standard: "IAB TCF",
          version: "2.0",
          value: tcData.tcString,
          gdprApplies: tcData.gdprApplies
        }
      ]
    });
  }
});

Este bloco de código escuta o evento useractioncomplete e define o consentimento, transmitindo a cadeia de consentimento e o sinalizador gdprApplies. Se você tiver identidades personalizadas para seus clientes, preencha a variável identityMap. Consulte o guia em setConsent para obter mais informações.

Inclusão de informações de consentimento em sendEvent

Nos esquemas XDM, você pode armazenar informações de preferência de consentimento de Eventos de experiência. Há duas maneiras de adicionar essas informações a cada evento.

Primeiro, você pode fornecer o esquema XDM relevante em cada chamada do sendEvent. O exemplo a seguir mostra uma maneira de fazer isso:

var sendEventOptions = { ... };
window.__tcfapi('getTCData', 2, function (tcData, success) {
  if (success) {
    sendEventOptions.xdm.consentStrings = [{
      consentStandard: "IAB TCF"
      consentStandardVersion: "2.0"
      consentStringValue: tcData.tcString,
      gdprApplies: tcData.gdprApplies
    }];
    window.alloy("sendEvent", sendEventOptions);
  }
});

Esse exemplo obtém as informações de consentimento da API TCF e envia um evento com as informações de consentimento adicionadas ao esquema XDM.

A outra maneira de adicionar as informações de consentimento a cada solicitação é com o retorno de chamada onBeforeEventSend.

Próximas etapas

Agora que você aprendeu a usar o IAB TCF 2.0 com a extensão SDK da Web da plataforma, também é possível optar por integrar com outras soluções de Adobe, como Adobe Analytics ou Adobe Real-time Customer Data Platform. Consulte a Visão geral da Estrutura de transparência e consentimento 2.0 do IAB para obter mais informações.