personalization

O objeto personalization configura quais decisões de personalização (ofertas ou propostas) são solicitadas e como elas são tratadas na solicitação e resposta. Ele é especialmente valioso em implementações do Adobe Target ou do Adobe Journey Optimizer, pois é a força motriz que permite personalizar o conteúdo exibido por usuário.

alloy("sendEvent", {
  personalization: {
    decisionScopes: ["hero-banner"],
    surfaces: ["web://example.com"],
    schemas: ["https://ns.adobe.com/personalization/dom-action"],
    sendDisplayEvent: true,
    sendDisplayNotifications: true,
    includePendingDisplayNotifications: true,
    defaultPersonalizationEnabled: false
  },
  renderDecisions: true,
  xdm: adobeDataLayer.getState(reference)
});

O objeto personalization contém as seguintes propriedades:

personalization.decisionScopes

A propriedade decisionScopes é uma matriz de cadeias de caracteres que instrui o Web SDK a recuperar e retornar decisões de personalização. Cada item no array identifica um local, contexto ou posicionamento lógico onde o conteúdo personalizado é desejado.

Essa propriedade é útil quando você deseja buscar explicitamente conteúdo personalizado para áreas específicas ou componentes de uma página. Ela é especialmente valiosa em aplicativos de página única que podem exigir diferentes conjuntos de ofertas, conforme a navegação do usuário ou as alterações de exibição. Também é possível usar essa propriedade para otimizar o desempenho, recuperando apenas ofertas para os elementos da interface relevantes para o usuário.

personalization: {
  decisionScopes: ["hero-banner", "cart-offer"]
}

No Adobe Target, cada escopo de decisão é mapeado para uma mbox ou atividade. No Adobe Journey Optimizer, cada escopo de decisão é mapeado para inserções de conteúdo ou campanhas da Web com base em decisões. No Offer Decisioning, os escopos de decisão mapeiam para quais ofertas ou propostas o visitante deve receber.

personalization.surfaces

A propriedade surfaces é uma matriz de cadeias de caracteres de URI de superfície que definem manualmente o canal, dispositivo ou contexto para o qual a personalização é solicitada. Eles permitem distinguir entre diferentes experiências digitais, como domínios, aplicativos ou plataformas de dispositivos em seu ecossistema entre canais. Por padrão, a biblioteca infere a superfície padrão da página atual. Você pode usar essa propriedade para substituir a superfície inferida automaticamente para a página atual.

Essa propriedade é importante quando você deseja usar a personalização entre canais e deve distinguir como a personalização funciona entre canais separados. Ele permite criar ofertas distintas para sites diferentes na mesma organização da Adobe Experience Platform.

personalization: {
  surfaces: ["web://example.com", "web://support.example.com/contact"]
}

Essa propriedade é usada basicamente com o Adobe Journey Optimizer, pois corresponde às superfícies configuradas nas campanhas do Journey Optimizer e no gerenciamento de superfícies.

personalization.schemas

A propriedade schemas é uma matriz de cadeias de caracteres de URI de esquema que filtram os tipos de conteúdo de personalização solicitados da Edge Network. Definir essa propriedade restringe a resposta recebida do Adobe para incluir apenas ofertas que correspondam às definições de tipo de conteúdo especificadas. Se for omitida, a biblioteca solicitará ofertas de todos os esquemas disponíveis para os escopos ou superfícies correspondentes.

Essa propriedade ajuda a otimizar o tamanho da resposta e garante que seu site ou aplicativo receba apenas tipos de oferta que possa lidar. Também é útil quando usado com aplicativos de página única que renderizam o conteúdo personalizado de uma maneira específica (como usar somente ações DOM ou objetos JSON).

personalization: {
  schemas: [
    "https://ns.adobe.com/personalization/dom-action",
    "https://ns.adobe.com/personalization/html-content-item"
  ]
}

Os seguintes URIs de esquema são compatíveis:

personalization.sendDisplayEvent

A propriedade sendDisplayEvent é um booleano que determina se um evento de notificação de exibição é enviado automaticamente para a Edge Network imediatamente após o conteúdo personalizado ser renderizado na página. Se omitido, seu valor padrão é true. Defina essa variável como false se você não quiser indicar que o conteúdo personalizado foi renderizado para rastreamento de impressão.

O caso de uso mais comum para definir essa variável como false é quando você planeja enviar outro comando em outro lugar na implementação que sinaliza um evento de exibição. Algumas implementações têm eventos de impressão e Analytics; essa propriedade oferece controle total sobre quais comandos sendEvent incrementam impressões.

personalization: {
  sendDisplayEvent: true
}

personalization.includePendingDisplayNotifications

A propriedade includePendingDisplayNotifications é um booliano que controla se qualquer notificação de exibição pendente é agrupada na chamada sendEvent atual. As notificações de exibição pendentes são impressões para conteúdo personalizado que foram renderizados, mas ainda não relatados ao Edge Network como um evento de exibição. Essa propriedade é útil ao usar aplicativos de página única, pois a renderização do conteúdo personalizado e as chamadas de sendEvent podem ser assíncronas entre si.

O valor padrão para esta propriedade é false. Defina essa propriedade como true se desejar agrupar e liberar quaisquer notificações de exibição pendentes para que suas impressões sejam registradas com precisão. A implementação síncrona, como sites tradicionais, normalmente não precisa definir essa propriedade.

personalization: {
  includePendingDisplayNotifications: true
}

personalization.defaultPersonalizationEnabled

A propriedade defaultPersonalizationEnabled é um booleano que oferece controle explícito sobre como o Web SDK solicita o escopo de personalização padrão de toda a página (__view__) e a superfície para esse comando sendEvent. Por padrão, no primeiro comando sendEvent após um carregamento de página, o Web SDK solicita ofertas para o escopo de personalização padrão em toda a página e superfícies associadas. Os comandos sendEvent subsequentes não solicitam personalização padrão. Você pode usar essa propriedade para substituir esse comportamento. Isso é importante em implementações de aplicativos de página única, nas quais você pode solicitar a personalização padrão novamente enquanto o usuário navega em seu site. Você também pode usar essa propriedade quando quiser somente enviar um evento de exibição sem duplicar a recuperação da oferta.

personalization: {
  defaultPersonalizationEnabled: false
}

Essa propriedade usa a seguinte lógica, dependendo de como é definida:

Componentes do Personalization usando a extensão de tag da Web SDK

O equivalente da extensão de marca Web SDK dessa propriedade é a seção Personalization ao configurar uma ação 'Send event'.