Engage 開發人員整合工作流程

本指南會逐步說明將 Engage SDK 整合到應用程式中的流程。

共用資源

下列資源可用來協助您完成整合:

驗證應用程式

這個驗證應用程式可用來驗證在 UI 中發布的內容。

內容發布指南

這份說明文件會解說如何使用 API 有效發布內容。

步驟 1:使用 SDK 偵錯模式進行開發

build.gradle 檔案中加入 Engage SDK,然後按照適用的產業整合指南完成整合作業。

dependencies {
    // Make sure you also include the repository in your project's
    // build.gradle file.
    implementation 'com.google.android.engage:engage-core:1.5.12'
}

步驟 2:安裝驗證應用程式

驗證應用程式是 Android 應用程式,可讓您用來驗證整合作業是否有效。此應用程式內含可協助開發人員驗證資料和廣播意圖的功能。

步驟 3:確認驗證應用程式可顯示資料

驗證應用程式應將每個叢集顯示為獨立的一列。

  • 輸入要發布資料的開發人員套件名稱。
圖 1:輸入套件名稱
  • 確認叢集中的所有實體皆已發布。
圖 2:確認叢集中的所有實體都已發布
  • 確認實體中的所有欄位皆已發布。對於各資料列項目,您可以按一下代表圖片來驗證意圖。
圖 3:驗證實體欄位和海報圖片
  • 查看應用程式、叢集和實體層級的摘要,瞭解驗證錯誤的數量。查看每個相關欄位下方以紅色顯示的驗證錯誤訊息。如果缺少必要欄位或欄位值不正確,就會發生驗證錯誤。
圖 4:驗證錯誤摘要和詳細資料
  • 確認所有驗證錯誤都已解決。範例狀態:
圖 5:確認驗證錯誤已解決

步驟 4:驗證廣播意圖流程

如要驗證廣播意圖,請按一下使用者介面頂端的按鈕,觸發傳送廣播的邏輯。

圖 6:驗證廣播意圖

完成步驟 1 到 4 後,您已完成整合作業的測試程序。

步驟 5:自行認證整合功能

在我們審查前,你必須完成自我認證。這是重要步驟,可驗證整合功能是否已準備就緒,並簡化審查程序。

  • 輸入套件名稱,然後按一下驗證應用程式首頁上的「開始自我認證」按鈕。

    圖 7:開始自我認證

  • 在下一頁中,從下拉式清單選取產業。系統會顯示垂直領域的測試清單:

圖 8:正在進行自我認證
  • 使用「驗證」應用程式,針對「驗證」應用程式中顯示的每個測試案例,測試整合結果。

    • 進度列會顯示目前執行的測試數量。
    • 按一下「查看詳細資料」按鈕,即可查看執行測試的步驟、預期行為和所需的手動驗證。
    • 自認證頁面中間部分會顯示已發布的叢集。
    • 按一下「記錄測試結果」按鈕,記錄測試結果。如果將測試標示為失敗或略過,請提供理由。
    • 使用「返回」和「下一步」按鈕,分別前往上一個和下一個測試。
    • 如要退出測試,請隨時按一下「退出測試」按鈕或關閉「驗證應用程式」。系統會自動儲存目前的測試工作階段,您隨時可以繼續或重新執行測試 (即使關閉「驗證應用程式」或重新啟動裝置也沒問題)。在自行認證開始時輸入相同的套件名稱並選取相同的產業,Verify 應用程式會顯示提示,詢問是否要繼續目前的測試工作階段。
    • 按一下「下載工作階段」按鈕,即可將目前的測試工作階段下載為 CSV 檔案。您可以共用這個 CSV 檔案,並使用「驗證」應用程式首頁上的「載入共用工作階段」按鈕,將這個工作階段載入「驗證」應用程式。請注意,只有測試案例和測試結果會儲存在下載的階段中。
  • 完成測試後,請按一下「完成測試」按鈕,產生可下載的自我認證測試摘要。

圖 9:完成自我認證

完成步驟 1 到 5 後,您已完成整合作業的測試程序。

步驟 6:再次檢查:切換至 SDK 正式版

偵錯完成後,您必須在資訊清單檔案中更新中繼資料:

<application>
  ...
  <meta-data
        android:name="com.google.android.engage.service.ENV"
        android:value="PRODUCTION"></meta-data>
</application>

步驟 7:將可發布的 APK 傳送給 Google

利用電子郵件附件,將可發布的 APK 檔案副本傳送至 engage-developers@google.com。此外,請附上由「驗證」應用程式產生的自我認證摘要。Google 會驗證整合作業是否正常運作。Google 驗證整合後,您即可將應用程式提交至正式版發布。

步驟 8:將 APK 發布至 Play 商店

取得核准後,請將 APK 發布到 Play 商店。發布 APK 後,請傳送電子郵件至 engage-developers@google.com,並提供發布版本號碼。Google 會採取後續步驟來回應。

下載

下載前,請先同意以下條款及細則。

條款及細則

這是《Android 軟體開發套件授權協議》

1. 簡介

1.1 Android 軟體開發套件 (在《授權協議》中稱為「SDK」,具體包含 Android 系統檔案、封裝的 API 及 Google API 外掛程式) 根據《授權協議》的條款向您授權。《授權協議》構成您與 Google 之間具法律約束效力的合約,用於規範您對 SDK 的使用行為。1.2「Android」是指裝置的 Android 軟體堆疊,根據 Android 開放原始碼計畫提供使用,網址為 https://source.android.com,並且不時更新。1.3「相容實作」是指任何 Android 裝置,只要 (i) 遵守 Android 相容性定義說明文件 (可前往 Android 相容性網站 (https://source.android.com/compatibility) 查閱,且可能不時更新);且 (ii) 成功通過 Android Compatibility Test Suite (CTS)。1.4「Google」是指 Google LLC,該公司根據美國德拉瓦州法律成立,並根據美國法律營運,主要營運地點位於 1600 Amphitheatre Parkway, Mountain View, CA 94043, USA。

2. 接受本《授權協議》

2.1 您必須同意《授權協議》才能使用 SDK。如果不接受《授權協議》,則不得使用 SDK。 2.2 按下接受和/或使用此 SDK 即表示您同意遵守《授權協議》的條款。2.3 如果您受到美國或其他國家/地區法律 (包括您居住或使用 SDK 時所在的國家/地區) 的法律禁止使用 SDK,則不得接受《授權協議》且不得使用 SDK。2.4 如果您代表雇主或其他實體同意接受本《授權協議》的約束,即表示您聲明及擔保已獲得完整法律授權,可約束雇主或這類實體遵守本《授權協議》。如果您沒有必要的授權,則不得代表雇主或其他實體接受《授權協議》或使用 SDK。

3. Google 提供的 SDK 授權

3.1 根據《授權協議》的條款,Google 授予您有限、全球、免權利金、不可轉讓、非專屬且不可轉授權的授權以使用 SDK,且 SDK 用途僅限於開發與 Android 實作相容的應用程式。 3.2 您不得使用此 SDK 開發其他平台的應用程式 (包括不相容的 Android 實作) 或開發其他 SDK。您當然可以開發其他平台的應用程式 (包括不相容的 Android 實作),前提是 SDK 並未用於上述用途。3.3 您同意 Google 或第三方擁有 SDK 的所有法律權利、所有權和利益,包括 SDK 既有的任何智慧財產權。「智慧財產權」是指根據專利法、著作權法、營業秘密法、商標法所述之所有權利,並享有所有其他財產權利。Google 保留未授予您的所有權利。 3.4 您不得將 SDK 用於《授權協議》未明確允許的任何目的。除了適用第三方授權要求的範圍內,您不得複製 (除了備份用途)、修改、調整、轉散布、反編譯、反向工程、反組譯 SDK 或 SDK 的任何部分,或建立其衍生作品。3.5 如果 SDK 的元件授權來源為某開放原始碼軟體授權,您必須在使用、複製及發布元件時遵守該開放原始碼軟體授權的條款,而不是本《授權協議》。3.6 您同意 Google 可在未向您事先通知的情況下變更 SDK 的格式和性質,而且日後推出的 SDK 版本可能會與先前 SDK 版本開發的應用程式不相容。您同意,Google 可自行決定停止 (永久或暫時) 向您或所有使用者提供 SDK (或 SDK 中的任何功能),不需事先通知。3.7《授權協議》中沒有任何內容讓您有權利使用 Google 的任何商業名稱、商標、服務商標、標誌、網域名稱或其他獨特品牌特徵。3.8 您同意不會移除、遮掩或竄改 SDK 隨附或包含的任何所有權聲明 (包括著作權和商標聲明)。

4. 您使用 SDK 的方式

4.1 Google 同意,依據您使用 SDK 開發的任何軟體應用程式的《授權協議》,Google 並未向您 (或您的授權者) 取得任何權利、所有權或利益,包括這類應用程式既有的智慧財產權。4.2 您同意僅將 SDK 用於 (a)《授權協議》以及 (b) 相關管轄區的任何適用法律、法規、公認慣例或準則 (包括有關資料或軟體進出美國或其他相關國家/地區的任何法律) 所允許的用途,並僅將應用程式用於上述用途。 4.3 您同意在使用 SDK 為一般大眾使用者開發應用程式時,保護這些使用者的隱私權和法律權利。如果使用者提供您使用者名稱、密碼或其他登入資訊或個人資訊,您必須確保使用者知道這些資訊將用於您的應用程式,且您必須為這些使用者提供具有足夠法律依據的隱私權聲明和保護。如果您的應用程式會儲存使用者提供的個人資訊或機密資訊,就必須採用安全的儲存方式。如果使用者將 Google 帳戶資訊提供給您的應用程式,您的應用程式必須取得使用者授權,才能使用該資訊存取使用者的 Google 帳戶,而且該資訊只能用於使用者授權的限定用途。 4.4 您同意不會利用 SDK 從事任何活動 (包括開發或發布應用程式),干擾、中斷、損害或未經授權存取任何第三方的伺服器、網路或其他資源或服務,包括但不限於 Google 或任何行動通訊業者。4.5 您同意,您必須對透過 Android 和/或 Android 應用程式建立、傳輸或顯示的任何資料、內容或資源,以及您因此類行為造成的後果 (包括 Google 可能遭受的任何損失或損害) 承擔全責 (且 Google 對您或任何第三方毋需承擔任何責任)。 4.6 您同意,您必須對任何違反授權協議、任何適用的第三方合約或服務條款,或任何適用法律或法規的行為,以及任何因這類違規行為而導致之後果 (包括 Google 或任何第三方可能蒙受的損失或損害) 承擔全責 (且 Google 對您或任何第三方毋需承擔任何責任)。

5. 您的開發人員憑證

5.1 您同意,凡是由 Google 核發或您自行選擇的開發人員憑證,您都會負責維護憑證的機密,而且只要是使用您開發人員憑證開發的應用程式,您也會承擔所有責任。

6. 隱私權及資訊

6.1 為持續創新及改善 SDK,Google 會從軟體蒐集特定的使用統計資料,包括但不限於唯一 ID、相關 IP 位址、軟體版本編號,以及關於使用 SDK 中工具和/或服務及其使用方式的資訊。蒐集任何上述資訊前,SDK 會通知您,並徵得您的同意。如果您不同意,系統將不會蒐集這些資訊。6.2 蒐集到的資料會經過匯總再送交檢視,用於改善 SDK。這類資料會依《Google 隱私權政策》的規定保存,詳請請參閱 https://policies.google.com/privacy。 6.3 為改善 SDK,經過去識別化及匯總的資料集可能會提供給 Google 合作夥伴。

7. 第三方應用程式

7.1 如果您使用 SDK 執行第三方開發的應用程式,或是存取第三方提供的資料、內容或資源,您同意 Google 對這些應用程式、資料、內容或資源概不負責。您瞭解透過這類第三方應用程式存取的所有資料、內容或資源,均由來源者負全責,且 Google 對於您因使用或存取任何這類第三方應用程式、資料、內容或資源而遭受的任何損失或損害,概不負責。 7.2 您應瞭解,透過這類第三方應用程式呈現的資料、內容和資源,可能受到供應商 (或其代表人員或公司) 擁有的智慧財產權保護。除非相關擁有者已特別向您提供權限,否則您不得根據這些資料、內容或資源 (無論是全部或其中一部分) 修改、出租、租用、貸款、銷售、發布或建立衍生作品。 7.3 您確認使用這類第三方應用程式、資料、內容或資源時,可能必須遵守您和相關第三方另外簽訂的條款。在這種情況下,《授權協議》不會影響您與這些第三方的法律關係。

8. 使用 Android API

8.1 Google Data API 8.1.1 如果您使用任何 API 從 Google 擷取資料,即表示您確認該資料可能受到 Google 擁有,或是由提供資料的一方 (或其代表人員或公司) 擁有的智慧財產權保護。您使用任何這類 API 時可能須遵守其他服務條款。除非相關《服務條款》允許,否則您不得根據此資料 (無論是全部或其中一部分) 修改、出租、租用、貸款、銷售、發布或建立衍生作品。8.1.2 如果您使用任何 API 從 Google 擷取使用者資料,即表示您瞭解並同意,您只會在取得使用者明確同意後,才能擷取資料,且只能用於使用者授權的限定用途。如果您使用 Android Recognition Service API (如以下網址所載:https://developer.android.com/reference/android/speech/RecognitionService,該網址內容會不時更新),即表示您瞭解 API 的使用須遵守《Google 為資料處理者的產品資料處理附加條款》(如以下網址所載:https://privacy.google.com/businesses/gdprprocessorterms/,該網址內容會不時更新)。您按下接受後,即表示同意《Data Processing Addendum for Products where Google is a Data Processor》的條款。

9. 終止本《授權協議》

9.1《授權協議》效力將持續至您或 Google 按以下規定終止為止。 9.2 如果您想終止《授權協議》,停止使用 SDK 和任何相關開發人員憑證即可。 9.3 如果您 (A) 違反「授權協議」的任何規定;或 (B) Google 必須依法採取行動;或 (C) Google 與合作夥伴終止關係,而 Google 是透過該合作夥伴向您提供部分 SDK (例如 API);或 (D) Google 決定停止向您所在國家/地區的使用者提供 SDK 或部分 SDK,或 Google 認為向您提供 SDK 或部分 SDK 服務已不具商業價值,Google 隨時可能終止您的「授權協議」。9.4 授權協議終止後,您和 Google 享有、受制於 (或在授權協議有效期間累積) 或明定無限期持續的所有法律權利、義務和責任,都不會受到影響,且第 14.7 段的條款將無限期適用於這類權利、義務和責任。

10. 免責事項

10.1 您瞭解並明確同意,您使用 SDK 時須自行承擔全部風險,且 SDK 是依「現況」與「適用情形」供應的服務,Google 不提供任何形式的擔保。10.2 使用 SDK 及任何因使用 SDK 所下載或以其他方式取得的材料時,您應自行斟酌任何風險,且對於因這類使用方式對電腦系統或其他裝置所造成的任何損害或資料損失,均應自行承擔責任。10.3 Google 進一步明確聲明,Google 不提供任何種類的明示或暗示擔保或條件,包括但不限於商業適售性、特定用途適用性,以及不侵害他人權利之擔保或條件。

11. 責任限制

11.1 您明確瞭解並同意,對於您可能遭受的任何直接、間接、附帶、特殊、衍生或懲罰性損害 (包括任何資料遺失),Google、其子公司和關係企業,以及授權人均不負任何責任,無論 Google 或其代表是否已獲知或應知悉發生這類損失的可能性。

12. 賠償

12.1 在法律允許的最大範圍內,您同意就任何及所有索賠、訴訟、法律行動或程序,以及任何及所有損失、責任、損害、成本和費用 (包括合理的律師費用),為 Google、其關係企業和各自的董事、主管、員工和代理人辯護、賠償並使其不致遭受損害,前提是這些索賠、訴訟、法律行動或程序,以及損失、責任、損害、成本和費用,是因下列事項而起或因此產生:(a) 您使用 SDK;(b) 您使用 SDK 開發的任何應用程式侵犯任何人的著作權、商標、商業機密、商品外觀或包裝、專利或其他智慧財產權,或誹謗任何人或侵犯其個人公開權或隱私權;以及 (c) 您未遵守授權協議。

13. 《授權協議》變更

13.1 Google 得在發布新版 SDK 時變更《授權協議》。如有變更,Google 會在提供 SDK 的網站上提供新版《授權協議》。 14.1 本《授權協議》構成您與 Google 之間的完整法律協議,用以規範您使用 SDK 的行為 (不包括 Google 可能根據另行簽署的書面協議向您提供的任何服務),並完全取代您與 Google 之前就 SDK 所達成的任何協議。14.2 您同意,如果 Google 未行使或強制執行「授權協議」所載 (或 Google 依據任何適用法律享有的) 任何法律權利或救濟,這不代表 Google 正式拋棄這些權利,且 Google 仍可使用這些權利或救濟。14.3 如果任何具管轄權的法院判定本《授權協議》的任何條款無效,則該條款將自本《授權協議》中移除,其他條款效力不受影響。「授權協議」的其餘條款仍具有有效且可執行的效力。 14.4 您瞭解並同意,Google 母公司集團的每個成員都是本授權協議的受益第三人,且這些公司有權直接執行並依據本授權協議中賦予其利益 (或權利) 的任何條款。除此之外,任何其他人或公司均不是《授權協議》的受益第三人。 14.5 出口限制。SDK 必須遵守美國出口法律和法規。您必須遵守適用於 SDK 的所有國內和國際出口法律和法規。這些法律含對目的地、終端使用者和終端用途的限制。 14.6 未經另一方的事先書面許可,您或 Google 不得轉讓或轉移《授權協議》所授予的權利,未經他方事先書面核准,您或 Google 均不得將《授權協議》所賦予之責任與義務委任予他人。14.7《授權協議》以及您與 Google 在《授權協議》規定下的關係受到美國加州法律規範,但不適用美國加州法律衝突條款。您與 Google 同意服從位於加州聖克拉拉郡法院之專屬管轄權,解決任何因《授權協議》而引致之法律事務。除上述規定之外,您亦同意 Google 仍可向任何管轄區的法院申請禁制性救濟處分 (或同類緊急法律救濟處分)。 2026 年 4 月 28 日
下載

verify_app_multiplatform_public_20251215.apk