ZReviewsBot

TL;DR

Deprecated, try the new ZReviewTender, powered by brand new App Store Connect API.

ZReviewsBot 為免費、開源專案，幫助您的 App 團隊自動追蹤 App Store (iOS) 及 Google Play (Android) 平台上 App 的最新評價，並發送到指定 Slack Channel 方便您即時了解當前 App 狀況。

特色

✅ 使用更新、更可靠的 API Endpoint 追蹤 iOS App 評價 (技術細節)
✅ 支援雙平台評價追蹤 iOS & Android
✅ 支援關鍵字通知略過功能 (防洗版廣告**)
✅ 客製化設定，隨心所欲
✅ 支援使用 Github Action 部署 Schedule 自動機器人

安裝及使用

GEM

$ gem install ZReviewsBot
$ ZReviewsBot

Manually

下載最新版本或 Clone 本專案
Unzip & $ cd /ZReviewsBot-X.X.X
Running $ bundle install for the first time
$ bundle exec ruby /bin/ZReviewsBot

設定檔配置

下載或複製專案的 config.example.yml 設定檔範本
更改檔名為 config.yml
Android 需要到後台匯出 Google service account key 檔案，並將檔案名改成 android_publisher_key.json 放在與 config.yml 同個目錄下
使用編輯器打開 config.yml

依照各參數說明填妥對應資料

iOS:
    appID: 'iOS APP ID'
    appleID: 'APP Store Connect Apple ID (email)'
    password: 'APP Store Connect Apple ID Password'
    notifySlackBotToken: 'slack bot token for iOS new review message'
    notifySlackBotChannelID: 'slack bot target channel id for iOS new review message'
    ignoreKeywords: #list, Optional
        - 'Keyword 1'
        - 'Keyword 2'
android:
    packageName: 'Android Package Name'
    jsonKeyFileName: 'android_publisher_key.json' # Google service account key file, relative to config.yml file
    notifySlackBotToken: 'slack bot token for android new review message'
    notifySlackBotChannelID: 'slack bot target channel id for android new review message'
    ignoreKeywords: #list, Optional
        - 'Keyword 1'
        - 'Keyword 2'
setting:
    lang: "en"
    googleTranslateAPIJsonKeyFileName: 'gcp-translate-api-key.json' # Google Translate api key, Optional
    googleTranslateTargetLang: 'zh-TW' # Google Translate api traget lang, Optional
    developerNotifySlackBotToken: 'slack bot token for debug message'
    developerNotifySlackBotChannelID: 'slack bot target channel id for debug message'

完成!

使用方式

執行 iOS App Store 最新評價撈取

ZReviewsBot -i config.yml

執行 Android Google Play 最新評價撈取

ZReviewsBot -a config.yml

Reset 清除紀錄，重新初始化

ZReviewsBot -c

執行

第一次執行僅作初始化，初始化完成後如有比對到新評價則會開始發送訊息
iOS 第一次執行須完成 AppStoreConnect 2步驟登入驗證，完成驗證後會將登入資訊儲存在環境變數 FASTLANE_SESSION 及檔案 ~/.fastlane/spaceship/iOS APP 開發者帳號 (email)/cookie 中

完成!

使用雲端服務部署排成機器人

iOS 因 Apple Store Connect 會驗證 Session 產生地與執行地有無異動，所以無法在本地產好 Session 然後給 Cloud Server 使用。

注意事項

登入資訊、帳號密碼、Key 均僅在本地使用，不會經過網路傳輸。
iOS 評價撈取的 Endpoint 需要身份驗證，因蘋果全面實行 2 步驟登入；登入資訊最多只能保持 30 天，每 30 天都須重新登入 & 2步驟驗證，此段是直接依賴 fastlane spaceship 實現。

Unfortunately there is nothing fastlane can do better in this regard, as these are technical limitations on how App Store Connect sessions are handled.

https://docs.fastlane.tools/best-practices/continuous-integration/#important-note-about-session-duration

FAQ

iOS 評價撈取失敗處理

ZhgChgLi / ZReviewsBot