Pré-ocultar guia de integração do SDK

Uma pequena biblioteca síncrona de JavaScript que impede a cintilação visual causada pela personalização de Adobe Target que reescreve um mid-render de página. Adicione uma tag <script> embutida na parte superior de <head> e a página será revelada somente depois que o conteúdo personalizado estiver pronto, ou quando o temporizador de segurança for acionado.

Etapas de integração integration-steps

Onde colocar o script script-placement

O SDK Pré-oculto deve aparecer anteriormente no documento em relação ao SDK Adobe Target que faz a limpeza depois dele. A ordem de carga é não negociável:

<!doctype html>
<html>
<head>
  <!-- ① Prehide SDK FIRST. Inline. Synchronous. No async/defer. -->
  <script> /* prehide.min.js inline contents */ </script>

  <!-- ② Alloy or at.js loads next -->
  <script src="https://cdn.alloy.adobe.com/alloy.min.js"></script>

  <!-- ③ Then everything else: meta, css, third-party tags, ... -->
  <link rel="stylesheet" href="main.css">
</head>
<body> ... your page ... </body>
</html>

Em linha vs. externo inline-vs-external

Há duas maneiras de incluir prehide.min.js:

Por que o incorporado é preferível

Configuração configuration

O SDK aceita a configuração de duas fontes, em ordem de prioridade. Lê o que estiver disponível primeiro.

Tempo de execução window.PrehideConfig (integração manual)

Para pacotes auto-hospedados ou não modificados, declare um objeto de configuração antes da execução do script prehide:

<script>
  window.PrehideConfig = {
    sdk: "alloy"             // optional: "alloy" (default) or "atjs"
  };
</script>

Seleção do SDK sdk-selection

O Adobe Target oferece dois SDKs de entrega: Alloy (o moderno Web SDK) e o at.js (a biblioteca clássica). Cada um procura por um elemento <style> diferente id quando a personalização é concluída e o remove para revelar a página. O SDK Prehide deve inserir o id correspondente; caso contrário, a página permanecerá oculta até o temporizador de segurança ser acionado.

Como definir

<!-- For at.js -->
<script>
  window.PrehideConfig = { sdk: "atjs" };
</script>
<script> /* prehide.min.js inline */ </script>
<script src="https://cdn.adobe.com/.../at.js"></script>

Valores desconhecidos ou ausentes retornam para "alloy", portanto, as integrações existentes do Alloy continuam a funcionar sem qualquer alteração de configuração.

Gerenciamento de consentimento consent-management

O Prehide SDK inclui uma API com reconhecimento de consentimento para coordenar com seu CMP. Usá-lo é opcional. Se setConsent nunca for chamado, o SDK se comportará como uma integração padrão sem consentimento.

Superfície da API

// Single function call. Pass a status string.
window.Prehide.setConsent("pending");  // banner shown, awaiting decision
window.Prehide.setConsent("in");       // user accepted personalization
window.Prehide.setConsent("out");      // user declined personalization

// Read-only debug snapshot.
window.Prehide.getState();
// → { sdk, version, consentStatus, consentApiUsed,
//      rulesResolved, hasSelectorsToGuard, guardTimeout }

O que cada status faz

Padrão recomendado: fase pendente explícita

Exemplo: integração do estilo OneTrust

// Called once OneTrust has rendered its banner.
function onOneTrustReady() {
  // Pause the guard timer while the banner is visible.
  window.Prehide.setConsent("pending");

  OneTrust.OnConsentChanged(function (event) {
    if (event.consentedToTargeting) {
      window.Prehide.setConsent("in");
    } else {
      window.Prehide.setConsent("out");
    }
  });
}

Exemplo: estilo TCF/IAB

// Optional: pause the guard while UI is up.
window.Prehide.setConsent("pending");

// Your CMP eventually emits the final TC string.
function onTcData(tcData) {
  const hasTargetConsent = /* derive from tcData */;
  window.Prehide.setConsent(hasTargetConsent ? "in" : "out");
}