ÿÿ Adaptyã®ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ãƒ³ã‚°ã¨Notifications | Adapty ドキュメント

メッセージングサービスã®é€£æº

モãƒã‚¤ãƒ«å¸‚å ´ãŒæˆé•·ã™ã‚‹ä¸­ã€ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®ç²å¾—ã¯å®¹æ˜“ã§ã‚‚ãªãã€ã‚³ã‚¹ãƒˆã‚‚ã‹ã‹ã‚Šã¾ã™ã€‚ãã®ãŸã‚ã€ç²å¾—ã—ãŸãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’ã†ã¾ã活用ã™ã‚‹ã“ã¨ãŒã€ç‰¹ã«ç«¶äº‰ã®æ¿€ã—ã„ニッãƒå¸‚å ´ã§ã¯ãƒ¦ãƒ‹ãƒƒãƒˆã‚¨ã‚³ãƒŽãƒŸã‚¯ã‚¹ã®æ”¹å–„ã«ã¤ãªãŒã‚Šã¾ã™ã€‚

Adaptyã¯ãƒ¦ãƒ¼ã‚¶ãƒ¼ã®ä¸»è¦ãªæ”¯æ‰•ã„アクションã«é–¢ã™ã‚‹ãƒªã‚¢ãƒ«ã‚¿ã‚¤ãƒ æƒ…報をæä¾›ã—ã¾ã™ã€‚顧客ãŒãƒˆãƒ©ã‚¤ã‚¢ãƒ«ã‚’é–‹å§‹ã—ãŸã¨ãã€æ”¯æ‰•ã„ã«å•題ãŒç™ºç”Ÿã—ãŸã¨ãã€ã¾ãŸã¯ã‚µãƒ–スクリプションを購入ã—ã¦å¾Œã«ã‚­ãƒ£ãƒ³ã‚»ãƒ«ã‚’決断ã—ãŸã¨ããªã©ã€ã“れらã™ã¹ã¦ã®ã‚¤ãƒ™ãƒ³ãƒˆãŒé¡§å®¢ã®çŠ¶æ…‹ã®å¤‰åŒ–を示ã—ã¦ã„ã¾ã™ã€‚ãã—ã¦ã€ã“れã“ããŒæœ€é©ãªã‚¿ã‚¤ãƒŸãƒ³ã‚°ã§ã™â€”—オファーや特別ãªã‚®ãƒ•トã€ãã®ä»–ã®ç¶™ç¶šä¿ƒé€²æ–½ç­–ã‚’é€ã‚Šã¾ã—ょã†ã€‚

プッシュ通知プラットフォームã§ã¯ã€æ¨™æº–タグやカスタムタグã§ãƒ¦ãƒ¼ã‚¶ãƒ¼ã‚’分類ã—ã€åŠ¹æžœçš„ãªè‡ªå‹•リテンションシステムを構築ã§ãã¾ã™ã€‚ã“ã®ã‚·ã‚¹ãƒ†ãƒ ã‚’機能ã•ã›ã‚‹ã«ã¯ã€ãƒ¡ãƒƒã‚»ãƒ¼ã‚¸é€ä¿¡ã®ã‚¿ã‚¤ãƒŸãƒ³ã‚°ã‚’システムã«ä¼ãˆã‚‹ãƒˆãƒªã‚¬ãƒ¼ã‚¤ãƒ™ãƒ³ãƒˆãŒå¿…è¦ã§ã™ã€‚ã“れらã®ã‚¤ãƒ™ãƒ³ãƒˆã¯ã€è¨­å®šæ¸ˆã¿ã®ã‚¤ãƒ³ãƒ†ã‚°ãƒ¬ãƒ¼ã‚·ãƒ§ãƒ³ã‚’通ã˜ã¦Adaptyã‹ã‚‰ãƒ—ッシュプラットフォームã«é€ä¿¡ã•れã¾ã™ã€‚

インテグレートã—ãŸã„サービスを以下ã‹ã‚‰é¸æŠžã—ã€æ‰‹é †ã«å¾“ã£ã¦ãã ã•ã„:

ãŠæŽ¢ã—ã®ã‚¢ãƒˆãƒªãƒ“ューションプロãƒã‚¤ãƒ€ãƒ¼ãŒè¦‹ã¤ã‹ã‚Šã¾ã›ã‚“ã‹ï¼Ÿ

Let us know! 機能リクエストを作æˆã—ã¦ã„ãŸã ã‘れã°ã€è¿½åŠ ã‚’æ¤œè¨Žã—ã¾ã™ã€‚

イベントã®ãƒ—ロパティ

Webhookイベントã¯JSONå½¢å¼ã§é€ä¿¡ã•れã¾ã™ã€‚ã™ã¹ã¦ã®ã‚¤ãƒ™ãƒ³ãƒˆã¯åŒã˜æ§‹é€ ã«å¾“ã„ã¾ã™ãŒã€ãƒ•ィールドã¯ã‚¤ãƒ™ãƒ³ãƒˆã®ç¨®é¡žã€ã‚¹ãƒˆã‚¢ã€ãŠã‚ˆã³è¨­å®šã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚

Adapty 㯠currencylayer.com ã®ç‚ºæ›¿ãƒ¬ãƒ¼ãƒˆï¼ˆ8時間ã”ã¨ã«æ›´æ–°ï¼‰ã‚’使用ã—ã¦ä»–ã®é€šè²¨ã‚’ USD ã«å¤‰æ›ã—ã¾ã™ã€‚レートã¯å–引時点ã§å›ºå®šã•れるãŸã‚ã€ãã®å¾Œã®å¤‰å‹•ã¯å¤‰æ›çµæžœã«å½±éŸ¿ã—ã¾ã›ã‚“。

プロパティ型説明
profile_iduuidAdaptyã®ãƒ¦ãƒ¼ã‚¶ãƒ¼ID。
currencystrローカル通貨(デフォルトã¯USD)。
price_usdfloatApple/Googleã®æ‰‹æ•°æ–™æŽ§é™¤å‰ã®ãƒ—ロダクト価格。売上高。
proceeds_usdfloatApple/Googleã®æ‰‹æ•°æ–™æŽ§é™¤å¾Œã®ãƒ—ロダクト価格。純売上高。
net_revenue_usdfloatUSDæ›ç®—ã®ç´”åŽç›Šï¼ˆApple/Googleã®æ‰‹æ•°æ–™ãŠã‚ˆã³ç¨Žé‡‘控除後)。空ã®å ´åˆãŒã‚りã¾ã™ã€‚
price_localfloatローカル通貨ã§ã®Apple/Googleã®æ‰‹æ•°æ–™æŽ§é™¤å‰ã®ãƒ—ロダクト価格。売上高。
proceeds_localfloatローカル通貨ã§ã®Apple/Googleã®æ‰‹æ•°æ–™æŽ§é™¤å¾Œã®ãƒ—ロダクト価格。純売上高。
transaction_idstr購入や更新ãªã©ã®ãƒˆãƒ©ãƒ³ã‚¶ã‚¯ã‚·ãƒ§ãƒ³ã®ä¸€æ„ã®è­˜åˆ¥å­ã€‚
original_transaction_idstr最åˆã®è³¼å…¥ã®ãƒˆãƒ©ãƒ³ã‚¶ã‚¯ã‚·ãƒ§ãƒ³è­˜åˆ¥å­ã€‚
purchase_dateISO 8601 dateãƒ—ãƒ­ãƒ€ã‚¯ãƒˆè³¼å…¥ã®æ—¥æ™‚。
original_purchase_dateISO 8601 date最åˆã®è³¼å…¥ã®æ—¥æ™‚。
environmentstrSandbox ã¾ãŸã¯ Production ã®ã„ãšã‚Œã‹ã€‚
vendor_product_idstrApple App Storeã€Google Play Storeã€ã¾ãŸã¯Stripeã®ãƒ—ロダクトID。
base_plan_idstrGoogle Play Storeã®ãƒ™ãƒ¼ã‚¹ãƒ—ランIDã¾ãŸã¯Stripeã®ä¾¡æ ¼ID。
event_datetimeISO 8601 dateã‚¤ãƒ™ãƒ³ãƒˆã®æ—¥æ™‚。
storestrapp_store ã¾ãŸã¯ play_store ã®ã„ãšã‚Œã‹ã€‚
trial_durationstrãƒˆãƒ©ã‚¤ã‚¢ãƒ«æœŸé–“ã®æ—¥æ•°ã€‚†daysâ€å½¢å¼ã§é€ä¿¡ã•れã¾ã™ï¼ˆä¾‹ï¼šã€Œ7 daysã€ï¼‰ã€‚
cancellation_reasonstr

ユーザーãŒã‚µãƒ–スクリプションをキャンセルã—ãŸç†ç”±ã€‚

以下ã®ã„ãšã‚Œã‹ã«ãªã‚Šã¾ã™

iOS & Android

voluntarily_cancelled, billing_error, refund

iOS

price_increase, product_was_not_available, unknown

Android

new_subscription_replace, cancelled_by_developer

subscription_expires_atISO 8601 dateã‚µãƒ–ã‚¹ã‚¯ãƒªãƒ—ã‚·ãƒ§ãƒ³ã®æœ‰åŠ¹æœŸé™ã€‚通常ã¯å°†æ¥ã®æ—¥æ™‚。
consecutive_paymentsintユーザーãŒä¸­æ–­ãªãサブスクリプションを継続ã—ã¦ã„る期間数。ç¾åœ¨ã®æœŸé–“ã‚’å«ã¿ã¾ã™ã€‚
rate_after_first_yearbool1年間継続ã—ã¦æ›´æ–°ã•れãŸå¾Œã€ã‚µãƒ–スクリプションãŒå¼•ã下ã’ã‚‰ã‚ŒãŸæ‰‹æ•°æ–™çŽ‡ï¼ˆé€šå¸¸15%)ã®å¯¾è±¡ã¨ãªã‚‹ã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値。手数料率ã¯ãƒ—ログラムã®é©æ ¼æ€§ã‚„国ã«ã‚ˆã£ã¦ç•°ãªã‚Šã¾ã™ã€‚詳細ã¯ã‚¹ãƒˆã‚¢ã®æ‰‹æ•°æ–™ã¨ç¨Žé‡‘ã‚’ã”覧ãã ã•ã„。
promotional_offer_idstrAdapty ダッシュボードã®ãƒ—ロダクトセクションã«è¨˜è¼‰ã•れã¦ã„るプロモーションオファーã®ID
store_offer_categorystrintroductory ã¾ãŸã¯ promotional ã®ã„ãšã‚Œã‹ã€‚
store_offer_discount_typestrfree_trialã€pay_as_you_goã€ã¾ãŸã¯ pay_up_front ã®ã„ãšã‚Œã‹ã€‚
paywall_namestrトランザクションãŒç™ºç”Ÿã—ãŸãƒšã‚¤ã‚¦ã‚©ãƒ¼ãƒ«ã®åå‰ã€‚
paywall_revisionintトランザクションãŒç™ºç”Ÿã—ãŸãƒšã‚¤ã‚¦ã‚©ãƒ¼ãƒ«ã®ãƒªãƒ“ジョン。値ã¯1ã«è¨­å®šã•れã¾ã™ã€‚
developer_idstrトランザクションãŒç™ºç”Ÿã—ãŸãƒ—レースメントã®ãƒ‡ãƒ™ãƒ­ãƒƒãƒ‘ー(SDK)ID。
ab_test_namestrトランザクションãŒç™ºç”Ÿã—ãŸA/B テストã®åå‰ã€‚
ab_test_revisionintトランザクションãŒç™ºç”Ÿã—ãŸA/B テストã®ãƒªãƒ“ジョン。値ã¯1ã«è¨­å®šã•れã¾ã™ã€‚
cohort_namestrプロファイルãŒå±žã™ã‚‹ã‚ªãƒ¼ãƒ‡ã‚£ã‚¨ãƒ³ã‚¹ã®åå‰ã€‚
profile_event_iduuidé‡è¤‡æŽ’除ã«ä½¿ç”¨ã§ãる一æ„ã®ã‚¤ãƒ™ãƒ³ãƒˆID。
store_countrystrストアã‹ã‚‰é€ä¿¡ã•れãŸå›½æƒ…報。
profile_ip_addressstrプロファイルã®IPアドレス(IPv4ã¾ãŸã¯IPv6。IPv4ãŒåˆ©ç”¨å¯èƒ½ãªå ´åˆã¯å„ªå…ˆã•れã¾ã™ï¼‰ã€‚デãƒã‚¤ã‚¹ã®IPãŒå¤‰æ›´ã•れるãŸã³ã«æ›´æ–°ã•れã¾ã™ã€‚
profile_countrystrプロファイルã®IPã‚’ã‚‚ã¨ã«AdaptyãŒåˆ¤å®šã—ãŸå›½ã€‚
profile_total_revenue_usdfloatプロファイルã®ç´¯è¨ˆå£²ä¸Šé«˜ï¼ˆè¿”金分をå«ã‚€ï¼‰ã€‚
variation_iduuid購入ãŒè¡Œã‚れãŸãƒšã‚¤ã‚¦ã‚©ãƒ¼ãƒ«ã®ä¸€æ„ã®ID。
access_level_idstr有料アクセスレベルã®ID
is_activeboolãƒ—ãƒ­ãƒ•ã‚¡ã‚¤ãƒ«ã®æœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ãƒ¬ãƒ™ãƒ«ãŒæœ‰åйã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値。
will_renewboolæœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ãƒ¬ãƒ™ãƒ«ãŒæ›´æ–°ã•れるã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値。
is_refundboolトランザクションãŒè¿”金済ã¿ã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値。
is_lifetimeboolæœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ãƒ¬ãƒ™ãƒ«ãŒæ°¸ç¶šã‚¢ã‚¯ã‚»ã‚¹ã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値。
is_in_grace_periodboolプロファイルãŒã‚°ãƒ¬ãƒ¼ã‚¹æœŸé–“中ã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値。
starts_atISO 8601 dateユーザーã¸ã®æœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ãƒ¬ãƒ™ãƒ«ã®é–‹å§‹æ—¥æ™‚。
renewed_atISO 8601 dateæœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ãŒæ›´æ–°ã•れる日時。
expires_atISO 8601 dateæœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ã®æœ‰åŠ¹æœŸé™ã®æ—¥æ™‚。
activated_atISO 8601 dateæœ‰æ–™ã‚¢ã‚¯ã‚»ã‚¹ãŒæœ‰åŠ¹åŒ–ã•ã‚ŒãŸæ—¥æ™‚。
billing_issue_detected_atISO 8601 date請求å•題ãŒç™ºç”Ÿã—ãŸæ—¥æ™‚。
profile_has_access_levelBoolプロファイルã«ã‚¢ã‚¯ãƒ†ã‚£ãƒ–ãªã‚¢ã‚¯ã‚»ã‚¹ãƒ¬ãƒ™ãƒ«ãŒã‚ã‚‹ã‹ã©ã†ã‹ã‚’示ã™ãƒ–ール値(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_purchaseprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_renewedprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
subscription_cancelledcancellation_reason, trial_duration
trial_startedsubscription_expires_at, trial_duration
trial_convertedprice_usd, proceeds_usd, subscription_expires_at, consecutive_payments, rate_after_first_year, trial_duration
trial_cancelledcancellation_reason, trial_duration
non_subscription_purchaseprice_usd, proceeds_usd
billing_issue_detectedsubscription_expires_at, trial_duration
entered_grace_periodsubscription_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ãŒæ›´æ–°ã•れã¾ã™ã€‚

ÿÿÿÿ