Google Play 遊戲助手

Play Games Sidekick 介面會重疊在遊戲畫面上，直接向玩家提供相關內容和優惠，讓玩家不必離開遊戲。

• 讓玩家留在遊戲中：提供官方和創作者影片，讓玩家不必切換應用程式，就能找到指南、逐步操作說明和直播。
• 提高營利成效：提供即時點數兌換、Play 贊助優惠和 Pass 優待券。
• 獎勵遊戲玩法：整合連續記錄、獎勵任務和個人資料互動。
• 更深入地參與內容和影片。

功能

Sidekick 提供的功能會因遊戲而異，具體取決於 Google Play Games 服務整合狀態和 Play Points 註冊情形。玩家可以期待以下功能：

• 遊戲工具：螢幕截圖、螢幕錄影器、YouTube 直播和「零打擾」模式。
• 成就：必須實作成就。
• 遊戲連續記錄： 遊戲連續記錄。
• Play Points 抵用金兌換。
• Play Points 點數倍增和優待券：適用於已註冊 Play Points 的開發人員。
• Play Pass 福利和優惠
• 獎勵任務：已註冊獎勵任務的開發人員可使用獎勵任務。
• 官方和創作者影片：Sidekick 會顯示你新增的影片。如要進一步瞭解如何在 Play 商店和 Sidekick 新增影片，請參閱「在 Google Play 加入能展示應用程式的 YouTube 影片」。

軟硬體需求

玩家必須符合下列條件，才能使用 Sidekick：

• 搭載 Android 13 以上版本的手機。

• 玩家必須擁有玩家個人資料。
• 遊戲必須從 Play 商店安裝。

試用 Sidekick

如要為遊戲啟用神隊友，請按照下列步驟操作：

為遊戲預設開啟 Sidekick

在 Play 管理中心建立內部或封閉測試版本，使用 Sidekick 測試遊戲的預先發布版，並收集特定意見回饋。請注意，雖然在 Beta 版封測測試群組中測試無法直接比較成效指標，但仍是基本功能測試 Sidekick 整合的有效方法。

等到一小群同事或可信任的使用者完成測試後，就能進一步執行公開測試。

1. 在 Play 管理中心設定內部或封閉測試版本。
2. 如要在應用程式套件中加入 Play Games Sidekick，請選取「Play Games Sidekick 預設為開啟」。
3. 進行測試。
4. 準備就緒後，即可發布正式版。詳情請參閱「分階段準備版本」。

玩家隨時能透過 Play 商店的使用者設定，管理 Sidekick 的顯示狀態。

安全測試 Sidekick

整合 Sidekick 時，請確保疊加畫面與遊戲完美融合，維持一致的玩家體驗，且不會對遊戲健康度 (當機/ANR)、參與度和收益等重要指標造成負面影響。如要在全面推出前建立效能基準，請先階段推出 5% 的版本。

這份測試教戰手冊可讓您在正式環境中執行並行比較，在驗證整合是否成功的同時，盡可能降低風險。

5% 階段推出教戰手冊

您可以先向一小群受控的目標對象發布 Sidekick，然後追蹤新遊戲版本的指標，藉此單獨評估 Sidekick 的影響。

• 準備版本：將 Sidekick SDK 整合至遊戲，並準備新的發布子版本。
• 開始階段推出：在 Google Play 管理中心，使用 5% 階段推出功能，將新版本發布至正式版群組。這樣一來，一小部分玩家就能即時看到 Sidekick 整合功能。
• 依應用程式版本區隔：請確認數據分析工具已設定為篩選資料，只顯示包含 Sidekick 整合功能的應用程式版本。

監控成效和指標

在 5% 階段推出期間，請結合使用 Google Play 管理中心和自己的數據分析設定，監控遊戲效能，並確保核心指標維持穩定。監控階段推出時，請著重於下列事項：

• 追蹤參與度和遊戲穩定性：使用 Google Play 管理中心，確保新版應用程式的 Android Vitals (例如當機率和 ANR) 和玩家參與度指標保持穩定。
• 追蹤收益穩定性：使用現有的數據分析基礎架構 (例如 Google Analytics 或內部商業智慧 (BI) 工具)，密切監控收益和應用程式內購指標。將可使用 Sidekick 的 5% 同類群組與其餘正式版流量進行比較，確保核心營利成效保持穩定。

確認 Sidekick 在 5% 階段推出期間，成功提升收益、參與度和穩定性後，您就可以放心地將推出比例提高到 100% 的玩家。

管理裝置上的 Sidekick 顯示設定，以便進行測試

測試人員可在 Play 管理中心取得版本後，請按照下列步驟在裝置上啟用 Play 商店開發人員選項：

1. 開啟 Google Play 商店應用程式。
2. 依序輕觸個人資料圖示和「設定」。
3. 輕觸「關於」選單。
4. 輕觸「Play 商店版本」7 次，直到看到「You are now a developer!」訊息。這樣就能在裝置上啟用開發人員選項。
5. 依序輕觸「一般」和「開發人員選項」。
6. 開啟「Play 遊戲助手」。
7. 前往遊戲，即可看到 Sidekick。

設定預設 Sidekick 進入點

根據預設，Sidekick 進入點會固定在邏輯結束邊緣 (螢幕的 MIDDLE_RIGHT 側)，並在直向和橫向模式中垂直置中 (預設略有偏移)。如果使用三按鈕操作模式，進入點會移至導覽列的另一側。

您可以在 AndroidManifest.xml 檔案中指定偏好的位置，覆寫預設的進入點位置。

如要為遊戲設定預設的 Sidekick 進入點位置，請按照下列步驟操作：

1. 在 AndroidManifest.xml 檔案中，將下列 <meta-data> 元素新增至 <application> 元素：

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

2. 在 XML_RESOURCE_FILE 中指定進入點位置。

   檔案範例 (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>

入口方向支援的值：

• 風景
• 肖像

這些值代表螢幕上的實際位置。舉例來說，MIDDLE_LEFT 一律會將進入點固定在螢幕左側邊緣，即使裝置設為從右到左 (RTL) 也是如此。邊緣對齊位置支援的值如下。

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

如果玩家在遊戲過程中手動拖曳並重新定位進入點，他們選擇的位置會在遊戲工作階段中保留，並優先於自訂預設 XML 設定。

在 FTUE 期間設定進入點延後時間長度

根據預設，Play 遊戲神隊友入口會立即顯示。您可以在 XML_RESOURCE_FILE 中，將遊戲內進入點延後自訂時間。

設定延後時間後，在初次使用者體驗 (FTUE) 期間，Sidekick 進入點會隱藏指定時間。延後時間結束後，就會顯示進入點。

1. 在 AndroidManifest.xml 檔案中，將下列 <meta-data> 元素新增至 <application> 元素：

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

2. 在 XML_RESOURCE_FILE 中指定延後時間長度。

   檔案範例 (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>

自訂貪睡時間長度上限為 30 分鐘。如果指定的值超過這個門檻，系統會自動預設為 30 分鐘。

自動將 Sidekick 新增至所有上傳的套件

建立版本並為遊戲預設開啟 Sidekick 後，日後所有應用程式套件都會加入 Sidekick。

如要變更上傳的所有新應用程式套件是否預設開啟 Sidekick，請按照下列步驟操作：

1. 開啟 Play 管理中心。
2. 選擇遊戲。
3. 依序前往「測試」 >「進階設定」。
4. 在「Play 遊戲助手」分頁中，選取下列任一選項：
   • 自動為新上傳的應用程式套件預設開啟 Sidekick。
   • 不要自動為新上傳的應用程式套件預設開啟 Sidekick。
5. 選取「儲存變更」。

如果應用程式更新不頻繁，我們可能會定期為您更新 Sidekick。您隨時可以透過 Google Play 管理中心的進階設定停用 Sidekick。

將 Sidekick 推送至正式環境

如果您將含有 Sidekick 的版本升級至正式版，玩家就會看到 Sidekick。玩家隨時能透過 Play 商店應用程式中的使用者設定，管理 Sidekick 的顯示狀態。

使用 Sidekick 宣傳新版本的遊戲符合 Level Up 指南。

常見問題