Kevel conexão kevel

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. O Retail Media Cloud do Kevel capacita formatos de anúncios direcionados, atribuíveis e personalizáveis para publicidade no local e fora do local.

Use o destino de streaming Kevel para ativar públicos-alvo da Adobe diretamente nas APIs UserDB e de Gerenciamento de segmento do Kevel e oferecer suporte ao direcionamento em tempo real no momento da decisão do anúncio. Você também pode exportar atributos de perfil, como a atribuição de grupo teste de incrementalidade de um usuário, para Kevel agir no momento da decisão.

IMPORTANT
Se você tiver dúvidas ou quiser solicitar uma atualização sobre o destino Kevel ou sua documentação, envie um email para a equipe Kevel em support@kevel.com.

Casos de uso use-cases

Públicos-alvo de mídia de varejo em tempo real. 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 o ad decisioning, permitindo o 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.

Medir impacto incremental. Você também pode exportar a atribuição de grupo de um usuário como um atributo de perfil para habilitar o teste de incrementalidade do Kevel. O Kevel mantém uma coorte de controle e a compara com os usuários expostos para quantificar o aumento de causal de suas campanhas, em vez de depender de métricas proxy, como contagens de novas marcas ou aumento com base em correlação. Isso permite comprovar vendas e conversões incrementais enquanto o Kevel minimiza o impacto na receita, veiculando o próximo melhor anúncio qualificado para usuários paralisados.

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 UserDB registros.
  • 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, como ECID, GAID, IDFA e ID de fidelidade.
  • Mapeie somente identidades enviadas durante solicitações de anúncios em tempo real. Cada identidade mapeada resulta 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:

Namespace de identidade
Descrição
Uso típico
ECID
Experience Cloud ID
Usado para personalização no site e identificação entre Adobe.
GAID
GOOGLE ADVERTISING ID
Usado para tráfego de aplicativo/dispositivo do Android.
IDFA
APPLE ADVERTISING ID
Usado para tráfego de aplicativo/dispositivo do iOS (sujeito ao consentimento do ATT).
EXTERNAL_ID
ID externa (identificador personalizado)
Passa IDs proprietárias ou geradas no back-end.

Suporte para namespaces de identidade personalizados custom-identity-namespaces

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, como loyalty_id, gigya_id ou qualquer identidade personalizada que você tenha definido no Serviço de identidade.
  • Você pode atribuir esses namespaces a kevel_user_key1, kevel_user_key2 ou kevel_user_key3 da mesma forma que os namespaces globais.

Comportamento do mapeamento de identidade identity-mapping-behavior

  • 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, o Kevel gera um registro UserDB por instância de cada identidade mapeada, permitindo a correspondência em tempo real em um momento de decisão de anúncio para cada identificador enviado pelos sistemas.
  • Mapeie somente as identidades enviadas nas solicitações de anúncio para Kevel para evitar o armazenamento UserDB desnecessário.

Captura de tela da etapa de mapeamento de identidade mostrando três namespaces de identidade mapeados para os slots de identidade Kevel.

Públicos-alvo compatíveis supported-audiences

O destino Kevel oferece suporte às seguintes origens de público-alvo e tipos de dados de público-alvo.

Origem do público
Suportado
Descrição
Serviço de segmentação
Sim
Públicos do perfil do Adobe avaliados pelo mecanismo de segmentação.
Todas as outras origens de público-alvo
Sim

Esta categoria inclui todas as origens de público-alvo fora dos públicos-alvo gerados pelo Segmentation Service. Leia sobre as várias origens do público-alvo. Alguns exemplos incluem:

  • carregar audiências personalizadas importadas para o Experience Platform de arquivos CSV,
  • públicos-alvo semelhantes,
  • públicos federados,
  • públicos-alvo gerados em outros aplicativos Experience Platform, como Adobe Journey Optimizer,
  • e muito mais.

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

Tipo de dados de público
Suportado
Descrição
Casos de uso
Públicos-alvo
Sim
Com base nos perfis de clientes, permitindo direcionar grupos específicos de pessoas para campanhas de marketing.
Compradores frequentes, abandonadores de carrinho
Públicos-alvo da conta
Não
Direcione indivíduos em organizações específicas para estratégias de marketing baseadas em conta.
Marketing B2B
Públicos-alvo potenciais
Não
Direcione indivíduos que ainda não são clientes, mas compartilham características com seu público-alvo.
Prospecção com dados de terceiros
Exportações do conjunto de dados
Não
Coleções de dados estruturados armazenados no Data Lake Adobe Experience Platform.
Relatórios, fluxos de trabalho de ciência de dados

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

O destino Kevel exporta dados usando o tipo e a frequência a seguir.

Item
Tipo
Notas
Tipo de exportação
Exportação de segmentos
Kevel recebe uma atualização sempre que um perfil se qualifica para ou sai de um público-alvo.
Frequência de exportação
Streaming
As atualizações são enviadas em tempo real usando a estrutura de transmissão do Destination SDK.

Conectar ao destino connect

Siga o fluxo de trabalho padrão do Experience Platform conectar um destino.

IMPORTANT
Você deve ter permissões para Exibir Destinos e Gerenciar Destinos.

Autenticar para o destino authenticate

Ao conectar-se a Kevel, forneça o seguinte campo:

  • Token de portador: sua chave de API Kevel.

Captura de tela da etapa de autenticação mostrando o campo de token de portador para o destino 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.
  • ID de Rede Kevel: Seu Kevel identificador de rede.

Captura de tela da etapa de detalhes do destino mostrando o nome, a descrição e os campos de ID de rede do Kevel.

Ativar públicos-alvo para esse destino activate

Para enviar audiências para Kevel, siga o fluxo de trabalho em Ativar audiências para destinos de streaming.

Desativar 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 público-alvo: não é necessário mapeamento manual. O Experience Platform passa automaticamente identificadores e aliases de associação de público-alvo.

Durante a ativação, selecione os namespaces de identidade configurados para Kevel. Cada identidade gera sua própria chamada de atualização UserDB.

Atributos do perfil (opcional) profile-attributes

Opcionalmente, é possível mapear atributos de perfil XDM para Kevel. O destino reconhece o seguinte nome de atributo de destino.

Nome do campo de destino
Descrição
Tipo de valor
kevelGroup
A atribuição do grupo de teste de incrementalidade do usuário. Usado por Kevel para dividir usuários em coortes de teste e controle para medir o impacto causal do anúncio.
Inteiro (1 a 100)

Para mapear um atributo de grupo, adicione uma nova linha de mapeamento na etapa Mapping e configure:

  1. Campo do Source: selecione o atributo XDM ou o atributo computado que contém o número de grupo do usuário, como _yourSchema.incrementalityGroup.
  2. Campo de destino: abra o seletor de campo de destino, mantenha Selecionar atributos escolhidos e selecione kevelGroup (Inteiro) do esquema.

Captura de tela da etapa de mapeamento mostrando um atributo XDM mapeado para o campo de destino kevelGroup do destino Kevel.

Validar a 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 sample-payload

O Experience Platform envia a seguinte carga de amostra para a API UserDB de Kevel.

PUT /udb/{networkId}/segments?userKey=ECID-12345&group=42
{
  "segments": [1723, 3344, 9988]
}
Parâmetro
Descrição
userKey
Derivado da identidade do Adobe mapeada.
grupo
(Opcional) Enviado como parâmetro de consulta. O grupo de teste de incrementalidade do usuário (1 a 100). Incluído somente se um atributo de perfil for mapeado para o campo de destino kevelGroup.
segmentos
O conjunto de Kevel IDs de segmento correspondentes aos públicos da Adobe para os quais o perfil é realizado no momento.

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 que você mapeou 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_key2 e kevel_user_key3
  • Um único segmento ativado no namespace ups
  • Um atributo de perfil mapeado para kevelGroup para teste de incrementalidade
{
  "attributes": {
    "kevelGroup": 42
  },
  "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 kevel-profile-interpretation

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.

Quando um atributo kevelGroup é mapeado e está presente no perfil, cada atualização UserDB também inclui a atribuição de grupo do usuário como o parâmetro de consulta group, habilitando o recurso de teste de incrementalidade de Kevel para determinar o teste e controlar associação de coorte no momento da decisão do anúncio.

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.

Recursos adicionais additional-resources

recommendation-more-help
experience-platform-help-destinations