LiveRamp - Onboarding conexão

Última atualização em 2024-01-22
  • Tópicos
  • Destinations
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader

Use o LiveRamp - Onboarding conexão com públicos integrados do Adobe Real-time Customer Data Platform para LiveRamp Connect.

Casos de uso

Para ajudá-lo a entender melhor como e quando você deve usar o LiveRamp - Onboarding destino, este é um exemplo de caso de uso que os clientes do Adobe Experience Platform podem resolver usando esse destino.

Como profissional de marketing, desejo enviar públicos-alvo do Adobe Experience Platform para integrar identidades no LiveRamp Connect para que eu possa direcionar os usuários em dispositivos móveis, Web aberta, redes sociais e CTV plataformas, usando o Ramp ID identificador.

Pré-requisitos

A variável LiveRamp - Onboarding a conexão exporta arquivos usando SFTP do LiveRamp armazenamento.

Antes de enviar dados do Experience Platform para LiveRamp - Onboarding, você precisa do seu LiveRamp credenciais. Entre em contato com LiveRamp representante para obter suas credenciais, se você ainda não as tiver.

Identidades suportadas

LiveRamp - Onboarding O suporta a ativação de identidades, como identificadores baseados em PII, identificadores conhecidos e IDs personalizadas, descritos no documento Documentação do LiveRamp.

No etapa de mapeamento do workflow de ativação, você deve definir os target mappings como atributos personalizados.

Públicos-alvo compatíveis

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

Origem do público Suportado Descrição
Segmentation Service Públicos-alvo gerados pelo Experience Platform Serviço de segmentação.
Uploads personalizados Públicos-alvo importado para o Experience Platform de arquivos CSV.

Tipo e frequência de exportação

Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.

Item Tipo Notas
Tipo de exportação Exportação de público Você está exportando todos os membros de um público-alvo com os identificadores (nome, número de telefone ou outros) usados no LiveRamp - Onboarding destino.
Frequência de exportação Lote diário Como os perfis são atualizados em Experience Platform com base na avaliação do público-alvo, os perfis (identidades) são atualizados uma vez por dia downstream para a plataforma de destino. Leia mais sobre destinos baseados em arquivo em lote.

Conectar ao destino

IMPORTANTE

Para se conectar ao destino, você precisa da variável Exibir destinos e Gerenciar destinos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Para se conectar a esse destino, siga as etapas descritas no tutorial de configuração de destino. No workflow de configuração de destino, preencha os campos listados nas duas seções abaixo.

Autenticar para o destino

Para autenticar no destino, preencha os campos obrigatórios e selecione Conectar ao destino.

Autenticação SFTP com senha

Captura de tela de exemplo mostrando como autenticar no destino usando SFTP com senha

  • Nome de usuário: O nome de usuário do LiveRamp - Onboarding local de armazenamento.
  • Senha: A senha do LiveRamp - Onboarding local de armazenamento.
  • Chave de criptografia PGP/GPG: como opção, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.
    Imagem que mostra um exemplo de uma chave PGP formatada corretamente na interface
  • ID da subchave:Se você fornecer uma chave de criptografia, deverá fornecer também uma chave de criptografia ID da subchave. Consulte a LiveRamp documentação de criptografia para saber como obter a ID da subchave.

SFTP com autenticação de chave SSH

Captura de tela de exemplo mostrando como autenticar no destino usando a chave SSH

  • Nome de usuário: O nome de usuário do LiveRamp - Onboarding local de armazenamento.

  • Chave SSH: O privado SSH chave usada para fazer logon no seu LiveRamp - Onboarding local de armazenamento. A chave privada deve ser formatada como um Base64-encoded e não deve ser protegido por senha.

    • Para conectar seu SSH chave para o LiveRamp - Onboarding , você deve enviar um tíquete por meio do LiveRampdo portal de suporte técnico da e forneça sua chave pública. Veja mais informações na seção Documentação do LiveRamp.
  • Chave de criptografia PGP/GPG: como opção, você pode anexar sua chave pública formatada em RSA para adicionar criptografia aos arquivos exportados. Veja um exemplo de uma chave de criptografia formatada corretamente na imagem abaixo.
    Imagem que mostra um exemplo de uma chave PGP formatada corretamente na interface

  • ID da subchave:Se você fornecer uma chave de criptografia, deverá fornecer também uma chave de criptografia ID da subchave. Consulte a LiveRamp documentação de criptografia para saber como obter a ID da subchave.

Preencher detalhes do destino

Para configurar detalhes para o destino, preencha os campos obrigatórios e opcionais abaixo. Um asterisco ao lado de um campo na interface do usuário indica que o campo é obrigatório.

Captura de tela da interface do usuário da plataforma mostrando como preencher detalhes para o seu destino

  • Nome: um nome pelo qual você reconhecerá esse destino no futuro.
  • Descrição: uma descrição que ajudará você a identificar esse destino no futuro.
  • Caminho da pasta: O caminho para o LiveRamp uploads que hospedará os arquivos exportados. A variável uploads O prefixo é adicionado automaticamente ao caminho da pasta. LiveRamp A recomenda a criação de uma subpasta dedicada para deliveries do Adobe Real-Time CDP para manter os arquivos separados de quaisquer outros feeds existentes e garantir que toda a automação seja executada sem problemas.
    • Por exemplo, se você deseja exportar seus arquivos para uploads/my_export_folder, digite my_export_folder no Caminho da pasta campo.
  • Formato de compactação: selecione o tipo de compactação que o Experience Platform deve usar para os arquivos exportados. As opções disponíveis são GZIP ou Nenhum.

Ativar alertas

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, leia o manual no assinatura de alertas de destinos usando a interface do.

Quando terminar de fornecer detalhes da conexão de destino, selecione Próxima.

Ativar públicos-alvo para esse destino

IMPORTANTE

Para ativar os dados, é necessário Exibir destinos, Ativar destinos, Exibir perfis, e Exibir segmentos permissões de controle de acesso. Leia o visão geral do controle de acesso ou entre em contato com o administrador do produto para obter as permissões necessárias.

Ler Ativar dados do público-alvo para destinos de exportação de perfil em lote para obter instruções sobre como ativar públicos-alvo para esse destino.

Agendamento

No Agendamento crie um agendamento de exportação para cada público-alvo, com as configurações mostradas abaixo.

  • Opções de exportação de arquivo: Exportar arquivos completos. Exportações incrementais de arquivos no momento, não são compatíveis com o LiveRamp destino.
  • Frequência: Diariamente
  • Data: selecione as horas de início e término da exportação conforme desejado.

Captura de tela da interface do usuário da Platform mostrando a etapa de agendamento de público-alvo.

O nome do arquivo exportado não pode ser configurado pelo usuário no momento. Todos os arquivos exportados para o LiveRamp - Onboarding Os destinos são nomeados automaticamente com base no seguinte modelo:

%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%

Captura de tela da interface do usuário da plataforma mostrando o modelo de nome de arquivo exportado.

Por exemplo, o nome de um arquivo exportado para uma organização chamada Luma pode ser semelhante a:

Luma_LiveRamp_52137231-4a99-442d-804c-39a09ddd005d_20230330_153857.csv

Mapear atributos e identidades

No Mapeamento etapa, você pode selecionar quais atributos e identidades deseja exportar para seus perfis.

IMPORTANTE

Este destino dá suporte à ativação de um namespace de identidade de origem por fluxo de ativação. Se precisar exportar vários namespaces de identidade, como Email e Phone, você deve criar um fluxo de ativação separado para cada identidade.

No Mapeamento etapa, a variável Campo de destino O mapeamento define o nome do cabeçalho da coluna no arquivo CSV exportado. Você pode alterar os cabeçalhos de coluna CSV no arquivo exportado para qualquer nome amigável que desejar, fornecendo um nome personalizado para a Campo de destino.

IMPORTANTE

Para quaisquer alterações feitas nos campos de público-alvo após a entrega inicial do arquivo para LiveRamp, notifique seu LiveRamp equipe de conta ou enviar um tíquete para o suporte do LiveRamp para garantir que as alterações sejam refletidas no processo de automação.

  1. No Mapeamento etapa, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.

    Captura de tela da interface do Experience Platform mostrando a tela Mapeamento.

  2. No Selecionar campo de origem escolha a Selecionar atributos categoria e selecione o atributo XDM que deseja mapear ou escolha o Selecionar namespace de identidade e selecione uma identidade para mapear ao seu destino.

    Captura de tela da interface do Experience Platform mostrando a tela Mapeamento de origem.

  3. No Selecionar campo de destino , informe o nome do atributo para o qual você deseja mapear o campo de origem selecionado. O nome do atributo definido aqui refletirá no arquivo CSV exportado como um cabeçalho de coluna.

    Captura de tela da interface do Experience Platform mostrando a tela Target Mapping.

    Você também pode inserir o nome do atributo digitando-o diretamente na Campo de destino.

    Captura de tela da interface do Experience Platform mostrando a tela Target Mapping.

Depois de adicionar todos os mapeamentos desejados, selecione Próxima e conclua o fluxo de trabalho de ativação.

Dados exportados / Validar exportação de dados

Seus dados são exportados para o LiveRamp - Onboarding local de armazenamento que você configurou, como arquivos CSV.

Ao exportar arquivos para o LiveRamp - Onboarding destino, a Platform gera um arquivo CSV para cada ID da política de mesclagem.

Por exemplo, vamos considerar os seguintes públicos-alvo:

  • Público-alvo A (política de mesclagem 1)
  • Público-alvo B (política de mesclagem 2)
  • Público-alvo C (política de mesclagem 1)
  • Audience D (política de mesclagem 1)

A Platform exportará dois arquivos CSV para LiveRamp - Onboarding:

  • Um arquivo CSV contendo os públicos-alvo A, C e D;
  • Um arquivo CSV contendo o público-alvo B.

Os arquivos CSV exportados contêm perfis com os atributos selecionados e o status de público-alvo correspondente, em colunas separadas, com o nome do atributo e audience_namespace:audience_ID pares como cabeçalhos de coluna, conforme mostrado no exemplo abaixo:

ATTRIBUTE_NAME, AUDIENCE_NAMESPACE_1_AUDIENCE_ID_1, AUDIENCE_NAMESPACE_2_AUDIENCE_ID_2,..., AUDIENCE_NAMESPACE_X_AUDIENCE_ID_X

Os perfis incluídos nos arquivos exportados podem corresponder a um dos seguintes status de qualificação de público-alvo:

  • Active: o perfil está qualificado para o público-alvo no momento.
  • Expired: o perfil não está mais qualificado para o público-alvo, mas se qualificou no passado.
  • ""(sequência de caracteres vazia): o perfil nunca se qualificou para o público-alvo.

Por exemplo, um arquivo CSV exportado com um email atributo, dois públicos-alvo originados do Experience Platform Serviço de segmentação, e um importado público externo, pode ter esta aparência:

email,ups_aa2e3d98-974b-4f8b-9507-59f65b6442df,ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f,CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
abc117@testemailabc.com,active,,
abc111@testemailabc.com,,,active
abc102@testemailabc.com,,,active
abc116@testemailabc.com,active,,
abc107@testemailabc.com,active,expired,active
abc101@testemailabc.com,active,active,

No exemplo acima, a variável ups_aa2e3d98-974b-4f8b-9507-59f65b6442df e ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f descrevem os públicos-alvo provenientes do Serviço de segmentação, enquanto CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e descreve um público-alvo importado para o Platform as a upload personalizado.

Como a Platform gera um arquivo CSV para cada ID da política de mesclagem, ele também gera um fluxo de dados separado para cada ID de política de mesclagem.

Isto significa que a Identidades ativadas e Perfis recebidos métricas no execuções de fluxo de dados As páginas são agregadas para cada grupo de públicos-alvo que usam a mesma política de mesclagem, em vez de serem exibidas para cada público-alvo.

Como consequência da geração de execuções de fluxo de dados para um grupo de públicos-alvo que usam a mesma política de mesclagem, os nomes dos públicos-alvo não são exibidos no painel de monitoramento.

Captura de tela da interface do Experience Platform mostrando a métrica de identidades ativadas.

Carregar dados exportados para o LiveRamp

Após os dados serem exportados com êxito para o LiveRamp - Onboarding armazenamento, você deve fazer upload dos dados para o LiveRamp plataforma.

Para obter mais informações sobre como fazer upload dos arquivos da LiveRamp - Onboarding armazenamento para um LiveRamp público-alvo, consulte a seguinte documentação: Considerações ao fazer upload do primeiro arquivo para um público-alvo.

Uso e governança de dados

Todos Adobe Experience Platform os destinos estão em conformidade com as políticas de uso de dados ao manipular seus dados. Para obter informações detalhadas sobre como Adobe Experience Platform fiscaliza a governança de dados, leia o Visão geral da governança de dados.

Recursos adicionais

Para obter mais detalhes sobre como configurar LiveRamp - Onboarding armazenamento, consulte a seção documentação oficial.

Nesta página