Thêm biểu mẫu đăng ký vào trang web của bạn

Hướng dẫn thao tác

Dành cho:: Nhà xuất bản và marketer
Cần quyền:: forms:edit
Trong ứng dụng:: Biểu mẫu và trang, rồi Biểu mẫu đăng ký

Form đăng ký nhận email của ReputeCast chỉ cần hai dòng HTML để hiển thị trên trang web của bạn. Bạn tạo biểu mẫu một lần, chọn để nó nằm ngay trong trang, mở ra dạng bật lên hay nằm trên một trang riêng do ReputeCast lưu trữ, và ReputeCast ghi lại chính xác nội dung đồng ý mà mỗi người đã chấp nhận.

Trước khi bắt đầu

Bạn cần quyền forms:edit để tạo, sửa và xuất bản biểu mẫu. Chủ sở hữu, Quản trị viên và Biên tập viên có quyền này.
Hãy tạo trước các danh sách mà người đăng ký có thể tham gia. Xem danh sách, sự đồng ý và xác nhận hai bước.
Định tuyến luồng Hệ thống tới một nhà cung cấp gửi thư để email xác nhận của xác nhận hai bước gửi đi được. Xem định tuyến thư qua nhiều nhà cung cấp.
Đặt logo, màu và phông chữ trong phần thương hiệu: mọi biểu mẫu đều dùng chúng.

Tạo và xuất bản biểu mẫu

Trang đăng ký trên ReputeCast của không gian làm việc hoạt động ngay cả khi bạn chưa tạo biểu mẫu nào. Biểu mẫu riêng cho phép bạn chọn trường, danh sách và kiểu hiển thị.

Mở Biểu mẫu và trang, rồi Biểu mẫu đăng ký và chọn Biểu mẫu mới.
Đặt tên biểu mẫu, chọn kiểu và chọn Tạo biểu mẫu:
- Biểu mẫu Nhúng hiển thị bên trong một trang trên site của bạn.
- Biểu mẫu Bật lên mở ra phía trên site của bạn. Đặt thời điểm mở bằng Mở sau (giây) (mặc định 8) và Hoặc khi cuộn (%), tùy điều kiện nào đến trước. Sau khi ai đó đóng biểu mẫu, nó giữ trạng thái đóng trong trình duyệt đó trong số ngày ở Đóng trong (ngày) (mặc định 14).
- Trang trên ReputeCast nằm trên một trang riêng tại /subscribe/<form-slug> (slug lấy từ tên biểu mẫu), nên bạn có thể dẫn liên kết tới nó từ bất cứ đâu mà không cần viết mã.
Biểu mẫu mới có sẵn trường email và tên, danh sách công khai đầu tiên của bạn, xác nhận hai bước, trường honeypot và kiểm tra thời gian. Biểu mẫu vẫn là bản nháp cho đến khi bạn xuất bản.
Trong Trường, chọn những thông tin biểu mẫu sẽ hỏi. Email luôn bắt buộc. Đánh dấu Tên hoặc Công ty, hoặc dùng Thêm trường tùy chỉnh để thêm Họ và các trường tùy chỉnh của không gian làm việc. Một biểu mẫu có tối đa 20 trường.
Trong Danh sách, đánh dấu từng danh sách mà biểu mẫu cung cấp. Bật Cho phép người dùng chọn danh sách để hiện một ô chọn cho mỗi danh sách; khi tắt, mỗi lượt đăng ký sẽ tham gia mọi danh sách được cung cấp. Để chọn danh sách nào được chọn sẵn, đánh dấu ô của chúng trong bản xem trước trực tiếp.
Trong Sự đồng ý, sửa Nội dung đồng ý. Cụm từ “chính sách quyền riêng tư” (“privacy policy” trong nội dung tiếng Anh) dẫn tới địa chỉ chính sách quyền riêng tư trong phần thương hiệu của bạn. Mỗi thay đổi tạo một phiên bản nội dung đồng ý mới, và những lượt đăng ký trước đó vẫn giữ nội dung họ đã chấp nhận. ReputeCast lưu địa chỉ IP, thời điểm và nội dung chính xác làm bằng chứng đồng ý.
Giữ Xác nhận hai bước ở trạng thái bật (mặc định), trừ khi bạn đã biết rõ những người đăng ký. Khi bật, liên hệ ở trạng thái chờ cho đến khi họ nhấp vào liên kết trong email xác nhận. Một liên hệ từng hủy đăng ký vẫn phải xác nhận, kể cả trên biểu mẫu không dùng xác nhận hai bước.
Chọn các kiểm tra trong Chống spam (xem chống spam).
Trong Sau khi gửi, hiện thông báo có sẵn (“hãy kiểm tra hộp thư” khi dùng xác nhận hai bước, “bạn đã đăng ký” khi không dùng) hoặc chuyển hướng tới một địa chỉ của bạn, ví dụ https://acme.io/thanks.
Trong Tên miền được phép, chọn Thêm tên miền cho mỗi site có nhúng biểu mẫu, ví dụ acme.io. Chỉ nhập tên máy chủ. Mỗi tên miền con cần một mục riêng.
Chọn Lưu và xuất bản.

Nhúng biểu mẫu vào site của bạn

Trong Mã nhúng, chọn Sao chép mã tập lệnh rồi dán mã vào nơi biểu mẫu cần xuất hiện trên site của bạn:

<div data-reputecast-form="frm_8c2e1a"></div>
<script async
  src="https://news.acme.io/p/acme-newsletter/forms/frm_8c2e1a.js">
</script>

Tập lệnh được phục vụ từ /p/<workspace>/forms/<form id>.js trên tên miền tùy chỉnh của bạn, hoặc trên URL công khai của máy chủ ReputeCast khi bạn chưa có tên miền tùy chỉnh. Nó hiển thị biểu mẫu bên trong thẻ <div> bằng phông chữ của site. Tập lệnh không tải mã của bên thứ ba, không dùng iframe và không đặt cookie; nó chỉ giữ hai cờ trong local storage của trình duyệt, một cờ sau khi đăng ký và một cờ khi ai đó đóng biểu mẫu bật lên.

Biểu mẫu bật lên: chỉ dán phần tử <script>. Tập lệnh chỉ mở biểu mẫu bật lên khi trang không có phần tử data-reputecast-form; nếu có thẻ <div>, biểu mẫu sẽ hiển thị ngay trong trang.
Ngôn ngữ: biểu mẫu theo thuộc tính lang gần thẻ <div> nhất (hoặc thuộc tính data-reputecast-lang đặt trên thẻ đó). Khi biểu mẫu chưa chạy bằng ngôn ngữ đó, nó hiển thị ngôn ngữ dự phòng.
Cập nhật: trình duyệt có thể lưu đệm tập lệnh trong 5 phút, nên một thay đổi đã xuất bản có thể mất chừng ấy thời gian mới đến site của bạn.

Dùng biểu mẫu HTML thuần

Với site không tải được tập lệnh, chọn Sao chép biểu mẫu HTML. Bạn nhận được biểu mẫu dạng HTML thuần bằng một ngôn ngữ. Biểu mẫu gửi dữ liệu tới trang trên ReputeCast của nó, và trang này hiển thị kết quả:

<form action="https://news.acme.io/p/acme-newsletter/subscribe/newsletter-signup" method="post" accept-charset="utf-8" lang="en">
  <input type="hidden" name="_plain" value="1">
  <input type="hidden" name="_lang" value="en">
  <label>Email <input type="email" name="email" autocomplete="email" required></label>
  <label>First name <input type="text" name="first_name" autocomplete="given-name"></label>
  <fieldset>
    <legend>What would you like?</legend>
    <label><input type="checkbox" name="list" value="01a1637b-5a5f-75a9-9c7b-b2786b3c5968" checked> Weekly Digest</label>
    <label><input type="checkbox" name="list" value="01a1637b-5a60-7ea9-9b79-848e29771b81"> Product Updates</label>
  </fieldset>
  <label><input type="checkbox" name="consent" value="1" required> I agree to receive emails from Acme. Unsubscribe any time with one click. See the <a href="https://acme.io/privacy">privacy policy</a>.</label>
  <div style="position:absolute;left:-10000px" aria-hidden="true"><input type="text" name="website" tabindex="-1" autocomplete="off"></div>
  <button type="submit">Subscribe</button>
</form>

Hãy sao chép lại HTML sau khi bạn đổi trường, danh sách hoặc nội dung đồng ý của biểu mẫu: bản trên site của bạn không tự cập nhật. Biểu mẫu thuần bỏ qua kiểm tra thời gian, nên việc chống spam dựa vào tên miền được phép và trường honeypot.

Dẫn liên kết tới trang trên ReputeCast

Mỗi biểu mẫu có một trang trên ReputeCast trong Trang trên ReputeCast, tại /p/<workspace>/subscribe/<form-slug>, hoặc /subscribe/<form-slug> trên tên miền tùy chỉnh của bạn. Biểu mẫu được chọn cho trang đăng ký của không gian làm việc trả lời tại /subscribe. Để đổi biểu mẫu đó, xem trang đăng ký, trang tùy chọn và trang hủy đăng ký.

Chống spam

Chống spam có ba kiểm tra:

Trường honeypot và kiểm tra thời gian (mặc định bật). Một trường ẩn bắt các bot điền mọi ô nhập, và lượt gửi đến sớm hơn 3 giây sau khi biểu mẫu tải xong bị xem là tự động. Bot điền vào trường honeypot vẫn thấy thông báo thành công, nhưng không có gì được lưu.
Cloudflare Turnstile (mặc định tắt). ReputeCast chỉ hiện kiểm tra Turnstile cho những lượt gửi đã có dấu hiệu tự động, và giữ chúng trong 30 phút trong lúc người đó hoàn tất kiểm tra. Mọi biểu mẫu của không gian làm việc dùng chung cặp khóa: dán site key và secret key từ bảng điều khiển Cloudflare rồi chọn Lưu khóa. Secret key được lưu ở dạng mã hóa và không bao giờ hiện lại.
Từ chối tên miền dùng một lần và địa chỉ chức danh (mặc định bật). Hộp thư dùng một lần và địa chỉ như info@ bị từ chối, kèm thông báo giải thích lý do.

Giới hạn tốc độ áp dụng cho mọi biểu mẫu: 5 lượt gửi mỗi phút từ một địa chỉ IP trên toàn bộ biểu mẫu của không gian làm việc, và 120 lượt mỗi phút cho mỗi biểu mẫu. Để kiểm tra từng địa chỉ bằng dịch vụ xác minh ngay khi người dùng đăng ký, xem xác minh địa chỉ email.

Mặc định và giới hạn

Thiết lập	Mặc định	Cách thay đổi
Xác nhận hai bước trên biểu mẫu mới	On	Trình tạo biểu mẫu
Nhắc xác nhận	One reminder 24 hours after the confirmation email	Cố định
Thư xác nhận chờ một nhà cung cấp cho luồng Hệ thống	Up to 3 days	Cố định; sau đó các lượt đăng ký được liệt kê là đang chờ trong 30 ngày, kèm liên kết có thể sao chép
Lượt gửi đáng ngờ bị tạm giữ để kiểm tra Turnstile	30 minutes	Trình tạo biểu mẫu › Turnstile
Lượt gửi nhanh hơn mức này bị xem là tự động	3 s	API `minSeconds`, 0–60
Số lượt gửi mỗi địa chỉ IP	5 per minute across the workspace's forms	API `rateLimitPerIp`, 1–120
Số lượt gửi mỗi biểu mẫu	120 per minute	Cố định
Thời điểm biểu mẫu bật lên	Opens after 8 s; stays closed for 14 days after it's dismissed	Trình tạo biểu mẫu › Mở sau (0–600 s), Hoặc khi cuộn (0–100%), Đóng trong (0–365 ngày)
Tùy chọn tạm dừng trong trung tâm tùy chọn	30 or 90 days	Biểu mẫu và trang › Trang › trung tâm tùy chọn
Liên kết tải xuống sau khi đăng ký qua biểu mẫu	7 days	Trình tạo biểu mẫu › Liên kết có hiệu lực trong, 1–30 ngày

Email xác nhận được gửi qua luồng Hệ thống. Khi chưa có nhà cung cấp gửi thư nào gửi được thư Hệ thống, các lượt đăng ký chờ tối đa 3 ngày. Sau đó trình tạo biểu mẫu liệt kê những người vẫn đang chờ, và Sao chép liên kết xác nhận cho phép người có quyền subscribers:edit tự gửi liên kết cho từng người. Mỗi liên kết được sao chép đều được ghi nhật ký.

Kiểm tra kết quả

Mở một trang trên site có biểu mẫu và đăng ký bằng một địa chỉ bạn đọc được.
Mở email xác nhận và xác nhận. Trang xác nhận mở ra.
Trong ReputeCast, tìm địa chỉ đó trong danh sách người đăng ký: liên hệ nằm trong các danh sách của biểu mẫu, và lịch sử đồng ý của liên hệ hiện biểu mẫu, phiên bản nội dung đồng ý và nội dung. Xem quản lý liên hệ.
Trong trình tạo biểu mẫu, số liệu 30 ngày qua hiện lượt xem, lượt gửi và lượt xác nhận đăng ký.

Khắc phục sự cố

Biểu mẫu báo “Không thể dùng biểu mẫu này trên trang web này.” (This form can’t be used on this site.) Site không nằm trong tên miền được phép. Thêm tên máy chủ của site vào Tên miền được phép rồi lưu và xuất bản. Trình tạo biểu mẫu cũng hiện cảnh báo kèm số lượt gửi bị từ chối theo từng site, với các nút để cho phép site hoặc Giữ chặn.
Tập lệnh trả về 404. Biểu mẫu vẫn là bản nháp. Hãy xuất bản nó.
Biểu mẫu bật lên lại hiển thị trong trang. Trang có phần tử <div data-reputecast-form>. Xóa phần tử đó và chỉ giữ lại phần tử <script>.
Biểu mẫu bật lên không còn mở với bạn. Sau khi bạn đóng, nó giữ trạng thái đóng trong số ngày ở Đóng trong (ngày) (mặc định 14), và không bao giờ mở lại trong trình duyệt đã đăng ký. Hãy thử một cửa sổ ẩn danh.
Khách truy cập thấy “Biểu mẫu này hiện không nhận đăng ký.” (This form isn’t taking signups right now.) Ai đó đã chọn Tạm dừng nhận đăng ký. Hãy tiếp tục nhận đăng ký từ cùng menu đó.
Email xác nhận không bao giờ đến. Chưa có nhà cung cấp gửi thư nào được định tuyến cho luồng Hệ thống. Hãy kết nối một nhà cung cấp và định tuyến thư Hệ thống tới đó: các email xác nhận đã chờ chưa đến 3 ngày sẽ được gửi đi. Với các lượt đăng ký cũ hơn, dùng Sao chép liên kết xác nhận.

Liên quan

Trang đăng ký, trang tùy chọn và trang hủy đăng ký
Gắn thương hiệu cho trang và dùng tên miền riêng
Danh sách, sự đồng ý và xác nhận hai bước
Trình kích hoạt và các bước: bắt đầu một tự động hóa khi có người gửi biểu mẫu
Chạy chương trình giới thiệu: liên kết giới thiệu có thể dẫn tới bất kỳ trang biểu mẫu nào