調査と計画は、あらゆるAPIプロジェクトの成功において極めて重要なステップです。APIの設計、開発、デプロイメントにおける様々な複雑さ、およびマーケティングと収益化に伴うビジネス慣行を分析することで、リスクを軽減し、成功の可能性を高めることができます。
Nordic APIsは、API開発の背後にあるテクノロジーから、API消費を取り巻くビジネスまで、APIに関するあらゆる情報とリソースを提供する主要な情報源の1つです。世界中の何千人ものAPI実務家を読者に持ち、Nordic APIsはAPI分野で最もよく知られたリソースの1つとなっています。
私は、Nordic APIsの編集長であるビル・ドアーフェルド氏と、APIプログラムの成功に関連する様々なトピックについて話す機会を得ました。私たちは、APIマーケティングの課題、APIの発見可能性を高める上でのAPI記述フォーマットの役割、テクニカルマーケターの台頭などについて語り合いました。
私たちの会話の全文は以下でお読みいただけます。
OpenAPIのようなAPI定義フォーマットは、API分野でその重要性を増し続けています。APIの開発にどのように役立ってきたかは知られていますが、API定義フォーマットはAPIのマーケティングにどのように役立ったと思いますか？
API記述フォーマットは非常に重要性を増し、APIのライフサイクル全体に大きな影響を与えています。これらは、APIを扱う多くの企業にとって、より確立された常識的なものになりつつあります。定義フォーマットは、APIの開発と消費により良い体験をもたらす「デザインファースト」思考を現実のものにしています。記述フォーマットを取り巻く補完的なツール作成も、その採用に役立っています。
記述フォーマットは、APIのアクセシビリティを高め、その結果、使いやすく、マーケティングしやすくなっています。ドキュメント生成、クライアントライブラリ、開発者キットなどの補完的なツールによって、無限の可能性を広げ、APIのプロモーションと採用を支援します。業界として、私たちがOpenAPI仕様に標準化されたことで、REST APIの世界で共通のコミュニケーション言語を持つことができるようになったことは素晴らしいことです。
定義はまた、APIをカタログでポータブルにし、あらゆるAPIの一元的なハブを作り出します。
APIをマーケティングする際、APIカタログについてよく耳にします。カタログはどれほど効果的ですか？開発者は実際にそれらを使用しますか、それとも昔ながらのGoogle検索に頼りますか？
カタログは重要性を増しています。ProgrammableWebのようなサイトは多くの注目を集めていることで知られており、APIを発見するための重要な手段となっています。公開APIをホストしている開発者から、ディレクトリに追加され、リードを獲得したという話を聞いたことがあります。カタログは実際にリード生成メカニズムであり、Web上での足跡を増やすための追加チャネルとして機能することが知られています。素晴らしい例の1つは、人気を集め、急速にAPIのWikipediaになりつつあるAPIs.guruです。
カタログは人間にとっては素晴らしいですが、機械可読ではありません。つまり、広範な人間向けのカタログでも、様々な検索エンジンへの移植性には問題があるでしょう。これはおそらく、Web APIに関連付けられたメタデータを持つことの最大の利点です。なぜなら、それによって検索アルゴリズムがクロールできるようになるからです。
APIは依然として手作業でディレクトリに追加されており、将来的には、より多くのAPIが様々なクロールアルゴリズムによって自動的にインデックスされることを願っています。
マーケティングはAPIのライフサイクルのどの段階で考慮すべきですか？計画中ですか？開発中ですか？
答えは、組織がAPIで何をしたいか、そして会社としてどれほどオープンであるかによって異なります。大規模な組織であれば、公開する前に多くのテストを実施するための内部リソースがあるかもしれません。これらのテスト結果は、APIが公開される前に、適切なメッセージング、チャネル戦略、採用モデルを決定するための良い洞察と時間とをマーケターに与えます。
スタートアップの場合、広範なベータテストを実施するためのリソースが少ないかもしれません。そのようなシナリオでは、マーケターがAPIの計画段階の早い段階から会話に参加し、採用目標を達成するための最適なマーケティング手法を決定するための時間を与えることが賢明でしょう。
APIのマーケティングに関連する課題は何だと思いますか？
開発者へのマーケティングは、彼らが非常に批判的になる傾向があるため、難しいものです。彼らは、可能な限り迅速かつ最もシンプルな方法で価値を理解する必要があります。多くの場合、このシンプルさはメッセージング、ランディングページのユーザーインターフェース、さらにはAPIのドキュメントの読み方や解釈方法にまで翻訳されます。
APIのマーケティングは、収益サイクルが長いため、別の意味で困難です。組織がAPIから直接的に具体的で測定可能な影響を見つけるまでには時間がかかります。この価値は、直接的な収益、ブランド認知、またはリピートビジネスの形で現れる可能性があります。APIと通常の製品との大きな違いは、価値創造のタイムラインが長くなることです。
APIが高レベルの統合であり、企業のアーキテクチャ内の多くの重要なコンポーネントに触れる可能性があることを理解することが重要です。CPO、CTO、CFOなどの上級管理職は、APIがもたらす価値を理解する必要があります。これは、この分野が少しエンタープライズ寄りになっているように見えるかもしれませんが、マーケターとして、私たちは常に真のターゲットユーザーである開発者のニーズを決して忘れてはなりません。これが、マーケターがAPIの新規顧客を獲得するためのツールとしてドキュメントが非常に重要である理由です。
優れたAPIドキュメントを作成するためにお勧めするツールはありますか？
私は最近、30種類のドキュメンテーションツールをまとめた記事を作成しました。SmartBearのSwagger UIが好きです。この分野では非常に確立されており、多くの企業がすでに使用しているものです。また、ReDocや、3カラムのドキュメンテーションレイアウトが好きならSlateも好きです。
開発者がAPIを使い始めるまでの時間を短縮するのに役立つ優れた開発者ポータルがいくつかあります。
APIや記述フォーマットのような技術の普及は、マーケターをより技術的にしていると思いますか？
マーケティングだけでなく、すべての人に言えることです。これは、すべての産業と職業に共通する傾向です。マーケター、ライター、起業家を含め、誰もが関連性を保つために少しずつ技術的になる必要があります。APIについても言えることですが、画期的な破壊的技術には多くの異なる人々が関心を持っています。彼らは完全にコードに精通しているわけではありませんが、日々の活動にそれらを適用する方法を学ぶ必要があります。
将来的には、「APIマーケター」という専門職を採用する企業が出てくるかもしれませんね。
それはすでに存在していると思います。彼らは「開発者アドボケート」と呼んでいます。残念ながら、開発者の世界では「マーケティング」という言葉は評判が良くありません（笑）。
ビル・ドアーフェルド氏へのインタビューは、Swaggerブログの専門家インタビューシリーズの一環です。OpenAPIイニシアティブのダレル・ミラー氏への人気のインタビューもご覧ください。