Integração com o LiveRamp

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

A LiveRamp é uma plataforma de colaboração de dados que ajuda as empresas a ligar, controlar e ativar os respetivos dados para melhorar as experiências dos clientes e gerar melhores resultados para a empresa. O Cortex Framework oferece as ferramentas e a plataforma para analisá-los, combiná-los com outras origens de dados e usar a IA para obter estatísticas mais detalhadas e otimizar a sua estratégia de marketing.

O diagrama seguinte descreve como a origem de dados do LiveRamp está disponível através da carga de trabalho de marketing da Data Foundation do Cortex Framework:

Ficheiro de configuração

O ficheiro config.json configura as definições necessárias para estabelecer ligação a origens de dados para transferir dados de várias cargas de trabalho. Este ficheiro contém os seguintes parâmetros para o LiveRamp:

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

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

Ligação à API

A base de dados do Cortex Framework permite a resolução de identidades através da integração com o LiveRamp.Os Cortex Frameworks podem realizar uma procura de RampIDs, o que permite às empresas identificar públicos-alvo conhecidos ou segmentos de clientes a partir dos respetivos sistemas de CRM.

O RampID é um identificador gerado pela API da LiveRamp através de informações de identificação pessoal (PII), como o email, o número de telefone e o nome. Este RampID permite que as empresas identifiquem e consolidem registos em vários sistemas, como públicos-alvo de diferentes campanhas. Através da integração com a LiveRamp, as empresas podem melhorar a capacidade de identificar e segmentar os seus 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 de forma programática os dados de PII para indivíduos. A framework Cortex usa o ponto final de pesquisa da LiveRamp enviando dados de PII com hash através da chamada API.

Tabelas de entrada e saída

Após a implementação da Cortex Framework, o sistema cria as duas tabelas do BigQuery seguintes 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.

A tabela rampid_lookup_input tem de ser preenchida periodicamente (com base nas necessidades da sua empresa) com os detalhes de PII dos seus clientes, como: O Cortex Framework não oferece uma forma automática de o fazer, mas disponibiliza um script de exemplo ddls/samples/populate_rampid_lookup_input.sql que mostra como pode preencher esta tabela com dados no seu sistema Salesforce já implementado com o Cortex Framework. Pode usar este ficheiro como guia caso os seus dados provenham de outro sistema.

Certifique-se de que não tem entradas duplicadas na tabela rampid_lookup_input (por exemplo, o mesmo indivíduo está presente várias vezes com as mesmas informações de PII, mesmo que o respetivo ID possa ser diferente). O DAG de pesquisa da framework Cortex falha se um segmento contiver muitas entradas duplicadas. Isto é 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 registo de entrada. Por predefinição, o LiveRamp não permite mapear o RampID para um registo individual.

Os RampIDs do LiveRamp podem mudar ao longo do tempo, para o mesmo indivíduo. Isto significa que tem de fazer uma nova pesquisa dos dados já processados periodicamente. O Cortex Framework fornece um script de exemplo ddls/samples/clean_up_segment_matching.sql que mostra como pode fazê-lo ao nível do segmento. Desta forma, pode repor um segmento inteiro, e o sistema faz uma pesquisa desse segmento e fornece RampIDs atualizados.

A rampid_lookup (tabela de saída) pode conter um número ligeiramente inferior de registos em comparação com a tabela de entrada. Isto é intencional, uma vez que a framework Cortex tenta depurar os registos de entrada através de detalhes de PII para garantir que a procura da API LiveRamp não falha.

Autenticação da conta

1. Contacte a LiveRamp para obter credenciais de autenticação. Deve incluir o ID de cliente e o segredo do cliente.

2. Crie um segredo com 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 o seguinte:

   • "CLIENT_ID" com o ID de cliente obtido no passo 1.
   • 'CLIENT_SECRET' com o segredo do cliente obtido no passo 1.

Ligações do Cloud Composer

Crie as seguintes associações no Cloud Composer. Veja mais detalhes na documentação sobre a gestão de associações do Airflow.

Configuração

O ficheiro config.ini controla alguns comportamentos do DAG do Cloud Composer, bem como a forma como as APIs LiveRamp são consumidas. Configure o ficheiro LiveRamp/src/pipelines/config.ini com base nas suas necessidades. Embora estes parâmetros já estejam descritos no ficheiro, preste atenção a liveramp_api_base_url. Por predefinição, este parâmetro aponta para o URL da API de produção da LiveRamp. Para fins de teste, pode ter de apontá-lo para a versão de preparação, consoante a sua configuração.

O que se segue?

• Para mais informações sobre outras origens de dados e cargas de trabalho, consulte o artigo Origens de dados e cargas de trabalho.
• Para mais informações sobre os passos de implementação em ambientes de produção, consulte os Pré-requisitos de implementação da base de dados do Cortex Framework.