Integração com o LiveRamp

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

O LiveRamp é uma plataforma de colaboração de dados que ajuda as empresas a conectar, controlar e ativar os dados para melhorar a experiência do cliente 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 ter insights mais aprofundados e otimizar sua estratégia de marketing.

O diagrama a seguir descreve como a fonte de dados do LiveRamp está disponível na carga de trabalho de marketing do 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 configurações necessárias para se conectar a fontes de dados para transferir dados de várias cargas de trabalho. Esse arquivo contém os seguintes parâmetros para o LiveRamp:

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

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

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

Conexão de API

A base de dados do Cortex Framework permite a resolução de identidade ao se integrar ao LiveRamp.O Cortex Framework pode realizar a pesquisa RampID, que permite que as empresas identifiquem públicos-alvo conhecidos ou segmentos de clientes nos sistemas de CRM.

O RampID é um identificador gerado pela API do LiveRamp usando informações de identificação pessoal (PII, na sigla em inglês) como e-mail, número de telefone e nome. Esse RampID permite que as empresas identifiquem e consolidem registros em vários sistemas, como públicos-alvo de campanhas diferentes. Com a integração ao LiveRamp, as empresas podem melhorar a capacidade de identificar e segmentar os públicos-alvo, o que resulta em campanhas de marketing mais eficazes e personalizadas.

A API LiveRamp Identity Resolution Retrieval permite que as empresas resolvam dados de PII de forma programática para indivíduos. O Cortex Framework usa o endpoint de pesquisa do LiveRamp enviando dados de PII criptografados 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 do 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 CEP 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 "VERDADEIRO" depois que ele é processado. 		FALSO Não
load_timestamp TIMESTAMP Carimbo de data/hora em que o registro foi inserido no sistema. Isso é puramente 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 os 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 no seu sistema do Salesforce já implantado com o Cortex Framework. Você pode usar 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, o mesmo indivíduo aparece 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 contiver muitas entradas duplicadas. Isso é aplicado pelas APIs do 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. O 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 do LiveRamp
selo de registro TIMESTAMP Carimbo de data/hora em que a pesquisa do RampID foi realizada.

Os RampIDs do LiveRamp podem mudar ao longo do tempo, para a mesma pessoa. Isso significa que você precisa realizar uma nova pesquisa de dados já processados de tempos em tempos. O Cortex Framework fornece um script de amostra ddls/samples/clean_up_segment_matching.sql que mostra como fazer isso no nível do segmento. Dessa forma, é possível 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 é intencional, porque 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 o LiveRamp para receber as 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 recebido na etapa 1.
    • CLIENT_SECRET pela chave secreta do cliente recebida na etapa 1.

Conexões do Cloud Composer

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

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

Configuração

O arquivo config.ini controla alguns comportamentos do DAG do Cloud Composer, bem como a forma 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 a 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 teste, dependendo da sua configuração.

A seguir