Integrasi dengan LiveRamp

Halaman ini menjelaskan konfigurasi yang diperlukan untuk mengambil data dari LiveRamp sebagai sumber data beban kerja pemasaran Cortex Framework Data Foundation.

LiveRamp adalah platform kolaborasi data yang membantu bisnis menghubungkan, mengontrol, dan mengaktifkan data mereka untuk meningkatkan pengalaman pelanggan dan mendorong hasil bisnis yang lebih baik. Cortex Framework menawarkan alat dan platform untuk menganalisisnya, menggabungkannya dengan sumber data lainnya, dan menggunakan AI untuk mendapatkan insight yang lebih mendalam dan mengoptimalkan strategi pemasaran Anda.

Diagram berikut menjelaskan cara sumber data LiveRamp tersedia melalui beban kerja pemasaran Cortex Framework Data Foundation:

Sumber data LiveRamp

Gambar 1. Sumber data LiveRamp.

File konfigurasi

File config.json mengonfigurasi setelan yang diperlukan untuk terhubung ke sumber data guna mentransfer data dari berbagai beban kerja. File ini berisi parameter berikut untuk LiveRamp:

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

Tabel berikut menjelaskan nilai untuk setiap parameter LiveRamp:

Parameter Arti Nilai Default Deskripsi
marketing.LiveRamp Men-deploy LiveRamp true Jalankan deployment untuk sumber data LiveRamp.
marketing.LiveRamp.datasets.cdc Set data CDC untuk LiveRamp Set data CDC untuk LiveRamp.

Koneksi API

Framework Data Cortex Framework memungkinkan Resolusi Identitas dengan berintegrasi dengan LiveRamp.Cortex Framework dapat melakukan penelusuran RampID, yang memungkinkan bisnis mengidentifikasi audiens atau segmen pelanggan yang diketahui dari sistem CRM mereka.

RampID adalah ID yang dihasilkan oleh API LiveRamp menggunakan Informasi Identitas Pribadi (PII) seperti email, nomor telepon, dan nama. RampID ini memungkinkan bisnis mengidentifikasi dan menggabungkan data di beberapa sistem, seperti audiens berbagai kampanye. Dengan berintegrasi dengan LiveRamp, bisnis dapat meningkatkan kemampuan mereka untuk mengidentifikasi dan menargetkan audiens, sehingga menghasilkan kampanye pemasaran yang lebih efektif dan dipersonalisasi.

LiveRamp Identity Resolution Retrieval API memungkinkan bisnis me-resolve data PII secara terprogram ke individu. Cortex Framework menggunakan Endpoint Lookup LiveRamp dengan mengirimkan data PII yang di-hash melalui panggilan API.

Tabel input dan output

Setelah men-deploy Framework Cortex, sistem akan membuat dua tabel BigQuery berikut dalam set data yang relevan yang disediakan di config.json.

Tabel rampid_lookup_input

Tabel rampid_lookup_input adalah input untuk proses RampID Lookup.

Kolom Data Type Deskripsi Contoh Kunci Utama
id STRING ID unik data ini. "123" Ya
segment_name STRING Nama segmen audiens/CRM/Pelanggan. "Nilai Tinggi" Tidak
source_system_name STRING Sistem sumber tempat data berasal. "Salesforce" Tidak
nama STRING Nama Pelanggan "John Doe" Tidak
email STRING Email Pelanggan "example@example.com" Tidak
phone_number STRING Telepon Pelanggan "1234567890" Tidak
postal_code STRING Kode pos pelanggan "12345" Tidak
is_processed BOOL Menunjukkan apakah data sudah diproses.

Untuk data baru, isi dengan SALAH.

Sistem akan memperbarui status ini menjadi BENAR (TRUE) setelah diproses. 		FALSE Tidak
load_timestamp TIMESTAMP Stempel waktu saat data disisipkan dalam sistem. Hal ini murni untuk tujuan audit. "2020-01-01 00:00:00 UTC" Tidak
processed_timestamp TIMESTAMP Stempel waktu saat sistem melakukan API Lookup untuk data ini. Kolom ini selalu diisi oleh sistem. "2020-01-01 00:00:00 UTC" Tidak

Tabel rampid_lookup_input harus diisi secara berkala (berdasarkan kebutuhan bisnis Anda) dengan detail PII pelanggan Anda seperti. Cortex Framework tidak menyediakan cara otomatis untuk melakukannya, tetapi menyediakan contoh skrip ddls/samples/populate_rampid_lookup_input.sql yang menunjukkan cara mengisi tabel ini menggunakan data di sistem Salesforce yang telah di-deploy dengan Cortex Framework. Anda dapat menggunakan file ini sebagai panduan jika data Anda berasal dari sistem lain.

Pastikan Anda tidak memiliki entri duplikat di tabel rampid_lookup_input (misalnya, individu yang sama muncul beberapa kali dengan informasi PII yang sama, meskipun ID-nya mungkin berbeda). DAG Lookup Cortex Framework akan gagal jika segmen berisi banyak entri duplikat. Hal ini diterapkan oleh LiveRamp API.

Tabel rampid_lookup

Tabel rampid_lookup adalah tabel output yang berisi RampID untuk setiap segmen dalam data input. Secara desain, LiveRamp tidak mengizinkan pemetaan RampID ke setiap kumpulan data.

Kolom Data Type Deskripsi
segment_name STRING Nama segmen dari tabel input.
ramp_id STRING RampID LiveRamp
stempel data TIMESTAMP Stempel waktu saat pencarian RampID ini dilakukan.

RampID LiveRamp dapat berubah selama jangka waktu tertentu, untuk individu yang sama. Artinya, Anda perlu melakukan pencarian baru untuk data yang telah diproses dari waktu ke waktu. Cortex Framework menyediakan contoh skrip ddls/samples/clean_up_segment_matching.sql yang menunjukkan cara melakukannya di tingkat segmen. Dengan cara ini, Anda dapat mereset seluruh segmen, dan sistem akan melakukan pencarian untuk segmen tersebut dan memberi Anda RampID terbaru.

rampid_lookup (tabel output) mungkin berisi sedikit lebih sedikit jumlah data dibandingkan dengan tabel input. Hal ini memang disengaja, karena Cortex Framework mencoba men-debug data input menggunakan detail PII untuk memastikan pencarian LiveRamp API tidak gagal.

Autentikasi akun

  1. Hubungi LiveRamp untuk mendapatkan kredensial autentikasi. Ini harus mencakup Client ID dan Client Secret.

  2. Buat secret menggunakan Secret Manager dengan nama cortex-framework-liveramp, dan gunakan kode berikut sebagai nilai. Lihat petunjuk dalam dokumentasi Secret-Manager.

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

    Ganti kode berikut:

    • 'CLIENT_ID' dengan client ID yang diperoleh dari langkah 1.
    • 'CLIENT_SECRET' dengan rahasia klien yang diperoleh dari langkah 1.

Koneksi Cloud Composer

Buat koneksi berikut di Cloud Composer. Lihat detail selengkapnya di dokumentasi Mengelola koneksi Airflow.

Nama Koneksi Tujuan
liveramp_cdc_bq Untuk LiveRamp API > Transfer set data CDC

Konfigurasi

File config.ini mengontrol beberapa perilaku DAG Cloud Composer, serta cara API LiveRamp digunakan. Konfigurasikan file LiveRamp/src/pipelines/config.ini berdasarkan kebutuhan Anda. Meskipun parameter ini sudah dijelaskan dalam file, perhatikan liveramp_api_base_url. Parameter ini secara default mengarah ke URL API produksi LiveRamp. Untuk tujuan pengujian, Anda mungkin perlu mengarahkannya ke versi staging, bergantung pada penyiapan Anda.

Apa langkah selanjutnya?