Playable Analytics Integration

Playable ads provide additional data points besides impressions and clicks. AppLovin enables you to track specific in-playable events such as when playables load, when users progress through challenges, when users complete experiences, and when users click call-to-action buttons.

When to Use Analytics

Integrate analytics into fully immersive playable experiences. Do not integrate analytics into shorter playable experiences such as:

• Playables with fewer than three interactions to complete
• Playables that redirect in less than five seconds from the first interaction

Implementation

Basic Usage

Wrap all analytics calls in a safety check:

if (typeof window.ALPlayableAnalytics != 'undefined') {
  window.ALPlayableAnalytics.trackEvent('«event-name»');
}

Important Notes

• Always wrap analytics calls: The safety check prevents errors when you test locally or serve ads on other networks.
• Do not define ALPlayableAnalytics: The SDK automatically defines the ALPlayableAnalytics object in its context.
• Only predefined events work: AppLovin does not track custom events.

Available Events

Loading and Display Events

• LOADING: The playable creative begins loading.
• LOADED: The playable creative finishes loading.
• DISPLAYED: The playable creative displays to the user.

Challenge Events

• CHALLENGE_STARTED: The user begins a challenge within the playable.
• CHALLENGE_FAILED: The user fails a challenge.
• CHALLENGE_RETRY: The user retries a failed challenge.
• CHALLENGE_PASS_25: The user reaches 25% completion of a challenge.
• CHALLENGE_PASS_50: The user reaches 50% completion of a challenge.
• CHALLENGE_PASS_75: The user reaches 75% completion of a challenge.
• CHALLENGE_SOLVED: The user successfully completes a challenge.

Completion and Conversion Events

• COMPLETED: The user completes the entire playable experience.
• CTA_CLICKED: The user clicks the call-to-action button.
• ENDCARD_SHOWN: The end card displays to the user.

Key Metrics You Can Track

Performance Metrics

• Load time and success rates (LOADING, LOADED)
• Display performance (DISPLAYED)

Engagement Metrics

• Challenge engagement rates (CHALLENGE_STARTED)
• Challenge progression (CHALLENGE_PASS_25, CHALLENGE_PASS_50, CHALLENGE_PASS_75)
• Completion rates (COMPLETED, CHALLENGE_SOLVED)

Conversion Metrics

• Call-to-action performance (CTA_CLICKED)
• End card effectiveness (ENDCARD_SHOWN)

Challenge Performance

• Success versus failure rates (CHALLENGE_SOLVED versus CHALLENGE_FAILED)
• Retry behavior (CHALLENGE_RETRY)
• Challenge difficulty optimization