Quy cách phần tải dữ liệu

Khi tích hợp CRM với API Chuyển đổi của Meta và sử dụng Quảng cáo tìm kiếm khách hàng tiềm năng với mục tiêu tối ưu hóa Khách hàng có tiềm năng chuyển đổi, bạn có thể đạt kết quả chất lượng cao hơn. Hiện tại, tùy chọn tối ưu hóa này chỉ hỗ trợ Quảng cáo tìm kiếm khách hàng tiềm năng tự nhiên (Mẫu phản hồi tức thì) được tạo trên Facebook hoặc Instagram.

Hướng dẫn này cung cấp quy cách phần tải dữ liệu cho riêng sự kiện CRM được tải lên để tối ưu hóa Khách hàng có tiềm năng chuyển đổi. Không sử dụng quy cách này cho các sự kiện không liên quan đến tùy chọn tối ưu hóa này.

Hãy xem tài liệu về API Chuyển đổi để biết thêm thông tin về cách bắt đầu sử dụng API cũng như các thông tin và nguồn lực hữu ích khác.

Phần tải dữ liệu sự kiện

Thông số

Tên	Mô tả
`lead_id` số nguyên	Bắt buộc. ID do Facebook tạo cho mọi khách hàng tiềm năng. ID này là một số gồm 15 hoặc 16 chữ số, được lấy từ trường `leadgen_id` trong Webhook tìm kiếm khách hàng tiềm năng và được đưa vào thông số `user_data`. Hãy tham khảo bài viết Tìm ID khách hàng tiềm năng để biết thêm thông tin. Bạn phải sử dụng ID khách hàng tiềm năng thay vì thông tin khách hàng để so khớp. Hãy sử dụng biến để chuyển các giá trị ID vào từ CRM của bạn. Lưu ý: Không băm dữ liệu.
`event_name` chuỗi	Bắt buộc. Trường dạng tự do để thu thập các giai đoạn mà bạn sử dụng trong CRM. Hãy nhớ gửi tất cả giai đoạn khi có cập nhật, bao gồm cả giai đoạn khách hàng tiềm năng ban đầu. Ví dụ: các giai đoạn có thể bao gồm những loại sau. Nếu một khách hàng tiềm năng đến giai đoạn cuối cùng là "Đã chuyển đổi", bạn cần gửi trước mọi giai đoạn trước đó. Khách hàng tiềm năng ban đầu từ Facebook Khách hàng tiềm năng đủ điều kiện marketing Cơ hội bán hàng Đã chuyển đổi Hãy sử dụng biến để chuyển các giai đoạn vào từ CRM của bạn. Ngoài ra, bạn có thể tạo lệnh gọi API riêng cho mỗi giai đoạn.
`event_time` số nguyên	Bắt buộc. Nhãn thời gian UNIX tính bằng giây, cho biết thời điểm CRM cập nhật sự kiện cập nhật giai đoạn khách hàng tiềm năng. Hãy sử dụng biến để chuyển vào các giá trị nhãn thời gian UNIX từ cơ sở dữ liệu của bạn. Lưu ý: Giá trị của thông số `event_time` có thể lên đến 7 ngày trước khi bạn gửi sự kiện cho Meta. Ngoài ra, nhãn thời gian này phải sau thời điểm tìm kiếm khách hàng tiềm năng. Nếu không, sự kiện có thể bị bỏ.
`action_source` chuỗi	Bắt buộc. Hãy đặt thông số này thành giá trị `system_generated` cho mọi sự kiện Khách hàng có tiềm năng chuyển đổi. Đối với tích hợp Khách hàng có tiềm năng chuyển đổi, thông số này sẽ chỉ định nơi hệ thống tạo chuyển đổi.
`lead_event_source` chuỗi	Bắt buộc. Hãy đặt thông số này thành tên của công cụ cung cấp dữ liệu khách hàng tiềm năng (ví dụ: Hubspot, SAP, Oracle, Dynamics, CRM nội bộ, v.v), được đưa vào thông số `custom_data`.
`event_source` chuỗi	Bắt buộc. Hãy đặt thông số này thành giá trị `crm` cho mọi sự kiện Khách hàng có tiềm năng chuyển đổi. Đối với tích hợp Khách hàng có tiềm năng chuyển đổi, thông số này sẽ chỉ định nguồn sự kiện là CRM của bạn trong thông số `custom_data`.

Ví dụ

Ví dụ này minh họa định dạng của phần tải dữ liệu sự kiện được gửi trong lệnh gọi API.

{
    "event_name": "my lead stage",
    "event_time": 1617693833,
    "user_data": {
        "lead_id": 1234567890123456
    },
    "action_source": "system_generated",
    "custom_data": {
        "lead_event_source": "Salesforce",
        "event_source": "crm"
    }
}

Tìm hiểu thêm

Trung tâm trợ giúp doanh nghiệp: Thiết lập CRM cho Khách hàng có tiềm năng chuyển đổi
Trung tâm trợ giúp doanh nghiệp: Giới thiệu về cách tối ưu hóa phân phối cho quảng cáo tìm kiếm khách hàng tiềm năng