Recommended ride-hailing app events

At a glance: Measure the quality of your users throughout their user journey by recording these suggested in-app events for your ride-hailing app.

InApp_Events_ride.png Ride-hailing

Ride-hailing has become very popular recently, especially in urban areas where most residents don't own a car. The typical events that we suggest recording are ride requests and bookings.

Recording events can help you determine:

  • How passengers and drivers interact
  • Countries where more people use your ride-hailing service
  • Metrics about price, rides, and ride distance

 Important!

  • Make sure to read the instructions for marketers about implementing in-app events.
  • To streamline the implementation process, use our In-app event generator. This tool includes all of the typical in-app events described in this article and lets you modify the events according to your business needs. Once complete, share the file with your developer.
  • For each recommended event included in this article, there are code samples for iOS, Android, and Unity developers.
  • Detailed instructions for your developer can be found in the AppsFlyer developer hub.

For more information about recording in-app events, see the Rich in-app events guide.

Flowchart_for_recommended_events_ride_hailing_app_user_journey

Recommended structures for predefined events

The following section provides a list of event structures that are typical to the ride-hailing vertical. Each structure includes a predefined event name and the suggested event parameters to use. Note that in-app events can include any event parameters that meet your business needs.

Complete registration (af_complete_registration)

Purpose

This event can help you:

  • Learn what sign-up method your users prefer
  • Understand how many users actually sign up after downloading and installing the app
  • See registration trends across countries to determine the countries whose users are most likely to use your app

Trigger

When the user completes the signup process

Event parameters

Name Description Example value
af_registration_method Platform or method through which the user signs up Facebook
country_code Country code (phone code) 66

Login (af_login)

Purpose

Understand the retention of your registered users

Trigger

When the user successfully logs in

Event parameters

Can be sent without any additional parameters

Add payment info (af_add_payment_info)

Purpose

Helps you categorize users. You can: 

  • Learn how long it takes a user to add their payment info
  • What payment methods are most popular, for example, credit card or eWallets 
  • Set up campaigns and collaborate with popular payment method providers

Trigger

When the user successfully adds payment info to their account

Event parameters

Name Description Example value
af_success Whether the payment method is successful true
credit_card_type Credit card type (optional) Visa, Mastercard
payment_method_type Type of payment method credit card, eWallet

Spent credits (af_spent_credits)

Purpose

The Ride booking completed event includes a parameter named credits_earned. This parameter logs the credits that a passenger earns for each ride. Passengers can trade credits for vouchers and discounts.

This event can help you:

  • See how many passenger trade credits for vouchers
  • See what sort of vouchers and discounts passengers prefer

Trigger 

When a passenger spends credits

Event parameters

Name Description Example value
af_content Type of voucher or discount Single movie ticket
credits_used How many credits used 1000
credits_remaining How many credits left in the account 2090
invoice_id

ID of the invoice that is created for spending credits

KO215123SD

Recommended structures for custom events

The following section provides a list of event structures that include custom event names and the suggested event parameters to use. Note that in-app events can include any event parameters that meet your business needs.

Ride booking requested (ride_booking_requested)

Purpose

This event can help you:

  • Learn about popular destinations
  • Learn about trends, where people ride to and from where
  • See the average distance of a ride
  • See what cities, regions, and countries most users come from

In addition, recording this event along with the other booking-related events can help you record successful transactions. Then, you can compare successful transactions with unsuccessful transactions. For example, you can see how many ride bookings are requested and how many ride bookings are completed or canceled.

Trigger 

When the passenger created a ride-booking request

Event parameters

Name Description Example value
af_price Quoted price for the ride 22.4
af_currency Currency SGD
af_destination_a Point of departure Plaza Singapura
af_destination_b Point of arrival Marina Bay Sands
distance Distance between the two destinations 5.2
af_content_type Type of transportation Taxi
payment_method_type Type of payment method credit card, eWallet
af_city City where the ride is booked Singapore
af_region Region where the ride is booked SFA
af_country Country where the ride is booked Singapore
order_id Order ID 135790

Ride booking confirmed (ride_booking_confirmed)

Purpose

This event can help you:

  • Learn who the most active drivers are
  • See what destinations are common among drivers
  • See the average and overall ride prices for each driver

In addition, recording this event along with the other three booking-related events can help you better understand driver activity. You can see, for example, which drivers confirm the most ride-booking requests, and which drivers choose short rides as opposed to long rides.

Trigger 

When the booking is accepted by a driver

Event parameters

Name Description Example value
af_price Quoted price for the ride 22.4
af_currency Currency SGD
af_destination_a Point of departure Plaza Singapura
af_destination_b Point of arrival Marina Bay Sands
distance Distance between the two destinations 5.2
af_content_type Type of transportation Taxi
driver_id ID of the driver who confirmed performing the ride 1706
payment_method_type Type of payment method credit card, eWallet
af_city City where the ride is booked Singapore
af_region Region where the ride is booked SFA
af_country Country where the ride is booked Singapore
af_order_id Order ID 135790

Ride booking canceled (ride_booking_canceled)

Purpose

This event can help you:

  • Log drivers or passengers that constantly cancel
  • Learn how many rides are canceled
  • Correlate cancellation rate with attributes such as price, destination, distance, and cities
  • Learn the reasons why a ride is canceled

Trigger 

When the booking is canceled

Event parameters

Name Description Example value
af_price Quoted price for the ride 22.4
af_currency Currency SGD
af_destination_a Point of departure Plaza Singapura
af_destination_b Point of arrival Marina Bay Sands
distance Distance between the two destinations 5.2
af_content_type Type of transportation Taxi
driver_id ID of the driver who confirmed the ride 1706
cancelation_reason Reason the ride is canceled price is too high, driver didn't show up, passenger didn't show up
payment_method_type Type of payment method credit card, eWallet
af_city City where the ride is booked Singapore
af_region Region where the ride is booked SFA
af_country Country where the ride is booked Singapore
order_id Order ID 135790
canceled_by Whether the ride is canceled by the passenger or driver Passenger

Ride booking completed (ride_booking_completed)

Purpose

This event can help you:

  • Learn about passenger spending and driver earnings
  • Correlate completed rides with attributes such as destination, distance, payment type, and driver ID
  • See the average and overall distance for drivers and passengers
  • Compare completed rides with canceled ones
  • Log and record the score of drivers

Trigger 

When the journey is complete

Event parameters

Name Description Example value
af_price Quoted price for the ride 22.4
af_currency Currency SGD
af_destination_a Point of departure Plaza Singapura
af_destination_b Point of arrival Marina Bay Sands
distance Distance between the two destinations 5.2
af_content_type Type of transportation Taxi
driver_id ID of the driver who confirmed performing the ride 1706
payment_method_type Type of payment method credit card, eWallet
af_city City where the ride is booked Singapore
af_region Region where the ride is booked SFA
af_country Country where the ride is booked Singapore
order_id Order ID 135790
credits_earned Credits that the passenger earned for completing a ride 248
Was this article helpful?