Conexão de personalização personalizada custom-personalization-connection

Log de alterações de destino changelog

Mês de lançamento
Tipo de atualização
Descrição
Maio de 2023
Atualização de funcionalidade e documentação
A partir de maio de 2023, a conexão Personalização personalizada oferecerá suporte à personalização baseada em atributos e estará disponível para todos os clientes.
IMPORTANT
Os atributos do perfil podem conter dados confidenciais. Para proteger esses dados, você deve usar a API do Edge Network Server ao configurar o destino do Personalization Personalizado para personalização baseada em atributos. Todas as chamadas da API do Servidor devem ser feitas em um contexto autenticado.
Você pode recuperar atributos de perfil por meio da API do Edge Network Server adicionando uma integração do lado do servidor que utiliza a mesma sequência de dados que você já está usando para a implementação do SDK da Web ou do Mobile.
Se você não seguir os requisitos acima, a personalização será baseada somente na associação ao público-alvo.

Visão geral overview

Configure esse destino para permitir que plataformas de personalização externas, sistemas de gerenciamento de conteúdo, servidores de anúncios e outros aplicativos em execução nos sites do cliente recuperem informações de público do Adobe Experience Platform.

Pré-requisitos prerequisites

Esta integração é fornecida pelo Adobe Experience Platform Web SDK ou pelo Adobe Experience Platform Mobile SDK. Você deve usar um desses SDKs para usar esse destino.

IMPORTANT
Antes de criar uma conexão de personalização personalizada, leia o guia sobre como ativar dados de público-alvo para destinos de personalização de borda. Este guia orienta você sobre as etapas de configuração necessárias para casos de uso de personalização de mesma página e próxima página, em vários componentes do Experience Platform.

Públicos-alvo compatíveis supported-audiences

Esta seção descreve quais tipos de públicos-alvo você pode exportar para esse destino.

Origem do público
Suportado
Descrição
Segmentation Service
Públicos gerados por meio do Serviço de segmentação do Experience Platform.
Uploads personalizados
Públicos importados para o Experience Platform de arquivos CSV.

Tipo e frequência de exportação export-type-frequency

Item
Tipo
Notas
Tipo de exportação
Profile request
Você está solicitando todos os públicos mapeados no destino de personalização personalizado para um único perfil. Destinos de personalização personalizados diferentes podem ser configurados para sequências de dados de Coleção de dados de Adobe diferentes.
Frequência de exportação
Streaming
Os destinos de transmissão são conexões baseadas em API "sempre ativas". Assim que um perfil é atualizado em Experience Platform com base na avaliação do público-alvo, o conector envia a atualização downstream para a plataforma de destino. Leia mais sobre destinos de streaming.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa de Exibir Destinos e Gerenciar Destinos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

Para se conectar a este destino, siga as etapas descritas no tutorial de configuração de destino.

Parâmetros de conexão parameters

Ao configurar este destino, você deve fornecer as seguintes informações:

  • Nome: preencha o nome preferencial para este destino.
  • Descrição: insira uma descrição para o seu destino. Por exemplo, você pode mencionar para qual campanha está usando esse destino. Este campo é opcional.
  • Alias de integração: esse valor é enviado ao SDK da Web do Experience Platform como um nome de objeto JSON.
  • ID da Sequência de Dados: Isso determina em qual sequência de dados de Coleção de Dados os públicos-alvo serão incluídos na resposta à página. O menu suspenso mostra apenas as sequências de dados com a configuração de destino habilitada. Consulte Configurando uma sequência de dados para obter mais detalhes.

Ativar alertas enable-alerts

Você pode ativar os alertas para receber notificações sobre o status do fluxo de dados para o seu destino. Selecione um alerta na lista para assinar e receber notificações sobre o status do seu fluxo de dados. Para obter mais informações sobre alertas, consulte o manual sobre assinatura de alertas de destinos usando a interface.

Quando terminar de fornecer detalhes da conexão de destino, selecione Avançar.

Ativar públicos-alvo para esse destino activate

IMPORTANT
Para ativar dados, você precisa de Exibir Destinos, Ativar Destinos, Exibir Perfis e Exibir Segmentos permissões de controle de acesso. Leia a visão geral do controle de acesso ou contate o administrador do produto para obter as permissões necessárias.

Leia Ativar perfis e públicos-alvo para destinos de personalização de borda para obter instruções sobre como ativar públicos-alvo para este destino.

Dados exportados exported-data

Se você estiver usando Tags no Adobe Experience Platform para implantar o SDK da Web do Experience Platform, use a funcionalidade enviar conclusão do evento e sua ação de código personalizado terá uma variável event.destinations que você pode usar para ver os dados exportados.

Este é um exemplo de valor para a variável event.destinations:

[
   {
      "type":"profileLookup",
      "destinationId":"7bb4cb8d-8c2e-4450-871d-b7824f547111",
      "alias":"personalizationAlias",
      "segments":[
         {
            "id":"399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         },
         {
            "id":"499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
         }
      ]
   }
]

Se você não estiver usando Tags para implantar o SDK da Web do Experience Platform, use respostas de comando para ver os dados exportados.

A resposta JSON do Adobe Experience Platform pode ser analisada para encontrar o alias de integração correspondente do aplicativo que você está integrando com o Adobe Experience Platform. As IDs de público-alvo podem ser passadas para o código do aplicativo como parâmetros de direcionamento. Abaixo está uma amostra do que isso pareceria específico para a resposta de destino.

alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "commerce": {
      "order": {
        "purchaseID": "a8g784hjq1mnp3",
        "purchaseOrderNumber": "VAU3123",
        "currencyCode": "USD",
        "priceTotal": 999.98
      }
    }
  }
}).then(function(result) {
    if(result.destinations) { // Looking to see if the destination results are there

        // Get the destination with a particular alias
        var personalizationDestinations = result.destinations.filter(x => x.alias == "personalizationAlias")
        if(personalizationDestinations.length > 0) {
             // Code to pass the audience IDs into the system that corresponds to personalizationAlias
        }
        var adServerDestinations = result.destinations.filter(x => x.alias == "adServerAlias")
        if(adServerDestinations.length > 0) {
            // Code to pass the audience IDs into the system that corresponds to adServerAlias
        }
     }
   })
  .catch(function(error) {
    // Tracking the event failed.
  });

Exemplo de resposta para Personalization Personalizado com Atributos

Ao usar a Personalization Personalizada com Atributos, a resposta da API será semelhante ao exemplo abaixo.

A diferença entre Personalization Personalizado com Atributos e Personalization Personalizado é a inclusão da seção attributes na resposta da API.

[
    {
        "type": "profileLookup",
        "destinationId": "7bb4cb8d-8c2e-4450-871d-b7824f547130",
        "alias": "personalizationAlias",
        "attributes": {
             "countryCode": {
                   "value" : "DE"
              },
             "membershipStatus": {
                   "value" : "PREMIUM"
              }
         },
        "segments": [
            {
                "id": "399eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            },
            {
                "id": "499eb3e7-3d50-47d3-ad30-a5ad99e8ab77"
            }
        ]
    }
]

Uso e governança de dados data-usage-governance

Todos os destinos do Adobe Experience Platform são compatíveis com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como o Adobe Experience Platform fiscaliza a governança de dados, leia a Visão geral da Governança de Dados.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6