Engage SDK Food: Hướng dẫn tích hợp kỹ thuật của bên thứ ba

Google đang xây dựng một nền tảng trên thiết bị giúp sắp xếp các ứng dụng của người dùng theo ngành dọc, đồng thời đem lại trải nghiệm mới mẻ và chân thực để người dùng khám phá và xem nội dung ứng dụng được cá nhân hoá. Trải nghiệm toàn màn hình này giúp các đối tác nhà phát triển có cơ hội giới thiệu nội dung đa dạng thức hay nhất của họ trên một kênh riêng bên ngoài ứng dụng của họ.

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 tích hợp nội dung liên quan đến thực phẩm của họ, sử dụng Engage SDK để điền dữ liệu cho cả khu vực nền tảng mới này và các nền tảng hiện có của Google.

Thông tin chi tiết về quy trình tích hợp

Thuật ngữ

Nội dung tích hợp này bao gồm 5 loại cụm sau: Đề xuất, Nổi bật, Giỏ hàng thực phẩm, Danh sách mua sắm thực phẩm và Đặt hàng lại.

  • Cụm Đề xuất hiển thị các nội dung đề xuất liên quan đến thực phẩm cho từng cá nhân từ từng đối tác nhà phát triển. Những đề xuất này có thể dành riêng cho từng người dùng hoặc cho tất cả người dùng (ví dụ: mới bán). Hãy sử dụng đề xuất để hiển thị công thức nấu ăn, cửa hàng, món ăn, hàng tạp hoá, v.v. khi bạn thấy phù hợp.

    • Cụm Đề xuất có thể được tạo từ các trang thông tin ProductEntity, StoreEntity hoặc RecipeEntity, nhưng không thể kết hợp các loại thực thể khác nhau.
    Hình :`ProductEntity`, `StoreEntity` và `RecipeEntity`. (*Giao diện người dùng chỉ nhằm mục đích minh hoạ)

  • 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.

    Hình : Cụm nổi bật có "RecipeEntity". (*Giao diện người dùng chỉ nhằm mục đích minh hoạ)

  • Cụm Giỏ hàng thực phẩm cho phép bạn xem trước giỏ hàng tạp hoá của nhiều đối tác nhà phát triển trong một nhóm giao diện người dùng, nhắc họ hoàn tất giỏ hàng chưa thanh toán. Có duy nhất một cụm Giỏ hàng thực phẩm.

    • Cụm Giỏ hàng thực phẩm phải hiện tổng số mặt hàng trong giỏ hàng và cũng có thể đưa hình ảnh của X mặt hàng vào giỏ hàng của người dùng.

      Hình: Cụm Giỏ hàng thực phẩm từ một đối tác. (*Giao diện người dùng chỉ mang tính minh hoạ)

  • Cụm Danh sách mua sắm thực phẩm cho phép xem trước danh sách mua sắm hàng tạp hoá của nhiều đối tác nhà phát triển trong một nhóm giao diện người dùng, nhắc người dùng quay lại ứng dụng tương ứng để cập nhật và hoàn tất danh sách. Có duy nhất một cụm Danh sách mua sắm thực phẩm.

    Hình: Cụm Danh sách mua sắm thực phẩm của một đối tác. (*Giao diện người dùng chỉ mang tính chất minh hoạ)

  • Cụm Đặt hàng lại cho phép xem trước các đơn đặt hàng trước đây từ nhiều đối tác nhà phát triển trong một nhóm giao diện người dùng, nhắc người dùng đặt hàng lại. Có duy nhất một cụm Đặt hàng lại.

    • Cụm Đặt hàng lại phải hiện tổng số mặt hàng trong đơn đặt hàng trước đây của người dùng và cũng phải đưa vào một trong các mục sau:

      • Hình ảnh của X mặt hàng trong đơn đặt hàng trước đây của người dùng.
      • Nhãn của các mặt hàng X trong đơn đặt hàng trước đây của người dùng.
    Hình: Cụm Đặt hàng lại đồ ăn của một đối tác. (*Giao diện người dùng chỉ mang tính chất minh hoạ)

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.5.2'
}

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 Số cụm tối đa Số lượng thực thể tối đa trong một cụm
Cụm Đề xuất Tối đa 5 Tối đa 25 (ProductEntity, RecipeEntity hoặc StoreEntity)
Cụm Nổi bật Tối đa 1 Tối đa 10 (ProductEntity, RecipeEntity hoặc StoreEntity)
Cụm Giỏ hàng thực phẩm Tối đa 1 Tối đa 1 ShoppingCartEntity
Cụm Danh sách mua sắm thực phẩm Tối đa 1 Tối đa 1 ShoppingListEntity
Cụm sắp xếp lại thực phẩm Tối đa 1 Tối đa 1 ReorderEntity

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 Thực phẩm:

  1. ProductEntity
  2. StoreEntity
  3. RecipeEntity
  4. FoodShoppingCart
  5. FoodShoppingList
  6. FoodReorderCluster

Các biểu đồ bên dưới nêu ra các thuộc tính có sẵn và yêu cầu cho từng loại.

ProductEntity

Đối tượng ProductEntity đại diện cho từng mặt hàng (chẳng hạn như mặt hàng tạp hoá, món ăn của nhà hàng hoặc chương trình khuyến mãi) mà các đối tác nhà phát triển muốn phát hành.

Hình : Thuộc tính của ProductEntity

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 trang trong ứng dụng hiện thông tin chi tiết về sản phẩm.

Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Hãy 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 sản phẩm.

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)
Giá – hiện tại Bắt buộc có điều kiện

Giá hiện tại của sản phẩm.

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á – gốc Không bắt buộc Giá gốc của thực thể (sẽ bị gạch ngang trong giao diện người dùng). Văn bản tự do
Chú thích Không bắt buộc Chú thích giới thiệu một chương trình khuyến mãi, sự kiện hoặc thông tin cập nhật về sản phẩm (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)
Điểm xếp hạng (Không bắt buộc) – Lưu ý: Tất cả điểm xếp hạng sẽ hiện theo hệ thống xếp hạng tiêu chuẩn theo sao của chúng tôi.
Đ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 – Số lượng Không bắt buộc

Số lượt xếp hạng cho sản phẩm.

Lưu ý: Hãy cung cấp trường này nếu ứng dụng của bạn kiểm soát cách số lượng người dùng nhìn thấy. Sử dụng chuỗi ngắn gọn. Ví dụ: nếu số lượng là 1.000.000, hãy cân nhắc sử dụng chữ viết tắt như 1 triệu để số lượng không bị cắt bớt trên màn hình có kích thước nhỏ hơn.

 Chuỗi
Điểm xếp hạng – Giá trị số lượng Không bắt buộc

Số lượt xếp hạng cho sản phẩm.

Lưu ý: Cung cấp trường này nếu bạn không tự xử lý logic viết tắt hiển thị. Nếu cả Số lượng và Giá trị số lượng đều có, thì Số lượng sẽ hiển thị cho người dùng.

 Dài
DisplayTimeWindow (Không bắt buộc) – Đặt khoảng thời gian hiện nội dung trên nền tảng
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 (theo 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ư nhà hàng hoặc cửa hàng tạp hoá.

Hình : Thuộc tính của StoreEntity

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 trang trong ứng dụng hiện thông tin chi tiết về cửa hàng.

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)
Lưu ý: Tất cả điểm xếp hạng sẽ hiện theo hệ thống xếp hạng tiêu chuẩn theo sao của chúng tôi.
Đ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 – Số lượng Không bắt buộc

Số điểm xếp hạng của cửa hàng.

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ư 1 triệu để số lượng 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ị số lượng Không bắt buộc

Số lượt xếp hạng cho cửa hàng.

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ả Count và Count Value, chúng ta sẽ sử dụng Count để hiển thị cho người dùng

 Dài

RecipeEntity

Đối tượng RecipeEntity đại diện cho một mục công thức nấu ăn mà đối tác nhà phát triển muốn xuất bản.

Hình : Thuộc tính của RecipeEntity

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 trang trong ứng dụng hiện thông tin chi tiết về công thức nấu ăn.

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ông thức nấu ăn.

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)
Tác giả Không bắt buộc Tác giả của công thức nấu ăn.

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)
Thời gian nấu/chuẩn bị Không bắt buộc Thời gian nấu theo công thứ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)
Chú thích Không bắt buộc Chú thích để giới thiệu một chương trình khuyến mãi, sự kiện hoặc thông tin cập nhật về công thức nấu ă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 Không bắt buộc Danh mục công thức nấu ăn.

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ả công thức nấu ăn.

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)
Lưu ý: Tất cả điểm xếp hạng sẽ hiện theo hệ thống xếp hạng tiêu chuẩn theo sao của chúng tôi.
Đ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 – Số lượng Không bắt buộc

Số lượt xếp hạng cho công thức nấu ă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ư 1 triệu để số lượng 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ị số lượng Không bắt buộc

Số lượt xếp hạng cho công thức nấu ă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ả Count và Count Value, chúng ta sẽ sử dụng Count để hiển thị cho người dùng

 Dài

FoodShoppingCart

Hình: Thuộc tính cụm Giỏ hàng thực phẩm.

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 giỏ hàng trong ứng dụng của đối tác.

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
Số lượng mặt hàng Bắt buộc

Số lượng mặt hàng (chứ không chỉ số lượng sản phẩm) trong giỏ hàng.

Ví dụ: Nếu giỏ hàng có 3 quả cam và 1 quả táo, thì con số này phải là 4.

 Số nguyên >= 1
Tiêu đề Không bắt buộc

Tiêu đề của giỏ hàng (ví dụ: Giỏ hàng của bạn).

Nếu nhà phát triển không cung cấp tiêu đề, thì Giỏ hàng của bạn sẽ là tiêu đề mặc định.

Văn bản tự do

Kích thước văn bản nên dùng: dưới 25 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm)
Văn bản hành động Không bắt buộc

Văn bản kêu gọi hành động của nút trên Giỏ hàng (ví dụ: Túi mua sắm của bạn).

Nếu nhà phát triển không cung cấp văn bản hành động, thì Xem giỏ hàng sẽ là giá trị mặc định.

Thuộc tính này được hỗ trợ từ phiên bản 1.1.0 trở đi.

Chuỗi văn bản
Hình ảnh giỏ hàng Không bắt buộc

Hình ảnh về từng sản phẩm trong giỏ hàng.

Bạn có thể cung cấp tối đa 10 hình ảnh theo thứ tự ưu tiên. Số lượng hình ảnh thực tế hiển thị tuỳ thuộc vào kiểu dáng thiết bị.

 Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn.
Nhãn mặt hàng Không bắt buộc

Danh sách nhãn của các mặt hàng trong danh sách mua sắm.

Số lượng nhãn thực tế hiển thị tuỳ thuộc vào kiểu dáng thiết bị.

Danh sách nhãn (ở dạng văn bản tự do)

Kích thước văn bản nên dùng: dưới 20 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 nền tảng
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)

FoodShoppingList

Hình: Cụm Danh sách mua sắm thực phẩm.

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 danh sách mua sắm trong ứng dụng của đối tác.

Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Hãy tham khảo phần Câu hỏi thường gặp này

URI
Số lượng mặt hàng Bắt buộc Số lượng mặt hàng trong danh sách mua sắm. Số nguyên >= 1
Tiêu đề Không bắt buộc

Tiêu đề danh sách (ví dụ: Danh sách hàng tạp hoá của bạn).

Nếu nhà phát triển không cung cấp tiêu đề, thì Danh sách mua sắm sẽ là giá trị mặc định.

Văn bản tự do

Kích thước văn bản nên dùng: dưới 25 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm)
Nhãn mặt hàng Bắt buộc

Danh sách nhãn của các mặt hàng trong danh sách mua sắm.

Bạn phải cung cấp tối thiểu 1 nhãn và tối đa 10 nhãn theo thứ tự ưu tiên. Số lượng nhãn thực tế hiển thị tuỳ thuộc vào kiểu dáng của thiết bị.

Danh sách nhãn (ở dạng văn bản tự do)

Kích thước văn bản nên dùng: dưới 20 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm)

FoodReorderCluster

Hình: cụm Đặt hàng lại thực phẩm.

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 để đặt hàng lại trong ứng dụng của đối tác.

Lưu ý: Bạn có thể sử dụng đường liên kết sâu để phân bổ. Hãy tham khảo phần Câu hỏi thường gặp này

URI
Văn bản hành động Không bắt buộc

Văn bản kêu gọi hành động của nút trên thực thể Đặt hàng lại (ví dụ: Đặt hàng lại).

Nếu nhà phát triển không cung cấp văn bản hành động, thì Đặt hàng lại sẽ là giá trị mặc định.

Thuộc tính này được hỗ trợ từ phiên bản 1.1.0 trở đi.

Chuỗi văn bản
Số lượng mặt hàng Bắt buộc

Số lượng mặt hàng (chứ không chỉ là số lượng sản phẩm) trong đơn đặt hàng trước.

Ví dụ: Nếu có 3 tách cà phê nhỏ và 1 bánh sừng bò trong đơn đặt hàng trước, thì con số này phải là 4.

Số nguyên >= 1
Tiêu đề Bắt buộc Tiêu đề của mặt hàng đặt lại.

Văn bản tự do

Kích thước văn bản nên dùng: dưới 40 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm)
Nhãn mặt hàng

Không bắt buộc

(Nếu không cung cấp, bạn phải cung cấp hình ảnh áp phích)

Danh sách nhãn mặt hàng của đơn đặt hàng trước.

Bạn có thể cung cấp tối đa 10 nhãn theo thứ tự ưu tiên. Số lượng nhãn thực tế hiển thị tuỳ thuộc vào kiểu dáng của thiết bị.

Danh sách văn bản tự do

Kích thước văn bản nên dùng cho mỗi nhãn: dưới 20 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm)
Hình ảnh áp phích

Không bắt buộc

(Nếu không cung cấp, bạn phải cung cấp nhãn của mặt hàng)

Hình ảnh của các mặt hàng trong đơn đặt hàng trước.

Bạn có thể cung cấp tối đa 10 hình ảnh theo thứ tự ưu tiên. Số lượng hình ảnh thực tế hiển thị tuỳ thuộc vào kiểu dáng thiết bị.

 Hãy xem Thông số kỹ thuật của hình ảnh để biết hướng dẫn.

Thông số kỹ thuật của hình ảnh

Dưới đây là thông số kỹ thuật bắt buộc cho thành phần hình ảnh:

Tỷ lệ khung hình Số điểm ảnh tối thiểu Số điểm ảnh đề xuất

Vuông (1 x 1)

Ưa thích

 300 x 300 1200 x 1200
Ngang (1,91 x 1) 600 x 314 1200 x 628
Dọc (4 x 5) 480 x 600 960 x 1200

Đị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.

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).

AppEngageFoodClient chịu trách nhiệm xuất bản các nhóm thực phẩm.

Các API dưới dây dùng để xuất bản cụm trong ứng dụng:

  • isServiceAvailable
  • publishRecommendationClusters
  • publishFeaturedCluster
  • publishFoodShoppingCart
  • publishFoodShoppingList
  • publishReorderCluster
  • publishUserAccountManagementRequest
  • updatePublishStatus
  • deleteRecommendationsClusters
  • deleteFeaturedCluster
  • deleteFoodShoppingCartCluster
  • deleteFoodShoppingListCluster
  • deleteReorderCluster
  • deleteUserManagementCluster
  • deleteClusters

isServiceAvailable

API này dùng để kiểm tra xem dịch vụ có thể tích hợp và nội dung có xuất hiện trên thiết bị hay khô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 dùng để xuất bản danh sách đối tượng RecommendationCluster.

Đối tượng RecommendationCluster có thể có các thuộc tính sau:

Thuộc tính Yêu cầu Nội dung mô tả
Danh sách ProductEntity, StoreEntity hoặc RecipeEntity Bắt buộc Danh sách các thực thể tạo nên các đề xuất cho cụm Đề xuất này. Các thực thể trong một cụm duy nhất phải thuộc cùng một loại.
Tiêu đề Bắt buộc

Tiêu đề của cụm Đề xuất (ví dụ: Thực đơn siêu tiết kiệm cho dịp Lễ Tạ ơn).

Kích thước văn bản nên dùng: dưới 25 ký tự (Văn bản quá dài có thể hiển thị dấu ba chấm)
Phụ đề Không bắt buộc Phụ đề của cụm Đề xuất.
URI hành động Không bắt buộc

Đường liên kết sâu đến trang trong ứng dụng của đối tác để người dùng có thể xem danh sách chứa đầy đủ các đề xuất.

Lưu ý: Bạn có thể 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

Kotlin

client.publishRecommendationClusters(
            PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Big savings on Thanksgiving menu")
                        .build())
                .build())

Java

client.publishRecommendationClusters(
            new PublishRecommendationClustersRequest.Builder()
                .addRecommendationCluster(
                    new RecommendationCluster.Builder()
                        .addEntity(entity1)
                        .addEntity(entity2)
                        .setTitle("Big savings on Thanksgiving menu")
                        .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:

  • Mọi dữ liệu hiện có về cụm Đề xuất đều bị xoá.
  • Dữ liệu từ yêu cầu được phân tích cú pháp và lưu trữ trong cụm Đề xuất mới.

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 đối tượng FeaturedCluster.

Kotlin

client.publishFeaturedCluster(
            PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    FeaturedCluster.Builder()
                        ...
                        .build())
                .build())

Java

client.publishFeaturedCluster(
            new PublishFeaturedClusterRequest.Builder()
                .setFeaturedCluster(
                    new FeaturedCluster.Builder()
                        ...
                        .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 FeaturedCluster hiệ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ì.

publishFoodShoppingCart

API này được dùng để phát hành đối tượng FoodShoppingCart.

Kotlin

client.publishFoodShoppingCart(
            PublishFoodShoppingCartClusterRequest.Builder()
                .setShoppingCart(
                    FoodShoppingCart.Builder()
                        ...
                        .build())
                .build())

Java

client.publishFoodShoppingCart(
            new PublishFoodShoppingCartClusterRequest.Builder()
                .setShoppingCart(
                    new FoodShoppingCart.Builder()
                        ...
                        .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 FoodShoppingCart hiệ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 Giỏ hàng đã 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ì.

publishFoodShoppingList

API này được dùng để phát hành đối tượng FoodShoppingList.

Kotlin

client.publishFoodShoppingList(
            PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    FoodShoppingListEntity.Builder()
                        ...
                        .build())
                .build())

Java

client.publishFoodShoppingList(
            new PublishFoodShoppingListRequest.Builder()
                .setFoodShoppingList(
                    new FoodShoppingListEntity.Builder()
                        ...
                        .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 FoodShoppingList hiệ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 Danh sách mua sắ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ì.

publishReorderCluster

API này được dùng để phát hành đối tượng FoodReorderCluster.

Kotlin

client.publishReorderCluster(
            PublishReorderClusterRequest.Builder()
                .setReorderCluster(
                    FoodReorderCluster.Builder()
                        ...
                        .build())
                .build())

Java

client.publishReorderCluster(
            new PublishReorderClusterRequest.Builder()
                .setReorderCluster(
                    new FoodReorderCluster.Builder()
                        ...
                        .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 FoodReorderCluster hiệ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 hàng lại đã 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 UserAccountManagementCluster hiệ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.
  • Thông tin này giúp nhà phát triển cung cấp thông tin chi tiết về thời điểm công bố và 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());

deleteRecommendationClusters

API này dùng để xoá nội dung của cụm Recommendation (Đề xuất).

Kotlin

client.deleteRecommendationClusters()

Java

client.deleteRecommendationClusters();

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 vẫn giữ nguyên.

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 vẫn giữ nguyên.

deleteFoodShoppingCartCluster

API này dùng để xoá nội dung của cụm Food Shopping Cart (Giỏ hàng thực phẩm).

Kotlin

client.deleteFoodShoppingCartCluster()

Java

client.deleteFoodShoppingCartCluster();

Khi nhận được yêu cầu này, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Giỏ hàng thực phẩ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.

deleteFoodShoppingListCluster

API này dùng để xoá nội dung của cụm Food Shopping List (Danh sách mua sắm thực phẩm).

Kotlin

client.deleteFoodShoppingListCluster()

Java

client.deleteFoodShoppingListCluster();

Khi nhận được yêu cầu này, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Danh sách mua sắm thực phẩ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.

deleteReorderCluster

Đây là API dùng để xoá nội dung của FoodReorderCluster.

Kotlin

client.deleteReorderCluster()

Java

client.deleteReorderCluster();

Khi nhận được yêu cầu, dịch vụ sẽ xoá dữ liệu hiện có khỏi cụm Đặt hàng lại. 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.

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.

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_FEATURED)
      .addClusterType(ClusterType.TYPE_RECOMMENDATION)
      ...
      .build())

Java

client.deleteClusters(
            new DeleteClustersRequest.Builder()
                .addClusterType(ClusterType.TYPE_FEATURED)
                .addClusterType(ClusterType.TYPE_RECOMMENDATION)
                ...
                .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.

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 BroadcastReceiver bằng cách sử dụng Context.registerReceiver(). Điều này cho phép giao tiếp từ các ứng dụng vẫn còn trong bộ nhớ.
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 shopping cart cluster publish when PUBLISH_FOOD_SHOPPING_CART
// broadcast is received

// Trigger shopping list cluster publish when PUBLISH_FOOD_SHOPPING_LIST
// broadcast is received

// Trigger reorder cluster publish when PUBLISH_REORDER_CLUSTER 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));

// Register Featured Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.service.Intents.ACTION_PUBLISH_FEATURED));

// Register Shopping Cart Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.food.service.Intents.ACTION_PUBLISH_FOOD_SHOPPING_CART));

// Register Shopping List Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.food.service.Intents.ACTION_PUBLISH_FOOD_SHOPPING_LIST));

// Register Reorder Cluster Publish Intent
context.registerReceiver(new AppEngageBroadcastReceiver(),
new IntentFilter(com.google.android.engage.food.service.Intents.ACTION_PUBLISH_REORDER_CLUSTER));

}
  • Khai báo tĩnh quá trình triển khai bằng thẻ <receiver> trong tệp AndroidManifest.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: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.food.PUBLISH_FOOD_SHOPPING_CART" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.food.PUBLISH_FOOD_SHOPPING_LIST" />
      </intent-filter>
      <intent-filter>
         <action android:name="com.google.android.engage.action.food.PUBLISH_REORDER_CLUSTER" />
      </intent-filter>
   </receiver>
</application>

Dịch vụ sẽ gửi các ý định sau:

  • com.google.android.engage.action.PUBLISH_RECOMMENDATION Bạn nên bắt đầu lệnh gọi publishRecommendationClusters khi nhận được ý định này.
  • com.google.android.engage.action.PUBLISH_FEATURED Bạn nên bắt đầu lệnh gọi publishFeaturedCluster khi nhận được ý định này.
  • com.google.android.engage.action.food.PUBLISH_FOOD_SHOPPING_CART Bạn nên bắt đầu lệnh gọi publishFoodShoppingCart khi nhận được ý định này.
  • com.google.android.engage.action.food.PUBLISH_FOOD_SHOPPING_LIST Bạn nên bắt đầu lệnh gọi publishFoodShoppingList khi nhận được ý định này.
  • com.google.android.engage.action.food.PUBLISH_REORDER_CLUSTER Bạn nên bắt đầu lệnh gọi publishReorderCluster khi 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ệ

Hãy liên hệ với engage-developers@google.com nếu bạn có câu hỏi trong quá trình tích hợp. Nhóm của chúng tôi sẽ trả lời sớm nhất có thể.

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.com và đí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 nội bộ để đảm bảo APK tích hợp hoạt động 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 phát hành 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 phát hành lên Cửa hàng Play, các cụm Đề xuất, Nổi bật, Giỏ hàng, Danh sách mua sắm và Đặt hàng lại sẽ được phát hành và hiển thị cho người dùng.