Thư viện mẫu cho cộng đồng của Trình quản lý thẻ của Google cho phép tổ chức của bạn tạo và quản lý các mẫu thẻ và biến tích hợp sẵn với Trình quản lý thẻ của Google. Tổ chức của bạn có thể tạo một mẫu, xuất bản kho lưu trữ mẫu lên GitHub, sau đó gửi mẫu đó đến Thư viện mẫu cho cộng đồng để cung cấp cho người dùng trên toàn thế giới. Tổ chức của bạn sẽ nhận được những lợi ích sau:
- Khách hàng của bạn sẽ có thể dễ dàng thêm và sử dụng các mẫu của bạn.
- Người dùng Trình quản lý thẻ sẽ thấy thương hiệu của tổ chức bạn.
- Khách hàng của bạn sẽ có thể triển khai thẻ trong vòng vài phút chứ không phải vài tháng.
- Bạn có thể phát hành nội dung cập nhật cho mẫu và tự động cung cấp nội dung cập nhật đó cho khách hàng.
Quy trình gửi mẫu mới đến Thư viện mẫu cho cộng đồng bao gồm các bước chính sau:
Tạo mẫu
Để bắt đầu, hãy tạo mẫu trong Trình quản lý thẻ của Google dưới dạng mẫu tuỳ chỉnh. Đảm bảo mẫu của bạn đã được kiểm thử kỹ lưỡng, nội dung của mẫu tuân thủ Hướng dẫn về kiểu và bạn có kế hoạch hoặc quy trình để duy trì và cập nhật mẫu nếu cần trong tương lai.
Điều khoản dịch vụ
Mọi mẫu mới gửi đều phải đồng ý với Điều khoản dịch vụ của Thư viện mẫu cho cộng đồng Trình quản lý thẻ của Google. Cách xác nhận việc đồng ý với Điều khoản dịch vụ cho mẫu:
- Đọc Điều khoản dịch vụ của Thư viện mẫu cho cộng đồng Trình quản lý thẻ của Google.
- Trong Trình chỉnh sửa mẫu, hãy mở mẫu để chỉnh sửa rồi đánh dấu vào hộp có nhãn "Đồng ý với Điều khoản dịch vụ của Thư viện mẫu cho cộng đồng" trong thẻ Thông tin.
Xuất mẫu
Sau khi hoàn tất mẫu, hãy xuất tệp mẫu sang máy cục bộ rồi đổi tên tệp thành template.tpl
.
Chuẩn bị tệp dự án
Bước tiếp theo là chuẩn bị kho lưu trữ để phát hành trên GitHub. Mỗi kho lưu trữ phải chứa các tệp sau:
- Tệp mẫu đã xuất có tên là
template.tpl
. Bạn phải cập nhật tệp này để thêm mụccategories
. - Tệp
metadata.yaml
. - Tệp
LICENSE
. Tên tệp phải viết hoa TOÀN BỘ và nội dung của tệp giấy phép phải chỉ là Apache 2.0. - Thêm tệp
README.md
(không bắt buộc, nhưng nên dùng).
Thêm danh mục vào template.tpl
Cập nhật tệp template.tpl
bằng mục nhập categories
vào mục INFO
và cung cấp ít nhất một giá trị danh mục có liên quan được chọn trong bảng sau. Nếu có nhiều danh mục phù hợp, bạn có thể cung cấp tối đa 3 giá trị danh mục, được sắp xếp theo thứ tự từ phù hợp nhất đến ít phù hợp nhất.
Ví dụ:
___INFO___
{
"displayName": "Example Template",
"categories": ["AFFILIATE_MARKETING", "ADVERTISING"],
// additional template properties, etc...
}
Bảng giá trị danh mục được hỗ trợ:
Danh mục | Mô tả |
---|---|
QUẢNG CÁO | Quảng cáo |
AFFILIATE_MARKETING | Tiếp thị liên kết |
ANALYTICS | Số liệu phân tích |
GHI CÔNG | Phân bổ |
TRÒ CHUYỆN | Chat (Trò chuyện) |
CHUYỂN ĐỔI | Đo lường lượt chuyển đổi |
DATA_WAREHOUSING | Kho dữ liệu |
EMAIL_MARKETING | Tiếp thị qua email |
THỬ NGHIỆM | Thử nghiệm A/B và tối ưu hoá nội dung |
HEAT_MAP | Bản đồ nhiệt |
LEAD_GENERATION | Khả năng tạo khách hàng tiềm năng |
TIẾP THỊ | Tiếp thị |
CÁ NHÂN HOÁ | Cá nhân hoá |
TĂNG CƯỜNG TIẾP THỊ | Tiếp thị lại |
GIẢM GIÁ | Bán hàng và CRM |
SESSION_RECORDING | Bản ghi phiên |
XÃ HỘI | Xã hội |
KHẢO SÁT | Khảo sát |
TAG_MANAGEMENT | Hệ thống quản lý thẻ |
Tiện ích | Tiện ích của Trình quản lý thẻ của Google |
metadata.yaml
Tệp metadata.yaml
chứa thông tin về mẫu, bao gồm cả đường liên kết đến trang chủ của tổ chức, tài liệu về mẫu và thông tin phiên bản. Mỗi phiên bản được biểu thị bằng một số thay đổi, còn gọi là số SHA, là số thay đổi liên kết với thay đổi trong Git. Trường changeNotes
là trường không bắt buộc nhưng bạn nên sử dụng để thông báo cho người dùng về những thay đổi trong phiên bản.
Cách thiết lập tệp metadata.yaml
:
- Thêm mục nhập
homepage
. Đây phải là URL trỏ đến trang chủ của tổ chức. - Thêm mục nhập cho
documentation
. Đây phải là URL trỏ đến tài liệu về mẫu của bạn. - Trong GitHub, hãy tìm thay đổi mà bạn muốn đẩy cho phiên bản ban đầu của mẫu và sao chép số SHA. Một cách dễ dàng để lấy số SHA trong GitHub là chuyển đến chế độ xem cam kết rồi nhấp vào biểu tượng bảng nhớ tạm (
). Thao tác này sẽ sao chép toàn bộ số SHA vào bảng nhớ tạm. Dán số đó làm giá trị cho mục
sha
dưới dạng phần tử con của nútversions
, như minh hoạ dưới đây. - Thêm mục nhập
changeNotes
vào nútversions
để mô tả ngắn gọn các thay đổi có trong phiên bản mới này.
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
- sha: 5f02a788b90ae804f86b04aa24af8937e567874a
changeNotes: Initial release.
Tải lên GitHub
Bước tiếp theo là tải tệp lên GitHub. Tạo một kho lưu trữ GitHub có các tệp và cấu trúc phù hợp như đã nêu ở trên.
Kho lưu trữ mẫu phải có các tệp * template.tpl
, metadata.yaml
và LICENSE
ở cấp gốc của kho lưu trữ Git. Mỗi kho lưu trữ Git chỉ được có một tệp template.tpl
. Tất cả tài nguyên phải nằm trên nhánh chính trong kho lưu trữ GitHub của bạn. Mọi kho lưu trữ mẫu không khớp với cấu trúc này sẽ bị xoá khỏi Thư viện.
Mỗi mục trong Thư viện mẫu cho cộng đồng sẽ liên kết đến phần Vấn đề của kho lưu trữ GitHub của mẫu để người dùng có thể cho bạn biết nếu họ phát hiện lỗi. Hãy đảm bảo rằng các vấn đề chưa bị vô hiệu hoá đối với kho lưu trữ GitHub của mẫu để bạn có thể xem xét và giải quyết mọi vấn đề phát sinh.
Gửi mẫu
Sau khi lưu trữ kho lưu trữ mẫu trên GitHub, bạn có thể tiếp tục gửi mẫu vào Thư viện mẫu cho cộng đồng. Để gửi mẫu, hãy làm theo các bước sau:
- Đảm bảo bạn đã đăng nhập vào GitHub bằng một tài khoản có quyền truy cập vào kho lưu trữ mẫu mà bạn muốn thêm vào Thư viện.
- Truy cập vào Thư viện mẫu cho cộng đồng tại tagmanager.google.com/gallery.
- Nhấp vào more_vert rồi chọn Gửi mẫu.
- Cung cấp URL kho lưu trữ trong trường được cung cấp rồi nhấp vào Gửi.
Cập nhật mẫu
Sau khi xuất bản mẫu, bạn có thể cập nhật mẫu theo thời gian. Người dùng mẫu sẽ nhận được thông báo nếu có bản cập nhật cho mẫu và có thể cập nhật mẫu lên phiên bản mới nhất.
Tệp metadata.yaml
được dùng để xác định phiên bản mẫu cần sử dụng trong thư viện. Để phát hành các phiên bản mới, bạn cần thêm số thay đổi (số SHA) vào phần versions
của tệp metadata.yaml
.
- Tìm thay đổi mà bạn muốn đẩy và sao chép số SHA. Một cách dễ dàng để thực hiện việc này trong GitHub là chuyển đến chế độ xem cam kết rồi nhấp vào biểu tượng bảng nhớ tạm (
). Thao tác này sẽ sao chép toàn bộ số SHA vào bảng nhớ tạm.
- Thêm mục
sha
mới vào đầu danh sáchversions
trongmetadata.yaml
. (Xem ví dụ bên dưới.) - Thêm
changeNotes
để mô tả ngắn gọn các thay đổi có trong phiên bản mới này. Bạn có thể tạo các nhận xét nhiều dòng nếu muốn. (Xem ví dụ bên dưới.) - Hãy xác nhận thay đổi đối với
metadata.yaml
và nội dung cập nhật của bạn sẽ xuất hiện trong thư viện trong vòng 2 đến 3 ngày.
Ví dụ này minh hoạ cách thêm thông tin phiên bản mới, bao gồm cả số SHA và ghi chú thay đổi:
homepage: "https://www.example.com"
documentation: "https://www.example.com/documentation"
versions:
# Latest version
- sha: 5f02a788b90ae804f86b04aa24af8937e567874c
changeNotes: |2
Fix bug with the whatsamajig.
Improve menu options.
Update API calls.
# Older versions
- sha: 5f02a788b90ae804f86b04aa24af8937e567874b
changeNotes: Adds eject button.
- sha: 5f02a788b90ae804f86b04aa24af8937e567874a
changeNotes: Initial release.
Di chuyển kho lưu trữ
Nếu muốn thay đổi chủ sở hữu hoặc tên kho lưu trữ, bạn có thể sử dụng quy trình chuyển kho lưu trữ GitHub. Vị trí mới sẽ được phát hiện và người dùng sẽ tự động được chuyển hướng đến kho lưu trữ mới vào lần tiếp theo họ cập nhật mẫu.
Xoá mẫu
Để xoá một mẫu khỏi thư viện, hãy xoá tệp LICENSE
hoặc tệp metadata.yaml
khỏi kho lưu trữ của mẫu đó. Hệ thống giám sát thư viện sẽ phát hiện thay đổi này và tự động xoá mẫu.