[Alpha]{class="badge informative"}

thirdPartyCookiesEnabled (SDK do Servidor)

Esta página descreve thirdPartyCookiesEnabled no método configure do SDK do Servidor. Para o Web SDK, consulte thirdPartyCookiesEnabled.

A propriedade thirdPartyCookiesEnabled determina se o SDK do Servidor usa o domínio de terceiros do Adobe Audience Manager, adobedc.demdex.net, para ajudar a identificar visitantes. Também controla se você pode solicitar a ID PRINCIPAL do visitante.

Como essa propriedade funciona em um servidor how-it-works

Em um navegador, o Web SDK usa o domínio de terceiros para ler e definir um cookie em demdex.net, o que ajuda a identificar um visitante nos domínios. Em um servidor, as solicitações vão diretamente do seu servidor para o Adobe, para que nunca carreguem o cookie demdex.net do visitante, e qualquer cookie demdex.net definido pelo Adobe na resposta nunca chegue ao navegador do visitante.

Quando thirdPartyCookiesEnabled for true, que é o padrão:

  • A primeira solicitação não autenticada de um visitante, de getIdentity, appendIdentityToUrl ou setConsent, vai para adobedc.demdex.net em vez de para edgeDomain.
  • A SDK solicita a ECID e a CORE ID à Edge Network.
  • Você pode solicitar o namespace CORE com getIdentity. Como a solicitação não tem o cookie demdex.net do visitante, a ID PRINCIPAL que o servidor recebe pode não corresponder à do navegador do visitante.

Quando thirdPartyCookiesEnabled é false:

  • Todas as solicitações não autenticadas vão para o edgeDomain.
  • A SDK solicita a ECID somente à Edge Network.
  • A solicitação do namespace CORE com getIdentity é rejeitada com um erro.

Esta propriedade não afeta para onde sendEvent envia eventos. O SDK sempre envia eventos para a API autenticada do Edge Network Server.

A menos que você precise da ID CORE, considere configurar thirdPartyCookiesEnabled como false, para que todas as solicitações sejam direcionadas ao edgeDomain configurado.

Exemplo de código

Defina o booleano thirdPartyCookiesEnabled ao chamar configure. Se você omitir, o padrão será true.

await alloy.configure({
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  edgeCredentials: {
    clientId: process.env.ADOBE_CLIENT_ID,
    clientSecret: process.env.ADOBE_CLIENT_SECRET,
    scopes: process.env.ADOBE_SCOPES.split(",")
  },
  thirdPartyCookiesEnabled: false
});
recommendation-more-help
experience-platform-help-collection