Skip to content
AppDues
Log in
Contact salesSign up

Send in-app purchase events to Airship

This integration passes subscription lifecycle events into Airship as Custom Events.

That lets you build Airship Journeys and Automations that respond to what a subscriber actually does — start a trial, convert, renew, cancel, or hit a billing problem — instead of relying on fixed schedules.

Events you can connect

The integration forwards the following subscription events. Each event has a precise meaning, and the distinctions matter when you choose a trigger.

  • Initial Purchase — the first purchase of an auto-renewing subscription that has no free trial.
  • Trial Started — a free trial begins on an auto-renewing subscription.
  • Trial Converted — a free trial becomes a normal paid period.
  • Trial Cancelled — the user turns off renewals while still inside the free trial.
  • Renewal — the subscription renews, or the user repurchases after a lapse.
  • Cancellation — the user turns off renewals during the normal paid period.
  • Uncancellation — the user re-enables auto-renew.
  • Non Subscription Purchase — any purchase that is not an auto-renewing subscription.
  • Billing Issues — a charge attempt failed; with a grace period enabled, this does not necessarily mean the subscription has expired.
  • Expiration — the subscription has ended and access should be removed.
  • Product Change — the user changed the subscription product; the new product is not necessarily active immediately.

For product changes, the timing of updates, downgrades, and crossgrades is covered in the subscription management documentation.

Choosing the right trigger

A few event pairs are easy to confuse. Use this checklist before you wire a message:

  1. Trial ending vs paid subscription ending. Trial Cancelled fires when renewals are switched off during the trial. Cancellation fires when renewals are switched off during the paid period. If your message says "your trial ends soon," trigger it from Trial Cancelled, not Cancellation.
  2. Payment trouble vs lost access. Billing Issues means a charge attempt failed. Expiration means access should be removed. With a grace period, a Billing Issues event can arrive while the subscriber still has access, so a dunning message is appropriate; an access-removal message is not.
  3. New subscriber vs returning subscriber. Initial Purchase covers a first auto-renewing purchase with no trial. Renewal also covers a repurchase after a lapse, so a "welcome back" variant belongs on Renewal, not Initial Purchase.
  4. Trial start vs trial conversion. Trial Started marks the beginning of the free trial; Trial Converted marks the move to a paid period. Use them for onboarding and confirmation messages respectively.
  5. Product change vs immediate switch. Product Change tells you the user changed products, but the new subscription is not necessarily in effect right away. Avoid messaging that assumes instant access to the new product.

Worked example: a trial win-back journey

Suppose a subscriber starts a free trial and then turns off renewals before the trial ends. The event you receive is Trial Cancelled. A useful Airship journey might:

  • Send an in-app or push message acknowledging the decision and restating the value of the paid plan.
  • Offer a clear path to re-enable auto-renew, which would later surface as an Uncancellation event if the user acts.
  • If the trial runs out without a conversion, the subscription eventually reaches Expiration, at which point an access-removal message is appropriate.

Contrast that with a subscriber in the paid period who turns off renewals: that is Cancellation, and the message should focus on what changes at the end of the paid term rather than on trial timing. Keeping these two journeys separate prevents the common mistake of sending trial language to paying subscribers.

How the connection works

The integration sends the events above to Airship as Custom Events. Airship then uses those events as triggers inside Journeys and Automations. Setup steps and configuration details are maintained in the Airship integration documentation; the integration is described as no-code, connecting real-time events and revenue data to your tools.

ConfigureTargetTest

Frequently asked questions

What is the difference between Trial Cancelled and Cancellation?

Trial Cancelled fires when a user turns off renewals during a free trial. Cancellation fires when a user turns off renewals during the normal paid period. They are separate events, so you can send trial-specific messaging without accidentally targeting paying subscribers.

Does a Billing Issues event mean the subscriber has lost access?

Not necessarily. Billing Issues means a charge attempt failed. If a grace period is enabled, the subscription has not expired at that point. Expiration is the separate event that indicates the subscription has ended and access should be removed.

If I receive a Product Change event, is the new subscription active immediately?

No. Product Change indicates the user changed the subscription product, but the new subscription is not necessarily in effect right away. The subscription management documentation covers how updates, downgrades, and crossgrades are timed.

How does Airship use the events the integration sends?

The integration sends the events to Airship as Custom Events. Airship can then use them as triggers for Journeys and Automations, so messages are driven by actual purchase and trial behavior rather than a fixed schedule.