Blog/The developer journey

The developer journey, in video: a map

Six stages, six jobs. A video that tries to do all of them does none well. Here is the map, and how to use it.

Kevin Blanco··6 min read·Every stage

The short answer

Developers move through six stages: awareness, evaluation, activation, adoption, retention and advocacy. Each stage needs a different video, a different call to action and a different number. One video can't serve all six, so decide the stage before you decide the idea, and attach a metric to each.

01

One video, six jobs

Teams often ask a single video to find strangers, convince evaluators, onboard new users and delight customers, all at once. It does none of them well.

A developer's relationship with your product has stages, and the right video changes at each one. The viewer's question changes, so the picture, the length, the ask and the number all change with it.

FigureSix stages, six jobs. Each gets its own post in this series.

02

The map

StageThe viewer asksThe videoThe call to actionThe number
AwarenessIs this for me?A problem they feel, shown solved fastWatch the next one, subscribeQualified views
EvaluationWill it work for my case?A real use case and one honest limitTry the sandbox, read the quickstartClicks to docs or sandbox
ActivationCan I get it running?One task, start to first successRun the snippetTime to first success
AdoptionWhat else can I do with it?Use cases by role, in a series with a pathTry the next featureWeekly active developers
RetentionIs it worth staying?Releases, advanced patterns, migrationsRead the upgrade notesTickets on covered topics
AdvocacyWould I recommend it?Community builds, talks, customer engineersShare your buildMentions and referrals

03

How to use the map

  1. 1

    Pick the stage

    Before the idea. Which stage is this video for?

  2. 2

    Name the viewer

    One sentence: who they are and what they're stuck on.

  3. 3

    Write the ask first

    The call to action sets what the video has to do.

  4. 4

    Choose the number

    The one metric you'll check, decided before you record.

The order matters. Teams that start from the idea tend to end up with videos nobody can place on the map.

04

A post for each stage

FAQ

Questions people ask

What are the stages of the developer journey?

We use six: awareness, evaluation, activation, adoption, retention and advocacy. Other frameworks name them differently, but the jobs are the same: be found, be believed, get to a first success, give reasons to stay, keep and grow usage, and earn recommendations.

Why can't one video serve every stage?

The viewer's question changes at each stage, and so do the right length, the right proof and the right call to action. A video built for a stranger will bore a customer, and a video built for a customer will lose a stranger.

Which stage should I start with?

Start where your biggest gap is. If developers sign up and don't get anything working, start with activation. If nobody finds you, start with awareness. The audit post in this series helps you find the gap.

What metric goes with each stage?

Qualified views for awareness, clicks to docs or the sandbox for evaluation, time to first success for activation, weekly active developers for adoption, tickets on covered topics for retention, and mentions and referrals for advocacy.

How long until developer video shows results?

It depends on the stage. Activation tends to show first, often within a few weeks. Advocacy is the slowest, usually a quarter or more. These are rules of thumb, not benchmarks.

DevReel

How we do it at DevReel

Every video we make starts with a stage, a viewer and a number. The stage decides the idea, the ask and the length, and the number decides whether the video was worth making.

Cloudinary's videos usually average around 400 views. Ours passed 9,000 in the first week. For ngrok, watch hours tripled and subscribers went from about 450 to over 800 in the first week.

Cloudinary views

9,000+

in the first week, against a usual ~400

ngrok watch hours

3×

subscribers from ~450 to 800+ in the first week

Now the hard part

Tell us which stage of the journey your videos miss, and we'll plan the one that fills it.

Kevin Blanco founded DevReel. He has made 500+ developer-tool videos and spoken at 80+ developer conferences.

Keep reading