English 中文TürkçeРусскийFrançaisTiếng ViệtEspañol日本語
POST /api/v1/client-api/metrics/retention/

リテンションデータの取得

Copy as Markdown

プロダクトがユーザーのエンゲージメントを維持する能力を分析するためのリテンションデータを取得します。

レート制限: 1秒あたり2リクエスト。

Request body

filtersobjectrequired
datearray of stringrequired

チャートデータを取得する日付または期間を入力してください

compare_datearray of string

比較する日付または期間を入力してください

storearray of string

購入が行われたアプリストアでフィルタリングします

countryarray of string

購入が行われた国の2文字の国コードでフィルタリングします

store_product_idarray of string

ストア修飾子付きのプロダクトID。<store>:<product_id> の形式で指定します。例えば app_store:premium_monthly や、ベースプランを持つ Google サブスクリプションの場合は play_store:premium_sub:monthly-base-plan のように指定します。ストアプレフィックスのないプロダクトIDは拒否されます。

durationarray of string

サブスクリプションの期間を指定してください

attribution_sourcearray of string

アトリビューションのソースインテグレーション

attribution_statusarray of string

アトリビューションがオーガニックか非オーガニックかを示します

attribution_channelarray of string

トランザクションにつながったマーケティングチャネル

attribution_campaignarray of string

トランザクションをもたらしたマーケティングキャンペーン

attribution_adgrouparray of string

トランザクションをもたらしたアトリビューションの広告グループ

attribution_adsetarray of string

トランザクションにつながったアトリビューションの広告セット

attribution_creativearray of string

効果測定のために追跡される広告またはキャンペーン内の特定のビジュアルまたはテキスト要素

offer_categoryarray of string

データを取得するオファーカテゴリを指定してください

offer_typearray of string

データを取得するオファータイプを指定してください

offer_idarray of string

データを取得する特定のオファーを指定してください

period_unitstring

分析データを集計する時間間隔を指定します

One of: "day", "week", "month", "quarter", "year"

segmentationstring

セグメンテーションの基準を設定します

use_trialboolean

トライアルが使用されたかどうかを示すブール値

formatstring

エクスポートファイルの形式を指定します

One of: "json", "csv"

Responses

リテンションデータが正常に取得されました

Schema

ユーザーエンゲージメントの経時変化を示すリテンションデータを含むレスポンス

dataarray of object

リテンションデータポイントの配列（リテンションの種類によっては空になる場合があります）

titlestring

リテンション指標の表示タイトル

metric_namestring

リテンション指標の内部名

descriptionstring

リテンションの計算方法の説明（絶対値または相対値）

value_typestring

リテンション値の種類（絶対値または相対値）

Example 
{
  "data": [],
  "title": "Subscription retention",
  "metric_name": "Subscription retention",
  "description": "Absolute value is the amount of users who entered the current step - subscribed for a trial or paid for a subscription. Relative is calculated as a percentage of these users among those who got a trial. So it starts with 100% for the trial step.",
  "value_type": null
}

リクエストが不正です

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

認証されていません

Schema
errorsarray of object
sourcestring
errorsarray of string
error_codestring
status_codeinteger

レート制限を超えました。APIキーごとに1秒あたり最大2リクエストです。