Tăng mức độ tương tác với ứng dụng bằng cách tiếp cận người dùng ở nơi họ hiện diện. Tích hợp Engage SDK để phân phối đề xuất được cá nhân hoá và nội dung liên tục trực tiếp đến người dùng trên nhiều không gian trên thiết bị, chẳng hạn như Bộ sưu tập, Entertainment Space và Cửa hàng Play. Việc tích hợp này chỉ làm tăng chưa đến 50 KB (đã nén) cho kích thước trung bình của tệp APK và nhà phát triển chỉ mất khoảng một tuần để tích hợp cho hầu hết các ứng dụng. Tìm hiểu thêm tại trang web doanh nghiệp của chúng tôi.
Hướng dẫn này cung cấp cho các đối tác nhà phát triển thông tin về cách phân phối nội dung du lịch và sự kiện đến các nền tảng nội dung của Engage.
Danh mục được hỗ trợ và nền tảng
Điều kiện sử dụng nền tảng Engage SDK dựa trên danh mục nội dung của ứng dụng. Hãy tham khảo bảng sau đây để xác định xem bạn có đủ điều kiện sử dụng các nền tảng cụ thể hay không:
| Trạng thái | Danh mục nội dung hoặc trường hợp sử dụng | Các nền tảng được hỗ trợ |
|---|---|---|
|
Được hỗ trợ (Đủ điều kiện trên tất cả các nền tảng) |
|
|
| Không được hỗ trợ |
|
Kỹ năng Android
Xem trên GitHubTích hợp Engage SDK
android skills add engage-sdk-integrationThông tin chi tiết về quy trình tích hợp
Phần này trình bày chi tiết các bước, mô hình dữ liệu và thuật ngữ cần thiết để tích hợp với Engage SDK cho nội dung du lịch và sự kiện.
Thuật ngữ
Quy trình tích hợp này gồm các loại cụm sau: Đề xuất, Nổi bật, Đặt chỗ và Tiếp tục tìm kiếm.
Cụm Đề xuất hiển thị các đề xuất về du lịch và sự kiện được cá nhân hoá từ từng đối tác nhà phát triển. Những đề xuất này có thể được cá nhân hoá cho người dùng hoặc tổng quát (ví dụ: các mặt hàng thịnh hành). Hãy sử dụng các thẻ này để đề xuất bài viết, sự kiện, chỗ ở hoặc địa điểm yêu thích.
- Cụm Đề xuất có thể được tạo từ các trang thông tin
ArticleEntity,EventEntity,LodgingEntity,PointOfInterestEntityhoặcStoreEntity, nhưng không thể kết hợp các loại thực thể khác nhau.
Các đề xuất của bạn có cấu trúc sau:
Cụm Đề xuất: Khung hiển thị giao diện người dùng chứa một nhóm các đề xuất từ cùng một đối tác nhà phát triển.
Thực thể: Một đối tượng đại diện cho mỗi nội dung trong một cụm. Tính năng tích hợp này cung cấp một số thực thể sẽ xuất hiện khi sử dụng Cụm đề xuất:
ArticleEntity: ArticleEntity đại diện cho nội dung đề xuất về nội dung dựa trên văn bản liên quan đến du lịch và sự kiện. Bạn có thể dùng tính năng này cho bài viết, bài đăng trên blog, nội dung tiếp thị, đoạn tin tức, v.v.
Hình 1: Giao diện người dùng hiển thị một ArticleEntity duy nhất trong cụm Đề xuất. EventEntity: EventEntity đại diện cho một sự kiện sẽ diễn ra trong tương lai. Thời gian bắt đầu sự kiện là một thông tin quan trọng cần được truyền đạt đến người dùng.
Hình 2: Giao diện người dùng cho thấy một EventEntity duy nhất trong cụm Đề xuất. LodgingEntity: LodgingEntity đại diện cho một chỗ lưu trú, chẳng hạn như khách sạn, căn hộ, nhà nghỉ dưỡng cho thuê ngắn hạn và dài hạn.
Hình 3: Giao diện người dùng hiển thị một LodgingEntity duy nhất trong cụm Đề xuất. StoreEntity: StoreEntity đại diện cho một cửa hàng, nhà hàng, quán cà phê, v.v. Đối tượng này làm nổi bật nội dung trong đó địa điểm ăn uống hoặc cửa hàng là thông tin quan trọng cần truyền tải đến người dùng.
Hình 4: Giao diện người dùng hiển thị một StoreEntity duy nhất trong cụm Đề xuất. PointOfInterestEntity: PointOfInterestEntity đại diện cho một địa điểm yêu thích như trạm xăng, địa điểm tổ chức sự kiện, công viên giải trí, bảo tàng, điểm tham quan du lịch, đường mòn đi bộ đường dài, v.v. Thực thể này làm nổi bật nội dung mà vị trí là một thông tin quan trọng cần được truyền tải đến người dùng. Không được dùng cho nơi lưu trú, cửa hàng hoặc địa điểm ăn uống.
Hình 5: Giao diện người dùng hiển thị một PointOfInterestEntity duy nhất trong cụm Đề xuất.
- Cụm Đề xuất có thể được tạo từ các trang thông tin
Cụm Đặt chỗ hiển thị nội dung mà người dùng đã tương tác gần đây từ nhiều đối tác nhà phát triển trong một nhóm giao diện người dùng. Mỗi đối tác nhà phát triển sẽ được phép thông báo về tối đa 10 thực thể trong cụm Đặt chỗ.
Nội dung đặt trước có thể có cấu trúc như sau:
RestaurantReservationEntity: RestaurantReservationEntity đại diện cho thông tin đặt chỗ tại nhà hàng hoặc quán cà phê, đồng thời giúp người dùng theo dõi thông tin đặt chỗ sắp tới hoặc đang diễn ra tại nhà hàng.
Hình 6. Giao diện người dùng cho thấy một RestaurantReservationEntity duy nhất trong một cụm Đặt chỗ. EventReservationEntity: EventReservationEntity đại diện cho một lượt đặt chỗ cho một sự kiện và giúp người dùng theo dõi các lượt đặt chỗ cho sự kiện sắp tới hoặc đang diễn ra. Sự kiện có thể bao gồm nhưng không giới hạn ở những sự kiện sau:
- Sự kiện thể thao như đặt chỗ cho một trận bóng đá
- Sự kiện trò chơi như đặt chỗ cho thể thao điện tử
- Sự kiện giải trí như đặt chỗ xem phim tại rạp chiếu phim, buổi hoà nhạc, nhà hát, buổi ký tặng sách
- Thông tin đặt chỗ cho chuyến đi hoặc địa điểm yêu thích, chẳng hạn như chuyến tham quan có hướng dẫn viên, vé bảo tàng
- Đặt chỗ tham gia sự kiện xã hội/hội thảo/hội nghị
- Đặt chỗ tham gia các buổi đào tạo/giáo dục
Hình 7. Giao diện người dùng hiển thị một EventReservationEntity duy nhất trong một cụm Đặt chỗ. LodgingReservationEntity: LodgingEntityReservation đại diện cho thông tin đặt chỗ lưu trú khi đi du lịch và giúp người dùng theo dõi thông tin đặt phòng khách sạn hoặc chỗ nghỉ du lịch sắp tới hoặc đang diễn ra.
Hình 8. Giao diện người dùng hiển thị một LodgingReservationEntity duy nhất trong một cụm Đặt phòng. TransportationReservationEntity: TransportationReservationEntity đại diện cho thông tin đặt chỗ cho phương tiện vận chuyển bằng bất kỳ phương thức nào và giúp người dùng theo dõi thông tin đặt chỗ cho chuyến bay, phà, tàu hoả, xe buýt, dịch vụ gọi xe hoặc du thuyền sắp tới hoặc đang diễn ra.
Hình 9. Giao diện người dùng hiển thị một TransportationReservationEntity trong một cụm Đặt chỗ. VehicleRentalReservationEntity: VehicleRentalReservationEntity đại diện cho thông tin đặt thuê xe và giúp người dùng theo dõi thông tin đặt thuê xe sắp tới hoặc đang diễn ra.
Hình 10. Giao diện người dùng hiển thị một VehicleRentalReservationEntity trong một cụm Đặt trước.
Cụm Nổi bật hiển thị một số thực thể được chọn từ nhiều đối tác nhà phát triển trong một nhóm giao diện người dùng. Sẽ có một cụm Nổi bật duy nhất xuất hiện gần đầu giao diện người dùng và có vị trí ưu tiên phía trên tất cả các cụm Đề xuất. Mỗi đối tác nhà phát triển sẽ được phép thông báo về tối đa 10 thực thể trong cụm Nổi bật.
GenericFeaturedEntity: GenericFeaturedEntity khác với mục Đề xuất ở chỗ mục Nổi bật nên được dùng cho một nội dung hàng đầu của nhà phát triển và phải đại diện cho một nội dung quan trọng nhất, thú vị và phù hợp với người dùng.
Hình 11: Giao diện người dùng hiển thị một FeaturedCluster có danh sách GenericFeaturedEntity
Cụm Tiếp tục tìm kiếm giúp người dùng tiếp tục hành trình tìm kiếm thông tin du lịch trước đó bằng cách hiển thị danh sách các cụm từ tìm kiếm mà người dùng đã tìm kiếm gần đây trên tất cả ứng dụng du lịch của họ. Cụm này sẽ được ghim ở vị trí thứ hai, sau cụm đặt trước và trước cụm nổi bật và đề xuất. Mỗi đối tác nhà phát triển sẽ được phép thông báo về tối đa 3 thực thể trong cụm Tiếp tục tìm kiếm.
- PointOfInterestEntity: PointOfInterestEntity đại diện cho một địa điểm yêu thích như trạm xăng, địa điểm tổ chức sự kiện, công viên giải trí, bảo tàng, điểm du lịch, đường mòn đi bộ đường dài, v.v. Thực thể này làm nổi bật nội dung mà người dùng đã tìm kiếm trước đó.
Chuẩn bị trước
Cấp độ API tối thiểu: 19
Thêm thư viện com.google.android.engage:engage-core vào ứng dụng của bạn:
dependencies {
// Make sure you also include that repository in your project's build.gradle file.
implementation 'com.google.android.engage:engage-core:1.6.0'
}
Tóm tắt
Thiết kế này dựa trên việc triển khai dịch vụ ràng buộc.
Dữ liệu mà ứng dụng có thể phát hành phải tuân theo các giới hạn sau cho các loại cụm khác nhau:
| Loại cụm | Giới hạn về cụm | Giới hạn số lượng thực thể tối thiểu trong một cụm | Giới hạn số lượng thực thể tối đa trong một cụm |
|---|---|---|---|
| Cụm Đề xuất | Tối đa 7 | Ít nhất 1 | Tối đa 50 (ArticleEntity, EventEntity, LodgingEntity, StoreEntity hoặc PointOfInterestEntity) |
| Cụm Đặt trước | Tối đa 1 | Ít nhất 1 | Tối đa 20 (RestaurantReservationEntity, EventReservationEntity, LodgingReservationEntity, TransportationReservationEntity hoặc VehicleRentalReservationEntity) |
| Cụm Nổi bật | Tối đa 1 | Ít nhất 1 | Tối đa 20 (GenericFeaturedEntity) |
| Cụm Tiếp tục tìm kiếm | Tối đa 1 | Ít nhất 1 | Tối đa 3 (PointOfInterestEntity) |
Bước 1: Cung cấp dữ liệu về thực thể
SDK đã xác định các thực thể khác nhau để đại diện cho từng loại mục. Chúng tôi hỗ trợ các thực thể sau cho danh mục Du lịch và Sự kiện:
GenericFeaturedEntityArticleEntityEventEntityLodgingEntityStoreEntityPointOfInterestEntityRestaurantReservationEntityEventReservationEntityLodgingReservationEntityTransportationReservationEntityVehicleRentalReservationEntity
Các biểu đồ sau đây nêu ra các thuộc tính hiện có và yêu cầu cho từng loại.
GenericFeaturedEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Hình ảnh áp phích | Bắt buộc | Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Tiêu đề | Không bắt buộc | Tiêu đề của thực thể. | Văn bản tự do Kích thước văn bản nên dùng: 50 ký tự |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Huy hiệu | Không bắt buộc | Mỗi huy hiệu là văn bản tuỳ ý (tối đa 15 ký tự) hoặc hình ảnh nhỏ. Xử lý trải nghiệm người dùng đặc biệt trên hình ảnh/video, ví dụ: lớp phủ huy hiệu trên hình ảnh
|
|
| Huy hiệu – Văn bản | Không bắt buộc | Tiêu đề cho huy hiệu Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Văn bản tự do Kích thước văn bản nên dùng: tối đa 15 ký tự |
| Huy hiệu – Hình ảnh | Không bắt buộc | Hình ảnh nhỏ Xử lý trải nghiệm người dùng đặc biệt, ví dụ như lớp phủ huy hiệu trên hình thu nhỏ của hình ảnh/video. Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Danh mục nội dung | Không bắt buộc | Mô tả danh mục của nội dung trong thực thể. | Danh sách enum Hãy xem phần Danh mục nội dung để biết hướng dẫn. |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
ArticleEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Văn bản tự do Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Hình ảnh áp phích | Không bắt buộc | Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Bạn nên thêm hình ảnh. Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Nguồn – Tiêu đề | Không bắt buộc | Tên của tác giả, tổ chức hoặc người đưa tin | Văn bản tự do Kích thước văn bản nên dùng: Dưới 25 ký tự |
| Nguồn – Hình ảnh | Không bắt buộc | Hình ảnh của nguồn như tác giả, tổ chức, phóng viên | Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Huy hiệu | Không bắt buộc | Mỗi huy hiệu là văn bản tuỳ ý (tối đa 15 ký tự) hoặc hình ảnh nhỏ. Xử lý trải nghiệm người dùng đặc biệt trên hình ảnh/video, ví dụ: lớp phủ huy hiệu trên hình ảnh
|
|
| Huy hiệu – Văn bản | Không bắt buộc | Tiêu đề cho huy hiệu Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Văn bản tự do Kích thước văn bản nên dùng: tối đa 15 ký tự |
| Huy hiệu – Hình ảnh | Không bắt buộc | Hình ảnh nhỏ Xử lý trải nghiệm người dùng đặc biệt, ví dụ như lớp phủ huy hiệu trên hình thu nhỏ của hình ảnh/video. Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Thời gian xuất bản nội dung | Không bắt buộc | Đây là dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) khi nội dung được xuất bản/cập nhật trong ứng dụng. | Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Thời gian tương tác gần đây nhất | Không bắt buộc | Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) khi người dùng tương tác với thực thể này lần gần đây nhất. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Phần trăm tiến trình | Không bắt buộc | Tỷ lệ phần trăm nội dung đầy đủ mà người dùng đã xem tính đến thời điểm hiện tại. |
Giá trị int từ 0 đến 100. |
| Danh mục nội dung | Không bắt buộc | Mô tả danh mục của nội dung trong thực thể. | Danh sách enum Hãy xem phần Danh mục nội dung để biết hướng dẫn. |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
EventEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Chuỗi Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Thời gian bắt đầu theo giờ địa phương – Dấu thời gian | Bắt buộc |
Dấu thời gian bắt đầu của hệ thống khi sự kiện dự kiến bắt đầu. |
Joda-Time Instant |
| Thời gian bắt đầu theo múi giờ địa phương – Múi giờ | Bắt buộc |
Múi giờ dự kiến bắt đầu sự kiện. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Chế độ sự kiện | Bắt buộc | Trường cho biết sự kiện sẽ diễn ra trực tuyến, trực tiếp hay cả hai. |
Enum: VIRTUAL, IN_PERSON hoặc HYBRID |
| Hình ảnh áp phích | Bắt buộc | Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Bạn nên thêm hình ảnh. Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Vị trí – Quốc gia | Bắt buộc có điều kiện | Quốc gia nơi sự kiện diễn ra. Lưu ý: Đây là thông tin bắt buộc đối với các sự kiện TRỰC TIẾP hoặc KẾT HỢP |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Thành phố | Bắt buộc có điều kiện | Thành phố nơi sự kiện diễn ra. Lưu ý: Đây là thông tin bắt buộc đối với các sự kiện TRỰC TIẾP hoặc KẾT HỢP |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ hiển thị | Bắt buộc có điều kiện | Địa chỉ hoặc tên địa điểm nơi sự kiện sẽ diễn ra và sẽ được hiển thị cho người dùng. Lưu ý: Đây là thông tin bắt buộc đối với các sự kiện TRỰC TIẾP hoặc KẾT HỢP |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của địa điểm tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) nơi tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của địa điểm tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Khu vực lân cận | Không bắt buộc | Vùng lân cận (nếu có) nơi tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống khi sự kiện dự kiến kết thúc. Lưu ý: Giá trị này sẽ được biểu thị bằng mili giây. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Huy hiệu | Không bắt buộc |
Mỗi huy hiệu là văn bản tuỳ ý (tối đa 15 ký tự) hoặc hình ảnh nhỏ. |
|
| Huy hiệu – Văn bản | Không bắt buộc | Tiêu đề cho huy hiệu Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Văn bản tự do Kích thước văn bản nên dùng: tối đa 15 ký tự |
| Huy hiệu – Hình ảnh | Không bắt buộc | Hình ảnh nhỏ Xử lý trải nghiệm người dùng đặc biệt, ví dụ như lớp phủ huy hiệu trên hình thu nhỏ của hình ảnh/video. Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Price – CurrentPrice | Bắt buộc có điều kiện |
Giá hiện tại của vé/thẻ tham dự sự kiện. Phải cung cấp nếu bạn cung cấp giá gốc bị gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của vé/thẻ tham dự sự kiện. | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Danh mục nội dung | Không bắt buộc | Mô tả danh mục của nội dung trong thực thể. | Danh sách enum đủ điều kiện
Hãy xem phần Danh mục nội dung để biết hướng dẫn. |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
LodgingEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Chuỗi Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Hình ảnh áp phích | Bắt buộc |
Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Vị trí – Quốc gia | Bắt buộc | Quốc gia nơi khách lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Thành phố | Bắt buộc | Thành phố nơi có dịch vụ lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ hiển thị | Bắt buộc | Địa chỉ sẽ hiển thị cho người dùng. Bạn nên thêm tên thành phố và có thể là tiểu bang hoặc quốc gia cho hầu hết các trường hợp sử dụng. Chỉ thêm địa chỉ đường phố hoặc khu vực lân cận nếu người dùng ở gần vị trí đó, người dùng quen thuộc với vị trí đó hoặc thành phố có trong tiêu đề cụm. Nếu bạn thêm địa chỉ đường phố, hãy cung cấp địa chỉ ngắn gọn, sử dụng từ viết tắt nếu có thể (ví dụ: "St" cho "Street", "Ave" cho "Avenue"). | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của nơi lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) nơi cơ sở lưu trú toạ lạc. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của cơ sở lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của cơ sở lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Huy hiệu | Không bắt buộc |
Mỗi huy hiệu là văn bản tuỳ ý (tối đa 15 ký tự) hoặc hình ảnh nhỏ. |
|
| Huy hiệu – Văn bản | Không bắt buộc | Tiêu đề cho huy hiệu Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Văn bản tự do Kích thước văn bản nên dùng: tối đa 15 ký tự |
| Huy hiệu – Hình ảnh | Không bắt buộc | Hình ảnh nhỏ Xử lý trải nghiệm người dùng đặc biệt, ví dụ như lớp phủ huy hiệu trên hình thu nhỏ của hình ảnh/video. Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| AvailabilityTimeWindow – Thời gian bắt đầu đã bản địa hoá – Dấu thời gian | Không bắt buộc | Dấu thời gian bắt đầu kỷ nguyên khi cơ sở lưu trú dự kiến sẽ mở cửa/hoạt động. | Joda-Time Instant |
| AvailabilityTimeWindow – Thời gian bắt đầu đã bản địa hoá – Múi giờ | Không bắt buộc | Múi giờ mà cơ sở lưu trú dự kiến sẽ mở cửa/hoạt động. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| AvailabilityTimeWindow – Localized End Time – Timestamp | Không bắt buộc | Dấu thời gian bắt đầu kỷ nguyên cho biết thời điểm dự kiến cơ sở lưu trú sẽ mở cửa/hoạt động. | Joda-Time Instant |
| AvailabilityTimeWindow – Giờ kết thúc theo múi giờ địa phương – Múi giờ | Không bắt buộc | Múi giờ mà cơ sở lưu trú dự kiến sẽ mở cửa/hoạt động. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Điểm xếp hạng – Giá trị tối đa | Không bắt buộc | Giá trị tối đa của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị hiện tại của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Giá trị hiện tại | Không bắt buộc | Giá trị hiện tại của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị tối đa của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Tổng | Không bắt buộc | Số lượt xếp hạng cho cơ sở lưu trú. Lưu ý: Cung cấp trường này nếu ứng dụng của bạn muốn kiểm soát cách hiển thị thông tin này cho người dùng. Cung cấp chuỗi ngắn gọn có thể hiển thị cho người dùng. Ví dụ: nếu số lượng là 1.000.000, hãy cân nhắc sử dụng các từ viết tắt như 1M để số lượng này không bị cắt bớt trên các kích thước màn hình nhỏ hơn. |
Chuỗi |
| Điểm xếp hạng – Giá trị tổng | Không bắt buộc | Số lượt xếp hạng cho cơ sở lưu trú. Lưu ý: Cung cấp trường này nếu bạn không muốn tự xử lý logic viết tắt hiển thị. Nếu có cả Số lượng và Giá trị số lượng, chúng tôi sẽ sử dụng Số lượng để hiển thị cho người dùng |
Kinh độ |
| Price – CurrentPrice | Bắt buộc có điều kiện | Giá hiện tại của cơ sở lưu trú. Phải cung cấp nếu bạn cung cấp giá gốc được gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của nơi lưu trú (sẽ bị gạch ngang trong giao diện người dùng). | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
StoreEntity
Đối tượng StoreEntity đại diện cho từng cửa hàng mà các đối tác nhà phát triển muốn xuất bản, chẳng hạn như một địa điểm ăn uống hoặc quán ăn nổi tiếng có liên quan đến trải nghiệm du lịch của một người.
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| Hình ảnh áp phích | Bắt buộc | Bạn phải cung cấp ít nhất một hình ảnh. | Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Không bắt buộc | Tên cửa hàng. | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Vị trí | Không bắt buộc | Vị trí cửa hàng. | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Chú thích | Không bắt buộc | Chú thích giới thiệu về một chương trình khuyến mãi, sự kiện hoặc thông tin cập nhật của cửa hàng (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Dòng chữ in nhỏ của chú thích | Không bắt buộc | Văn bản in nhỏ của chú thích. | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Nội dung mô tả | Không bắt buộc | Nội dung mô tả về cửa hàng. | Văn bản tự do Kích thước văn bản nên dùng: dưới 90 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Danh mục | Không bắt buộc | Danh mục của cửa hàng, trong bối cảnh địa điểm ăn uống, có thể là ẩm thực như "món Pháp", "món Mỹ mới", "mì ramen", "ẩm thực cao cấp". |
Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Điểm xếp hạng – Giá trị tối đa | Không bắt buộc | Giá trị tối đa của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị hiện tại của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Giá trị hiện tại | Không bắt buộc | Giá trị hiện tại của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị tối đa của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Tổng | Không bắt buộc | Số lượt xếp hạng cho cơ sở lưu trú. Lưu ý: Cung cấp trường này nếu ứng dụng của bạn muốn kiểm soát cách hiển thị thông tin này cho người dùng. Cung cấp chuỗi ngắn gọn có thể hiển thị cho người dùng. Ví dụ: nếu số lượng là 1.000.000, hãy cân nhắc sử dụng các từ viết tắt như 1M để số lượng này không bị cắt bớt trên các kích thước màn hình nhỏ hơn. |
Chuỗi |
| Điểm xếp hạng – Giá trị tổng | Không bắt buộc | Số lượt xếp hạng cho cơ sở lưu trú. Lưu ý: Cung cấp trường này nếu bạn không muốn tự xử lý logic viết tắt hiển thị. Nếu có cả Số lượng và Giá trị số lượng, chúng tôi sẽ sử dụng Số lượng để hiển thị cho người dùng |
Kinh độ |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
PointOfInterestEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Chuỗi Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Hình ảnh áp phích | Bắt buộc có điều kiện |
Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Bạn phải cung cấp hình ảnh nếu thực thể thuộc cụm đề xuất. Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Thời gian tương tác gần đây nhất | Bắt buộc có điều kiện |
Dấu thời gian bắt đầu kỷ nguyên khi người dùng có lượt tương tác cuối cùng với thực thể này. Lưu ý: Trường này là bắt buộc nếu thực thể là một phần của cụm tiếp tục tìm kiếm. |
Joda-Time Instant |
| Vị trí – Quốc gia | Bắt buộc có điều kiện |
Quốc gia nơi địa điểm yêu thích đang diễn ra. Lưu ý: Đây là trường bắt buộc nếu thực thể là một phần của cụm đề xuất. |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Thành phố | Bắt buộc có điều kiện |
Thành phố nơi diễn ra địa điểm yêu thích. Lưu ý: Đây là trường bắt buộc nếu thực thể là một phần của cụm đề xuất. |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ hiển thị | Bắt buộc có điều kiện |
Địa chỉ sẽ hiển thị cho người dùng. Cung cấp địa chỉ ngắn gọn, sử dụng chữ viết tắt nếu có thể (ví dụ: "St" cho "Street", "Ave" cho "Avenue"). Chuỗi này có thể bị cắt bớt tuỳ thuộc vào thiết bị và chế độ cài đặt của người dùng. Thêm tên thành phố để xác định rõ ràng. Lưu ý: Đây là trường bắt buộc nếu thực thể là một phần của cụm đề xuất. |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~35 ký tự |
| Vị trí – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của địa điểm yêu thích. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) nơi có địa điểm yêu thích. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của địa điểm yêu thích. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của địa điểm yêu thích. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| AvailabilityTimeWindow – Thời gian bắt đầu đã bản địa hoá – Dấu thời gian | Không bắt buộc | Dấu thời gian bắt đầu kỷ nguyên khi địa điểm yêu thích dự kiến sẽ mở cửa/hoạt động. | Joda-Time Instant |
| AvailabilityTimeWindow – Thời gian bắt đầu đã bản địa hoá – Múi giờ | Không bắt buộc | Múi giờ mà địa điểm yêu thích dự kiến sẽ mở cửa/hoạt động. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| AvailabilityTimeWindow – Localized End Time – Timestamp | Không bắt buộc | Dấu thời gian bắt đầu kỷ nguyên cho biết thời điểm địa điểm yêu thích dự kiến sẽ mở cửa/hoạt động. | Joda-Time Instant |
| AvailabilityTimeWindow – Giờ kết thúc theo múi giờ địa phương – Múi giờ | Không bắt buộc | Múi giờ mà địa điểm yêu thích dự kiến sẽ mở cửa/hoạt động. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Huy hiệu | Không bắt buộc |
Mỗi huy hiệu là văn bản tuỳ ý (tối đa 15 ký tự) hoặc hình ảnh nhỏ. |
|
| Huy hiệu – Văn bản | Không bắt buộc | Tiêu đề cho huy hiệu Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Văn bản tự do Kích thước văn bản nên dùng: tối đa 15 ký tự |
| Huy hiệu – Hình ảnh | Không bắt buộc | Hình ảnh nhỏ Xử lý trải nghiệm người dùng đặc biệt, ví dụ như lớp phủ huy hiệu trên hình thu nhỏ của hình ảnh/video. Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Điểm xếp hạng – Giá trị tối đa | Không bắt buộc | Giá trị tối đa của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị hiện tại của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Giá trị hiện tại | Không bắt buộc | Giá trị hiện tại của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị tối đa của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Tổng | Không bắt buộc | Số lượt xếp hạng cho địa điểm yêu thích. Lưu ý: Cung cấp trường này nếu ứng dụng của bạn muốn kiểm soát cách hiển thị thông tin này cho người dùng. Cung cấp chuỗi ngắn gọn có thể hiển thị cho người dùng. Ví dụ: nếu số lượng là 1.000.000, hãy cân nhắc sử dụng các từ viết tắt như 1M để số lượng này không bị cắt bớt trên các kích thước màn hình nhỏ hơn. |
Chuỗi |
| Điểm xếp hạng – Giá trị tổng | Không bắt buộc | Số lượt xếp hạng cho địa điểm yêu thích. Lưu ý: Cung cấp trường này nếu bạn không muốn tự xử lý logic viết tắt hiển thị. Nếu có cả Số lượng và Giá trị số lượng, chúng tôi sẽ sử dụng Số lượng để hiển thị cho người dùng |
Kinh độ |
| Price – CurrentPrice | Bắt buộc có điều kiện |
Giá hiện tại của vé/thẻ vào cửa cho địa điểm yêu thích. Phải cung cấp nếu bạn cung cấp giá gốc bị gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của vé/thẻ vào cửa cho địa điểm yêu thích. | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). |
Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Danh mục nội dung | Không bắt buộc | Mô tả danh mục của nội dung trong thực thể. | Danh sách enum đủ điều kiện
Hãy xem phần Danh mục nội dung để biết hướng dẫn. |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
RestaurantReservationEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Chuỗi Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Thời gian bắt đầu đặt chỗ theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu dự kiến của lượt đặt trước. | Joda-Time Instant |
| Thời gian bắt đầu đặt chỗ theo giờ địa phương – Múi giờ | Bắt buộc | Múi giờ mà lượt đặt trước dự kiến sẽ bắt đầu. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Vị trí – Quốc gia | Bắt buộc | Quốc gia nơi nhà hàng đang hoạt động. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Thành phố | Bắt buộc | Thành phố nơi nhà hàng toạ lạc. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ hiển thị | Bắt buộc | Địa chỉ của nhà hàng sẽ hiển thị cho người dùng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của nhà hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) nơi nhà hàng toạ lạc. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của nhà hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của nhà hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Hình ảnh áp phích | Không bắt buộc | Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 | Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Kích thước bàn | Không bắt buộc | Số người trong nhóm đặt chỗ | Số nguyên > 0 |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
EventReservationEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Chuỗi Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Thời gian bắt đầu theo giờ địa phương – Dấu thời gian | Bắt buộc |
Dấu thời gian bắt đầu của hệ thống khi sự kiện dự kiến bắt đầu. |
Joda-Time Instant |
| Thời gian bắt đầu theo múi giờ địa phương – Múi giờ | Bắt buộc |
Múi giờ dự kiến bắt đầu sự kiện. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Chế độ sự kiện | Bắt buộc | Trường cho biết sự kiện sẽ diễn ra trực tuyến, trực tiếp hay cả hai. |
Enum: VIRTUAL, IN_PERSON hoặc HYBRID |
| Vị trí – Quốc gia | Bắt buộc có điều kiện | Quốc gia nơi sự kiện diễn ra. Lưu ý: Đây là thông tin bắt buộc đối với các sự kiện TRỰC TIẾP hoặc KẾT HỢP |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Thành phố | Bắt buộc có điều kiện | Thành phố nơi sự kiện diễn ra. Lưu ý: Đây là thông tin bắt buộc đối với các sự kiện TRỰC TIẾP hoặc KẾT HỢP |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ hiển thị | Bắt buộc có điều kiện | Địa chỉ hoặc tên địa điểm nơi sự kiện sẽ diễn ra và sẽ được hiển thị cho người dùng. Lưu ý: Đây là thông tin bắt buộc đối với các sự kiện TRỰC TIẾP hoặc KẾT HỢP |
Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của địa điểm tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) nơi tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của địa điểm tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Khu vực lân cận | Không bắt buộc | Vùng lân cận (nếu có) nơi tổ chức sự kiện. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Hình ảnh áp phích | Không bắt buộc | Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Bạn nên thêm hình ảnh. Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Giờ kết thúc theo giờ địa phương – Dấu thời gian | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống khi sự kiện dự kiến kết thúc. |
Joda-Time Instant |
| Giờ kết thúc theo múi giờ địa phương – Múi giờ | Không bắt buộc |
Múi giờ dự kiến kết thúc sự kiện. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Nhà cung cấp dịch vụ – Tên | Không bắt buộc |
Tên của nhà cung cấp dịch vụ. Lưu ý:Nhà cung cấp dịch vụ phải có văn bản hoặc hình ảnh. |
Văn bản tuỳ ý. Ví dụ: tên của đơn vị tổ chức sự kiện/chuyến lưu diễn |
| Nhà cung cấp dịch vụ – Hình ảnh | Không bắt buộc |
Biểu trưng/hình ảnh của nhà cung cấp dịch vụ. Lưu ý:Nhà cung cấp dịch vụ phải có văn bản hoặc hình ảnh. |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Huy hiệu | Không bắt buộc |
Mỗi huy hiệu là văn bản tuỳ ý (tối đa 15 ký tự) hoặc hình ảnh nhỏ. |
|
| Huy hiệu – Văn bản | Không bắt buộc | Tiêu đề cho huy hiệu Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Văn bản tự do Kích thước văn bản nên dùng: tối đa 15 ký tự |
| Huy hiệu – Hình ảnh | Không bắt buộc | Hình ảnh nhỏ Xử lý trải nghiệm người dùng đặc biệt, ví dụ như lớp phủ huy hiệu trên hình thu nhỏ của hình ảnh/video. Lưu ý: Bạn phải có văn bản hoặc hình ảnh cho huy hiệu |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mã đặt chỗ | Không bắt buộc | Mã đặt chỗ cho sự kiện đặt chỗ. | Văn bản tự do |
| Price – CurrentPrice | Bắt buộc có điều kiện |
Giá hiện tại của vé/thẻ tham dự sự kiện. Phải cung cấp nếu bạn cung cấp giá gốc bị gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của vé/thẻ tham dự sự kiện. | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| Điểm xếp hạng – Giá trị tối đa | Không bắt buộc | Giá trị tối đa của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị hiện tại của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Giá trị hiện tại | Không bắt buộc | Giá trị hiện tại của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị tối đa của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Tổng | Không bắt buộc | Tổng số điểm xếp hạng cho sự kiện. Lưu ý: Cung cấp trường này nếu ứng dụng của bạn muốn kiểm soát cách hiển thị thông tin này cho người dùng. Cung cấp chuỗi ngắn gọn có thể hiển thị cho người dùng. Ví dụ: nếu số lượng là 1.000.000, hãy cân nhắc sử dụng các từ viết tắt như 1M để số lượng này không bị cắt bớt trên các kích thước màn hình nhỏ hơn. |
Chuỗi |
| Điểm xếp hạng – Giá trị tổng | Không bắt buộc | Tổng số điểm xếp hạng cho sự kiện. Lưu ý: Cung cấp trường này nếu bạn không muốn tự xử lý logic viết tắt hiển thị. Nếu có cả Số lượng và Giá trị số lượng, chúng tôi sẽ sử dụng Số lượng để hiển thị cho người dùng |
Kinh độ |
| Danh mục nội dung | Không bắt buộc | Mô tả danh mục của nội dung trong thực thể. | Danh sách enum đủ điều kiện
Hãy xem phần Danh mục nội dung để biết hướng dẫn. |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
LodgingReservationEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Văn bản tuỳ ý. Ví dụ: "Chuyến lưu trú của bạn từ ngày 12 tháng 12" Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Giờ nhận phòng theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu của hệ thống thể hiện thời gian nhận phòng cho lượt đặt phòng. | Joda-Time Instant |
| Giờ nhận phòng theo giờ địa phương – Múi giờ | Bắt buộc | Múi giờ của thời gian nhận phòng cho lượt đặt phòng. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Giờ trả phòng theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu của hệ thống thể hiện thời gian trả phòng cho lượt đặt phòng. | Joda-Time Instant |
| Giờ trả phòng theo giờ địa phương – Múi giờ | Bắt buộc | Múi giờ của thời gian trả phòng cho lượt đặt phòng. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Vị trí – Quốc gia | Bắt buộc | Quốc gia nơi cơ sở lưu trú toạ lạc. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Thành phố | Bắt buộc | Thành phố nơi cơ sở lưu trú toạ lạc. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Địa chỉ hiển thị | Bắt buộc | Địa chỉ sẽ hiển thị cho người dùng. Cung cấp địa chỉ ngắn gọn, sử dụng chữ viết tắt nếu có thể (ví dụ: "St" cho "Street", "Ave" cho "Avenue"). Chuỗi này có thể bị cắt bớt tuỳ thuộc vào thiết bị và chế độ cài đặt của người dùng. Thêm tên thành phố để xác định rõ ràng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~35 ký tự |
| Vị trí – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của nơi lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) nơi cơ sở lưu trú toạ lạc. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của cơ sở lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Vị trí – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của cơ sở lưu trú. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Hình ảnh áp phích | Không bắt buộc |
Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 Lưu ý: Nếu có huy hiệu, hãy đảm bảo khoảng trống an toàn là 24 dp ở cả phía trên và phía dưới hình ảnh |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Mã đặt chỗ | Không bắt buộc | Mã đặt phòng cho yêu cầu đặt phòng lưu trú. | Văn bản tự do |
| Điểm xếp hạng – Giá trị tối đa | Không bắt buộc | Giá trị tối đa của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị hiện tại của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Giá trị hiện tại | Không bắt buộc | Giá trị hiện tại của thang điểm xếp hạng. Phải cung cấp nếu bạn cũng cung cấp giá trị tối đa của điểm xếp hạng. |
Số >= 0,0 |
| Điểm xếp hạng – Tổng | Không bắt buộc | Số lượt xếp hạng cho cơ sở lưu trú. Lưu ý: Cung cấp trường này nếu ứng dụng của bạn muốn kiểm soát cách hiển thị thông tin này cho người dùng. Cung cấp chuỗi ngắn gọn có thể hiển thị cho người dùng. Ví dụ: nếu số lượng là 1.000.000, hãy cân nhắc sử dụng các từ viết tắt như 1M để số lượng này không bị cắt bớt trên các kích thước màn hình nhỏ hơn. |
Chuỗi |
| Điểm xếp hạng – Giá trị tổng | Không bắt buộc | Số lượt xếp hạng cho cơ sở lưu trú. Lưu ý: Cung cấp trường này nếu bạn không muốn tự xử lý logic viết tắt hiển thị. Nếu có cả Số lượng và Giá trị số lượng, chúng tôi sẽ sử dụng Số lượng để hiển thị cho người dùng |
Kinh độ |
| Price – CurrentPrice | Bắt buộc có điều kiện | Giá hiện tại của cơ sở lưu trú. Phải cung cấp nếu bạn cung cấp giá gốc được gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của nơi lưu trú (sẽ bị gạch ngang trong giao diện người dùng). | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
TransportationReservationEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Văn bản tuỳ ý. Ví dụ: "SFO đến SAN" Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Loại phương tiện giao thông | Bắt buộc | Phương thức/loại phương tiện giao thông cho lượt đặt chỗ. | Enum: FLIGHT, TRAIN, BUS hoặc FERRY |
| Giờ khởi hành theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu của hệ thống đại diện cho thời gian khởi hành. | Joda-Time Instant |
| Giờ khởi hành theo giờ địa phương – Múi giờ | Bắt buộc | Múi giờ của thời gian khởi hành. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Thời gian đến theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu của hệ thống biểu thị thời gian đến. | Joda-Time Instant |
| Thời gian đến theo giờ địa phương – Múi giờ | Bắt buộc | Múi giờ của thời gian đến. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Số hiệu phương tiện | Bắt buộc | Số hiệu chuyến bay, số hiệu xe buýt, số hiệu tàu hoả hoặc số hiệu phà/tàu thuỷ. | Văn bản tự do |
| Giờ lên máy bay theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu kỷ nguyên đại diện cho thời gian lên máy bay của lượt đặt chỗ (nếu có) | Joda-Time Instant |
| Giờ lên máy bay theo giờ địa phương – Múi giờ | Bắt buộc | Múi giờ của thời gian lên máy bay cho thông tin đặt chỗ (nếu có) |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Địa điểm khởi hành – Quốc gia | Không bắt buộc | Quốc gia khởi hành. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm khởi hành – Thành phố | Không bắt buộc | Thành phố khởi hành. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm khởi hành – Địa chỉ hiển thị | Không bắt buộc | Địa điểm khởi hành sẽ hiển thị cho người dùng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm khởi hành – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của địa điểm khởi hành. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm khởi hành – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) của địa điểm khởi hành. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm khởi hành – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của địa điểm khởi hành. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm khởi hành – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của địa điểm khởi hành. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Quốc gia | Không bắt buộc | Quốc gia đến. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Thành phố | Không bắt buộc | Thành phố đến. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Địa chỉ hiển thị | Không bắt buộc | Vị trí đến sẽ hiển thị cho người dùng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của địa điểm đến. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) của địa điểm đến. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của địa điểm đến. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa điểm đến – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của địa điểm đến. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Nhà cung cấp dịch vụ – Tên | Không bắt buộc |
Tên của nhà cung cấp dịch vụ. Lưu ý:Nhà cung cấp dịch vụ phải có văn bản hoặc hình ảnh. |
Văn bản tuỳ ý. Ví dụ: Tên hãng hàng không |
| Nhà cung cấp dịch vụ – Hình ảnh | Không bắt buộc |
Biểu trưng/hình ảnh của nhà cung cấp dịch vụ. Lưu ý:Nhà cung cấp dịch vụ phải có văn bản hoặc hình ảnh. |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Hình ảnh áp phích | Không bắt buộc |
Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Mã đặt chỗ | Không bắt buộc | Mã đặt chỗ cho yêu cầu đặt chỗ phương tiện di chuyển. | Văn bản tự do |
| Price – CurrentPrice | Bắt buộc có điều kiện | Giá hiện tại của yêu cầu đặt trước. Phải cung cấp nếu bạn cung cấp giá gốc được gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của yêu cầu đặt trước (sẽ bị gạch ngang trong giao diện người dùng). | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
VehicleRentalReservationEntity
| Thuộc tính | Yêu cầu | Nội dung mô tả | Định dạng |
|---|---|---|---|
| URI hành động | Bắt buộc |
Đường liên kết sâu đến thực thể trong ứng dụng của nhà cung cấp. Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Tham khảo phần Câu hỏi thường gặp này |
URI |
| Tiêu đề | Bắt buộc | Tiêu đề của thực thể. | Văn bản tuỳ ý. Ví dụ: "Avis Union Square SF" Kích thước văn bản nên dùng: Tối đa 50 ký tự |
| Giờ lấy hàng theo giờ địa phương – Dấu thời gian | Bắt buộc | Dấu thời gian bắt đầu của hệ thống thể hiện thời gian lấy hàng cho yêu cầu đặt trước. | Joda-Time Instant |
| Giờ lấy hàng theo múi giờ địa phương – Múi giờ | Bắt buộc | Múi giờ của thời gian lấy hàng cho lượt đặt trước. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Thời gian trả lại hàng theo giờ địa phương – Dấu thời gian | Không bắt buộc | Dấu thời gian bắt đầu của hệ thống thể hiện thời gian trả phòng cho lượt đặt phòng. | Joda-Time Instant |
| Giờ trả xe theo giờ địa phương – Múi giờ | Không bắt buộc | Múi giờ của thời gian trả phòng cho lượt đặt phòng. |
Joda-Time DateTimeZone Hãy xem Thông số kỹ thuật về múi giờ để biết hướng dẫn. |
| Địa chỉ lấy hàng – Quốc gia | Không bắt buộc | Quốc gia của địa điểm đón khách. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ lấy hàng – Thành phố | Không bắt buộc | Thành phố của địa điểm đón khách. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ lấy hàng – Địa chỉ hiển thị | Không bắt buộc | Địa điểm lấy hàng sẽ hiển thị cho người dùng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ lấy hàng – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của địa điểm đón khách. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ lấy hàng – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) của địa điểm đón khách. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ lấy hàng – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của địa điểm lấy hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ lấy hàng – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của địa điểm đón khách. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Quốc gia | Không bắt buộc | Quốc gia của vị trí trả lại hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Thành phố | Không bắt buộc | Thành phố của vị trí trả lại hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Địa chỉ hiển thị | Không bắt buộc | Vị trí trả lại hàng sẽ hiển thị cho người dùng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Địa chỉ đường phố | Không bắt buộc | Địa chỉ đường phố (nếu có) của vị trí trả lại hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Tiểu bang | Không bắt buộc | Tiểu bang hoặc tỉnh (nếu có) của vị trí trả lại hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Mã ZIP | Không bắt buộc | Mã ZIP (nếu có) của vị trí trả lại hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Địa chỉ người gửi – Khu vực lân cận | Không bắt buộc | Khu vực lân cận (nếu có) của vị trí trả lại hàng. | Văn bản tự do Kích thước văn bản nên dùng: tối đa ~20 ký tự |
| Nhà cung cấp dịch vụ – Tên | Không bắt buộc |
Tên của nhà cung cấp dịch vụ. Lưu ý:Nhà cung cấp dịch vụ phải có văn bản hoặc hình ảnh. |
Văn bản tuỳ ý. Ví dụ: "Avis Car Rental" |
| Nhà cung cấp dịch vụ – Hình ảnh | Không bắt buộc |
Biểu trưng/hình ảnh của nhà cung cấp dịch vụ. Lưu ý:Nhà cung cấp dịch vụ phải có văn bản hoặc hình ảnh. |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Hình ảnh áp phích | Không bắt buộc |
Chúng tôi sẽ chỉ hiển thị 1 hình ảnh khi có nhiều hình ảnh. Tỷ lệ khung hình đề xuất là 16:9 |
Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn. |
| Mô tả | Không bắt buộc | Một đoạn văn bản mô tả thực thể. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng: 180 ký tự |
| Danh sách phụ đề | Không bắt buộc | Tối đa 3 phụ đề, mỗi phụ đề là một dòng văn bản. Lưu ý: Người dùng sẽ thấy nội dung mô tả hoặc danh sách phụ đề, chứ không thấy cả hai. |
Văn bản tự do Kích thước văn bản nên dùng cho mỗi phụ đề: tối đa 50 ký tự |
| Mã xác nhận | Không bắt buộc | Mã xác nhận cho thông tin đặt thuê xe. | Văn bản tự do |
| Price – CurrentPrice | Bắt buộc có điều kiện | Giá hiện tại của yêu cầu đặt trước. Phải cung cấp nếu bạn cung cấp giá gốc được gạch ngang. |
Văn bản tự do |
| Giá – Giá gốc | Không bắt buộc | Giá gốc của yêu cầu đặt trước (sẽ bị gạch ngang trong giao diện người dùng). | Văn bản tự do |
| Chú thích về giá | Không bắt buộc | Chú thích về giá để giới thiệu một chương trình khuyến mãi, sự kiện, ưu đãi chiết khấu cho thành viên (nếu có). | Văn bản tự do Kích thước văn bản nên dùng: dưới 45 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm) |
| DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên giao diện | |||
| Dấu thời gian bắt đầu | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung sẽ hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
| Dấu thời gian kết thúc | Không bắt buộc |
Dấu thời gian bắt đầu của hệ thống mà sau đó nội dung không còn hiện trên nền tảng. Nếu bạn không đặt giá trị này, thì nội dung sẽ đủ điều kiện hiện trên nền tảng. |
Dấu thời gian bắt đầu của hệ thống (tính bằng mili giây) |
Thông số kỹ thuật của hình ảnh
Bảng sau đây trình bày các thông số kỹ thuật bắt buộc đối với thành phần hình ảnh:
| Tỷ lệ khung hình | (Các) cụm được hỗ trợ | Số điểm ảnh tối thiểu | Số điểm ảnh đề xuất |
|---|---|---|---|
| Ngang (16:9, 1,91x1) | Nổi bật, đặt trước, tiếp tục tìm kiếm và đề xuất (ưu tiên tỷ lệ khung hình 16:9) | 640x360 (16:9) / 600x314 (1,91x1) | 1264x712 (16:9) / 1200x628 (1,91x1) |
| Vuông (1 x 1) | Tất cả cụm (ưu tiên dùng cho StoreEntity; bắt buộc đối với hình ảnh nhà cung cấp dịch vụ và huy hiệu) |
300 x 300 | 1200 x 1200 |
| Dọc (4 x 5) | Nội dung đề xuất | 480 x 600 | 960 x 1200 |
Hình ảnh phải được lưu trữ trên CDN công khai để Google có thể truy cập.
Định dạng tệp
PNG, JPG, GIF tĩnh, WebP
Kích thước tệp tối đa
5120 KB
Đề xuất khác
- Khu vực an toàn cho hình ảnh: Đặt nội dung quan trọng của bạn vào phần chiếm 80% trung tâm của hình ảnh.
- Sử dụng nền trong suốt để hình ảnh có thể hiển thị chính xác trong phần cài đặt Giao diện sáng và tối.
Quy cách múi giờ
Ưu tiên mã nhận dạng (ví dụ: "America/Los_Angeles") hơn độ lệch (ví dụ: "-07:00").
Cách sử dụng mẫu: DateTimeZone.forID("America/Los_Angeles")
Danh mục nội dung
Danh mục nội dung cho phép ứng dụng xuất bản nội dung thuộc nhiều danh mục. Thao tác này sẽ liên kết nội dung với một số danh mục được xác định trước, cụ thể là:
TYPE_EDUCATIONTYPE_SPORTSTYPE_MOVIES_AND_TV_SHOWSTYPE_BOOKSTYPE_AUDIOBOOKSTYPE_MUSICTYPE_DIGITAL_GAMESTYPE_TRAVEL_AND_LOCALTYPE_HOME_AND_AUTOTYPE_BUSINESSTYPE_NEWSTYPE_FOOD_AND_DRINKTYPE_SHOPPINGTYPE_HEALTH_AND_FITENESSTYPE_MEDICALTYPE_PARENTINGTYPE_DATING
Hình ảnh phải được lưu trữ trên CDN công khai để Google có thể truy cập.
Nguyên tắc sử dụng danh mục nội dung
- Một số thực thể như ArticleEntity và GenericFeaturedEntity đủ điều kiện sử dụng bất kỳ danh mục nội dung nào. Đối với các thực thể khác như EventEntity, EventReservationEntity, PointOfInterestEntity, chỉ một số danh mục trong số này đủ điều kiện. Hãy kiểm tra danh sách các danh mục đủ điều kiện cho một loại thực thể trước khi điền vào danh sách.
Sử dụng loại thực thể cụ thể cho một số danh mục nội dung thay vì kết hợp Thực thể chung và Danh mục nội dung:
- TYPE_MOVIES_AND_TV_SHOWS – Hãy xem các thực thể trong Hướng dẫn tích hợp tính năng xem trước khi sử dụng các thực thể chung.
- TYPE_BOOKS – Hãy xem EbookEntity trước khi sử dụng thực thể chung.
- TYPE_AUDIOBOOKS – Hãy xem AudiobookEntity trước khi sử dụng các thực thể chung.
- TYPE_SHOPPING – Hãy xem ShoppingEntity trước khi sử dụng các thực thể chung.
- TYPE_FOOD_AND_DRINK – Xem các thực thể trong Hướng dẫn tích hợp thực phẩm trước khi sử dụng các thực thể chung.
Trường ContentCategory là không bắt buộc và nên để trống nếu nội dung không thuộc bất kỳ danh mục nào được đề cập trước đó.
Trong trường hợp có nhiều danh mục nội dung, hãy cung cấp các danh mục đó theo thứ tự mức độ liên quan đến nội dung, trong đó danh mục nội dung có mức độ liên quan nhất được đặt đầu tiên trong danh sách.
Bước 2: Cung cấp dữ liệu Cụm
Bạn nên thực hiện tác vụ xuất bản nội dung trong nền (ví dụ: sử dụng WorkManager) và lên lịch thường xuyên hoặc theo sự kiện (ví dụ: mỗi khi người dùng mở ứng dụng hoặc khi người dùng vừa thêm mặt hàng nào vào giỏ hàng).
AppEngageTravelClient chịu trách nhiệm xuất bản cụm.
Các API dưới dây dùng để xuất bản cụm trong ứng dụng:
isServiceAvailablepublishRecommendationClusterspublishFeaturedClusterpublishReservationClusterpublishContinueSearchClusterpublishUserAccountManagementRequestupdatePublishStatusdeleteRecommendationsClustersdeleteFeaturedClusterdeleteReservationClusterdeleteContinueSearchClusterdeleteUserManagementClusterdeleteClusters
isServiceAvailable
API này được dùng để kiểm tra xem dịch vụ có thể tích hợp và nội dung có hiện trên thiết bị hay không.
Đối với Engage SDK phiên bản 1.6.0 trở lên (Nên dùng)
Kỹ năng Android
Xem trên GitHubTích hợp Engage SDK
android skills add engage-sdk-integrationUse the engage-sdk-integration skill to use Engage SDK 1.6.0 and refactor isServiceAvailable to pass ServiceAvailabilityRequest for publishing all cluster types.Bạn có thể kiểm tra phạm vi cung cấp dịch vụ cho mọi loại cụm mà bạn dự định
xuất bản. API isServiceAvailable chấp nhận một đối tượng yêu cầu, ServiceAvailabilityRequest, chứa các loại cụm cần kiểm tra tình trạng sẵn sàng của dịch vụ. Bạn có thể tìm thấy các giá trị enum ClusterType cần thiết cho ServiceAvailabilityRequest trong bảng sau.
| Loại cụm | Hằng số loại cụm | Giá trị số nguyên |
|---|---|---|
| Không xác định | TYPE_UNKNOWN |
0 |
| Cụm đề xuất | TYPE_RECOMMENDATION |
1 |
| Cụm Nổi bật | TYPE_FEATURED |
2 |
| Cụm Tiếp tục | TYPE_CONTINUATION |
3 |
| Cụm Quản lý người dùng | TYPE_ENGAGEMENT |
8 |
| Cụm Đăng ký | TYPE_SUBSCRIPTION |
12 |
| Cụm Tiếp tục tìm kiếm | TYPE_CONTINUE_SEARCH |
13 |
| Cụm Đặt trước | TYPE_RESERVATION |
14 |
Kotlin
val request = ServiceAvailabilityRequest.Builder()
.addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
.addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
.build()
client.isServiceAvailable(request).addOnCompleteListener { task ->
if (task.isSuccessful) {
val availabilityMap = task.result
if (availabilityMap[ClusterType.TYPE_CONTINUATION] == true) {
// Proceed with publishing continuation content
}
if (availabilityMap[ClusterType.TYPE_RECOMMENDATION] == true) {
// Proceed with publishing recommendation content
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
Java
ServiceAvailabilityRequest request =
new ServiceAvailabilityRequest.Builder()
.addIntendedClusterType(ClusterType.TYPE_CONTINUATION)
.addIntendedClusterType(ClusterType.TYPE_RECOMMENDATION)
.build();
client.isServiceAvailable(request).addOnCompleteListener(task -> {
if (task.isSuccessful()) {
Map<Integer, Boolean> availabilityMap = task.getResult();
if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_CONTINUATION))) {
// Proceed with publishing continuation content
}
if (Boolean.TRUE.equals(availabilityMap.get(ClusterType.TYPE_RECOMMENDATION))) {
// Proceed with publishing recommendation content
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
Tính năng cung cấp dịch vụ có điều kiện
Một số ứng dụng tích hợp yêu cầu một cấu hình đặc biệt để bật và tắt dịch vụ Engage không liên tục nhằm giảm chi phí phân phát. Tuy nhiên, chiến lược phân tích nội dung không liên tục này ảnh hưởng tiêu cực đến trải nghiệm người dùng: nội dung cũ sẽ không được trình bày và một số nền tảng sẽ không được phân phát.
Kể từ phiên bản 1.6.0, Engage SDK cho phép kiểm tra xem có các loại cụm cụ thể hay không. Nếu ứng dụng của bạn sử dụng tính năng nhập không liên tục:
- Cụm tiếp tục (chẳng hạn như Đặt chỗ và Tiếp tục tìm kiếm) vẫn được bật theo mặc định trên tất cả thiết bị được hỗ trợ.
- Các loại cụm khác (chẳng hạn như Đề xuất) được bật và tắt không liên tục.
Nếu cấu hình mặc định này không phù hợp với nhu cầu của bạn, hãy liên hệ với engage-developers@google.com.
Đối với các phiên bản SDK trước phiên bản 1.6.0 (Ngừng hoạt động)
Kotlin
client.isServiceAvailable.addOnCompleteListener { task ->
if (task.isSuccessful) {
// Handle IPC call success
if(task.result) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
}
Java
client.isServiceAvailable().addOnCompleteListener(task - > {
if (task.isSuccessful()) {
// Handle success
if(task.getResult()) {
// Service is available on the device, proceed with content publish
// calls.
} else {
// Service is not available, no further action is needed.
}
} else {
// The IPC call itself fails, proceed with error handling logic here,
// such as retry.
}
});
publishRecommendationClusters
API này được dùng để phát hành danh sách đối tượng RecommendationCluster.
Kotlin
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build()
)
.build()
)
Java
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(
new RecommendationCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.setTitle("Top Picks For You")
.build())
.build());
Khi dịch vụ nhận được yêu cầu, các hành động sau đây sẽ diễn ra trong một giao dịch:
- Dữ liệu
RecommendationClusterhiện có của đối tác nhà phát triển sẽ bị xoá. - Dữ liệu của yêu cầu được phân tích cú pháp và lưu trữ trong cụm Đề xuất đã cập nhật.
Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
publishFeaturedCluster
API này được dùng để phát hành danh sách đối tượng FeaturedCluster.
Kotlin
client.publishFeaturedCluster(
PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build())
Java
client.publishFeaturedCluster(
new PublishFeaturedClusterRequest.Builder()
.setFeaturedCluster(
new FeaturedCluster.Builder()
.addEntity(entity1)
.addEntity(entity2)
.build())
.build());
Khi dịch vụ nhận được yêu cầu, các hành động sau đây sẽ diễn ra trong một giao dịch:
- Dữ liệu
FeaturedClusterhiện có của đối tác nhà phát triển sẽ bị xoá. - Dữ liệu của yêu cầu được phân tích cú pháp và lưu trữ trong cụm Nổi bật đã cập nhật.
Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
publishReservationCluster
API này được dùng để phát hành đối tượng ReservationCluster.
Kotlin
client.publishReservationCluster(
PublishReservationClusterRequest.Builder()
.setReservationCluster(
ReservationCluster.Builder()
.addLodgingReservationEntity(lodgingReservationEntity)
.addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
.addTransportationReservationEntity(transportationReservationEntity)
.addEventReservationEntity(eventReservationEntity)
.addRestaurantReservationEntity(restaurantReservationEntity)
.build())
.build())
Java
client.publishReservationCluster(
new PublishReservationClusterRequest.Builder()
.setReservationCluster(
new ReservationCluster.Builder()
.addLodgingReservationEntity(lodgingReservationEntity)
.addVehicleRentalReservationEntity(vehicleRentalReservationEntity)
.addTransportationReservationEntity(transportationReservationEntity)
.addEventReservationEntity(eventReservationEntity)
.addRestaurantReservationEntity(restaurantReservationEntity)
.build())
.build());
Khi dịch vụ nhận được yêu cầu, các hành động sau đây sẽ diễn ra trong một giao dịch:
- Dữ liệu
ReservationClusterhiện có của đối tác nhà phát triển sẽ bị xoá. - Dữ liệu của yêu cầu được phân tích cú pháp và lưu trữ trong cụm Đặt chỗ đã cập nhật.
Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
publishContinueSearchCluster
API này được dùng để phát hành danh sách đối tượng ContinueSearchCluster.
Kotlin
client.publishContinueSearchCluster(
PublishContinueSearchClusterRequest.Builder()
.setContinueSearchCluster(
ContinueSearchCluster.Builder()
.addPointOfInterestEntity(entity1)
.addPointOfInterestEntity(entity2)
.build())
.build())
Java
client.publishContinueSearchCluster(
new PublishContinueSearchClusterRequest.Builder()
.setContinueSearchCluster(
new ContinueSearchCluster.Builder()
.addPointOfInterestEntity(entity1)
.addPointOfInterestEntity(entity2)
.build())
.build());
Khi dịch vụ nhận được yêu cầu, các hành động sau đây sẽ diễn ra trong một giao dịch:
- Dữ liệu
ContinueSearchClusterhiện có của đối tác nhà phát triển sẽ bị xoá. - Dữ liệu của yêu cầu được phân tích cú pháp và lưu trữ trong cụm Tiếp tục tìm kiếm đã cập nhật.
Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
publishUserAccountManagementRequest
API này dùng để xuất bản thẻ Đăng nhập. Thao tác đăng nhập sẽ đưa người dùng đến trang đăng nhập của ứng dụng để ứng dụng có thể xuất bản nội dung (hoặc cung cấp nội dung phù hợp hơn cho cá nhân)
Siêu dữ liệu sau đây là một phần của Thẻ đăng nhập –
| Thuộc tính | Yêu cầu | Nội dung mô tả |
|---|---|---|
| URI hành động | Bắt buộc | Đường liên kết sâu đến hành động (chẳng hạn như điều hướng đến trang đăng nhập ứng dụng) |
| Hình ảnh | Không bắt buộc – Nếu không cung cấp thì bạn phải cung cấp Tiêu đề |
Hình ảnh hiện trên thẻ Hình ảnh có tỷ lệ khung hình 16x9 với độ phân giải 1264x712 |
| Tiêu đề | Không bắt buộc – Nếu không cung cấp thì bạn phải cung cấp Hình ảnh | Tiêu đề trên thẻ |
| Văn bản hành động | Không bắt buộc | Văn bản hiện trên CTA (chẳng hạn như Đăng nhập) |
| Phụ đề | Không bắt buộc | Phụ đề không bắt buộc trên thẻ |
Kotlin
var SIGN_IN_CARD_ENTITY =
SignInCardEntity.Builder()
.addPosterImage(
Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build()
client.publishUserAccountManagementRequest(
PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
Java
SignInCardEntity SIGN_IN_CARD_ENTITY =
new SignInCardEntity.Builder()
.addPosterImage(
new Image.Builder()
.setImageUri(Uri.parse("http://www.x.com/image.png"))
.setImageHeightInPixel(500)
.setImageWidthInPixel(500)
.build())
.setActionText("Sign In")
.setActionUri(Uri.parse("http://xx.com/signin"))
.build();
client.publishUserAccountManagementRequest(
new PublishUserAccountManagementRequest.Builder()
.setSignInCardEntity(SIGN_IN_CARD_ENTITY)
.build());
Khi dịch vụ nhận được yêu cầu, các hành động sau đây sẽ diễn ra trong một giao dịch:
- Dữ liệu
UserAccountManagementClusterhiện có của đối tác nhà phát triển sẽ bị xoá. - Dữ liệu của yêu cầu được phân tích cú pháp và lưu trữ trong cụm UserAccountManagementCluster đã cập nhật.
Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
updatePublishStatus
Nếu vì một lý do kinh doanh nội bộ bất kỳ mà không có cụm nào được xuất bản, bạn nên cập nhật trạng thái xuất bản bằng cách sử dụng API updatePublishStatus. Việc này quan trọng vì:
- Trong mọi trường hợp, ngay cả khi nội dung được xuất bản (STATUS == PUBLISHED), bạn phải cho biết trạng thái để điền trang tổng quan. Trạng thái rõ ràng này sẽ được trang tổng quan sử dụng để truyền tải tình trạng và các chỉ số khác của quá trình tích hợp.
- Nếu không có nội dung nào được xuất bản nhưng trạng thái tích hợp không phải là bị lỗi (STATUS == NOT_PUBLISHED), Google có thể tránh kích hoạt cảnh báo trong trang tổng quan về tình trạng của ứng dụng. Phương thức này xác nhận rằng nội dung chưa được xuất bản do tình huống dự kiến theo quan điểm của nhà cung cấp.
- Theo đó, nhà phát triển có thể cung cấp thông tin chi tiết về thời điểm công bố hoặc không công bố dữ liệu.
- Google có thể sử dụng các mã trạng thái nhắc người dùng thực hiện một số thao tác trong ứng dụng để họ có thể xem hoặc bỏ qua nội dung ứng dụng.
Dưới đây là danh sách mã trạng thái xuất bản đủ điều kiện:
// Content is published
AppEngagePublishStatusCode.PUBLISHED,
// Content is not published as user is not signed in
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN,
// Content is not published as user is not subscribed
AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SUBSCRIPTION,
// Content is not published as user location is ineligible
AppEngagePublishStatusCode.NOT_PUBLISHED_INELIGIBLE_LOCATION,
// Content is not published as there is no eligible content
AppEngagePublishStatusCode.NOT_PUBLISHED_NO_ELIGIBLE_CONTENT,
// Content is not published as the feature is disabled by the client
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_FEATURE_DISABLED_BY_CLIENT,
// Content is not published as the feature due to a client error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_CLIENT_ERROR,
// Content is not published as the feature due to a service error
// Available in v1.3.1
AppEngagePublishStatusCode.NOT_PUBLISHED_SERVICE_ERROR,
// Content is not published due to some other reason
// Reach out to engage-developers@ before using this enum.
AppEngagePublishStatusCode.NOT_PUBLISHED_OTHER
Nếu nội dung chưa được xuất bản do người dùng chưa đăng nhập, thì bạn nên xuất bản Thẻ đăng nhập. Nếu vì một lý do bất kỳ mà nhà cung cấp không thể xuất bản Thẻ đăng nhập, bạn nên gọi API updatePublishStatus kèm theo mã trạng thái NOT_PUBLISHED_REQUIRES_SIGN_IN
Kotlin
client.updatePublishStatus(
PublishStatusRequest.Builder()
.setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
.build())
Java
client.updatePublishStatus(
new PublishStatusRequest.Builder()
.setStatusCode(AppEngagePublishStatusCode.NOT_PUBLISHED_REQUIRES_SIGN_IN)
.build());
deleteRecommendationsClusters
API này dùng để xoá nội dung của cụm Recommendation (Đề xuất).
Kotlin
client.deleteRecommendationsClusters()
Java
client.deleteRecommendationsClusters();
Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Đề xuất. Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
deleteFeaturedCluster
API này dùng để xoá nội dung của cụm Featured (Nổi bật).
Kotlin
client.deleteFeaturedCluster()
Java
client.deleteFeaturedCluster();
Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Nổi bật. Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
deleteReservationCluster
API này dùng để xoá nội dung của cụm Đặt chỗ.
Kotlin
client.deleteReservationCluster()
Java
client.deleteReservationCluster();
Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Đặt chỗ. Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
deleteUserManagementCluster
API này dùng để xoá nội dung của cụm UserAccountManagement.
Kotlin
client.deleteUserManagementCluster()
Java
client.deleteUserManagementCluster();
Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm UserAccountManagement. Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại vẫn giữ nguyên.
deleteContinueSearchCluster
API này dùng để xoá nội dung của cụm Tiếp tục tìm kiếm.
Kotlin
client.deleteContinueSearchCluster()
Java
client.deleteContinueSearchCluster();
Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Tiếp tục tìm kiếm. Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại vẫn giữ nguyên.
deleteClusters
API này dùng để xoá nội dung của một loại cụm cụ thể.
Kotlin
client.deleteClusters(
DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_RESERVATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
.build())
Java
client.deleteClusters(
new DeleteClustersRequest.Builder()
.addClusterType(ClusterType.TYPE_RESERVATION)
.addClusterType(ClusterType.TYPE_FEATURED)
.addClusterType(ClusterType.TYPE_RECOMMENDATION)
.addClusterType(ClusterType.TYPE_CONTINUE_SEARCH)
.build());
Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi tất cả các cụm khớp với loại cụm đã chỉ định. Ứng dụng có thể chọn truyền một hoặc nhiều loại cụm. Trong trường hợp xảy ra lỗi, toàn bộ yêu cầu sẽ bị từ chối và trạng thái hiện tại sẽ được duy trì.
Xử lý lỗi
Bạn nên nghe kết quả tác vụ từ các API phát hành để có thể thực hiện thao tác tiếp theo nhằm khôi phục và gửi lại tác vụ thành công.
Kotlin
client.publishRecommendationClusters(
PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(..)
.build())
.addOnCompleteListener { task ->
if (task.isSuccessful) {
// do something
} else {
val exception = task.exception
if (exception is AppEngageException) {
@AppEngageErrorCode val errorCode = exception.errorCode
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
}
Java
client.publishRecommendationClusters(
new PublishRecommendationClustersRequest.Builder()
.addRecommendationCluster(...)
.build())
.addOnCompleteListener(
task -> {
if (task.isSuccessful()) {
// do something
} else {
Exception exception = task.getException();
if (exception instanceof AppEngageException) {
@AppEngageErrorCode
int errorCode = ((AppEngageException) exception).getErrorCode();
if (errorCode == AppEngageErrorCode.SERVICE_NOT_FOUND) {
// do something
}
}
}
});
Lỗi được trả về dưới dạng AppEngageException với nguyên nhân được đưa vào dưới dạng mã lỗi.
| Mã lỗi | Tên lỗi | Lưu ý |
|---|---|---|
1 |
SERVICE_NOT_FOUND |
Dịch vụ này không dùng được trên thiết bị đã cho. |
2 |
SERVICE_NOT_AVAILABLE |
Dịch vụ này hoạt động trên thiết bị đã cho, nhưng không hoạt động tại thời điểm gọi (ví dụ: dịch vụ bị vô hiệu hoá một cách rõ ràng). |
3 |
SERVICE_CALL_EXECUTION_FAILURE |
Không thực hiện được tác vụ do có vấn đề về luồng. Trong trường hợp này, bạn có thể thử lại. |
4 |
SERVICE_CALL_PERMISSION_DENIED |
Trình gọi không được phép thực hiện cuộc gọi dịch vụ. |
5 |
SERVICE_CALL_INVALID_ARGUMENT |
Yêu cầu chứa dữ liệu không hợp lệ (ví dụ: nhiều hơn số cụm được phép). |
6 |
SERVICE_CALL_INTERNAL |
Đã xảy ra lỗi bên phía dịch vụ. |
7 |
SERVICE_CALL_RESOURCE_EXHAUSTED |
Cuộc gọi dịch vụ được thực hiện quá thường xuyên. |
Bước 3: Xử lý ý định truyền tin
Ngoài việc thực hiện lệnh gọi API nội dung phát hành thông qua một công việc, bạn cũng phải thiết lập BroadcastReceiver để nhận yêu cầu phát hành nội dung.
Mục tiêu của ý định truyền tin chủ yếu là để kích hoạt lại ứng dụng và buộc đồng bộ hoá dữ liệu. Ý định truyền tin không được thiết kế để gửi quá thường xuyên. Lệnh này chỉ được kích hoạt khi Dịch vụ Engage xác định nội dung có thể đã lỗi thời (ví dụ: một tuần trước). Bằng cách đó, bạn có thể yên tâm hơn rằng người dùng sẽ có trải nghiệm nội dung mới mẻ, ngay cả khi ứng dụng không được sử dụng trong một thời gian dài.
Bạn phải thiết lập BroadcastReceiver theo 2 cách sau:
Tự động đăng ký một thực thể của lớp
BroadcastReceiverbằng cách sử dụngContext.registerReceiver(). Điều này cho phép giao tiếp từ các ứng dụng vẫn còn trong bộ nhớ.
Kotlin
class AppEngageBroadcastReceiver : BroadcastReceiver(){
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received
// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}
fun registerBroadcastReceivers(context: Context){
var context = context
context = context.applicationContext
// Register Recommendation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Featured Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Continue Search Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
// Register Reservation Cluster Publish Intent
context.registerReceiver(AppEngageBroadcastReceiver(),
IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null)
}
Java
class AppEngageBroadcastReceiver extends BroadcastReceiver {
// Trigger recommendation cluster publish when PUBLISH_RECOMMENDATION broadcast
// is received
// Trigger featured cluster publish when PUBLISH_FEATURED broadcast is received
// Trigger continue search cluster publish when PUBLISH_CONTINUE_SEARCH
// broadcast is received
// Trigger reservation cluster publish when PUBLISH_RESERVATION broadcast is
// received
}
public static void registerBroadcastReceivers(Context context) {
context = context.getApplicationContext();
// Register Recommendation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_RECOMMENDATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Continue Search Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_CONTINUE_SEARCH),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
// Register Reservation Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.travel.service.Intents.ACTION_PUBLISH_RESERVATION),
com.google.android.engage.service.BroadcastReceiverPermissions.BROADCAST_REQUEST_DATA_PUBLISH_PERMISSION,
/*scheduler=*/null);
}
Khai báo tĩnh quá trình triển khai bằng thẻ
<receiver>trong tệpAndroidManifest.xml. Điều này cho phép ứng dụng nhận được ý định truyền tin khi ứng dụng không chạy, đồng thời cho phép ứng dụng phát hành nội dung đó.
<application>
<receiver
android:name=".AppEngageBroadcastReceiver"
android:permission="com.google.android.engage.REQUEST_ENGAGE_DATA"
android:exported="true"
android:enabled="true">
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_RECOMMENDATION" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.PUBLISH_FEATURED" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCH" />
</intent-filter>
<intent-filter>
<action android:name="com.google.android.engage.action.travel.PUBLISH_RESERVATION" />
</intent-filter>
</receiver>
</application>
Dịch vụ sẽ gửi các ý định sau:
com.google.android.engage.action.PUBLISH_RECOMMENDATIONBạn nên bắt đầu lệnh gọipublishRecommendationClusterskhi nhận được ý định này.com.google.android.engage.action.PUBLISH_FEATUREDBạn nên bắt đầu lệnh gọipublishFeaturedClusterkhi nhận được ý định này.com.google.android.engage.action.travel.PUBLISH_CONTINUE_SEARCHBạn nên bắt đầu lệnh gọipublishContinueSearchClusterkhi nhận được ý định này.com.google.android.engage.action.travel.PUBLISH_RESERVATIONBạn nên bắt đầu lệnh gọipublishReservationClusterkhi nhận được ý định này.
Quy trình tích hợp
Để được hướng dẫn từng bước về cách xác minh quy trình tích hợp sau khi hoàn tất, hãy xem Quy trình tích hợp dành cho nhà phát triển Engage.
Câu hỏi thường gặp
Hãy xem mục Câu hỏi thường gặp về Engage SDK để biết các câu hỏi thường gặp.
Liên hệ
Vui lòng liên hệ qua engage-developers@google.com nếu bạn có câu hỏi trong quá trình tích hợp.
Các bước tiếp theo
Sau khi bạn hoàn tất quá trình tích hợp này, các bước tiếp theo sẽ như sau:
- Gửi email đến
engage-developers@google.comvà đính kèm APK tích hợp sẵn sàng cho Google kiểm thử. - Google sẽ xác minh và xem xét trong phạm vi nội bộ để đảm bảo quá trình tích hợp diễn ra như mong đợi. Nếu cần thay đổi, Google sẽ liên hệ với bạn để yêu cầu bạn cung cấp mọi thông tin chi tiết cần thiết.
- Khi quá trình kiểm thử hoàn tất và bạn không cần thay đổi gì, Google sẽ liên hệ với bạn để thông báo rằng bạn có thể bắt đầu xuất bản APK tích hợp mới nhất lên Cửa hàng Play.
- Sau khi Google xác nhận rằng APK mới nhất của bạn đã được xuất bản lên Cửa hàng Play, các cụm Đề xuất, Nổi bật, Đặt trước và Tiếp tục tìm kiếm có thể được xuất bản và người dùng có thể thấy chúng.