App Store Connect 分析輔助說明
Analytics Reports API
概覽
你可以透過 Analytics Reports API 一次大量匯出 App Store Connect 的「分析」資料,以便離線執行分析,並將 App Store 的表現資料整合至自己的資料系統中。
App Store Connect 的「分析」報告不只提供你最詳細的資料,還同時保護資料隱私。你可以使用這些報告進行自訂分析、報告,並執行自動化作業。
-
資料格式:系統所傳送的報告為壓縮的定位符號分隔文字檔案(
.txt.gz),大多數的資料處理工具都可以輕鬆匯入這種標準格式。 -
存取權限與角色:除了 App Store Connect API 金鑰,使用者還需要具備適當角色才能存取報告。第一次要求新的「分析」報告類型時,須由具備「管理」角色的使用者提出申請。申請了報告類型後,具備「銷售」、「報告」或「財務」角色的使用者即可使用 API 金鑰下載產生的報告。
-
初始設定:你可以提出的要求有兩種。
ONGOING要求會定期(每天、每週和每月)產生報告,而ONE_TIME_SNAPSHOT則提供全套的可用歷史資料。提出ONGOING報告要求後,經過約 24 到 48 小時,你就會收到第一份報告。 -
資料完整性:在報告日期的兩天後,特定一天的資料才算完整。進一步瞭解資料完整性。
可用的報告類別
「分析」報告分為多個類別,分別著重於 App 生命週期的不同環節。
App Store 參與度
這些報告說明使用者在 App Store 上如何探索到你的 App 並與之互動。
-
App Store Discovery and Engagement(App Store 探索和參與度)報告
提供各產品頁面、商店列表及 App 內活動的曝光次數、頁面檢視次數和點按次數等詳細資料。可使用事件類型、頁面類型、來源類型和彙總計數等維度。
-
App Store Web Preview(App Store 網頁預覽)報告
提供使用者在網頁中如何與你 App 的產品頁面和 App 內活動互動的深入解析。
App Store 商務
這些報告著重於下載、預訂和購買情況。
-
App Store Downloads(App Store 下載次數)報告
衡量你的 App 從 App Store 下載的頻率。
-
App Store Pre-orders(App Store 預訂數量)報告
提供下訂和取消的 App 預訂數量的詳細資料。
-
App Store Purchases(App Store 購買狀況)報告
提供收益與購買資料,包括購買類型、內容名稱、銷售額、實收金額、付費使用者數量,以及下載來源的歸屬。
-
提供訂閱生命週期各種變動的詳細資料,包括優惠開始、優惠續訂、轉為付費方案、付費方案續訂、自願和非自願取消的數量。也能將訂閱事件歸屬到下載來源。
-
提供 App Store 已啟用的訂閱數和流失訂閱數的詳細資料,包括付費訂閱、免費試用、付費優惠、有帳單問題的訂閱等項目的總數。也能將訂閱狀態歸屬到下載來源。
注意:以上這些報告會取代舊有的「銷售與趨勢」訂閱報告,除了能保護資料隱私,還方便你建立起下載次數與訂閱成效之間的關聯。
App 使用狀況
這些報告有助你瞭解使用者在下載 App 之後的互動情形。所收集的使用狀況資料,僅來自於同意分享診斷及使用資訊的使用者。
-
提供輕巧 App 的參與度和使用狀況分析指標。
-
按 App 版本和裝置類型提供當機資料。
-
App Installations and Deletions(App 安裝和刪除次數)報告
提供一段時間內的安裝與刪除活動。
-
App Store Opt-in(App Store 同意分享資料人數)報告
提供同意分享診斷與使用狀況資料的使用者比例。
-
提供階段作業次數和階段作業的平均持續時間。
隱私權和資料供應狀況
「分析」報告特別重視使用者的隱私。我們使用能增進隱私的技術來彙總和處理資料,以免識別出個人。標準報告會排除可輕易識別個別使用者的欄位。提供其他欄位的詳細報告則採用額外的保護措施。舉例來說,我們設置了門檻,若使用者或不重複裝置少於五位或五個,則該資料行會遭到排除。如未達到最低門檻,某些使用狀況報告就不會產生。也就是說,數量不足的活動或新功能的資料可能不會出現。此外,我們會在分析指標中加入少量的統計雜訊,這樣可以在大規模下維持資料的準確性,同時防止個別活動遭到逆向工程解析。