Subscription callbacks

Using callbacks, you can send user-level data directly to your servers—seconds after Adjust records the event.

Adjust automatically records the following subscription events:

  • Subscription activation
  • Subscription first conversion
  • Subscription entered billing retry
  • Subscription renewal
  • Subscription cancellation
  • Subscription renewal from billing retry
  • Subscription reactivation

When you include the {subscription_event_subtype} placeholder in your callbacks, you can receive subtypes for each subscription event. These offer greater insight into your user data. Read more on how to manage subscription data.

Recommended placeholders

Note:
If placeholder data is not available, it will be dropped from the callback.

Callback example

Callback URL with placeholdersUnencoded (Do not use as is)
Callback URL populated with values
https://mynetworkserver.com/mobile_attribution?gps_adid={gps_adid}&idfa={idfa}&tracker_name={link_name}&app_name={app_name}&activity_kind={activity_kind}&created_at={created_at}&reattributed_at={reattributed_at}&reattributed_at_hour={reattributed_at_hour}&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}

Other recommended placeholders

We also advise that you include the following placeholders in all callback URLs. These placeholders will ensure that you always receive basic information that you can use to identify the app, link, data point, and device to which the rest of your callback data belongs.

PlaceholderDescriptionExample
{gps_adid}Google Play Store advertising ID (Android only)38400000-8cf0-11bd-b23e-10b96e40000d
{idfa}ID for advertisers (iOS only)8C6CBCOD-5F43-4765-A6E6-84DFF3D24707
{idfv}ID for vendors (iOS only)CCB300A0-DE1B-4D48-BC7E-599E453B8DD4
{adid}Adjust device ID18546f6171f67e29d1cb983322ad1329
{tracker}Adjust link tokenabc123
{tracker_name}Current link name as defined in Campaign LabNetwork1%3A%3AChristmas%3A%3AReindeers%3A%3A320x70_en
{app_name}Name of the appMyApp
{activity_kind}This will allow you to determine the data point: impression, click, install, rejected install, rejected reattribution, session, reattribution, uninstall, reinstall, reattribution reinstall, updated attribution, in-app event, or ad spend (cost_updated)rejected_reattribution
{created_at}The timestamp for when the data point occurred1404214665