メモ
この記事は、 Marketplace でのアプリの公開にのみ適用されます。 Marketplace での Actions の公開について詳しくは、「 Marketplaceでのアクションの公開」をご覧ください。
ドラフト リストの Listing description セクションに入力する必要があるフィールドについてのガイドラインは以下のとおりです。
リストの名前は Marketplace ホームページに表示されます。 名前は255文字を上限とし、アプリケーションの名前と異なっていても構いません。 名前が自分自身のユーザー名または組織名である場合を除き、 上の既存のアカウントと同じ名前をリストに使うことはできません。
コミュニティには、 Marketplace ホームページのアプリ名の下に "ごく短い" 説明が表示されます。
簡単な説明は、40～80文字にとどめることをお勧めします。 それ以上の文字数を使うこともできますが、説明は簡潔なほうが顧客に読みやすく、わかりやすくなります。
アプリケーションの機能を説明します。 このスペースを操作の指示には使用しないでください。 次に例を示します。
良い例: の issue に関する軽量のプロジェクト管理
悪い例: Manage your projects and issues on ( でプロジェクトと issue を管理する)
ヒント: アクションの呼び出しで動詞の末尾に "s" を追加して、許容できる説明に変換します: Manages your projects and issues on
説明でアプリケーション名は繰り返さないようにします。
良い例: コンテナーネイティブの継続的インテグレーション ツール
悪い例: Skycap はコンテナーネイティブの継続的インテグレーション ツールです
英文字表記は固有名詞に使用し、大文字小文字は常に正しく使ってください。 大文字で始めて英文字表記するのは固有名詞だけです。
短い説明の終わりには句読点を付けません。 完全文では書かないようにし、複数文は絶対に避けてください。
大文字で始めて英文字表記するのは固有名詞だけです。 次に例を示します。
良い例: Web 開発者向けのワンクリック配信自動化
悪い例: Web Developers 向けのワンクリック配信自動化
リストには常にシリアル コンマを使います。
コミュニティを "ユーザー" と呼ぶことは避けます。
良い例: 組織内の個人向けに issue を自動的に作成する
悪い例: 組織のユーザー向けに issue を自動的に作成する
略語は一般的な場合 (APIなど) を除いて使用しないでください。 次に例を示します。
良い例: を離れることなく使用できるアジャイル タスク ボード、見積もり、レポート
悪い例: の UI を離れることなく使用できるアジャイル タスク ボード、見積もり、レポート
Marketplaceのアプリケーションはカテゴリ別に表示できます。 [Primary category](プライマリ カテゴリ) ドロップダウンでアプリの主な機能を端的に表すカテゴリを選び、必要に応じてアプリに適した [Secondary category](セカンダリ カテゴリ) を選びます。
アプリケーションが特定の言語でのみ動作する場合は、アプリケーションがサポートしている言語を最大10まで選択します。 選択した言語はアプリケーションの Marketplaceリストページに表示されます。 このフィールドは省略可能です。
必須 URL
- Customer support URL (カスタマー サポートの URL): 顧客がテクニカル サポート、製品、またはアカウントについて問い合わせるためにアクセスする Web ページの URL。
- Privacy policy URL (プライバシーポリシーのURL): アプリのプライバシー ポリシーが表示される Web ページ。
- インストール URL: このフィールドは OAuth apps の場合にのみ表示されます。 ( Apps では、 App の設定ページの省略可能な [セットアップ URL] を代わりに使うため、この URL は使いません)。顧客は、OAuth app を購入してインストールした後は、 によってインストール URL にリダイレクトされます。 OAuth 認可フローを開始するために、顧客を
https://.com/login/oauth/authorizeにリダイレクトする必要があります。 詳細については、「新しい購入や無料トライアルの処理」を参照してください。 App の一覧を表示している場合は、このフィールドをスキップします。
Optional URLs (省略可能な URL)
- Company URL (会社の URL): あなたの会社の Web サイトへのリンク。
- Status URL (ステータス URL): アプリのステータスを表示する Web ページのリンク。 ステータスページには、現在および履歴のインシデントレポート、Webアプリケーションの稼働時間ステータス、およびメンテナンスのスケジュールが記載されます。
- Documentation URL (ドキュメントの URL): 顧客にアプリの使用方法を説明するドキュメントのリンク。
Marketplaceには、アプリケーションを視覚的に区別するために、円形のバッジの中に四角いロゴ画像の付いたリストが表示されます。
機能カードは、アプリケーションのロゴ、名前、およびブランドの個性を捉えた顧客の背景画像で構成されます。 アプリが、ホームページの上部にランダムに表示されている 4 つのアプリの 1 つである場合、 Marketplace にこのカードが表示されます。 各アプリケーションのごく短い説明が、機能カードの下に表示されます。
画像をアップロードして色を選択すると、 Marketplaceのドラフトリストに、ロゴと機能カードのプレビューが表示されます。
ロゴ用として、カスタム画像をアップロードする必要があります。 バッジには、背景色を選択します。
- リストを公開するときにアップスケールしなくて済むように、アップロードするロゴ画像は200×200ピクセル以上にしてください。
- ロゴは正方形にトリミングされます。 ロゴが中央にある正方形の画像ファイルをアップロードすることをお勧めします。
- 最適な結果を得るには、透明な背景のロゴ画像をアップロードしてください。
- 継ぎ目がないようにバッジを表示するには、ロゴ画像の背景色 (または透明) と一致する色をバッジの背景として選択します。
- 単語や文章が含まれるロゴ画像の使用は避けてください。 文字が含まれる画像は、小さい画面で適切に縮小されません。
機能カード用として、カスタム背景画像をアップロードする必要があります。 アプリケーションの名前には、文字色を選択します。
- カードを視覚的に区別しやすいように、また Marketplaceホームページの暗い背景に対して目立つように、背景画像にはパターンまたはテクスチャを使用します。 機能カードには、アプリケーションのブランドの個性を取得する必要があります。
- 背景画像の大きさは、幅965ピクセル x 高さ482ピクセルです。
- アプリケーション名の文字色には、背景画像に対してはっきり見える色を選択してください。
アプリケーションのランディングページにアクセスするには、 Marketplaceホームページまたはカテゴリページからアプリケーションの名前をクリックします。 ランディングページページには、アプリケーションの長い説明が表示されます。説明は「概要説明」と「詳細説明」の2部で構成されています。
「概要説明」は、アプリケーションの Marketplaceランディングページの上部に表示されます。
Read more をクリックすると、Detailed description が表示されます。
説明の記述は、以下のガイドラインに従ってください。
アプリをリストするときに、必須の Introductory description フィールドには、150 から 250 文字の長さで 1、2 文の概要を入力することをお勧めします。 それ以上の文字数を使うこともできますが、概要は簡潔なほうが顧客に読みやすく、わかりやすくなります。
オプションの「詳細説明」フィールドに情報を追加することもできます。 アプリのランディング ページで概要説明の下にある Read more をクリックすると、この説明が表示されます。 詳細説明は、3 つから 5 つの価値提案と、それぞれを説明する 1、2 文から構成されます。 この説明には、最大1,000文字まで使用できます。
概要説明は、必ずアプリケーション名から始めます。
説明とバリュープロポジションは、必ず能動態で書きます。
バリュープロポジションでは、英文字表記は固有名詞に使用し、大文字小文字は常に正しく使ってください。 大文字で始めて英文字表記するのは固有名詞だけです。
説明では句点を使用します。 感嘆符は避けてください。
バリュープロポジションのタイトルの終わりには句読点を付けません。 バリュープロポジションのタイトルを完全文では書かないようにし、複数文は避けてください。
各バリュープロポジションには、タイトルとそれに続く説明があります。 Markdown を使って、タイトルにレベル 3 ヘッダーの書式を設定します。 次に例を示します。
Skills は、 の使用、Markdown とのより効果的なやり取り、マージ競合の処理などの方法を学習するのに役立ちます。
大文字で始めて英文字表記するのは固有名詞だけです。
リストには常にシリアル コンマを使います。
コミュニティを "ユーザー" と呼ぶことは避けます。
良い例: 組織内の個人向けに issue を自動的に作成する
悪い例: 組織のユーザー向けに issue を自動的に作成する
略語は一般的な場合 (APIなど) を除いて使用しないでください。
アプリケーションのランディングページで表示されるように、アプリケーションのスクリーンショット画像を5つまでアップロードできます。 スクリーンショットごとに状況がわかるキャプションをオプションとして追加します。 スクリーンショットをアップロードすると、ランディングページに表示したい順序でドラッグできます。
- 画像は高解像度 (幅1200px以上) でなければなりません。
- 画像を次から次へのクリックしたときにページが移動するのを避けるために、すべての画像は高さと幅 (アスペクト比) を等しくする必要があります。
- アプリケーションの動作が見えるように、ユーザーインターフェースはできるだけ多く表示してください。
- ブラウザーでアプリケーションのスクリーンショットを取得するときには、ディスプレイウィンドウの内容のみを含めるようにします。 アドレスバー、タイトルバー、ツールバーのアイコンは含めないでください。小さい画面で適切に縮小されません。
- では、アップロードしたスクリーンショットは、アプリのランディング ページのボックス内に表示されるので、スクリーンショットの周囲にボックスや枠線は必要ありません。
- キャプションは、短く簡潔なほうが効果があります。
