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

Log de alterações de destino changelog

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.

Públicos-alvo compatíveis supported-audiences

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

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

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

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

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.