A DevRel Approach to Prioritising Events

Jan Schenk (he/him) - Dec 10 '21 - - Dev Community

My good friend Floor wrote an article how to source events recently. Read that first if you don't yet have a good list of events that you're interested in.

TL;DR

If your role includes decision-making on industry or community events in DevRel or Dev Marketing, this article can help you go through your own lists of events and rate them against each other, so you will be able to include a data-driven approach when deciding on contributing (sponsoring, speaking, volunteering, participating) and be less biased through previous participation or sparkly advertising. This process takes a heavy stance on diversity, equity and inclusion and so should you.

Objective

This is meant as a step-by-step guide to automate a data-driven assessment of events for sponsoring, participation, contribution and speaking. The event list can be dynamic and gathered through a form request tool, or imported from existing assets like a gSheet, Excel or Airtable. At the end of this guide, you'll be able to inspect a list of individually sourced events with supporting data for prioritising your time and budget. Whether you want to pick the top five or the best 30 that fit your (budget|focus topics) doesn't matter.

Disclaimer

A) This full process is work in progress.
B) The weight of different factors that heavily influence the outcome in form of a Rating is totally up to your customisation. We don't suggest by any means to keep the example weighting as is, but trial and error to best reflect your company's values and preferences. This customisation requires a certain level of programming knowledge as you will have to modify and manipulate arrays, variables, loops and conditions. The example weighting in the code is not what we at Postman DevRel are actually using.

The Step-by-Step Setup Guide

A brief version of this guide can be found on GitHub.

Overview

  1. 💿 Decide which data source to use
  2. 👦👦 Clone the template base on Airtable
  3. 📝 Create a Typeform
  4. 🔑 Fetch your Airtable API Key
  5. 🔌 Connect Typeform and Airtable
  6. 🍴 Fork a Postman collection
  7. 🚪 Set up authentication in Postman
  8. 💨 Set up Airtable variables in Postman
  9. 💾 Save everything
  10. 🏃‍♀️ Run the collection
  11. 🔁 Refine things

1. Defining a data source

In our case, it will be a Typeform request form to collect all relevant data, as it is most flexible and shareable as well as able to interact with Airtable through an existing Connect procedure (although it doesn't have the best user experience).
Alternatively you could decide to just import data to Airtable, but since this should be an ongoing business process, a form has been the better choice for us. You could still initially start with data from existing sheets. See import options in Airtable. Or manually fill the Airtable base.

2. Clone this Airtable base

Into your own workspace on Airtable.
Screenshot of an Airtable base pointing the viewer towards where to find the "Copy base" action on the top right of the web page
This base contains some incomplete and also outdated sample data. Replace this sample data as soon as possible with your own data.

3. Set up the request form like this Typeform.

My apologies, there's currently no way to share a template of this with you. Field names should ideally correspond to (but don't have to be the exact same name as) Airtable columns.
Screenshot of a Create screen at Typeform, showing all the form fields and their types
I suggest to start with a smaller set of questions (begin with 3 or 4), and not to add custom questions just yet. Do that once you implemented the whole template process and feel confident enough to also adapt the code behind. Otherwise you'll end up with a bunch of answers that you don't make use of.

4. Generate and copy your Airtable API key from your account settings

Head over to your Account page.
Screenshot of the section of the page where to find your account information, top right
If you haven't done so before, generate an API key. It only takes the blink of an eye.
Screenshot of the "Generate API Key" dialogue on the main profile page of Airtable
And now copy that key to your clipboard.
Screenshot of the API Key section with a generated API Key

Leave that window open, you'll need the API Key in another step in this guide again.

5. Now you can connect Typeform with Airtable.

All of the form replies will go into Airtable. There's just one caveat. The process of connecting the two is somewhat awkward, and updating an existing connection isn't possible. You can't even reload while setting up. But see yourself.
Screenshot of the Connect tab in Typeform with a filtered view on the Airtable integration, showing a connect button.
Now select Connect, and Typeform will ask you to log in to Airtable and provide your API Key.
After that, your good to go and match questions with fields in Airtable.
Screenshot of the Typeform integration dialogue how to connect an Airtable table, with the left side (values from Typeform) expanded
Screenshot of the Typeform integration dialogue how to connect an Airtable table, with the left side (fields from Airtable) expanded
This process is why I mentioned to start with a few questions first. It looks fancy first, but turns out to be awkward. Beyond awkward. Once you run into a mismatch, you have to start over. From. The. Beginning.
And yes, you will run into mismatches. More than once. Twitter mention me (@jansche) if you don't.

Once you're done and activated the integration, data will feed into Airtable. Do a test run through answering all questions in your own form.

6. It's Postman time!

Create a free Postman account if you haven't and then fork this Postman collection into your own workspace.
Screenshot of the context menu of a collection in Postman, highlighting the Create a Fork item
Screenshot of the forking dialogue in the Postman app

7. Use your Airtable API Key in Postman.

For now, it would be ok to just paste it where it says {{APIKey}} in the request builder (which is the main view of the collection). Open the request builder by selecting the container named "Sponsoring Viability" in the left hand collection view.
Screenshot of the Auth section of a collection in Postman, with the token being a placeholder
In general, you should store API keys in a dedicated environment, and, if you're going to share your environment, also only as "Current Value".

8. In the request builder, head over to the Variables tab.

As you will need to update "AirtableId" and Table variables with your Airtable ID from the URL and the name of your table.
Screenshot of the browser's URL bar, with the relevant portion of the URL selected. It's the one starting with the letters a, p, p.
Screenshot of the tables tab in Airtable, with the table name being selected, saying Event Suggestions
Screenshot of the Postman app with the Variables tab of a collection open, showing the TableId and the Table variables having the same value as the ones shown in the above screenshots.
You can leave the variable Event Name as is. If you're batch processing all entries in Airtable, setting this variable initially doesn't do much.

9. SAVE.

You have to select 💾 or Control-S/Command-S in the request builder to make these changes take effect.

10. Up next is to run the collection in Runner.

YAY! Cross your fingers. Buckle up. If everything went ok, we'll see some results being magically populated in Airtable in a moment.
Screenshot of the section of the page where the Run button is located, next to the request URL field, between "Share" and "Save"
Select the Run button next to the request URL field, between "Share" and "💾".

11. We're done! Not quite yet.

There's still plenty to fine tune. But you got it working!

You can now go back and complete your request form, that probably only has a few questions on it. Make sure to re-connect with Airtable as in step 5.

Bonus points for taking a look into the "Calculate Rating Existing Event" request. All of the calculation is happening in the "Tests" section of this request.

Screenshot of the side navigation in the Postman app, showing which request to select, the "Calculate Rating Existing Event" request
Screenshot of the Tests section of a request in the Postman app

But that's a different story and will be covered in a separate article soon.

Happy rating, and don't forget to make this only one factor of your decision on contributing to an event or not.

Jan

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .