Integrasi dengan LiveRamp

Halaman ini menjelaskan konfigurasi yang diperlukan untuk memasukkan 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 lain, dan menggunakan AI untuk mendapatkan insight yang lebih mendalam serta 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

Cortex Framework Data Foundation memungkinkan Resolusi Identitas dengan berintegrasi dengan LiveRamp.Cortex Framework dapat melakukan pencarian RampID, yang memungkinkan bisnis mengidentifikasi audiens atau segmen pelanggan yang dikenal 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 dari 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 menyelesaikan data PII secara terprogram untuk individu. Cortex Framework menggunakan Lookup Endpoint LiveRamp dengan mengirimkan data PII yang di-hash melalui panggilan API.

Tabel input dan output

Setelah men-deploy Cortex Framework, 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 Primary Key
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 suatu data sudah diproses.

Untuk data baru, isi kolom ini dengan FALSE.

Sistem akan memperbarui nilai ini menjadi TRUE setelah diproses. 		FALSE Tidak
load_timestamp TIMESTAMP Stempel waktu saat data dimasukkan ke dalam sistem. Hal ini murni untuk tujuan audit. "2020-01-01 00:00:00 UTC" Tidak
processed_timestamp TIMESTAMP Stempel waktu saat sistem melakukan Penelusuran API untuk catatan ini. Ini selalu diisi oleh sistem. "2020-01-01 00:00:00 UTC" Tidak

Tabel rampid_lookup_input perlu diisi secara berkala (berdasarkan kebutuhan bisnis Anda) dengan detail PII pelanggan Anda seperti. Cortex Framework tidak menyediakan cara otomatis untuk melakukannya, tetapi menyediakan skrip contoh ddls/samples/populate_rampid_lookup_input.sql yang menunjukkan cara mengisi tabel ini menggunakan data di sistem Salesforce Anda yang sudah 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 dalam tabel rampid_lookup_input (misalnya, orang yang sama muncul beberapa kali dengan informasi PII yang sama, meskipun ID-nya mungkin berbeda). DAG Pencarian Cortex Framework akan gagal jika segmen berisi banyak entri duplikat. Hal ini diterapkan oleh API LiveRamp.

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 data.

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

RampID LiveRamp dapat berubah dari waktu ke waktu, untuk individu yang sama. Artinya, Anda perlu melakukan pencarian baru untuk data yang sudah diproses dari waktu ke waktu. Cortex Framework menyediakan skrip contoh 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 serta memberi Anda RampID terbaru.

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

Autentikasi akun

  1. Hubungi LiveRamp untuk mendapatkan kredensial autentikasi. Hal 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 ID klien yang diperoleh dari langkah 1.
    • 'CLIENT_SECRET' dengan rahasia klien yang diperoleh dari langkah 1.

Koneksi Managed Airflow

Buat koneksi berikut di Managed Airflow. Lihat detail selengkapnya di Dokumentasi mengelola koneksi Airflow.

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

Konfigurasi

File config.ini mengontrol beberapa perilaku DAG Managed Airflow, serta cara penggunaan LiveRamp API. Konfigurasi 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?