モバイル市場が成長する中、ユーザー獲得は容易でも安価でもありません。そのため、獲得したユーザーを賢く活用することがユニットエコノミクスの改善につながります。特に競争の激しいニッチでは効果的です。

Adaptyはユーザーの主要な支払いアクションに関するリアルタイム情報を提供します。顧客がトライアルを開始したとき、支払いに問題が発生したとき、またはサブスクリプションを購入して後にキャンセルを決断したときなど、これらすべてのイベントが顧客の状態の変化を示しています。そして、これこそが最適なタイミングです——オファーや特別なギフト、その他の継続促進施策を送りましょう。

プッシュ通知プラットフォームでは、標準タグやカスタムタグでユーザーを分類し、効果的な自動リテンションシステムを構築できます。このシステムを機能させるには、メッセージ送信のタイミングをシステムに伝えるトリガーイベントが必要です。これらのイベントは、設定済みのインテグレーションを通じてAdaptyからプッシュプラットフォームに送信されます。

インテグレートしたいサービスを以下から選択し、手順に従ってください：

• Braze
• OneSignal
• Pushwoosh
• Slack

イベントのプロパティ

WebhookイベントはJSON形式で送信されます。すべてのイベントは同じ構造に従いますが、フィールドはイベントの種類、ストア、および設定によって異なります。

プロパティ	タイプ	説明
profile_id	uuid	Adapty ユーザー ID。
currency	str	現地通貨（デフォルトは USD）。
price_usd	float	Apple/Google の手数料控除前のプロダクト価格。収益。
proceeds_usd	float	Apple/Google の手数料控除後のプロダクト価格。純収益。
net_revenue_usd	float	純収益（Apple/Google の手数料および税金控除後の収入）の USD 換算値。空の場合あり。
price_local	float	現地通貨での Apple/Google 手数料控除前のプロダクト価格。収益。
proceeds_local	float	現地通貨での Apple/Google 手数料控除後のプロダクト価格。純収益。
transaction_id	str	購入や更新などのトランザクションの一意識別子。
original_transaction_id	str	元の購入のトランザクション識別子。
purchase_date	ISO 8601 date	プロダクト購入の日時。
original_purchase_date	ISO 8601 date	元の購入の日時。
environment	str	Sandbox または Production。
vendor_product_id	str	Apple App Store、Google Play Store、または Stripe でのプロダクト ID。12 か月コミットメントプランの場合、値は <product_id>:monthly となります。
base_plan_id	str	Google Play Store でのベースプラン ID、または Stripe での価格 ID。
event_datetime	ISO 8601 date	イベントの日時。
store	str	app_store または play_store。
trial_duration	str	トライアル期間の日数。” days” 形式（例: “7 days”）で送信されます。
cancellation_reason	str	ユーザーがサブスクリプションをキャンセルした理由。 次のいずれかです iOS & Android voluntarily_cancelled, billing_error, refund iOS price_increase, product_was_not_available, unknown Android new_subscription_replace, cancelled_by_developer
subscription_expires_at	ISO 8601 date	サブスクリプションの有効期限。通常は将来の日時。
consecutive_payments	int	ユーザーが中断なく継続しているサブスクリプション期間数。現在の期間を含む。
rate_after_first_year	bool	1 年間継続更新後に手数料率の引き下げ（通常 15%）が適用されるかどうかを示すブール値。手数料率はプログラムの資格要件や国によって異なります。詳細はストアの手数料と税金を参照してください。
promotional_offer_id	str	Adapty ダッシュボードのプロダクトセクションに記載されているプロモーションオファーの ID。
store_offer_category	str	introductory または promotional。
store_offer_discount_type	str	free_trial、pay_as_you_go、または pay_up_front。
paywall_name	str	トランザクションが発生したペイウォールの名前。フローの場合は、ペイウォール画面の ID（scr_...）。
paywall_revision	int	トランザクションが発生したペイウォールのリビジョン。値は 1 に設定されます。
developer_id	str	トランザクションが発生したプレースメントの開発者（SDK）ID。
ab_test_name	str	トランザクションが発生した A/B テストの名前。クロスプレースメント A/B テストの場合は、1 つのプレースメント上のテスト名（<テスト名> child-N）。プレースメントをまたいでクロスプレースメントテストをグループ化するには ab_test_id を使用してください。
ab_test_revision	int	トランザクションが発生した A/B テストのリビジョン。値は 1 に設定されます。
ab_test_id	uuid	トランザクションが発生した A/B テストの ID。クロスプレースメント A/B テストの場合、すべてのプレースメントで同じ値になります。
ab_test_parent_name	str	クロスプレースメント A/B テストの名前。クロスプレースメント A/B テストにのみ存在します。
ab_test_variant_id	uuid	トランザクションが発生した A/B テストのバリアント ID。テストバリアント別にトランザクションを分割する際に使用します。
ab_test_variant_name	str	A/B テストバリアントの名前。
flow_id	uuid	トランザクションが発生したフローの ID。
flow_name	str	トランザクションが発生したフローの名前。
flow_variation_id	uuid	このプレースメントにおけるフローバリアントの ID。SDK の flow.variationId と同じ値です。
cohort_name	str	プロファイルが属するオーディエンスの名前。
profile_event_id	uuid	重複排除に使用できる一意のイベント ID。
store_country	str	ストアから送信された国情報。
profile_ip_address	str	プロファイルの IP アドレス（IPv4 または IPv6。利用可能な場合は IPv4 が優先されます）。デバイスの IP が変わるたびに更新されます。
profile_country	str	プロファイルの IP を基に Adapty が判定した国。
profile_total_revenue_usd	float	返金を含むプロファイルの総収益。
variation_id	uuid	購入が行われたペイウォールの一意 ID。フローの場合は、A/B テストバリアントではなく、フロー内のペイウォール画面の ID。
access_level_id	str	有料アクセスレベルの ID。
is_active	bool	プロファイルの有料アクセスレベルがアクティブかどうかを示すブール値。
will_renew	bool	有料アクセスレベルが更新されるかどうかを示すブール値。
is_refund	bool	トランザクションが返金されているかどうかを示すブール値。
is_lifetime	bool	有料アクセスレベルが永続アクセスかどうかを示すブール値。
is_in_grace_period	bool	プロファイルがグレース期間中かどうかを示すブール値。
starts_at	ISO 8601 date	ユーザーの有料アクセスレベルが開始する日時。
renewed_at	ISO 8601 date	有料アクセスの現在の期間が最後に開始した日時。最初の更新までは activated_at と同じ値です。
expires_at	ISO 8601 date	有料アクセスが終了する日時。
activated_at	ISO 8601 date	有料アクセスが有効化された日時。
billing_issue_detected_at	ISO 8601 date	請求問題が検出された日時。
profile_has_access_level	Bool	プロファイルにアクティブなアクセスレベルがあるかどうかを示すブール値（Webhook のみ）。

各イベントには以下のプロパティが含まれます：

transaction_id, original_transaction_id, purchase_date, original_purchase_date, environment, vendor_product_id, event_datetime, store

また、一部のイベントには追加のプロパティがあります。subscription_refunded および non_subscription_purchase_refunded イベントについては、追加プロパティとして price_usd と proceeds_usd の値を必ず指定する必要があります。

イベント名	プロパティ
subscription_initial_purchase	price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_renewed	price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_cancelled	cancellation_reason, trial_duration
trial_started	subscription_expires_at, trial_duration
trial_converted	price_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
trial_cancelled	cancellation_reason, trial_duration
non_subscription_purchase	price_usd, proceeds_usd
billing_issue_detected	subscription_expires_at, trial_duration
entered_grace_period	subscription_expires_at, trial_duration

イベントの例

{
    "price_usd": 9.99,
    "proceeds_usd": 6.99,
    "transaction_id": "1000000628581600",
    "original_transaction_id": "1000000628581600",
    "purchase_date": "2020-02-18T18:40:22.000000+0000",
    "original_purchase_date": "2020-02-18T18:40:22.000000+0000",
    "environment": "Sandbox",
    "vendor_product_id": "premium",
    "event_datetime": "2020-02-18T18:40:22.000000+0000",
    "store": "app_store"
}

Adaptyはイベントをサーバーおよびサードパーティの分析システムに送信します。

profile_ip_address プロパティは現在のデバイスIPと同期されます。AdaptyのサーバーがSDKから情報を受信するたびに、記録済みのIPと異なる場合はIPが更新されます。