サイトのトップへ戻る

Twitter 開発者 ドキュメント日本語訳

画像付きサマリーカード

画像つきサマリーカードは、大きなフルワイドの目立つ画像をツイートと一緒に表示するための機能です。 読み手を大きな写真で引き付け、あなたのウェブサイトに誘導するために設計されています。

以下の@TechCrunchのツイートは、140文字の文章が付いた画像付きサマリーカードを表示しています:

twitter.com上 や我々のモバイル端末上では、画像はツイート文の下に表示されています。

我々のシステムではURLがツイート内に取り込まれたタイミングを検知し、あなたのサイトをクロールしてカードタイプとコンテンツを取得します。 我々のカードシステムがどのように動作するかを知りたいのであれば、 入門ガイドを参照してください。



サンプルコード

画像付きサマリーカードをあなたのツイートに追加するには、単に以下のメタタグをあなたのサイトに追加するだけできます:

<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:site" content="@nytimes">
<meta name="twitter:creator" content="@SarahMaslinNir">
<meta name="twitter:title" content="Parade of Fans for Houston’s Funeral">
<meta name="twitter:description" content="NEWARK - The guest list and parade of limousines with celebrities emerging from them seemed more suited to a red carpet event in Hollywood or New York than than a gritty stretch of Sussex Avenue near the former site of the James M. Baxter Terrace public housing project here.">
<meta name="twitter:image" content="http://graphics8.nytimes.com/images/2012/02/19/us/19whitney-span/19whitney-span-articleLarge.jpg">

あなたが権利を持つサイトの属性とコンテンツを記述するようにしてください。

タグが設定されると、Twitter Card Validatorを使ってカードをテストすることができます。



リファレンス

以下に記載しているのは、title、description、imageを含む、画像付きサマリーカードで最低限設定しておいたほうが良いプロパティです。

カードプロパティ 必須か否か

twitter:card

“summary_large_image”の値を設定してください
Yes

twitter:site

カードが帰属する Twitterユーザーの @username 。Twitter カードアナリティクスのために必要です。

Yes

twitter:title

関連コンテンツについての簡単なタイトル。

プラットフォーム固有の動作:
  • iOS, Web: Truncated to one line in timeline and expanded Tweet
  • Android: Truncated to two lines in timeline and expanded Tweet
Yes

twitter:description

コンテンツの内容を簡単にまとめた説明。title の値を使い回したり、ウェブサイトで提供している一般的なサービスの説明のためにこの項目を使ったりしないでください。

プラットフォーム固有の動作:
  • iOS: Truncated to one line in timeline and expanded Tweet
  • Android: Not displayed
  • Web: Truncated to two lines in timeline and expanded Tweet
Yes

twitter:image

ページのコンテンツを表す画像のURL。ウェブサイトのロゴや著者近影やその他複数のページに跨る画像のような、一般的な画像を使用しないでください。 このカードの画像には最低でも280pxの横幅と x 150px の高さが必要です。画像は1MB以内のサイズにしなければなりません。
No

サポートされているタグの全一覧については、 カードマークアップタグリファレンスを参照してください。



フォトカードからの統合

フォトカードは廃止され、画像付きサマリーカードに統合されました。まだフォトカードのメタタグを使用している場合は、 以下の表にてこれらのフィールドがサマリーカードのどの部分に対応しているかを示します。

カードプロパティ フォトカードプロパティ

twitter:image

twitter:image

twitter:title

twitter:title*, og:title

プロパティが見つからなかった場合カードは描写されません。

twitter:description

og:description, twitter:site

*Title is optional and the description is not a field for the Photo Card.



ギャラリーカードからの統合

ギャラリーカードは廃止され、画像付きサマリーカードに統合されました。まだギャラリーカードのメタタグを使用している場合は、 以下の表にてこれらのフィールドがサマリーカードのどの部分に対応しているかを示します。

カードプロパティ ギャラリーカードプロパティ

twitter:image

twitter:image0

twitter:title

twitter:title

twitter:description

og:description, twitter:site