Conexão Personalization personalizada custom-personalization-connection

Log de alterações de destino changelog

Use esse changelog para rastrear atualizações no destino do Personalization personalizado.

Visão geral overview

Configure este 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

Dependendo da sua implementação, esse destino exige um dos seguintes métodos de coleta de dados:

Públicos-alvo compatíveis supported-audiences

A tabela a seguir lista os tipos de público-alvo que você pode exportar para esse destino.

Públicos-alvo compatíveis por tipo de dados de público-alvo:

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

A tabela a seguir descreve o tipo de exportação e a frequência desse destino.

Conectar ao destino connect

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:

Ativar alertas enable-alerts

Ative os alertas para receber notificações sobre o status do fluxo de dados para esse 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 Next.

Ativar públicos-alvo para esse destino activate

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 Experience Platform Web SDK, use a funcionalidade enviar evento concluído. 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 Experience Platform Web SDK, use respostas de comando para ver os dados exportados.

Analise a resposta JSON de Adobe Experience Platform para encontrar o alias de integração do aplicativo que você está integrando com o Adobe Experience Platform. Transmita as IDs de público-alvo para o código do aplicativo como parâmetros de direcionamento. Abaixo está uma amostra do que isso parece 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 example-response-attributes

Ao usar Custom Personalization With Attributes, a resposta da API será semelhante ao exemplo abaixo.

A diferença entre Custom Personalization With Attributes e Custom Personalization é 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.