Bảng trợ giúp Play Games

Play Games Sidekick là một lớp phủ giúp giữ chân người chơi trong trò chơi của bạn bằng cách cung cấp nội dung và ưu đãi phù hợp trực tiếp cho người chơi.

  • Giữ chân người chơi trong trò chơi của bạn bằng video chính thức và video của nhà sáng tạo, nhờ đó, người chơi có thể tìm thấy hướng dẫn, video chơi thử và sự kiện phát trực tiếp mà không cần chuyển đổi ứng dụng.
  • Tăng khả năng kiếm tiền nhờ tính năng đổi Điểm tức thì, ưu đãi do Play tài trợ và phiếu giảm giá Pass.
  • Lối chơi có tặng thưởng với các chuỗi thành tích, nhiệm vụ và hoạt động tương tác với hồ sơ được tích hợp.
  • Tương tác sâu hơn với nội dung và video.
Play Games Sidekick có các tính năng hiện có.
Play Games Sidekick (nhấp để phóng to).

Tính năng

Các tính năng có trên Sidekick sẽ khác nhau tuỳ theo trò chơi, tuỳ thuộc vào trạng thái tích hợp Dịch vụ trò chơi của Google Play và trạng thái đăng ký tham gia Play Points. Người chơi có thể mong đợi các tính năng sau:

  • Tiện ích chơi game: Chụp ảnh màn hình, ghi màn hình, phát trực tiếp trên YouTube và chế độ Không làm phiền.
  • Thành tích: Yêu cầu triển khai thành tích.
  • Chuỗi ngày chơi liên tiếp: Chuỗi ngày chơi liên tiếp.
  • Đổi Điểm Play lấy tín dụng.
  • Ưu đãi tăng Điểm Play và phiếu giảm giá Play Points: Dành cho nhà phát triển đã đăng ký tham gia Play Points.
  • Lợi ích và ưu đãi của Play Pass.
  • Nhiệm vụ: Nhiệm vụ dành cho các nhà phát triển Nhiệm vụ đã đăng ký.
  • Video chính thức và video của nhà sáng tạo: Sidekick cho thấy những video mà bạn thêm. Để biết thêm thông tin về cách thêm video trên Cửa hàng Play và Sidekick, hãy xem bài viết Giới thiệu ứng dụng bằng video trên YouTube trên Google Play.

Yêu cầu về phần mềm và phần cứng

Để truy cập vào Sidekick, người chơi cần có:

  • Điện thoại di động chạy Android 13 trở lên.
  • Người chơi phải có một Hồ sơ người chơi.
  • Trò chơi phải được cài đặt qua Cửa hàng Play.

Dùng thử Sidekick

Để bật Trợ lý cho trò chơi của bạn, hãy làm theo các bước sau:

Bật Sidekick theo mặc định cho trò chơi

Tạo bản phát hành thử nghiệm nội bộ hoặc khép kín trong Play Console để thử nghiệm các phiên bản phát hành trước của trò chơi bằng Sidekick và thu thập ý kiến phản hồi có mục tiêu. Xin lưu ý rằng mặc dù việc thử nghiệm trong kênh thử nghiệm khép kín không cung cấp thông tin so sánh trực tiếp cho các chỉ số hiệu suất, nhưng đây vẫn là một phương pháp hợp lệ để kiểm tra về mặt hoạt động cơ bản của quá trình tích hợp Sidekick.

Sau khi thử nghiệm với một nhóm ít người gồm những đồng nghiệp hoặc người dùng đáng tin cậy, bạn có thể mở rộng phạm vi thử nghiệm và chuyển sang bản phát hành công khai.

  1. Trong Play Console, hãy thiết lập một bản phát hành thử nghiệm nội bộ hoặc khép kín.
  2. Để thêm Play Games Sidekick vào gói ứng dụng, hãy chọn Sidekick được bật theo mặc định.
  3. Tiến hành kiểm thử.
  4. Khi đã sẵn sàng, hãy phát hành bản dựng công khai. Để biết thêm thông tin, hãy xem bài viết Chuẩn bị bản phát hành theo giai đoạn.

Người chơi có thể quản lý chế độ hiển thị của Sidekick bất cứ lúc nào thông qua chế độ cài đặt người dùng trong Cửa hàng Play.

Sidekick được bật theo mặc định
Thêm Play Games Sidekick vào trò chơi.

Thử nghiệm Sidekick một cách an toàn

Khi tích hợp Sidekick, hãy đảm bảo lớp phủ tích hợp liền mạch vào trò chơi, duy trì trải nghiệm nhất quán cho người chơi và không ảnh hưởng tiêu cực đến các chỉ số chính như tình trạng trò chơi (Sự cố/ANR), mức độ tương tác và doanh thu. Để thiết lập một đường cơ sở về hiệu suất trước khi ra mắt đầy đủ, hãy sử dụng bản phát hành theo giai đoạn 5%.

Sổ tay hướng dẫn kiểm thử này cho phép bạn chạy một phép so sánh đồng thời trong môi trường thực tế, giảm thiểu rủi ro trong khi xác minh sự thành công của quá trình tích hợp.

Cẩm nang phát hành theo giai đoạn 5%

Bằng cách phát hành Sidekick cho một phân khúc nhỏ, có kiểm soát trong đối tượng người dùng, bạn có thể tách biệt tác động của Sidekick bằng cách theo dõi các chỉ số so với phiên bản trò chơi mới.

  • Chuẩn bị bản phát hành: Tích hợp SDK Sidekick vào trò chơi của bạn và chuẩn bị một bản phát hành mới.
  • Bắt đầu phát hành theo giai đoạn: Xuất bản bản dựng mới lên kênh phát hành công khai bằng cách phát hành theo giai đoạn 5% trong Google Play Console. Thao tác này sẽ hiển thị bản tích hợp Sidekick cho một phần nhỏ người chơi theo thời gian thực.
  • Tách riêng theo phiên bản ứng dụng: Đảm bảo rằng các công cụ phân tích của bạn được định cấu hình để lọc dữ liệu riêng cho phiên bản ứng dụng có chứa tính năng tích hợp Sidekick.

Theo dõi hiệu suất và các chỉ số

Trong quá trình phát hành theo giai đoạn 5%, hãy theo dõi hiệu suất của trò chơi và đảm bảo các chỉ số chính luôn ổn định bằng cách kết hợp Google Play Console với chế độ thiết lập số liệu phân tích của riêng bạn. Khi theo dõi bản phát hành theo giai đoạn, hãy tập trung vào những điểm sau:

  • Theo dõi mức độ tương tác và độ ổn định của trò chơi: Sử dụng Google Play Console để đảm bảo rằng các chỉ số Android vitals (chẳng hạn như tỷ lệ sự cố và lỗi ANR) cũng như chỉ số tương tác của người chơi vẫn ổn định cho phiên bản ứng dụng mới.
  • Theo dõi tính nhất quán của doanh thu: Theo dõi chặt chẽ các chỉ số về doanh thu và giao dịch mua hàng trong ứng dụng (IAP) bằng cách sử dụng cơ sở hạ tầng phân tích hiện có, chẳng hạn như Google Analytics hoặc các công cụ Thông tin doanh nghiệp (BI) nội bộ. So sánh nhóm thuần tập 5% có quyền truy cập vào Sidekick với phần còn lại của lưu lượng truy cập chính thức để đảm bảo khả năng kiếm tiền cốt lõi của bạn vẫn ổn định.

Sau khi xác minh rằng Bảng trợ giúp giúp tăng doanh thu, mức độ tương tác và độ ổn định trong giai đoạn phát hành theo giai đoạn 5%, bạn có thể tự tin tiến hành tăng tỷ lệ phát hành lên 100% cho người chơi.

Quản lý chế độ hiển thị của Sidekick trên thiết bị để thử nghiệm

Sau khi người kiểm thử có thể truy cập vào bản phát hành trong Play Console, hãy làm theo các bước sau để bật tuỳ chọn cho nhà phát triển trên Cửa hàng Play trên thiết bị:

  1. Mở ứng dụng Cửa hàng Google Play.
  2. Nhấn vào biểu tượng hồ sơ rồi nhấn vào Cài đặt.
  3. Nhấn vào trình đơn Giới thiệu.
  4. Nhấn vào Phiên bản Cửa hàng Play 7 lần cho đến khi bạn thấy thông báo You are now a developer!. Thao tác này sẽ bật Tùy chọn cho nhà phát triển trên thiết bị của bạn.
  5. Nhấn vào Chung rồi nhấn vào Tuỳ chọn cho nhà phát triển.
  6. Bật Play Games Sidekick.
  7. Chuyển đến trò chơi của bạn để thấy Sidekick xuất hiện.
Nút bật/tắt để bật Play Games Sidekick trên ứng dụng Cửa hàng Google Play.
Nút bật Play Games Sidekick trên ứng dụng Cửa hàng Google Play (nhấp để phóng to).

Định cấu hình điểm truy cập mặc định vào Sidekick

Theo mặc định, điểm truy cập Sidekick được neo vào cạnh cuối logic (phía MIDDLE_RIGHT của màn hình) và được căn giữa theo chiều dọc (với độ lệch mặc định nhỏ) ở cả hướng dọc và hướng ngang. Trong trường hợp thao tác bằng 3 nút, điểm truy cập sẽ di chuyển sang phía đối diện với thanh điều hướng.

Bạn có thể ghi đè vị trí điểm truy cập mặc định bằng cách chỉ định một vị trí ưu tiên trong tệp tài nguyên XML được tham chiếu trong tệp AndroidManifest.xml bằng các tuỳ chọn sau:

  • Vị trí chính xác: Chỉ định vị trí chính xác của điểm truy cập dưới dạng tỷ lệ phần trăm trong tệp tài nguyên XML.
  • Vị trí căn lề: Chỉ định vị trí điểm truy cập căn lề trong tệp tài nguyên XML.

Nếu người chơi kéo và đặt lại điểm truy cập theo cách thủ công trong quá trình chơi, thì vị trí họ chọn sẽ được giữ nguyên trong các phiên chơi và được ưu tiên hơn cấu hình XML mặc định tuỳ chỉnh.

Định cấu hình vị trí chính xác của điểm truy cập

Để định cấu hình vị trí chính xác của điểm truy cập Sidekick cho trò chơi của bạn, hãy làm theo các bước sau:

  1. Trong tệp AndroidManifest.xml, hãy thêm phần tử <meta-data> sau đây vào phần tử <application>:

    <manifest>
  <application>
   <meta-data
   android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
   android:resource="@xml/XML_RESOURCE_FILE"/>
  </application>
</manifest>

  2. Chỉ định vị trí điểm truy cập trong XML_RESOURCE_FILE.

    Tệp mẫu (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
   <!-- Entrypoint default position overrides -->
   <!-- Anchored to RIGHT edge, 25% down from top -->
   <default-entrypoint-position orientation="portrait" horizontal-position="RIGHT" vertical-position-percent="25" />

   <!-- Anchored to LEFT edge, vertically centered at 50% -->
   <default-entrypoint-position orientation="landscape" horizontal-position="LEFT" vertical-position-percent="50" />

   <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Thẻ <default-entrypoint-position> hỗ trợ các thuộc tính sau:

  • orientation: Hướng màn hình cần định cấu hình. Giá trị được hỗ trợ:
    • landscape
    • portrait
  • horizontal-position: Cạnh ngang của màn hình để neo điểm truy cập. Giá trị được hỗ trợ:
    • LEFT
    • RIGHT

  • vertical-position-percent: Giá trị số trong khoảng từ 0 đến 100 (ví dụ: "25" hoặc "50") chỉ định vị trí dọc dưới dạng tỷ lệ phần trăm chiều cao của cửa sổ trò chơi tính từ trên cùng. Ví dụ: "25" đặt điểm truy cập thấp hơn 25% so với cạnh trên và "50" căn giữa điểm truy cập theo chiều dọc. Các giá trị không nằm trong phạm vi từ 0 đến 100 sẽ được đặt thành giới hạn gần nhất.

    Điểm truy cập luôn giữ một lề nhỏ so với cạnh trên và cạnh dưới của màn hình, đồng thời tự động dịch chuyển để tránh chồng chéo lên phần cắt camera hoặc phần khuyết đỉnh trên màn hình. Do đó, 0 đặt điểm truy cập gần cạnh trên và 100 đặt điểm truy cập gần cạnh dưới.

Các giá trị này đại diện cho vị trí thực tế trên màn hình. Ví dụ: LEFT neo điểm truy cập vào cạnh trái của màn hình, ngay cả khi thiết bị được đặt thành bố cục từ phải sang trái (RTL).

Quy tắc dự phòng và ưu tiên

Để định cấu hình vị trí chính xác, hãy chỉ định các thuộc tính orientation, horizontal-position và vertical-position-percent trên thẻ <default-entrypoint-position>:

  • Nếu cả horizontal-position và vertical-position-percent đều hợp lệ, thì các thuộc tính này sẽ được ưu tiên hơn thuộc tính value trên cùng một thẻ.
  • Nếu thuộc tính horizontal-position hoặc vertical-position-percent bị thiếu hoặc không hợp lệ, thì điểm truy cập sẽ sử dụng thuộc tính value nếu có.
  • Nếu thuộc tính value cũng bị thiếu hoặc không hợp lệ, thì điểm truy cập sẽ quay lại vị trí mặc định.

Định cấu hình vị trí điểm truy cập được căn chỉnh theo cạnh

Để định cấu hình vị trí điểm truy cập của Sidekick căn chỉnh theo cạnh cho trò chơi của bạn, hãy làm theo các bước sau:

  1. Trong tệp AndroidManifest.xml, hãy thêm phần tử <meta-data> sau đây vào phần tử <application>:

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. Chỉ định vị trí điểm truy cập trong XML_RESOURCE_FILE.

    Tệp mẫu (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
  <!-- Entrypoint default position overrides -->
  <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
  <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />

  <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Các giá trị được hỗ trợ cho điểm truy cập orientation:

  • phong cảnh
  • dọc

Thuộc tính value đại diện cho các vị trí thực tế trên màn hình. Ví dụ: MIDDLE_LEFT sẽ luôn neo điểm truy cập vào cạnh trái của màn hình, ngay cả khi thiết bị được đặt thành bố cục từ phải sang trái (RTL). Sau đây là các giá trị được hỗ trợ cho vị trí điểm truy cập được căn chỉnh theo cạnh:

  • MIDDLE_LEFT
  • MIDDLE_RIGHT
  • TOP_LEFT
  • TOP_RIGHT
  • BOTTOM_LEFT
  • BOTTOM_RIGHT

Định cấu hình thời gian tạm ẩn điểm truy cập trong FTUE

Theo mặc định, điểm truy cập Play Games Sidekick sẽ xuất hiện ngay lập tức. Bạn có thể tạm ẩn điểm truy cập trong trò chơi trong một khoảng thời gian tuỳ chỉnh được định cấu hình trong XML_RESOURCE_FILE.

Khi bạn đặt thời gian tạm ẩn, điểm truy cập Sidekick sẽ bị ẩn trong trải nghiệm đầu tiên của người dùng (FTUE) trong khoảng thời gian đã định cấu hình. Sau khi thời gian tạm ẩn kết thúc, điểm truy cập sẽ xuất hiện.

  1. Trong tệp AndroidManifest.xml, hãy thêm phần tử <meta-data> sau đây vào phần tử <application>:

    <manifest>
 <application>
  <meta-data
  android:name="com.google.android.finsky.deku.OVERLAY_CONFIG"
  android:resource="@xml/XML_RESOURCE_FILE"/>
 </application>

</manifest>

  2. Chỉ định thời gian tạm ẩn trong XML_RESOURCE_FILE.

    Tệp mẫu (res/xml/XML_RESOURCE_FILE.xml):

    <?xml version="1.0" encoding="utf-8"?>
<deku-config>
  <!-- Entrypoint default position overrides -->
  <default-entrypoint-position orientation="landscape" value="MIDDLE_LEFT" />
  <default-entrypoint-position orientation="portrait" value="TOP_RIGHT" />

  <!-- Custom Snooze Period -->
  <snooze duration_seconds="300" />

  <!-- Extensible: Add new configuration fields here as needed -->
</deku-config>

Thời gian tạm dừng tuỳ chỉnh tối đa là 30 phút. Nếu bạn chỉ định một giá trị vượt quá ngưỡng này, thì hệ thống sẽ tự động đặt giá trị mặc định là giới hạn 30 phút.

Tự động thêm Sidekick vào tất cả các gói tải lên

Khi bạn tạo một bản phát hành và bật Sidekick theo mặc định cho trò chơi, Sidekick sẽ được thêm vào tất cả các gói ứng dụng sau này.

Để thay đổi trạng thái bật/tắt mặc định của Sidekick cho tất cả gói ứng dụng mới mà bạn tải lên, hãy làm theo các bước sau:

  1. Mở Play Console.
  2. Chọn một trò chơi.
  3. Chuyển đến phần Thử nghiệm > Cài đặt nâng cao.
  4. Trên thẻ Play Games Sidekick, hãy chọn
    • Tự động bật Sidekick theo mặc định cho các gói ứng dụng mới mà bạn tải lên.
    • Không tự động bật Sidekick theo mặc định cho các gói ứng dụng mới mà bạn tải lên.
  5. Chọn Lưu thay đổi.

Nếu ứng dụng của bạn không được cập nhật thường xuyên, chúng tôi có thể định kỳ cập nhật Sidekick cho bạn. Bạn có thể chọn không sử dụng Sidekick bằng cách dùng phần cài đặt nâng cao trong Google Play Console bất cứ lúc nào.

Phát hành công khai Sidekick

Nếu bạn phát hành công khai một bản phát hành có chứa Sidekick, người chơi sẽ thấy Sidekick. Người chơi có thể quản lý chế độ hiển thị của Sidekick bất cứ lúc nào thông qua chế độ cài đặt người dùng trong ứng dụng Cửa hàng Play.

Những trò chơi quảng bá bản phát hành bằng Bảng trợ giúp sẽ đáp ứng nguyên tắc của chương trình Level Up.

Câu hỏi thường gặp

Bạn có thể thêm Sidekick vào trò chơi của mình bằng Publishing API không?

Bạn có thể thêm Sidekick vào trò chơi ngay cả khi xuất bản bằng API phát hành dành cho nhà phát triển trên Google Play. Trước tiên, hãy tự động thêm Sidekick vào tất cả các gói tải lên, sau đó tiếp tục quy trình phát hành thông thường. Bảng trợ giúp sẽ được thêm vào Android App Bundle của bạn.

Trò chơi của tôi không sử dụng Android App Bundle (AAB), tôi nên làm gì?

Bảng trợ giúp sẽ được thêm vào trò chơi khi bạn tải một Android App Bundle mới lên.

Nếu bạn đang sử dụng tệp APK, hãy thêm Sidekick SDK làm phần phụ thuộc.

Trò chơi của tôi sử dụng một sản phẩm chống can thiệp. Sidekick có tương thích với giải pháp của tôi không?

Chúng tôi đã và đang hợp tác với các công ty hàng đầu để đảm bảo khả năng tương thích của Sidekick.

Nếu bạn đang sử dụng một sản phẩm chống giả mạo không tương thích, hãy thêm SDK Sidekick làm phần phụ thuộc vào APK của bạn. Nếu bạn có câu hỏi khác, hãy yêu cầu hỗ trợ.

Tại sao thành tích không xuất hiện trong Sidekick?

Nếu thành tích không xuất hiện như dự kiến, hãy kiểm tra những điều sau:

  • Trạng thái nháp: Thành tích ở trạng thái "Nháp" sẽ không xuất hiện trong Sidekick.
  • Huy hiệu thành tích: Tất cả người chơi chỉ có thể nhìn thấy thành tích bị khoá nếu trò chơi đã đạt được huy hiệu thành tích. Để làm được điều này, bạn cần có ít nhất 100 người chơi riêng biệt đã thực hiện lệnh gọi đến API thành tích trong vòng 30 ngày qua.
  • Đã mở khoá: Nếu trò chơi chưa đạt được huy hiệu, người chơi sẽ thấy những thành tích mà họ đã mở khoá.