サブスクリプションデータの管理

警告:

Adjustは新規顧客のサブスクリプションの記録を終了しました。すでにサブスクリプションの記録を設定している場合は、専任のアカウントマネージャーまたは support@adjust.comまでお問い合わせください。

集計されたサブスクリプションデータは、Datascapeで確認できます。ユーザーレベルのデータを分析するには、ローデータエクスポートを設定してください。

ここでは、サブスクリプションイベントの管理方法と、コールバックおよびクラウドストレージアップロードの設定方法について説明します。

サブスクリプションイベント

Adjustでは、7つの主要なサブスクリプションイベントを計測できます。各サブスクリプションイベントにサブタイプを使用することで、ユーザーデータに関するより詳細なインサイトを得ることが可能です。

サブスクリプションイベント	説明
activation（有効化）	ユーザーがサブスクリプション製品を初めて有効化。
first_conversion（初回コンバージョン）	無料トライアルまたは無料特典終了時に、ユーザーがサブスクリプションを解約せず、登録ユーザーへのコンバージョンに至る。
entered_billing_retry（請求リトライ開始）	トライアル終了時に解約されず（ユーザーが製品のサブスクリプションを中止しなかった）、請求にも問題がない場合、サブスクリプションイベントは次のいずれかになります：converted_trial、converted_offer、renewed_subscription
renewal（更新）	ユーザーが正常にサブスクリプションを更新。
cancellation（キャンセル）	ユーザーがサブスクリプションを解約したか、請求リトライ更新に失敗したため、サブスクリプション期間の終わりにトランザクションが更新されない。
renewal_from_billing_retry（請求リトライ更新）	請求の問題が解決された後、ユーザーが正常にトランザクションを更新。
reactivation（再有効化）	トライアル、オファー、サブスクリプションで登録したユーザーが、解約した後に再有効化。

サブスクリプションイベントのサブタイプ

サブスクリプションイベント	サブスクリプションイベントのサブタイプ	説明
activation	`initial_subscription`	ユーザーがアプリ内で初めての（有料の）サブスクリプションをトリガー。
	`initial_trial`	ユーザーがアプリ内の最初の無料トライアルをトリガー。
	`initial_offer`	ユーザーがアプリ内の最初の（有料の）オファーを割引価格でトリガー。
first_conversion	`converted_trial`	ユーザーが無料トライアル終了時にサブスクリプションをキャンセルしなかったため、サブスクリプション登録ユーザーにコンバージョンされた。
first_conversion	`converted_offer`	ユーザーが最初の有料オファーが終了したときにサブスクリプションをキャンセルしなかったため、全額課金サブスクリプション登録ユーザーにコンバージョンされた。
entered_billing_retry	`trial_in_retry`	トライアルの有効期限が切れたが、請求の問題で更新に失敗。例：無料トライアル期間が終了したときにユーザーがキャンセルしなかったが、支払い元に問題があったために請求できなかった場合。
	`offer_in_retry`	オファーの有効期限が切れたが、請求の問題で更新に失敗。例：オファー期間が終了したときにユーザーがキャンセルしなかったが、支払い元に問題があったために請求できなかった場合。
	`subscription_in_retry`	サブスクリプションの有効期限が切れたが、請求の問題で更新に失敗。例：無料サブスクリプション期間が終了したときにユーザーがキャンセルしなかったが、支払い元に問題があったために請求できなかった場合。
renewal	`renewed_subscription`	サブスクリプション更新に成功。
cancellation	`failed_trial`	トライアル期間終了時にトライアルが更新されなかった。
	`failed_offer`	最初の有料オファーが、オファー期間終了時に更新されなかった。
	`failed_subscription`	サブスクリプション期間の終了時にサブスクリプションが更新されなかった。
	`failed_trial_from_retry`	請求リトライ失敗後にトライアルがコンバージョンされていない。
	`failed_offer_from_retry`	請求リトライ失敗後にオファーがコンバージョンされていない。
	`failed_subscription_from_retry`	請求リトライ失敗後にサブスクリプションが更新されていない。
renewal_from_billing_retry	`converted_trial_from_retry`	トライアルでの請求リトライが成功し、トライアルがコンバージョンされた。
	`converted_offer_from_retry`	オファーでの請求リトライが成功し、オファーがコンバージョンされた。
	`renewed_subscription_from_retry`	サブスクリプションでの請求リトライが成功し、サブスクリプションが更新された。
reactivation	`reactivated_subscription`	トライアル、オファー、サブスクリプションで登録したユーザーが、解約した後に再有効化。

サブスクリプションコールバックを設定する

コールバックを使用することで、Adjustがイベントを記録後、ユーザーレベルのデータを直接かつリアルタイムにサーバーに送信できます。

Adjustは以下のサブスクリプションイベントを自動的に記録します。

サブスクリプションの有効化
サブスクリプションの初回コンバージョン
サブスクリプションの請求リトライ開始
サブスクリプションの更新
サブスクリプション解約
サブスクリプションの請求リトライ更新
サブスクリプションの再有効化

コールバックに {subscription_event_subtype}プレースホルダーを含めると、各サブスクリプションイベントのサブタイプを受信することができます。これにより、ユーザーデータに関する優れたインサイトが得られます。

サブスクリプションプレースホルダー

ユーザーの行動をより詳細に把握するために、次のプレースホルダーをコールバックに追加できます。

プレースホルダー	説明	内容とサンプル値
`{subscription_event_type}`	7つのイベントタイプのうち、該当するイベントタイプ	activation first_conversion renewal
`{subscription_event_subtype}`	詳細は、サブスクリプションイベントのサブタイプ値の表をご覧ください	initial_subscription failed_trial renewed_subscription
`{subscription_purchased_at}`	有効な購入のUnixタイムスタンプ	1571608922
`{subscription_expiration_time}`	有効なサブスクリプションの有効期限を示すUnixタイムスタンプ。過去のデータでも未来のデータも該当します。	1571608922
`{subscription_cancelled_at}`	サブスクリプションが無効となる時点を示すUnixタイムスタンプ。expiration_timeより後のタイムスタンプとなることはありません。サブスクリプションのトランザクションが失敗し解決できない場合は、失敗したトランザクションのexpiration_timeを返します。expiration_timeプレースホルダーには値が返されません。	1571608922
`{subscription_transaction_id}`	有効なトランザクションの値。トランザクションが失敗した場合、値は返されません。課金に問題がある場合は、現在のトランザクションIDが返されます。	230000687036600
`{subscription_original_transaction_id}`	プロダクトサブスクリプションチェーンの最初のトランザクションID	230000687036600
`{subscription_expired_transaction_id}`	前回の有効なトランザクションID。最初のトランザクションの場合、空の値が返されます。失敗したトランザクションの場合、前回の有効なトランザクションIDが返されます。	230000687036600
`{subscription_environment}`	サブスクリプションの購入が発生した環境	sandbox production
`{subscription_product_id}`	アプリ内のサブスクリプションプロダクトタイプ	com.product.id
`{subscription_sales_region}`	Apple ストアアカウントの登録場所の地域コード。Googleの地域コードはデバイスの物理的な位置に基づいています。	us
`{subscription_store}`	サブスクリプション購入が発生したストア	appleappstore googleplaystore

グローバルコールバック

グローバルコールバックは、Adjustが記録する全てのアクティビティのデータポイントの全リストを提供します。

AppViewですでにグローバルコールバックを設定している場合は、サブスクリプションイベントのプレースホルダーを既存のコールバックURLに追加してください。

グローバルコールバックURLを作成する方法については、Adjustが提供するこちらのガイドをご覧ください。または、以下のテンプレートと例を使用してコールバックURLを編集することもできます。

例

http://callbackserver.com/adjust_global?app_id={app_id}&app_name={app_name}&app_name_dashboard={app_name_dashboard}&app_version={app_version}&app_version_raw={app_version_raw}&app_version_short={app_version_short}&store={store}&tracker={link_token}&tracker_name={link_name}&first_tracker={first_link}&last_tracker={last_link}&last_tracker_name={last_link_name}&outdated_tracker={outdated_link}&network_name={network_name}&campaign_name={campaign_name}&adgroup_name={adgroup_name}&creative_name={creative_name}&impression_based={impression_based}&is_organic={is_organic}&rejection_reason={rejection_reason}&click_referer={click_referer}&click_time={click_time}&click_time_hour={click_time_hour}&impression_time={impression_time}&impression_time_hour={impression_time_hour}&conversion_duration={conversion_duration}&engagement_time={engagement_time}&engagement_time_hour={engagement_time_hour}&installed_at={installed_at}&installed_at_hour={installed_at_hour}&install_finish_time={install_finish_time}&install_begin_time={install_begin_time}&referral_time={referral_time}&created_at={created_at}&created_at_milli={created_at_milli}&created_at_hour={created_at_hour}&reattributed_at={reattributed_at}&reattributed_at_hour={reattributed_at_hour}&attribution_updated_at={attribution_updated_at}&time_to_uninstall={time_to_uninstall}&idfa={idfa}&idfv={idfv}&gps_adid={gps_adid}&android_id={android_id}&adid={adid}&activity_kind={activity_kind}&revenue={revenue}&currency={currency}&subscription_event={subscription_event_type}&subscription_event_subtype={subscription_event_subtype}&product_id={subscription_product_id}&sales_region={subscription_sales_region}&transaction_id={subscription_transaction_id}&expired_transaction_id={subscription_expired_transaction_id}&original_transaction_id={subscription_original_transaction_id}&subscription_store={subscription_store}&subscription_start={subscription_purchased_at}&subscription_end={subscription_expiration_time}&subscription_cancelled={subscription_cancelled_at}&environment={subscription_environment}&callback_parameter={publisher_parameters}

サブスクリプションコールバック

サブスクリプションコールバックは、サブスクリプションベースのイベント7つ全てに対して単一のコールバックを送信します。

サブスクリプションコールバックURLの例

http://callbackserver.com/adjust_subscription?app_id={app_id}&app_name={app_name}&app_name_dashboard={app_name_dashboard}&app_version={app_version}&app_version_raw={app_version_raw}&app_version_short={app_version_short}&store={store}&tracker={link_token}&tracker_name={link_name}&first_tracker={first_link}&last_tracker={last_link}&last_tracker_name={last_link_name}&outdated_tracker={outdated_link}&network_name={network_name}&campaign_name={campaign_name}&adgroup_name={adgroup_name}&creative_name={creative_name}&impression_based={impression_based}&is_organic={is_organic}&rejection_reason={rejection_reason}&click_referer={click_referer}&click_time={click_time}&click_time_hour={click_time_hour}&impression_time={impression_time}&impression_time_hour={impression_time_hour}&conversion_duration={conversion_duration}&engagement_time={engagement_time}&engagement_time_hour={engagement_time_hour}&installed_at={installed_at}&installed_at_hour={installed_at_hour}&install_finish_time={install_finish_time}&install_begin_time={install_begin_time}&referral_time={referral_time}&created_at={created_at}&created_at_milli={created_at_milli}&created_at_hour={created_at_hour}&reattributed_at={reattributed_at}&reattributed_at_hour={reattributed_at_hour}&attribution_updated_at={attribution_updated_at}&time_to_uninstall={time_to_uninstall}&idfa={idfa}&idfv={idfv}&gps_adid={gps_adid}&android_id={android_id}&adid={adid}&revenue={revenue}&currency={currency}&subscription_event={subscription_event_type}&subscription_event_subtype={subscription_event_subtype}&subscription_product_id={subscription_product_id}&subscription_sales_region={subscription_sales_region}&subscription_transaction_id={subscription_transaction_id}&subscription_original_transaction_id={subscription_original_transaction_id}&subscription_store={subscription_store}&subscription_purchased_at={subscription_purchased_at}&subscription_expiration_time={subscription_expiration_time}&subscription_environment={subscription_environment}&callback_parameter={publisher_parameters}

クラウドストレージアップロードの設定

クラウドストレージアップロードでは、サブスクリプションイベントのローユーザーデータを1時間ごとに自動的にクラウドストレージにエクスポートできます。

Adjustがサポートしているサブスクリプションイベントの全リストはこちらをご覧ください。

注意:

AppViewでAmazon S3またはGoogle Cloud Storageをすでに設定している場合は、Adjustでサブスクリプションを記録すると、サブスクリプションイベントのクラウドストレージアップロードが自動的に受信されます。これらの特定のデータポイントを表示するには、サブスクリプション関連のプレースホルダーをCSVの定義に追加する必要があります。

設定を行うには、CSVの定義に含めるサブスクリプションのプレースホルダーを追加します。CSVの定義の形式についてはこちらをご覧ください。