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 Personalização personalizada suporte para conexão personalização baseada em atributos e está disponível para todos os clientes.
IMPORTANT
Os atributos do perfil podem conter dados confidenciais. Para proteger esses dados, você deve usar o API do servidor Edge Network ao configurar o Personalization personalizado destino para personalização baseada em atributo. Todas as chamadas à API do servidor devem ser feitas em um contexto autenticado.
Se você já estiver usando o SDK da Web ou o SDK móvel para a integração, poderá recuperar atributos por meio da API do servidor adicionando uma integração do lado do servidor.
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

Essa integração é viabilizada pelo Adobe Experience Platform Web SDK ou o 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 do 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-alvo gerados pelo Experience Platform Serviço de segmentação.
Uploads personalizados
Públicos-alvo importado 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. Diferentes destinos de personalização personalizados podem ser configurados para diferentes Fluxos de dados de Coleção de dados do Adobe.
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 transmissão.

Conectar ao destino connect

IMPORTANT
Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

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

Parâmetros de conexão parameters

Enquanto configuração Para esse destino, você deve fornecer as seguintes informações:

  • Nome: Preencha o nome preferencial para este destino.
  • Descrição: digite uma descrição para o destino. Por exemplo, você pode mencionar para qual campanha está usando esse destino. Este campo é opcional.
  • Alias de integração: esse valor é enviado para o SDK da Web do Experience Platform como um nome de objeto JSON.
  • ID da sequência de dados: 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 Configurar um fluxo 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 do.

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino activate

IMPORTANT
Para ativar os dados, é necessário Exibir destinos, Ativar destinos, Exibir perfis, e Exibir segmentos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

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

Dados exportados exported-data

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

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

[
   {
      "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 do 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 Personalization personalizado 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 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 Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, leia o Visão geral da governança de dados.

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