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:
- 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
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.