Tajo đưa dữ liệu Shopify vào Brevo theo hai cách. Ứng dụng Tajo Shopify xử lý các webhook Shopify ngay khi chúng đến. Các quy tắc đồng bộ được con người phê duyệt, chạy một chiều, theo lô và được ghi lại từ đầu đến cuối. Bài viết này giải thích cả hai, những gì chúng không bao gồm, và một vài thứ mà ứng dụng Tajo Shopify ghi ngược về Shopify.
Kiểm tra nhanh Bài viết này giả định bạn đã kết nối Shopify và Brevo, và đã xuất bản ít nhất một quy tắc đồng bộ. Nếu chưa, hãy bắt đầu với kết nối Tajo với Shopify.
Ngay khi sự kiện xảy ra: ứng dụng Tajo Shopify
Ứng dụng Tajo Shopify đăng ký các webhook Shopify và xử lý từng webhook ngay khi nó đến. Các thay đổi về khách hàng và sản phẩm chờ khoảng bốn giây trước. Khách hàng, đơn hàng, thanh toán, sản phẩm, bộ sưu tập và mức tồn kho đến Brevo theo cách này, cùng với các sự kiện như order_paid và cart_abandoned. Hướng dẫn tích hợp Shopify liệt kê mọi chủ đề và những gì mỗi chủ đề ghi vào Brevo.
Hình dạng của một quy tắc đồng bộ
Một quy tắc đồng bộ (sync rule) là một định nghĩa đã được xem lại và phê duyệt về chính xác những gì di chuyển và di chuyển như thế nào. Tác nhân xây dựng quy tắc từ mô tả của bạn, và một người phê duyệt nó. Một quy tắc có bốn phần bạn có thể kiểm tra trên trang của nó, dưới Connections > Syncs and mappings:
| Phần | Chức năng |
|---|---|
| Ánh xạ trường | Mỗi trường nguồn, trường Brevo mà nó ghi vào, và mọi phép biến đổi ở giữa |
| Biểu thức lọc | Được đánh giá theo từng bản ghi; các bản ghi không khớp sẽ bị bỏ qua |
| Cursor | Theo dõi đồng bộ đã tiến được đến đâu, để mỗi lần chạy tiếp tục từ nơi lần trước dừng lại |
| Run history | Mọi lần chạy, kèm số bản ghi đã đọc, đã ghi và thất bại, cùng thời lượng và trạng thái |
Một quy tắc đồng bộ di chuyển dữ liệu một chiều duy nhất: từ nguồn của bạn vào Brevo. Nó không bao giờ ghi vào Shopify. Ứng dụng Tajo Shopify có ghi ngược một vài thứ về Shopify, chẳng hạn hủy đăng ký nhận tin và thẻ hạng khách hàng thân thiết. Giải thích các quyền Shopify liệt kê từng thao tác ghi và thời điểm xảy ra.
Khi nào một quy tắc đồng bộ chạy
Các quy tắc đồng bộ chạy theo lô. Quy tắc đồng bộ liên hệ mặc định chạy mỗi 15 phút. Một quy tắc Shopify orders → Brevo orders đang hoạt động và đã xuất bản cũng chạy mỗi 15 phút, nhưng chỉ khi dùng bộ lọc đồng ý nhận marketing của người mua theo mẫu. Quy tắc có bộ lọc đã bị chỉnh sửa chỉ chạy khi bạn khởi chạy nó. Lần chạy theo lịch đầu tiên của quy tắc đơn hàng bắt đầu vài phút trước thời điểm đó và không gửi các đơn hàng cũ hơn. Mỗi lần chạy sau đó gửi các đơn hàng được cập nhật kể từ lần chạy trước. Đơn hàng cũ chỉ đến Brevo khi bạn tự chạy quy tắc. Trang của một quy tắc đang hoạt động có nút Test run (1 batch), và tác nhân Sync Operator chạy các quy tắc đang hoạt động khi bạn yêu cầu. Các lần chạy theo lô là điều giúp mọi lượt ghi có thể xem lại được, có ngân sách và có thể quy về một lần chạy cụ thể.
Mỗi lần chạy đọc các bản ghi mới và đã thay đổi kể từ vị trí cursor, áp dụng bộ lọc, ánh xạ các trường, và ghi vào Brevo. Bản ghi của lần chạy hiển thị chính xác số bản ghi đã đọc, đã ghi và thất bại.
Các đảm bảo về quản trị
Consent fails closed
Một quy tắc ghi dữ liệu cá nhân vào Brevo không thể được xuất bản nếu thiếu bộ lọc đồng thuận và chặn gửi. Tại thời điểm chạy, một liên hệ được ghi vào tệp đối tượng marketing mà không có bằng chứng đồng thuận sẽ bị từ chối. Khi không thể xác lập đồng thuận, Tajo từ chối việc ghi thay vì đoán. Chế độ thất bại luôn là “quá thận trọng”, không bao giờ là “gửi quá mức”.
Các lần chạy là idempotent
Mỗi lượt ghi mang một khóa được tạo từ bản ghi nguồn. Khóa này là một giá trị băm, nên không chứa dữ liệu cá nhân. Chạy lại một đồng bộ trên cùng các bản ghi, dù sau một thất bại, một lần tạm dừng hay chạy thủ công, đều không tạo ra các lượt ghi trùng lặp.
Mọi thứ đều được kiểm toán
Việc xuất bản một quy tắc, các phê duyệt bị vô hiệu và các lần tự động tạm dừng được ghi lại trong Activity. Mỗi quyết định phê duyệt kèm một lý do bằng văn bản. Mỗi lần chạy được ghi trong lịch sử chạy của quy tắc. Phê duyệt cho phép xuất bản được gắn với mã băm (digest) của đúng quy tắc đã được xem trước. Chỉnh sửa quy tắc sẽ đưa nó về bản nháp và làm vô hiệu phê duyệt, nên những gì chạy luôn là những gì đã được cho phép.
Thất bại sẽ tạm dừng quy tắc
Nếu năm lần chạy liên tiếp thất bại, một circuit breaker sẽ tự động tạm dừng quy tắc và hiển thị lỗi gần nhất trên trang của quy tắc. Khắc phục nguyên nhân, rồi xuất bản lại để tiếp tục. Một lần chạy thất bại một phần sẽ báo cáo số lượng thất bại của nó để bạn thấy chính xác điều gì đã không được ghi thành công.
Cách xử lý hủy đăng ký
- Khi một liên hệ hủy đăng ký qua liên kết ở chân email của Brevo, việc từ chối đó được ghi nhận cho liên hệ đó, và Brevo loại họ khỏi các chiến dịch sau này.
- Trong đồng bộ khách hàng theo lô, ứng dụng Tajo Shopify so sánh thời điểm đồng thuận trên Shopify với thời điểm hủy đăng ký trên Brevo và giữ lại thời điểm muộn hơn.
- Một thay đổi đồng thuận đến từ Shopify dưới dạng webhook được ghi vào Brevo đúng như Shopify báo cáo.
- Nếu liên hệ đã đăng ký nhận tin trong Shopify, ứng dụng Tajo Shopify cũng đánh dấu họ là đã hủy đăng ký trong Shopify. Một sự kiện Brevo chỉ chuyển một khách hàng từ đã đăng ký sang đã hủy đăng ký. Nó không bao giờ đăng ký nhận tin cho bất kỳ ai, nên việc đăng ký trong Brevo không làm thay đổi Shopify.
Dữ liệu nào có sẵn
Ứng dụng Tajo Shopify gửi liên hệ, đơn hàng, các sự kiện đơn hàng và giỏ hàng, danh mục sản phẩm và tồn kho. Những gì một quy tắc đồng bộ gửi phụ thuộc vào ánh xạ trường của nó. Với khách hàng Shopify, mẫu ánh xạ các trường định danh, tổng chi tiêu, số đơn hàng, thẻ và trạng thái đồng ý nhận tin vào các thuộc tính liên hệ Brevo mà bạn có thể dùng trong phân khúc và chiến dịch. Ánh xạ chính xác cho không gian làm việc của bạn không bị giấu trong một mô tả nào; hãy mở quy tắc đồng bộ và đọc bảng ánh xạ trường. Bảng đó là câu trả lời chính thức cho câu hỏi “cái gì được đồng bộ”.
Những gì Tajo chưa làm hôm nay
Rõ ràng về ranh giới quan trọng hơn một danh sách tính năng dài:
- Không có quy tắc đồng bộ hai chiều. Một quy tắc đồng bộ chỉ ghi vào Brevo. Các thao tác ghi riêng của ứng dụng Shopify vào Shopify (hủy đăng ký nhận tin, metafield tương tác và khách hàng thân thiết của Brevo, thẻ hạng khách hàng thân thiết) được liệt kê trong Giải thích các quyền Shopify.
- Không có quy tắc đồng bộ thời gian thực. Các quy tắc đồng bộ chạy theo lô. Chỉ đồng bộ qua webhook của ứng dụng Tajo Shopify hoạt động ngay khi sự kiện đến.
- Không có nút thông báo khi có hàng lại. Ứng dụng giữ tồn kho sản phẩm trong Brevo luôn cập nhật và gửi sự kiện
back_in_stockđến những người mua đã yêu cầu được thông báo. Yêu cầu đó phải đến từ storefront của bạn: ứng dụng không thêm nút “Notify me” vào giao diện cửa hàng của bạn.
Nếu một trong những ranh giới này cản trở một trường hợp sử dụng của bạn, hãy cho đội ngũ biết, các ưu tiên trong giai đoạn early access được định hình chính xác từ phản hồi như vậy.
Xem dữ liệu của bạn ở đâu
- Trong Tajo: mở quy tắc đồng bộ dưới Connections > Syncs and mappings để xem run history, vị trí cursor và số liệu theo từng lần chạy. Activity ghi lại các lần xuất bản và các lần tự động tạm dừng.
- Trong Brevo: mở Contacts và kiểm tra thuộc tính của bất kỳ liên hệ nào để xác nhận các trường đã ánh xạ đang được điền đầy đủ. Xây dựng phân khúc trên các thuộc tính đó để nhắm mục tiêu.
Khắc phục sự cố
- Liên hệ không xuất hiện trong Brevo: kiểm tra lần chạy gần nhất của quy tắc xem có thất bại không và trạng thái của nó (một quy tắc bị tạm dừng thì không chạy). Xem liên hệ thiếu trong Brevo.
- Các lần chạy thất bại liên tục: circuit breaker sẽ tạm dừng quy tắc và hiển thị lỗi gần nhất. Xem dữ liệu không đồng bộ.
- Liên hệ trùng lặp: các lượt ghi là idempotent theo từng bản ghi nguồn, nhưng các bản trùng lặp đã tồn tại từ trước trong Brevo vẫn còn đó. Xem liên hệ trùng lặp.
Câu hỏi thường gặp
Tôi có thể làm cho đồng bộ nhanh hơn không? Trang của một quy tắc đang hoạt động có nút Test run (1 batch). Với các thay đổi ngay khi chúng xảy ra, đồng bộ qua webhook của ứng dụng Tajo Shopify đã bao gồm khách hàng, đơn hàng, thanh toán, sản phẩm và tồn kho.
Điều gì xảy ra nếu một lần chạy thất bại giữa chừng? Lần chạy sẽ báo cáo số lượng thất bại của nó, cursor chỉ tiến lên trên phần đã xử lý, và lần chạy tiếp theo sẽ an toàn xử lý lại phần còn lại; các khóa idempotency ngăn chặn trùng lặp.
Tôi có thể thay đổi những gì được đồng bộ không? Có. Hãy yêu cầu tác nhân thay đổi ánh xạ trường hoặc bộ lọc của quy tắc. Chỉnh sửa sẽ đưa quy tắc về bản nháp, và quy tắc phải qua lại bước xem trước và phê duyệt trước khi chạy lại.
Tại sao quy tắc của tôi tự tạm dừng? Các lần thất bại liên tiếp làm kích hoạt circuit breaker. Trang của quy tắc hiển thị số lần thất bại và lỗi gần nhất; hãy khắc phục vấn đề rồi xuất bản lại.
Bài viết liên quan
- Kết nối Tajo với Shopify
- Kiến thức cơ bản về phân khúc
- Khắc phục sự cố: dữ liệu không đồng bộ
- Khắc phục sự cố: liên hệ thiếu trong Brevo