Kevel conexão kevel
Visão geral overview
Kevel fornece a tecnologia habilitada para IA e orientação de especialistas que ajudam líderes comerciais inovadores a lançar, escalar e ter sucesso na mídia de varejo. A Retail Media Cloud do Kevel possibilita formatos de anúncios direcionados, atribuíveis e personalizáveis para publicidade no local e fora do local.
O destino de streaming Kevel para o Adobe Experience Platform permite que os clientes ativem os públicos do Adobe diretamente no UserDB e nas APIs de gerenciamento de segmento do Kevel, para oferecer suporte ao direcionamento em tempo real no momento da decisão do anúncio.
Casos de uso use-cases
Você pode ativar públicos-alvo comportamentais primários avançados em suas experiências de mídia de varejo para fornecer anúncios mais relevantes e desempenho mais forte. Na Experience Platform, você constrói públicos-alvo de alto valor e baseados em intenção, como compradores frequentes de categorias ou usuários com interesse recente em produtos, e sincroniza essas associações a Kevel em tempo real. O Kevel disponibiliza imediatamente esses segmentos para decisões de anúncios, permitindo um direcionamento preciso para produtos patrocinados e outros formatos em experiências de pesquisa, navegação e aplicativo. Assim que os usuários forem qualificados, você poderá agir de acordo com esses sinais para gerar impressões mais relevantes, melhor direcionamento e medição e ROAS aprimorados.
Pré-requisitos prerequisites
Para se preparar para usar o destino Kevel, verifique se os seguintes pré-requisitos foram atendidos:
- Você deve ter uma rede Kevel ativa e acesso à API.
- Você precisa de uma Kevelchave de API com permissões para criar segmentos e atualizar registros do UserDB.
- Você deve configurar namespaces de identidade na Experience Platform que mapeiam para as identidades que seu site ou aplicativo envia durante Kevel solicitações de anúncio (por exemplo, ECID, GAID, IDFA, ID de fidelidade etc.).
- Os clientes do Adobe devem mapear identidades somente que são usadas durante solicitações de anúncios em tempo real, pois cada identidade resultará em um registro UserDB.
Identidades suportadas supported-identities
O destino Kevel oferece suporte à ativação para qualquer identidade que seu aplicativo possa usar ao enviar solicitações de anúncio para Kevel. Você pode mapear até três namespaces de identidade para gerar registros UserDB correspondentes.
Kevel dá suporte aos seguintes namespaces de identidade da Experience Platform:
Suporte para namespaces de identidade personalizados
O destino Kevel também aceita namespaces personalizados, conforme definido na implementação do Experience Platform.
Isso significa:
- Você pode mapear namespaces de identidade específicos do cliente (por exemplo:
loyalty_id,gigya_idou qualquer identidade personalizada que você tenha definido no Serviço de Identidade). - Esses namespaces podem ser atribuídos a
kevel_user_key1,kevel_user_key2oukevel_user_key3da mesma forma que os namespaces globais. - Kevel gerará um registro UserDB por instância de cada identidade mapeada, permitindo a correspondência em tempo real em tempo de decisão de anúncio para cada identificador enviado por seus sistemas.
Comportamento do mapeamento de identidade
- Você pode mapear até três namespaces de identidade da Experience Platform para os três slots de identidade de Kevel.
- Para cada perfil ativado, Kevel recebe um registro UserDB por instância de cada identidade mapeada.
- Os clientes devem mapear apenas as identidades para as quais realmente enviam solicitações de anúncio para Kevel para evitar o armazenamento desnecessário do UserDB.
Públicos-alvo compatíveis supported-audiences
Tipo e frequência de exportação export-type-frequency
Conectar ao destino connect
Siga o fluxo de trabalho padrão do Experience Platform conectar um destino.
Autenticar para o destino authenticate
Ao conectar-se a Kevel, forneça o seguinte campo:
- Token de portador — Sua chave de API Kevel.
Preencher detalhes do destino destination-details
Após a autenticação, configure:
- Nome — Um rótulo para identificar esta instância de destino.
- Descrição — Texto opcional para descrever esta instância de destino.
- KevelID de Rede — Seu Kevel identificador de rede.
Ativar segmentos para este destino activate
Para enviar públicos-alvo para Kevel, siga o fluxo de trabalho em
Ative perfis e segmentos para destinos de exportação de segmentos de streaming.
Desativação de públicos deactivate
Quando um público-alvo é desativado ou removido do destino Kevel no Experience Platform, a Experience Platform interrompe o envio de mais atualizações de qualificação de perfil para esse público-alvo. Qualquer segmento existente criado em Kevel permanece disponível e não é excluído automaticamente.
Se o segmento Kevel estiver sendo usado atualmente em uma campanha ativa, Kevel impedirá a exclusão para evitar interromper a entrega em tempo real. Nesse caso, a desativação no Experience Platform resulta no seguinte:
- O fluxo de dados do Experience Platform é interrompido
- O segmento Kevel continua a existir e pode permanecer anexado a campanhas até que seja removido manualmente ou a campanha seja atualizada
Para interromper totalmente o direcionamento no Kevel, verifique se o segmento foi removido de todas as campanhas ativas no sistema de gerenciamento de campanhas do Kevel.
Mapear atributos e identidades map
Kevel requer:
- Namespaces de identidade — Até três namespaces de identidade mapeados para Kevel slots de identidade.
- Associação de segmento — Não é necessário mapeamento manual; o Experience Platform passa automaticamente identificadores e aliases de associação de segmento.
Durante a ativação, selecione os namespaces de identidade configurados para Kevel. Cada identidade gerará sua própria chamada de atualização do UserDB.
Dados exportados / Validar exportação de dados exported-data
Quando um perfil é qualificado para ou sai de um público-alvo, o Experience Platform envia uma atualização de streaming para Kevel.
Carga de exemplo recebida por Kevel UserDB
PUT /udb/{networkId}/segments?userKey=ECID-12345
{
"segments": [1723, 3344, 9988]
}
Exemplo de perfil do Experience Platform usado durante a exportação sample-profile
Ao ativar públicos para o destino Kevel, o Experience Platform envia fragmentos de perfil que contêm qualificações de segmento e as identidades mapeadas pelo cliente para os slots de identidade de Kevel.
Veja abaixo um exemplo de um perfil exportado mostrando:
- Vários namespaces de identidade mapeados para
kevel_user_key1,kevel_user_key2ekevel_user_key3 - Um único segmento ativado no namespace
ups
{
"segmentMembership": {
"ups": {
"9d161bbb-c785-474a-965b-7d7bc2adf879": {
"status": "realized",
"lastQualificationTime": "2025-12-10T21:43:38.541076Z"
}
}
},
"identityMap": {
"kevel_user_key1": [
{
"id": "ECID-fN1zo"
},
{
"id": "ECID-9Xr2p"
}
],
"kevel_user_key2": [
{
"id": "GAID-4oic4"
}
],
"kevel_user_key3": [
{
"id": "IDFA-nB5fU"
}
]
}
}
Como Kevel interpreta este perfil
Com a configuração de destino Kevel, cada identidade mapeada gera um registro UserDB distinto, o que significa que Kevel recebe:
- Uma atualização para
ECID-fN1zo - Uma atualização para
ECID-9Xr2p - Uma atualização para
GAID-4oic4 - Uma atualização para
IDFA-nB5fU
Isso permite que a mesma pessoa seja reconhecida no momento da decisão do anúncio usando qualquer uma de suas identidades disponíveis, com cada identidade carregando um conjunto idêntico de associações de segmento.
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.