API Chuyển đổi cho CRM: Tích hợp dưới dạng nền tảng

Đối tác có thể cân nhắc việc cung cấp API Chuyển đổi cho các sự kiện CRM dưới dạng dịch vụ. Nhờ vậy, khách hàng có thể tải lên những sự kiện tìm kiếm khách hàng tiềm năng được tạo thông qua quảng cáo tìm kiếm khách hàng tiềm năng của họ trên Facebook/Instagram (mẫu phản hồi tức thì) từ hệ thống CRM tương ứng, cũng như có thể dùng mục tiêu tối ưu hóa Khách hàng tiềm năng chuyển đổi trong những quảng cáo có thể mang lại khách hàng tiềm năng chất lượng cao hơn và có nhiều khả năng sẽ chuyển đổi hơn.

Điều kiện tiên quyết

Để lập kế hoạch cho dự án của mình, bạn có thể sử dụng thời gian ước tính dưới đây làm hướng dẫn. Lưu ý:

  1. Giai đoạn tích hợp hay quá trình phát triển thực tế ở phía đối tác có thể mất khoảng 3-7 tuần. Sau khi tích hợp, nhà quảng cáo có thể mất từ 1,5-2 tháng mới có thể bắt đầu chạy các chiến dịch Quảng cáo tìm kiếm khách hàng tiềm năng chuyển đổi được tối ưu hóa toàn diện.
  2. Thời gian bên dưới dựa trên dữ liệu cũ. Thời gian thực tế có thể thay đổi tùy thuộc vào nguồn lực sẵn có, tốc độ giải quyết vấn đề, v.v.
Giai đoạnBướcThời gian (khoảng thời gian) ước tính







Tích hợp

Bước 1. Điều kiện tiên quyết khi thiếp lập tài sản


Bước 2. Xác thực



Bước 3. Tích hợp API




Tổng cộng

Điều kiện tiên quyết


1 ngày đến 3 tuần, tùy theo phương án xác thực


3-4 tuần.
Cần ít thời gian hơn nếu đối tác đã tích hợp với API Chuyển đổi cho sự kiện trên web, sự kiện offline, sự kiện trong ứng dụng hoặc sự kiện nhắn tin


Khoảng 3-7 tuần










Sau tích hợp


Bước 1. Thiết lập tập dữ liệu


Bước 2. Kết nối với hệ thống của đối tác


Bước 3. Chờ sự kiện CRM trong 7 ngày


Bước 4. Đặt cấu hình phễu bán hàng


Bước 5. Phân tích phễu và giai đoạn máy học


Bước 6. Chạy các chiến dịch Quảng cáo tìm kiếm khách hàng tiềm năng chuyển đổi được tối ưu hóa toàn diện*


Tổng cộng


0,25 giờ


1-2 giờ


1 tuần


0,5 giờ


1-2 tháng







Khoảng 1-2 tháng

*Nhà quảng cáo có thể chạy các chiến dịch Quảng cáo tìm kiếm khách hàng tiềm năng chuyển đổi trong giai đoạn máy học, nhưng sẽ không đạt được hiệu quả tối đa cho đến khi giai đoạn này hoàn tất.

Hướng dẫn tích hợp

Bước 1: Điều kiện tiên quyết

Nếu bạn chưa cung cấp API Chuyển đổi dưới dạng dịch vụ cho sự kiện trên web, sự kiện trong ứng dụng, sự kiện offline hoặc sự kiện nhắn tin cho doanh nghiệp, vui lòng đảm bảo rằng bạn đã thiết lập các tài sản bên dưới:

QuyềnMục đích kinh doanhThông tin trong nội dung gửi



ads_read

Bạn được phép dùng quyền này để cấp quyền truy cập API vào dữ liệu về hiệu quả quảng cáo của mình nhằm sử dụng trong bảng điều khiển tùy chỉnh và hoạt động phân tích dữ liệu hoặc để gửi thẳng sự kiện trên web từ máy chủ của bạn đến Meta.

Văn bản: Giải thích rằng bạn sẽ dùng quyền này để thay mặt nhà quảng cáo gửi thẳng sự kiện từ máy chủ của mình đến Meta qua API Chuyển đổi.

Video: Minh họa cách nền tảng của bạn gửi sự kiện qua API Chuyển đổi.






ads_management

Bạn được phép dùng tính năng này để cho phép không giới hạn số lượng tài khoản quảng cáo và giảm giới hạn tốc độ. Tối thiểu, bạn phải có quyền ads_read hoặc ads_management để dùng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.

Văn bản: Giải thích rằng bạn sẽ dùng quyền này để thay mặt nhà quảng cáo gửi thẳng sự kiện từ máy chủ của mình đến Facebook qua API Chuyển đổi hoặc để thay mặt doanh nghiệp bạn tạo và quản lý chiến dịch theo cách lập trình dưới dạng một tính năng gia tăng giá trị cho nền tảng của bạn.

Video: Minh họa cách nền tảng của bạn gửi sự kiện qua API Chuyển đổi hoặc cách một người dùng thử nghiệm đăng nhập vào nền tảng của bạn để tạo hoặc chỉnh sửa chiến dịch quảng cáo.





Quyền truy cập tiêu chuẩn để quản lý quảng cáo

Bạn được phép dùng tính năng này để cho phép không giới hạn số lượng tài khoản quảng cáo và giảm giới hạn tốc độ. Tối thiểu, bạn phải có quyền ads_read hoặc ads_management để dùng Quyền truy cập tiêu chuẩn để quản lý quảng cáo.

Để đủ điều kiện có quyền truy cập nâng cao, ứng dụng của bạn phải thực hiện thành công ít nhất 1.500 lệnh gọi API Marketing với tỷ lệ lỗi dưới 10% trong khoảng thời gian 15 ngày.

Bạn cần tránh lỗi thường gặp là gọi API liên tục sau khi đạt giới hạn tốc độ. Thay vào đó, hãy tạm dừng lệnh gọi ngay khi nhận được phản hồi lỗi.

Quyền này do hệ thống cấp nên không cần đưa vào nội dung gửi.





pages_read_engagement

Với quyền này, ứng dụng của bạn có thể đọc nội dung (bài viết, ảnh, video, sự kiện) do Trang đăng, đọc dữ liệu (gồm tên, PSID) và ảnh đại diện của người theo dõi, cũng như đọc siêu dữ liệu và thông tin chi tiết khác về Trang.

Văn bản: Giải thích rằng bạn sẽ cần có quyền này làm điều kiện tiên quyết cho quyền ads_management mà bạn sẽ dùng để thay mặt nhà quảng cáo gửi thẳng sự kiện từ máy chủ của mình đến Meta qua API Chuyển đổi.

Video: Minh họa cách nền tảng của bạn gửi sự kiện qua API Chuyển đổi.




pages_show_list (điều kiện tiên quyết cho pages_read_engagement)

Bạn được phép dùng quyền này để hiển thị danh sách các Trang mà một người dùng quản lý hoặc để xác minh quyền quản lý Trang của một người dùng.

Văn bản: Giải thích rằng bạn sẽ cần có quyền này làm điều kiện tiên quyết cho quyền pages_read_engagementads_management mà bạn sẽ dùng để thay mặt nhà quảng cáo gửi thẳng sự kiện từ máy chủ của mình đến Meta qua API Chuyển đổi.

Video: Minh họa cách nền tảng của bạn gửi sự kiện qua API Chuyển đổi.




business_management (điều kiện tiên quyết cho mọi quyền truy cập trang)

Bạn được phép dùng quyền này để gửi các hoạt động liên quan đến doanh nghiệp (ví dụ: lượt mua hàng, lượt thêm vào giỏ hàng, khách hàng tiềm năng) thay mặt cho những Trang mà người dùng ứng dụng của bạn sở hữu.

Văn bản: Giải thích rằng bạn sẽ cần có quyền này làm điều kiện tiên quyết cho quyền pages_show_list, pages_read_engagementads_management mà bạn sẽ dùng để thay mặt nhà quảng cáo gửi thẳng sự kiện từ máy chủ của mình đến Facebook qua API Chuyển đổi.

Video: Minh họa cách nền tảng của bạn gửi sự kiện qua API Chuyển đổi.


Bước 2: Xác thực

Đối tác có 2 phương án xác thực sau đây đối với những tập dữ liệu không do bạn quản lý:

Phương án 1 - Tiện ích Meta Business (MBE, ưu tiên)

MBE cung cấp một điểm cuối để truy xuất mã truy cập dành cho người dùng hệ thống được tạo trong Trình quản lý kinh doanh của nhà quảng cáo. Hãy hoàn thành tất cả yêu cầu để triển khai MBE.

Đảm bảo rằng bạn:

  • có quyền manage_business_extension cho ứng dụng của mình. Đây là quyền riêng tư yêu cầu đại diện Meta phải thêm ứng dụng của bạn vào danh sách cho phép
  • đặt giá trị của thông số kênh trong đối tượng cấu hình thiết lập là CONVERSIONS_API
  • có thể nhận phản hồi webhook khi tích hợp xong
  • sử dụng mã truy cập được trả về qua MBE và chuyển đổi mã đó thành Mã truy cập dành cho người dùng hệ thống bằng cách thực hiện một lệnh gọi API khác
  • lưu bản sao của external_business_id, pixel_id (tức là ID tập dữ liệu), business_id và mã truy cập dành cho người dùng hệ thống vào hệ thống của bạn

Phương án 2 - Mã truy cập dành cho người dùng hệ thống ứng dụng

Với phương án này, đối tác có thể yêu cầu nhà quảng cáo:

  • tạo mã truy cập dành cho người dùng hệ thống theo cách thủ công qua API Chuyển đổi trong phần Cài đặt của Trình quản lý sự kiện (EM) trên Meta
  • chia sẻ pixel_id (tức là ID tập dữ liệu), business_id và mã truy cập dành cho người dùng hệ thống với đối tác rồi lưu lại một bản sao

Bước 3. Tích hợp API

Sau đó, đối tác sẽ gọi điểm cuối API Chuyển đổi để gửi phần tải dữ liệu sự kiện. Sau đây là các bước quan trọng cần chú ý:

Tìm ID khách hàng tiềm năng

lead_id là ID định sẵn liên kết với những khách hàng tiềm năng tìm kiếm được từ chiến dịch quảng cáo tìm kiếm khách hàng tiềm năng chạy trên Facebook hoặc Instagram. Có nhiều cách để tìm ID khách hàng tiềm năng trên Meta. Đối tác nên sử dụng tính năng đọc dữ liệu hàng loạt qua Webhook hoặc API Đồ thị để tìm ID khách hàng tiềm năng.

Lưu ý rằng lead_id là một trường bắt buộc được dùng trong quá trình tích hợp API Chuyển đổi cho CRM. Trường này sẽ tải sự kiện lên lại Meta để giúp tối ưu hóa cho những khách hàng tiềm năng có chất lượng cao hơn


Thêm chuỗi partner_agent để ghi nhận

Gửi một chuỗi partner_agent duy nhất cùng với phần tải dữ liệu. Nếu có thể, bạn nên liên hệ với đại diện Meta riêng của mình để chọn một chuỗi tác nhân phù hợp. Nếu bạn đã gửi một chuỗi tác nhân qua API Chuyển đổi cho sự kiện trên web, sự kiện offline, sự kiện trong ứng dụng hoặc sự kiện nhắn tin cho doanh nghiệp, hãy sử dụng chính chuỗi tác nhân đó.

Ví dụ

Nếu thông tin nhận dạng nền tảng của bạn là datapartner, sau đây là phần tải dữ liệu mẫu cho sự kiện được gửi thay mặt khách hàng:

{
    "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"
    },
   "partner_agent": "datapartner"
}

Sử dụng đúng phần tải dữ liệu sự kiện

Khi tích hợp API Chuyển đổi cho CRM, đối tác nên dùng cấu trúc trên cho phần tải dữ liệu sự kiện để đảm bảo sự kiện có thể được tiếp nhận thành công. Lưu ý rằng cấu trúc này khác với cấu trúc dùng với API Chuyển đổi cho sự kiện trên web, sự kiện offline, sự kiện trong ứng dụng hoặc sự kiện nhắn tin cho doanh nghiệp.

Đảm bảo rằng bạn sử dụng đúng giá trị cho action_source của API Chuyển đổi cho sự kiện CRM, đó là action_source = system_generated

Gửi tất cả giai đoạn của khách hàng tiềm năng, bao gồm cả giai đoạn ban đầu

Nhớ gửi tất cả giai đoạn của khách hàng tiềm năng khi có cập nhật. Tức là một lead_id sẽ có nhiều sự kiện khi khách hàng tiềm năng di chuyển qua các giai đoạn trong phễu khách hàng tiềm năng.

Đảm bảo rằng bạn gửi giai đoạn đầu tiên của khách hàng tiềm năng (tức là sự kiện tìm kiếm khách hàng tiềm năng thô) để hệ thống biết rằng khách hàng tiềm năng đã được tiếp nhận và xử lý.

Bạn nên gửi ít nhất 2 giai đoạn cho các sự kiện từ phễu bán hàng của bạn, bao gồm cả sự kiện tìm kiếm khách hàng tiềm năng thô. Nếu có thể, bạn nên gửi từ 3 giai đoạn trở lên.

Ánh xạ đến các giai đoạn của khách hàng tiềm năng trong CRM

Nếu nhà quảng cáo của bạn đang dùng các hệ thống CRM khác nhau, hãy đảm bảo rằng bạn có thể ánh xạ thông số từ nhiều nguồn dữ liệu đến lần lượt lead_id, event_nameevent_time.

Một giải pháp khả thi là tích hợp tính năng UI/UX trên cổng thông tin dành cho nhà quảng cáo của bạn để họ tự ánh xạ thông số từ các CRM khác nhau đến lead_id, event_nameevent_time.

Sau đây là những cách làm tốt nhất khác:

  1. Tải dữ liệu lên ít nhất một lần mỗi ngày. Lý tưởng là tải dữ liệu lên theo thời gian thực. Tuy nhiên, nếu việc tích hợp theo thời gian thực không khả thi thì bạn có thể sử dụng phương thức tải lên hàng loạt theo giờ hoặc theo ngày.
  2. Mỗi lô có thể bao gồm tối đa 1.000 sự kiện. Nếu lô có lỗi, toàn bộ lô sẽ bị bỏ. Vì vậy, bạn nên sử dụng lô nhỏ và thêm logic cho các lần thử lại.
  3. Bạn có thể bổ sung dữ liệu cũ cho dữ liệu của mình trong tối đa 7 ngày trước. Chênh lệch thời gian được tính giữa event_timeupload_time. Việc bổ sung dữ liệu cũ cho một số dữ liệu có thể đẩy nhanh quá trình huấn luyện.
  4. Đảm bảo rằng giá trị event_time sau nhãn thời gian tìm kiếm khách hàng tiềm năng. Nếu không, sự kiện của bạn có thể bị bỏ.
  5. Ghi lại thông báo lỗi từ lệnh gọi API Chuyển đổi và tạo thông báo nếu có vấn đề. Việc xử lý ngoại lệ cho những lỗi này cũng sẽ là một ý hay.
  6. Lưu trữ lead_id trong hệ thống của bạn cùng với những thông tin khác như thông tin chi tiết về khách hàng tiềm năng, giai đoạn của khách hàng tiềm năng, v.v.

Sau tích hợp

Sau khi tích hợp API thành công, bạn nên chọn một số nhà quảng cáo phù hợp để thử nghiệm trước khi triển khai giải pháp cho mọi nhà quảng cáo.

Chọn nhà quảng cáo phù hợp

Bạn cần chọn nhà quảng cáo phù hợp để sử dụng API Chuyển đổi cho CRM. Sau đây là một số nguyên tắc đối với các nhà quảng cáo đó:

  • Sử dụng Quảng cáo tìm kiếm khách hàng tiềm năng trên Facebook/Instagram (Mẫu phản hồi tức thì)
  • Tìm kiếm được ít nhất 200 khách hàng tiềm năng mỗi tháng
  • Giai đoạn của khách hàng tiềm năng mà nhà quảng cáo muốn tối ưu hóa
    • diễn ra trong vòng 28 ngày kể từ khi tìm kiếm được khách hàng tiềm năng
    • có tỷ lệ chuyển đổi nằm trong khoảng từ 1% - 40%
  • Quan tâm đến chất lượng khách hàng tiềm năng

Nguyên tắc dành cho nhà quảng cáo

Để tích hợp thành công nhà quảng cáo với API Chuyển đổi cho CRM và phục vụ tốt sau tích hợp, bạn cần nắm rõ hành trình của nhà quảng cáo để hướng dẫn họ thực hiện:

Bước 1. Tạo tập dữ liệu CRM: Để xác minh xem tập dữ liệu CRM có được thiết lập đúng cách hay không, hãy mở Trình quản lý sự kiện > Nguồn dữ liệu > Cài đặt. Nếu đây là tập dữ liệu CRM thì bạn sẽ thấy phần Khách hàng tiềm năng chuyển đổi.

Bước 2. Gửi sự kiện CRM: Cho phép nhà quảng cáo kết nối với hệ thống của bạn và bắt đầu gửi sự kiện CRM. Nếu quá trình tích hợp dừng lại ở bước "Gửi sự kiện CRM" thì có nghĩa là nhà quảng cáo hoặc hệ thống của bạn chưa gửi thành công sự kiện nào.

Bước 3. Chờ sự kiện CRM trong 7 ngày: Để vượt qua bước kiểm tra Xác minh dữ liệu, tập dữ liệu phải đáp ứng mọi yêu cầu thì mới có thể chuyển sang bước tiếp theo. Để xác nhận xem giai đoạn này có thành công hay không, hãy kiểm tra trong Trình quản lý sự kiện xem trạng thái có chuyển xuống "Đặt cấu hình phễu bán hàng" không.

Nếu nhà quảng cáo không thể vượt qua bước này:

  • kiểm tra lỗi ở tab Chẩn đoán của Tập dữ liệu CRM trong Trình quản lý sự kiện.

  • liên tục gửi dữ liệu có giá trị ít nhất trong 7 ngày. Không nhất thiết phải là 7 ngày liên tiếp vì nhà quảng cáo có thể không tìm kiếm được khách hàng tiềm năng vào một số ngày như cuối tuần.

  • tải đủ sự kiện lên để so khớp với khách hàng tiềm năng tìm kiếm được trên Facebook. Ví dụ: nếu tìm kiếm được 100 khách hàng tiềm năng trong 1 ngày, nhà quảng cáo cần tải sự kiện tương ứng lên cho cả 100 khách hàng tiềm năng.

  • gửi ít nhất 2 giai đoạn cho các sự kiện từ phễu bán hàng của nhà quảng cáo, bao gồm cả giai đoạn đầu tiên của khách hàng tiềm năng (tức là sự kiện tìm kiếm khách hàng tiềm năng thô). Tuy nhiên, nhà quảng cáo nên gửi ít nhất 3 giai đoạn nếu có thể. Ví dụ: việc gửi sự kiện "Bán hàng" thôi là chưa đủ mà nhà quảng cáo cần gửi cả những giai đoạn trước đó nữa.

  • dữ liệu có mọi thông số bắt buộc và ở đúng định dạng được nêu bật trong hướng dẫn này. Việc gửi dữ liệu ở những định dạng khác có thể gây ra lỗi.


Bước 4. Đặt cấu hình phễu bán hàng

Bước 5. Phân tích phễu và giai đoạn máy học: Để vượt qua trạng thái "Phân tích phễu", quá trình tích hợp cần đáp ứng các tiêu chí sau đây:

  • Giai đoạn tối ưu hóa có tỷ lệ chuyển đổi nằm trong khoảng từ 1-40%

  • Khoảng thời gian chuyển đổi kể từ ngày tối ưu hóa là 28 ngày trở xuống

Sau khi quá trình tích hợp hoàn tất, sẽ có giai đoạn máy học kéo dài 1-2 tháng, trong đó mô hình sẽ cần sử dụng dữ liệu được gửi lại để tối ưu hóa mô hình. Để xác nhận xem quá trình tích hợp đã hoàn thành Giai đoạn máy học hay chưa, hãy kiểm tra xem trạng thái trong Trình quản lý sự kiện có hiển thị là "Đã hoàn thành giai đoạn máy học" không

Bước 6. Sử dụng tập dữ liệu CRM ở trên để chạy các chiến dịch Quảng cáo tìm kiếm khách hàng tiềm năng chuyển đổi được tối ưu hóa toàn diện thông qua Trình quản lý quảng cáo.

Lưu ý: Nhắc nhở nhà quảng cáo không thay đổi tập dữ liệu sau khi hoàn tất quá trình tích hợp. Nếu nhà quảng cáo thay đổi tập dữ liệu, hệ thống sẽ phải bắt đầu quá trình tích hợp mới và học máy lại từ đầu.