Integração com a LiveRamp

Esta página descreve as configurações necessárias para trazer dados da LiveRamp como uma fonte de dados da carga de trabalho de marketing da base de dados do Cortex Framework.

A LiveRamp é uma plataforma de colaboração de dados que ajuda as empresas a conectar, controlar e ativar os dados para melhorar as experiências dos clientes e gerar melhores resultados de negócios. O Cortex Framework oferece as ferramentas e a plataforma para analisar, combinar com outras fontes de dados e usar a IA para gerar insights mais detalhados e otimizar sua estratégia de marketing.

O diagrama a seguir descreve como a fonte de dados da LiveRamp está disponível no workload de marketing da Cortex Framework Data Foundation:

Fonte de dados do LiveRamp

Figura 1. Fonte de dados do LiveRamp.

Arquivo de configuração

O arquivo config.json configura as definições necessárias para se conectar a fontes de dados e transferir dados de várias cargas de trabalho. Esse arquivo contém os seguintes parâmetros para a LiveRamp:

   "marketing": {
        "deployLiveRamp": true,
        "LiveRamp": {
            "datasets": {
                "cdc": ""
            }
        }
    }

A tabela a seguir descreve o valor de cada parâmetro da LiveRamp:

Parâmetro Significado Valor padrão Descrição
marketing.LiveRamp Implantar o LiveRamp true Execute a implantação para a fonte de dados da LiveRamp.
marketing.LiveRamp.datasets.cdc Conjunto de dados do CDC para a LiveRamp Conjunto de dados de CDC para o LiveRamp.

Conexão de API

A base de dados do Cortex Framework permite a resolução de identidade ao se integrar à LiveRamp.Os frameworks do Cortex podem realizar pesquisas de RampID, que permitem às empresas identificar públicos-alvo ou segmentos de clientes conhecidos nos sistemas de CRM.

O RampID é um identificador gerado pela API da LiveRamp usando informações de identificação pessoal (PII), como e-mail, número de telefone e nome. Com ela, as empresas podem identificar e consolidar registros em vários sistemas, como públicos-alvo de diferentes campanhas. Ao fazer a integração com a LiveRamp, as empresas podem melhorar a capacidade de identificar e segmentar os públicos-alvo, resultando em campanhas de marketing mais eficazes e personalizadas.

A API LiveRamp Identity Resolution Retrieval permite que as empresas resolvam programaticamente dados de PII para indivíduos. O Cortex Framework usa o endpoint de pesquisa da LiveRamp enviando dados de PII com hash pela chamada de API.

Tabelas de entrada e saída

Depois de implantar o Cortex Framework, o sistema cria as duas tabelas do BigQuery a seguir no conjunto de dados relevante fornecido em config.json.

rampid_lookup_input tabela

A tabela rampid_lookup_input é a entrada para o processo de pesquisa de RampID.

Coluna Tipo de dado Descrição Exemplo Chave primária
ID STRING ID exclusivo deste registro. "123" Sim
segment_name STRING Nome do público-alvo/CRM/segmento de cliente. "Alto valor" Não
source_system_name STRING Sistema de origem de onde o registro veio. "Salesforce" Não
nome STRING Nome do cliente "John Doe" Não
e-mail STRING E-mail do cliente "example@example.com" Não
phone_number STRING Telefone do cliente "1234567890" Não
postal_code STRING Código postal do cliente "12345" Não
is_processed BOOL Indica se um registro já foi processado.

Para novos registros, preencha com FALSE.

O sistema atualiza esse valor para "TRUE" quando o processamento é concluído. 		FALSO Não
load_timestamp TIMESTAMP Carimbo de data/hora em que o registro foi inserido no sistema. Isso é apenas para fins de auditoria. "2020-01-01 00:00:00 UTC" Não
processed_timestamp TIMESTAMP Carimbo de data/hora em que o sistema realizou a pesquisa de API para esse registro. Isso é sempre preenchido pelo sistema. "2020-01-01 00:00:00 UTC" Não

A tabela rampid_lookup_input precisa ser preenchida periodicamente (com base nas necessidades da sua empresa) com detalhes de PII do cliente, como: O Cortex Framework não oferece uma maneira automatizada de fazer isso, mas fornece um script de amostra ddls/samples/populate_rampid_lookup_input.sql que mostra como preencher essa tabela usando dados do sistema do Salesforce já implantado com o Cortex Framework. Use este arquivo como um guia caso seus dados venham de outro sistema.

Verifique se não há entradas duplicadas na tabela rampid_lookup_input. Por exemplo, se a mesma pessoa estiver presente várias vezes com as mesmas informações de PII, mesmo que o ID seja diferente. O DAG de pesquisa do Cortex Framework falharia se um segmento contivesse muitas entradas duplicadas. Isso é aplicado pelas APIs da LiveRamp.

A tabela rampid_lookup

A tabela rampid_lookup é uma tabela de saída que contém RampIDs para cada segmento no registro de entrada. Por design, a LiveRamp não permite mapear o RampID para um registro individual.

Coluna Tipo de dado Descrição
segment_name STRING Nome do segmento da tabela de entrada.
ramp_id STRING RampID da LiveRamp
registro de carimbo TIMESTAMP Carimbo de data/hora em que essa pesquisa de RampID foi realizada.

Os RampIDs da LiveRamp podem mudar com o tempo para a mesma pessoa. Isso significa que você precisa fazer uma nova pesquisa de dados já processados periodicamente. O Cortex Framework oferece um script de exemplo ddls/samples/clean_up_segment_matching.sql que mostra como fazer isso no nível do segmento. Assim, você pode redefinir um segmento inteiro, e o sistema vai realizar uma pesquisa para esse segmento e fornecer RampIDs atualizados.

A rampid_lookup (tabela de saída) pode conter um número ligeiramente menor de registros em comparação com a tabela de entrada. Isso é proposital, já que o Cortex Framework tenta depurar os registros de entrada usando detalhes de PII para garantir que a pesquisa da API LiveRamp não falhe.

Autenticação da conta

  1. Entre em contato com a LiveRamp para receber credenciais de autenticação. Isso inclui o ID do cliente e a chave secreta do cliente.

  2. Crie um secret usando o Secret Manager com o nome cortex-framework-liveramp e use o seguinte como valor. Consulte as instruções na documentação do Secret Manager.

    {
  'client_id':'CLIENT_ID',
  'client_secret':'CLIENT_SECRET',
  'grant_type':'client_credentials'
}

    Substitua:

    • 'CLIENT_ID' com o ID do cliente obtido na etapa 1.
    • 'CLIENT_SECRET' com a chave secreta do cliente obtida na etapa 1.

Conexões do Airflow Gerenciado

Crie as seguintes conexões no Airflow Gerenciado. Confira mais detalhes na documentação sobre como gerenciar conexões do Airflow.

Nome da conexão Purpose
liveramp_cdc_bq Para API do LiveRamp > transferência de conjunto de dados de CDC

Configuração

O arquivo config.ini controla alguns comportamentos do DAG do Airflow Gerenciado, além de como as APIs do LiveRamp são consumidas. Configure o arquivo LiveRamp/src/pipelines/config.ini de acordo com suas necessidades. Embora esses parâmetros já estejam descritos no arquivo, preste atenção em liveramp_api_base_url. Por padrão, esse parâmetro aponta para o URL da API de produção da LiveRamp. Para fins de teste, talvez seja necessário apontar para a versão de pré-produção, dependendo da sua configuração.

A seguir