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

SFTP com autenticação de chave SSH

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.

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.

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.

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.

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:

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

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:

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.