『Twitterカード』を設定してサイトへの流入数を「若干」増やそう！1万6742文字に渡る開発者向けドキュメントの日本語訳まとめ。【ガイアックス】
これは、ある記事がツイートされた時に、ツイートに対してそのページの『画像』『ページタイトル』『ページ説明文』などを添付するための設定です。
これをサイト側で設定すると、ツイートされたリンクは以下の画像のように表示されます。
『Twitterカード』設定前後
色々細かいレギュレーションや設定項目があり、それはTwitterの開発者ドキュメントで解説されています。しかし、その解説は英語のみだったので、二の足を踏んでしまって設定できていなかった方も多いのではないでしょうか？
そんな方々向けに、Twitterカードの開発者ドキュメントを一字一句残さず日本語訳してみました。
一応実際の設定手順も来週にはこのブログでもご紹介しますが、まずは今回のドキュメントをご覧になって皆さんも設定してみて下さい！
※2013年1月31日時点の情報をまとめています。
※以前Web担当者Forumでも設定方法が紹介されていましたので、こちらの記事もご参照下さい。
開発者向けドキュメント日本語訳
Introduction
Twitterカードを利用すると、あなたのコンテンツのURLがツイートされた時に、そのコンテンツを添付する事ができる。HTMLタグを何行かWebページに追加すると、あなたのコンテンツへのリンクをツイートしたユーザーに、「Twitterカード」が追加される。(このTwitterカードは、全てのユーザーが見れる。)
開発者はTwitterカードを使って以下の事が実現できる。
- あなたのコンテンツがTweetでどのように表示されるか管理できる。
- あなたのサイトへの流入数を増やせる。
- コンテンツ分配でフォロワーを増やせる。
Three simple steps
１．どのタイプのカードを利用したいかを(今ご覧頂いている)このドキュメントを見て確認する。
２．メタタグをあなたのページに追加し、プレビューツールでテストする。
３．実施例のリンクと関連情報を提出し、こちらの申請フォームから申請する。
Card Principles
コンテンツの帰属先サイトが表示されているTwitterカードのサマリー表示例
ツイートに添付できるカードのタイプは3つあり、それぞれが過去の経験から、ウェブやモバイルのTwitterクライアント用に完璧に設計されている。
summary デフォルトのカードであり、タイトル・解説・サムネイル画像・ツイッターアカウントの帰属が含まれているもの。 photo ツイートのサイズのフォトカード player ツイートのサイズの動画/音声/メディアプレイヤーカード
以下のHTMLを、ページのHEADセクションに追加して、コンテンツのカードのタイプを明示しよう。
カードのプロパティは、シンプルなkey-value piars(カードの一意識別子[UID=key]と実際のデータの値[value]の組み合わせ)で、それぞれが上のような形で独自のHTMLメタタグでそれぞれ定義されている。
これらのプロパティが複数結合することによって、全体のカードでの表現を定義し、またそれぞれのカードが特別なプロパティの組み合わせをサポートする。
各ページでは一つのカードしかサポートされない。全てのカードは以下のいくつかの基本のプロパティをサポートしている。
Card Property 説明 twitter:card このカードタイプは”summary”,”photo”,”player”に使われる twitter:url カードに表示されるコンテンツの正規URL twitter:title カードに表示されるコンテンツのタイトル twitter:description カードに表示されるコンテンツのディスクリプションで、最大200文字まで twitter:image カードに表示されるコンテンツのイメージ画像
それぞれのカードが微妙に異なる形で上記のプロパティを利用している。以下各セクションに分かれてそれぞれのカードについて説明していく。
Card and Content Attribution(≒カードとコンテンツの帰属)
それぞれのカードではコンテンツの帰属を示す事ができ、あなたが明示したコンテンツ向けに適切なTwitterアカウントを表している。
ユーザー(恐らくTwitterアカウントのユーザー名のこと)を見ることによって、フォローをしたり、帰属しているアカウントのプロフィールをカードから直接見ることができる。
属性には二つの種類が存在する。
１．Website Attribution(ウェブサイト帰属):ウェブサイトやコンテンツが公開されたプラットフォームに帰属するTwitterアカウントを指す。
ウェブサイト内の異なるセクションやページ向けに、別々のツイッターアカウントがある場合もあり、最も適切なツイッターアカウントがユーザーに提供されなければいけない。
例えば、nytimes.comは、フロントページの記事を“@nytimes”に帰属させ、Arts & Entertainmentセクションの記事は“@NYTArts”の帰属にしている。
２．Creator Attribution(クリエイター帰属):カードに表示されているコンテンツがクリエイターに帰属している場合を指す。
あなたのカード帰属を、以下のプロパティを利用して構成しよう。
Card Property 説明 Required(必須か否か) twitter:site カードのフッターに使われたウェブサイト用の@username 必須ではない twitter:site:id twitter:siteと同じだが、代わりにウェブサイトのツイッターのユーザーIDを使用する。@usernameは変える事はできるが、ユーザーIDは変わらない。 必須ではない twitter:creator コンテンツのクリエイター/著者用の@username 必須ではない twitter:creator:id twitter:creatorと同じだが、TwitterのユーザーIDを示す。 必須ではない
Summary Card
Summaryカードは、ブログの投稿やニュースから製品やレストランまで、多くのウェブコンテンツ用に使える。以下のスクリーンショットは、New York Timesの記事のツイートが拡大されたものである。
このカードは読者がウェブサイトをクリックする前に、コンテンツのプレビューを見せるためのものである。
このカードは、前回のセクションで説明されたすべてのプロパティ(URL・title・description・image)から成り立っている。
Card Property 説明 Required
(必須か否か) twitter:card “summary”の値にセットされていなければならない 必須ではない。もしtwitter:cardの値が何も設定されていなければ、デフォルトとしてsummaryカードになる twitter:url コンテンツの正規URL Yes twitter:title タイトルは簡潔に70文字以下にしなければならない Yes twitter:description 1つのTweet内のディスクリプションとして、ページのコンテンツが簡潔かつ適切に説明されているもの。タイトルの文章を再利用ではいけない。また、サイトの一般的なサービスについても語らない方がいい。この説明は200文字以内でなければならない。 Yes twitter:image ページのコンテンツを象徴するユニークな画像のURLをここに設定する。ウェブサイトのロゴや著者の写真、またはページ内に沢山存在する汎用的な画像は使うべきではない。120×120ピクセル以上の画像は、長さを元に正方形に削られる。また60×60ピクセル以下の画像は表示されない。 必須ではない
上記の必須項目が一つでも欠けている場合は、ツイートに表示されない。
上の画像では、カードがウェブサイトとコンテンツクリエイターに帰属している事が、はっきりと表示されていることに注目してほしい。
以下が、上記でサンプルとして出したニューヨーク・タイムズのWebサイトで、実際に設定したHTMLの全容である。
Photo Card
フォトカードは、画像をツイートの全面また中心に設置する。
フォトカードを定義するには、タイプを”photo”にして、twitter:imageのメタカードにする。
Twitterはオリジナルの画像の比率を保ったまま、画像のサイズを変更する。
PC上 最大で縦375ピクセル・横が435ピクセル モバイル(retinaディスプレイ以外) 最大縦375ピクセル・横280ピクセル モバイル(retinaディスプレイ) 最大縦750ピクセル・横560ピクセルTwitterは、画像の大きさが縦150ピクセル横280ピクセル以下の場合は、フォトカードを作成しない。イメージは例外的なアスペクト(比率)でない限り、切り取られることはない。
全てのイメージは高品質なサービスとユーザーのSSLセキュリティのために、Twitterによりデータを取得されたのちプロキシサーバーに送られる。
“twitter:image:width”と”twitter:image:height”を使ってより詳細に縦と横のピクセルを定義することによって、画像のサイズが変えられた場合に、よりオリジナルのアスペクトを保ちやすくなる助けになる。
フォトカードは、タイトルが空白でも作成できる唯一のカードである。タイトルのないフォトカードを作る場合は、「空白」をタイトルとして設定する。（空白の設定例：.）
アニメgifは、現時点ではTwitterカードでは利用できない。フォトカードは下記のプロパティによって定義づけられる。
Card Property 説明 Required(必須か否か) twitter:card 値は”photo”と設定されていなければならない。 必須 twitter:title カードに表示されるコンテントのタイトル。タイトルを付けたくない場合は空白にしておける。 必須ではない twitter:description 200文字以内のコンテンツの説明 必須ではない twitter:image コンテンツを象徴する画像 必須 twitter:image:width 厳密な横幅をピクセルで入力することにより、サイズ変更の際により正確にオリジナルの比率を保つことができる。 必須ではない twitter:image:height 厳密な高さをピクセルで入力することにより、サイズ変更の際により正確にオリジナルの比率を保つことができる。 必須ではない
以下が、フォトカードのHTMLの例である。
Player Card
プレイヤーカードは、ビデオや音楽プレイヤー、イベントのLIVEストリーミングなどのメディア機能であり、iframe内のコンテンツをツイート内で公開することができる。
フォトカードやSummaryカードとは違い、全てのコンテンツの表現を管理し、以下全てのTwitterクライアントで利用できるよう、詳細な設定をする必要がある。
- twitter.comとmobile.twitter.com
- iPhone用Twitter公式アプリ
- Android用Twitter公式アプリ
各プラットフォームの性能により、プレイヤーカードは各クライアントで異なる働きを見せるので、カードを設定する前に詳細を知っておく必要がある。
以下が、それぞれのプラットフォームでどのように動くかの違いである。
Twitter.com上の場合、ツイートをプロフィールページ(タイムライン)上でクリックしたり、「概要を表示」をクリックしたり、ツイートのパーマリンクページを開いた時に、iframeページは表示される。もしiframeが435ピクセル以上の場合は、iframeプレイヤーは435ピクセル以内に収まるように、オリジナルのアスペクト比を保ちながらサイズが変更される。
Twitterのネイティブアプリ(iPhone用またはAndroid用Twitter)用の場合、イメージプレビューがビデオの場所に表示され、以下の優先順位で、いずれかにリンクされる。
１．”twitter:player:stream”で設定されているURL。ユーザーがイメージプレビューをタップした時に、URLのメディアストリームを読み込み、アプリ内で再生する。設定する場合は、MPEG-4コンテナフォーマット(MP4形式)で提供されなければならない。以下のコードで音声と動画を合わせる事ができる。- Video：H.264、Baseline Profile (BP)、レベル3.0、30fpsで最大640×480
- Audio: AAC, Low Complexity Profile (LC)
mobile.twitter.com(Twitter社のモバイルクライアント)上では、イメージプレビューがビデオの場所に表示され、以下の優先順位で、下記のリンクへと飛ばされる。
１．”twitter:url”で明示されているURL ２．ユーザーが最初にオリジナルでツイートしてシェアしたURL他のクライアントでは、ユーザーのツイートのURLへ飛ばされ、クライアントのデフォルトブラウザでサイトが開かれる。
全てのプレイヤーカードは、Twitterから、特別なホワイトリスティング(信頼できるURLであるという確認)を受けたのち、承認される必要がある。
Player Cards require more testing
プレイヤーカードは、少なくとも5つのコンテキストでテストする必要がある。我々は下のツイートにそれらの要項をまとめた。
現在のPCブラウザでtwitter.comを使った時に動くか？ネイティブのiOS/Android用Twitterアプリで動くか？mobile.twitter.comをiOS/Androidのデフォルトブラウザで開いたときに動くか？
A few simple rules for Cards
やるべき事：
- 全てのTwitterクライアントに対応し、同じように機能するカードを作る
上に明記されている全てのTwitterクライアント(補足：twitter.com・iPhone/Android用アプリ・mobile.twitter.com)で動かないものは承認されない
審査に提出する前に、Twitterクライアントのネイティブブラウザでテストする 可能な時はRAWのストリームビデオとオーディオを提供する httpsをiframe、stream、カード全てのアセットに使用する Wmodeを使う：twitter.com用にFlashを使っている場合は不明瞭なので、プレイヤーが正しいx-indexで開くようにする Flashが利用できない場合は、モバイルフレンドリーなコンテンツにfall backするよう、HTMLページにリンクさせる。
やってはいけない事:
- ブラウザの警告が出るようなコンテンツを入れること。全てのTwitterクライアントはhttpsを使うので、ブラウザのロックを破壊してはいけない。
- コンテンツの自動再生
- あなたのページにサインインしないといけないコンテンツ
- プレイヤー内に、他のネットワークのシェア機能を混合させること
- “Twitter:player”を.swfの動画ファイルに指定すること
プレイヤーカードは以下のプロパティで定義づけることができる。
Card Property 説明 Required
(必須か否か) twitter:card 値を”player”に設定 必須 twitter:title カードに表示されるコンテンツのタイトル 必須 twitter:description 200文字以下のコンテンツの説明 必須 twitter:player iframeプレイヤーにはhttps URLを設定。
Webブラウザに警告を与えるようなコンテンツと一緒にしてはいけない。 必須 twitter:player:width “twitter:player”で設定されているiframeの横幅 必須 twitter:player:height “twitter:player”で設定されているiframeの高さ 必須 twitter:image iframe又はインラインのプレイヤーをサポートしていないプラットフォームで、プレイヤーの場所で表示されるイメージ。イメージはプレイヤーと同じ大きさにしなければならない。68,000ピクセル以下(262×262正方形イメージ、又は350×196、16:9の画像)の画像を利用した場合、プレイヤーは実行されない。 必須 twitter:player:stream Twitterのモバイルアプリ上で直接再生されるRAWストリームのURL。MPEG-4 コンテナフォーマットでなければいけない。コンテナは以下の音声と動画のコーデックを混ぜる事ができる。
・Video: H.264, Baseline Profile (BP), Level 3.0, up to 640 x 480 at 30 fps.
・Audio: AAC, Low Complexity Profile (LC) 必須ではない twitter:player:stream:content_type “twitter:player:stream”内に含まれているコンテンツを、MIMEで表示するタイプ。RFC 6381で指定されているフォームを取る。現在サポートされている”content_type”という値は、RFC 4337 (MP4用MIMEタイプ登録)である。 “twitter:player:stream”が定義付けられている場合は必須
以下が、プレイヤーカードのhtml例である。
以下が、twitterモバイルアプリでRAW URLが再生されるfootbar.comのプレイヤーカードの一例である。
A few things to check before submitting a Player Card for approval.(プレイヤーカードが承認されるためにチェックしておくこと)
以下が、プレイヤーカードの提出をチェックしている際に最もよく見つかる問題である。（これらがあると問題が直るまで承認が遅れてしまう）：
１．httpsロックが壊れている場合。ビデオは例外なくhttpsを通して提供されている事を確認する。 ２．コンテンツは必ず停止または一時停止のコントロールが出来ないといけない。 ３．Android又はiPhoneでは、動画の設定を丁寧にfall backしないといけない。(モバイル用のサイズ、壊れていないFlash embed、など) ４．コンテンツは自動再生されてはいけない。 ５．コンテンツは第三者のネットワークにシェアできる機能を付けてはいけない（現時点ではこの機能はサポート外） ６．コンテンツはサインインを要してはいけない。 ７．コンテンツは全体的に広告であってはいけない。 ８．プレイヤーのURLは直接.swfに指定してはいけない ９．プレイヤーのz-indexが、コンテンツがページのヘッダーに重なる原因にならないように設定する。 １０．もしブラウザが不安定なアセットを表示したいかを聞いてきた場合は、httpsに問題がある。 １１．イメージは最少で68600ピクセル(262×262正方形イメージ、又は350×196、16:9の画像)以上にする。 １２．プレイヤーURLはhttpsではない。(すでに言及しただろうか？)
URL crawling
TwitterのクローラはURLをスキャンしている際、robots.txt重要視する。
もしカードマークアップ付きのページがブロックされている場合、カードは表示されない。もしイメージURLがブロックされている場合も、サムネイル又はフォトは表示されない。
Twitterは、あなたのrobots.txt ファイルに例外を作成する事ができるTwitterbotのユーザーエージェントを利用する。
以下が、Twitterのfetcher以外へのクローリングを拒否しているrobots.txtの例である。
User-agent: Twitterbot
Disallow:
User-agent: *
Disallow: /
以下が、どのディレクトリがTwitterbotからクロールされてもいいかを明示している例である。(このケースでは、イメージとアーカイブのディレクトリ以外は拒否している):
User-agent: Twitterbot
Disallow: *
Allow: /images
Allow: /archives
Twitter cards and Open Graph
あなたはきっと、Twitterカードのタグは、オープングラフのタグに似ていることに気が付くだろう。これはオープングラフプロトコルと同じ規定を使用しているからだ。
もしすでにページ上で、オープングラフを利用してデータを説明している場合は、タグやデータを複製せずに簡単にTwitterカードで作る事ができる。
Twitterカードプロセッサーがあなたのページのタグを探す時、まず最初にTwitterプロパティをチェックし、もしない場合はサポートされているオープングラフのプロパティを探すようになっている。
これにより、それぞれがページ上で独立して定義づけられ、あなたのコンテンツや体験を説明するマークアップの複製を最小に抑える事ができる。
オープングラフは”og”の接頭辞を prefix="og: http://ogp.me/ns#">という形で明示する必要があるが、Twitterカードのマークアップにはそういったものや”twitter”接頭辞は必要ない。
またオープングラフは、マークアップのプロパティやコンテンツの帰属を()と明示する必要もあるが、Twitterカードは名前と種類を明示するだけである。
Twitterの構文解析プログラムは、プロパティやコンテンツを利用するためにfall backするので、すでにページ上にオープングラフが存在する場合は、既存のオープングラフのマークアップを変更する必要はない。
Twitterとオープングラフのタグを合わせてSummaryカードで使う例が以下である。
次のセクションのテーブルが、それぞれのTwitterタグに対するオープングラフのfall backの動きである。
Overview of all Twitter Card Tags(Twitterカードタグのまとめ)
Property Card Value OpenGraph Fallback twitter:card - “summary”, “photo”, or “player” - twitter:site all @username of website - twitter:site:id all Same as twitter:user, but the user’s Twitter ID - twitter:creator all @username of content creator - twitter:creator:id all Twitter user ID of content creator - twitter:url all Canonical URL of the card content og:url twitter:description all Description of content (maximum 200 characters) og:description twitter:title all Title of content (max 70 characters) og:title twitter:image all URL of image to use in the card og:image twitter:image:width all Width of image in pixels og:image:width twitter:image:height all Height of image in pixels og:image:height twitter:player layer HTTPS URL of player iframe - twitter:player:width player Width of iframe in pixels - twitter:player:height player Height of iframe in pixels - twitter:player:stream player URL to raw video or audio stream -
以上、『Twitterカードの公式開発者向けドキュメントの日本語訳』でした。
ぜひ皆さんのサイトでも実装して見て下さい。
もう少し具体的なやり方(特にWordPress向けの実装)の流れについては、このブログで改めてご紹介します。今週にはアップしたいと思いますので少しお待ち下さい。
※元記事 ：http://gaiax-socialmedialab.jp/twitter/189
GaiaXソーシャルメディア ラボ">by GaiaXソーシャルメディア ラボ