LiveRamp - Onboarding conexão liveramp-onboarding
Use a conexão LiveRamp - Onboarding para integrar públicos do Adobe Real-time Customer Data Platform ao LiveRamp Connect.
Casos de uso use-cases
Para ajudá-lo a entender melhor como e quando você deve usar o destino LiveRamp - Onboarding, veja um exemplo de caso de uso que os clientes da Adobe Experience Platform podem resolver usando esse destino.
Como profissional de marketing, desejo enviar públicos-alvo do Adobe Experience Platform para identidades integradas no LiveRamp Connect para que eu possa direcionar usuários em plataformas móveis, abertas da Web, sociais e CTV, usando o identificador Ramp ID.
Pré-requisitos prerequisites
A conexão LiveRamp - Onboarding exporta arquivos usando o armazenamento SFTP🔗 do LiveRamp.
Antes de enviar dados do Experience Platform para o LiveRamp - Onboarding, você precisa de suas credenciais do LiveRamp. Entre em contato com o representante do LiveRamp para obter suas credenciais, caso ainda não as tenha.
Identidades suportadas supported-identities
O LiveRamp - Onboarding oferece suporte à ativação de identidades, como identificadores baseados em PII, identificadores conhecidos e IDs personalizadas, descritos na documentação oficial do LiveRamp.
Na etapa de mapeamento do fluxo de trabalho de ativação, você deve definir os mapeamentos de destino como atributos personalizados.
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
Consulte a tabela abaixo para obter informações sobre o tipo e a frequência da exportação de destino.
Conectar ao destino connect
Para se conectar a este 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 authenticate
Para autenticar no destino, preencha os campos obrigatórios e selecione Conectar ao destino.
Autenticação SFTP com senha
-
Porta: a porta usada para seu local de armazenamento LiveRamp - Onboarding. Use a porta que corresponde à sua localização geográfica, conforme descrito abaixo:
- NA: usar porta
22
- AU: usar a porta
2222
- NA: usar porta
-
Nome de usuário: o nome de usuário do local de armazenamento LiveRamp - Onboarding.
-
Senha: a senha do local de armazenamento LiveRamp - Onboarding.
-
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.
-
ID da Subchave:Se você fornecer uma chave de criptografia, também deverá fornecer uma ID da Subchave de criptografia. Consulte a LiveRamp documentação de criptografia para saber como obter a ID da subchave.
SFTP com autenticação de chave SSH
-
Porta: a porta usada para seu local de armazenamento LiveRamp - Onboarding. Use a porta que corresponde à sua localização geográfica, conforme descrito abaixo:
- EU: usar a porta
4222
- EU: usar a porta
-
Nome de usuário: o nome de usuário do local de armazenamento LiveRamp - Onboarding.
-
Chave SSH: a chave privada SSH usada para fazer logon no local de armazenamento LiveRamp - Onboarding. A chave privada deve ser formatada como uma cadeia de caracteres codificada em Base64 e não deve ser protegida por senha.
- Para conectar sua chave SSH ao servidor LiveRamp - Onboarding, você deve enviar um tíquete por meio do portal de suporte técnico do LiveRamp e fornecer sua chave pública. Veja mais informações na 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.
-
ID da Subchave:Se você fornecer uma chave de criptografia, também deverá fornecer uma ID da Subchave de criptografia. Consulte a LiveRamp documentação de criptografia para saber como obter a ID da subchave.
Preencher detalhes do destino destination-details
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.
- Nome: um nome pelo qual você reconhecerá este destino no futuro.
- Descrição: uma descrição que ajudará você a identificar este destino no futuro.
- Região: região geográfica da sua instância do armazenamento SFTP do LiveRamp.
- Caminho da pasta: o caminho para a subpasta LiveRamp
uploads
que hospedará os arquivos exportados. O prefixouploads
é adicionado automaticamente ao caminho da pasta. A LiveRamp recomenda criar uma subpasta dedicada para entregas a partir 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
, digitemy_export_folder
no campo Caminho da pasta.
- Por exemplo, se você deseja exportar seus arquivos para
- 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 None.
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, leia 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 dados de 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.
Agendando scheduling
Na etapa 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 não têm suporte no momento para o destino LiveRamp.
- Frequência: Diariamente
- Data: selecione as horas de início e término da exportação conforme desejar.
O nome do arquivo exportado não pode ser configurado pelo usuário no momento. Todos os arquivos exportados para o destino LiveRamp - Onboarding são automaticamente nomeados com base no seguinte modelo:
%ORGANIZATION_NAME%_%DESTINATION%_%DESTINATION_INSTANCE_ID%_%DATETIME%
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 map
Na etapa Mapeamento, você pode selecionar quais atributos e identidades deseja exportar para seus perfis.
Email
e Phone
, você deve criar um fluxo de ativação separado para cada identidade.Na etapa Mapping, o mapeamento do Campo de destino 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 o campo de Destino.
-
Na etapa Mapeamento, selecione Adicionar novo mapeamento. Você verá uma nova linha de mapeamento na tela.
-
Na janela Selecionar campo de origem, escolha a categoria Selecionar atributos e selecione o atributo XDM que deseja mapear ou escolha a categoria Selecionar namespace de identidade e selecione uma identidade para mapear para seu destino.
-
Na janela Selecionar campo de destino, digite 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.
Você também pode inserir o nome do atributo digitando-o diretamente no Campo de destino.
Depois de adicionar todos os mapeamentos desejados, selecione Avançar e conclua o fluxo de trabalho de ativação.
Dados exportados / Validar exportação de dados exported-data
Seus dados são exportados para o local de armazenamento LiveRamp - Onboarding que você configurou, como arquivos CSV.
Os arquivos exportados têm um tamanho máximo de 10 milhões de linhas. O Experience Platform gera vários arquivos por delivery se os públicos-alvo selecionados excederem 10 milhões de linhas. Se você espera exceder o limite de arquivo único, contate o representante do LiveRamp e peça a ele para configurar a assimilação em lote para você.
Ao exportar arquivos para o destino LiveRamp - Onboarding, 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 pares de audience_namespace:audience_ID
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 a audiência.Expired
: o perfil não está mais qualificado para a audiência, mas foi qualificado no passado.""
(cadeia de caracteres vazia): o perfil nunca se qualificou para a audiência.
Por exemplo, um arquivo CSV exportado com um atributo email
, dois públicos-alvo originados do Experience Platform Serviço de segmentação e um público-alvo externo importado podem ser assim:
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, as seções ups_aa2e3d98-974b-4f8b-9507-59f65b6442df
e ups_45d4e762-6e57-4f2f-a3e0-2d1893bcdd7f
descrevem públicos-alvo originados do Serviço de Segmentação, enquanto CustomerAudienceUpload_7729e537-4e42-418e-be3b-dce5e47aaa1e
descreve um público importado para a Platform como um carregamento personalizado.
Como a Platform gera um arquivo CSV para cada ID da política de mesclagem, ela também gera uma execução de fluxo de dados separada para cada ID da política de mesclagem.
Isso significa que as métricas Identidades ativadas e Perfis recebidos na página execuções do fluxo de dados são agregadas para cada grupo de públicos que usam a mesma política de mesclagem, em vez de serem exibidas para cada público.
Como consequência da geração de execuções de fluxo de dados para um grupo de públicos que usam a mesma política de mesclagem, os nomes de públicos-alvo não são exibidos no painel de monitoramento.
Carregar dados exportados para o LiveRamp upload-to-liveramp
Depois que seus dados forem exportados com êxito para o armazenamento do LiveRamp - Onboarding, você deverá carregá-los na plataforma LiveRamp.
Para obter mais informações sobre como carregar seus arquivos do armazenamento do LiveRamp - Onboarding para um público-alvo do LiveRamp, consulte a seguinte documentação: Considerações ao Carregar o Primeiro Arquivo para um Público-alvo.
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
Para obter mais detalhes sobre como configurar o armazenamento do LiveRamp - Onboarding, consulte a documentação oficial.
Changelog changelog
Esta seção captura a funcionalidade e as atualizações de documentação significativas feitas neste conector de destino.
table 0-row-3 1-row-3 2-row-3 layout-auto | ||
---|---|---|
Mês de lançamento | Tipo de atualização | Descrição |
Março de 2024 | Atualização de funcionalidade e documentação |
|
Julho de 2023 | Versão inicial | Versão inicial de destino e documentação publicada. |