SmartFormat仕様書(Atom準拠)

feed

使用する namespace などを定義します。

<feed xmlns="http://www.w3.org/2005/Atom"
      xml:lang="en"
      xmlns:dc="http://purl.org/dc/elements/1.1/"
      xmlns:media="http://search.yahoo.com/mrss/"
      xmlns:snf="http://www.smartnews.be/snf">
(...中略...)
</feed>

feed要素配下には、以下の要素が含まれます。

要素 必須 説明 用例
title サイトのタイトル名(10字以内を推奨) スマートタイムス
link サイトの URL  
subtitle サイトの説明文(15字以内を推奨) スマートなニュースをすべての人へ
updated   当該リソースが作成された日時 2014-05-16T06:00:00+0000
rights   当該リソース提供者の copyright © SmartNews, Inc.
snf:logo   サイトを象徴するロゴ画像 <url>http://times.smartnews.co.jp/snlogo.png</url>
entry 記事情報(後述)  

 

feed.title

<title>スマートタイムス</title>

ChannelView面(記事一覧画面)に表示される、サイト名を指定します。 

推奨される表記などの詳細はサイト名を指定するをご覧ください。

channel.title

feed.link

<link>http://times.smartnews.co.jp/</link>

サイトURLを指定します。SmartView記事上部に表示されるロゴをタップした際の遷移先となります。

推奨記述などの詳細は、サイトURLを指定するをご覧ください。

 

feed.updated

<updated>2014-05-16T06:00:00+0000</updated>

XMLファイルが作成された日時を指定します。

日付の書式について

日付は、EEE, dd MMM yyyy HH:mm:ss z の形式に則って記述していただく必要があります。

タイムゾーンについて

タイムゾーンについては、以下の2通りのうちいずれかの方法で指定をしてください。

  • グリニッジ標準時(GMT もしくは +0000)
  • サイト運営者の属するタイムゾーン(日本であれば JST もしくは +0900)

たとえば、「2014年5月16日 15時00分00秒(日本時間)」を表す場合、以下は正しい表記になります。

  • Fri, 16 May 2014 06:00:00 GMT
  • Fri, 16 May 2014 15:00:00 +0900

以下は誤りになります。(日本時間ではGMT+9時間で 「2014年5月17日 00時00分00秒」を表すことになります)

  • Fri, 16 May 2014 15:00:00 GMT
<snf:logo>
    <url>http://times.smartnews.co.jp/snlogo.png</url>
</snf:logo> 

SmartView面上部に固定表示するサイトのロゴ画像を指定します。

サイトロゴを指定するも併せてご確認ください。ロゴを変更したい場合は、サイトロゴを変更するをお読みください。

feed.snflogo_feed.link

  • 「横700px以下 x 縦およそ100px」のアルファ付きPNGファイルを推奨しています。
  • デザインについては以下例をご参照ください。

  • 明るい色、暗い色を含むいくつかの背景で、ロゴがなめらかに見えるか確認してください。

entry

サイトが提供する記事の情報を定義します。

要素 必須 説明 用例
title 記事のタイトル 渋谷区桜丘エリアの再開発計画が決定
link 記事の URL  
id 記事リソースを一意に特定する任意の文字列 http://times.smartnews.co.jp/2014/06/16/sakuragaoka
updated 記事の公開日(フォーマットは W3CDTF に定められたものとする) 2014-05-16T06:00:00+0000
content 記事本文(全文が必須) <p>渋谷駅桜丘口地区再開発準備組合と東急不動産株式会社は、2014年6月16日、渋谷区の市街地再開発等の都市開発計画が東京都により決定されたと発表した。</p><p>この都市計画は、2013年12月19日より東京都知事に対して提案されていたもので、渋谷駅中心地区の都市基盤整備を完成させる重要なプロジェクトとなっている。</p><p>今後、周辺再開発と連携した縦動線アーバン・コア、歩行者デッキ、ネットワークの整備を行うほか、街区再編と併せた都市計画道路の整備および地下車路ネットワーク等の整備により、利便性・安全性の向上を図っていくとのこと。</p><figure><img src="img.png"><figcaption>完成イメージ</figcaption></figure>
category   記事を代表、もしくは象徴する、任意のキーワード(複数存在する場合はカンマ区切りにて表現) iphone,テクノロジー,東京
author   記事の作成者 須磨戸 太郎
dc:language   記事に使用されている主たる言語(channel.languageと異なる場合、特に指定が必要な場合に指定) ja
media:thumbnail   記事を代表するサムネイル画像の URL (200☓200px以上必須, 400px以上推奨。一定値以下の場合、表示に反映されない。) http://times.smartnews.co.jp/2014/06/16/sakuragaoka/img.png
snf:video   埋め込み動画を指定 後述
media:status   記事のステータス(有効の場合は active、削除済みの場合は deleted を指定) active
snf:advertisement   SmartView 内に掲出する広告に関する情報  
snf:analytics   SmartView 上の解析ツールに関連する情報  

 

entry.title

<title>
  <![CDATA[渋谷区桜丘エリアの再開発計画が決定]]>
</title>

記事一覧画面およびSmartView面に表示される記事のタイトルを指定します。

  • タイトルを CDATA で囲った際の二重エスケープにご注意ください。

entry.link

<link type="text/html" href="http://times.smartnews.co.jp/2014/06/16/sakuragaoka" rel="alternate"/>

オリジナル記事のURLを指定します。 ここで指定されたURLは「オリジナルサイトで読む」の遷移先になります。

また、ここで指定されたURLは弊社アルゴリズムによる記事のスコアリングに使用されます。

entry.link

  • 記事の「カノニカルURL」を指定してください。    * カノニカルURLとは、記事のWebページのHTMLにおいて、 <link rel="canonical" href="xxxxxxxxxxx" > というタグで指定されている、記事を一意に表すURLになります。多くの場合PC版のURLですが、システムの都合上、調整が必要な場合あります。
  • 記事のURLはパラメータが付いていないURLを記述してください。
  • 記事がリダイレクトする場合、リダイレクト後の記事URLを記述してください。

entry.updated

<updated>Fri, 16 May 2014 06:00:00 GMT</updated>

記事の公開日を指定します。 記事の公開日が古い(2週間より以前)場合、クロールされない場合があります。詳しくは記事の日付を指定するをご覧ください。

  • 記事内容を更新した場合、 entry.updated を1秒でも変更することで、直ちに弊社クローラに更新を伝えることができます。

日付の書式について

日付は、EEE, dd MMM yyyy HH:mm:ss z の形式に則って記述していただく必要があります。

タイムゾーンについて

タイムゾーンについては、以下の2通りのうちいずれかの方法で指定をしてください。

  • グリニッジ標準時(GMT もしくは +0000)
  • サイト運営者の属するタイムゾーン(日本であれば JST もしくは +0900)

たとえば、「2014年5月16日 15時00分00秒(日本時間)」を表す場合、以下は正しい表記になります。

  • Fri, 16 May 2014 06:00:00 GMT
  • Fri, 16 May 2014 15:00:00 +0900

以下は誤りになります。(日本時間ではGMT+9時間で 「2014年5月17日 00時00分00秒」を表すことになります)

  • Fri, 16 May 2014 15:00:00 GMT

entry.content

<content>
  <![CDATA[
    <p>渋谷駅桜丘口地区再開発準備組合と東急不動産株式会社は、2014年6月16日、渋谷区の市街地再開発等の都市開発計画が東京都により決定されたと発表した。</p>
    <p>この都市計画は、2013年12月19日より東京都知事に対して提案されていたもので、渋谷駅中心地区の都市基盤整備を完成させる重要なプロジェクトとなっている。</p>
    <p>今後、周辺再開発と連携した縦動線アーバン・コア、歩行者デッキ、ネットワークの整備を行うほか、街区再編と併せた都市計画道路の整備および地下車路ネットワーク等の整備により、利便性・安全性の向上を図っていくとのこと。</p>
    <figure>
      <img src="img.png">
      <figcaption>完成イメージ</figcaption>
    </figure>
  ]]>
</content>

記事の本文を指定します。

  • オリジナル記事にページネーションがある際、 content 内には記事全文を記述してください。
  • 本文内の画像は弊社のCacheサーバーを通してデバイス向けに最適化されて配信されます。

 

 

entry.category

<category>iphone,テクノロジー,東京</category>

記事を代表する任意のキーワード群を指定します。詳細は記事の関連キーワードを指定するをご覧ください。

  • 弊社アルゴリズムにおいてカテゴリー分類の参考に使用されます。
  • Category を複数指定する場合は、半角カンマ区切りで記述してください。
  • 日本語、英語いずれも使用可能です。

entry.author

<author>パートナーリレーション担当事務局</author>

記事の作成者を指定します。 SmartView内の、記事タイトルの下に表示されます。

entry.author

entry.media:thumbnail

<media:thumbnail url="http://times.smartnews.co.jp/2014/06/16/sakuragaoka/img.png" />

記事一覧画面に表示されるサムネイル画像を指定します。

  • <media:thumbnail> が指定されていない場合は、サムネイル画像の表示は行われません。
  • 画像サイズが一定値以下の場合もサムネイル画像の表示は行われません。400px以上の画像の設定を推奨しています。
  • サムネイル画像は弊社のCacheサーバーを通してデバイス向けに最適化されて配信されます。
  • サムネイル画像に媒体ロゴを指定することはお控えください。

entry.snf:video

<snf:video url="http://www.foo.com/bar.mp4" caption="foo video" />

SmartNewsの動画プレイヤーにより再生される埋め込み動画を指定します。動画記事の配信についても併せてご覧ください。

記事一覧画面に再生マーク付きサムネイル、およびSmartView面上部にプレイヤー表示されます。

entry.snfvideo

  • 指定できる動画の仕様は下記の通りです。
    • ファイルサイズ: 600MB
    • 長さ: 最長5分(推奨90秒以内)
    • 動画コーデック: h.264
    • 音声コーデック: aac
    • ビットレート: 1Mbps
    • ファイル形式: mp4
  • URLで指定された動画は弊社サーバにキャッシュされて配信されます。そのため、指定URLにユーザからのアクセスが集中することはありません。

entry.media:status

<media:status>active</media:status>

記事の公開状況を指定します。

  • 弊社サーバの記事保持期間(2週間)以内の記事の削除を希望される場合は、
    記事自体を削除するのではなくmedia:status に deleted の値をご指定ください。参考:記事配信の停止・削除を行う
  • また、 entry.updated を1秒でも更新すると、直ちに変更が反映されます。

entry.snf:advertisement

<snf:advertisement>
  <snf:sponsoredLink link="http://times.smartnews.com/sponsored/article1.html" thumbnail="http://times.smartnews.com/sponsored/image1.jpg" title="桜丘に新スイーツ店が誕生!" advertiser="桜丘スイーツ"/>
  <snf:sponsoredLink link="http://times.smartnews.com/sponsored/article2.html" thumbnail="http://times.smartnews.com/sponsored/image2.jpg" title="sponsored link 2" advertiser="Example Company"/>
</snf:advertisement>

当該 entry 記事内に表示する広告情報を定義します。

<snf:sponsoredLink link="http://times.smartnews.com/sponsored/article1.html"
                   thumbnail="http://times.smartnews.com/sponsored/image1.jpg"
                   title="sponsored link 1"
                   advertiser="Example Company"/>

SmartView面本文下部に付与する記事広告等を指定します。

sponsoredLink

  • advertiser 要素への広告主体社名の明記が必須要件となります。  - スポンサードコンテンツ(記事広告)の場合、広告料金を払う事業主名を記述してください。  - 自社広告の場合、自社名を記述してください。
  • 1つの snf:advertisement に 2つまでの snf:sponsoredLink を指定可能です。
  • link に指定する記事のURLは、基本的に自社ドメインに限ります。
  • 弊社側では計測のサポートをしておりません。計測用のパラメータをURL末尾に付与する等、媒体社様側でのご対応をお願いします。
属性 必須 説明 用例
link スポンサードリンクの URL http://times.smartnews.com/sponsored/article1.html
title   スポンサードリンクの記事タイトル 桜丘に新スイーツ店が誕生!
thumbnail   記事を代表するサムネイル画像(アスペクト比 4:3 、320 x 240 px を推奨) http://times.smartnews.com/sponsored/image1.jpg
advertiser スポンサードリンクの広告主名 桜丘スイーツ

 

entry.snf:analytics

<snf:analytics><![CDATA[
  <script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','//www.google-analytics.com/analytics.js','ga');

ga('create', 'UA-xxx-2', 'examplecom');
ga('require', 'displayfeatures');
ga('set', 'referrer', 'http://www.smartnews.com/');
ga('send', 'pageview', '/260984/upsee/');
  </script>
  ]]>
</snf:analytics> 

SmartView 上で動作する解析コードを指定します。

  • JavaScriptで動く計測コードを1つまで使用可能です。
  • 弊社側から解析用コードの提供および解析スクリプトのサポートは行っていません。

サンプル(Atom準拠)

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:snf="http://www.smartnews.be/snf">
  <title>スマートタイムス</title>
  <link type="text/html" href="http://times.smartnews.co.jp/" rel="alternate"/>
  <subtitle>スマートなニュースをすべての人へ</subtitle>
  <updated>2014-05-16T06:00:00+0000</updated>
  <rights>(c) SmartNews, Inc.</rights>
  <logo>http://times.smartnews.co.jp/logo.png</logo>
  <snf:logo><url>http://times.smartnews.co.jp/snlogo.png</url></snf:logo>
  <entry>
    <title>渋谷区桜丘エリアの再開発計画が決定</title>
    <link type="text/html" href="http://times.smartnews.co.jp/2014/06/16/sakuragaoka" rel="alternate"/>
    <id>http://times.smartnews.co.jp/2014/06/16/sakuragaoka</id>
    <updated>2014-05-16T06:00:00+0000</updated>
    <content><![CDATA[
      <p>渋谷駅桜丘口地区再開発準備組合と東急不動産株式会社は、2014年6月16日、渋谷区の市街地再開発等の都市開発計画が東京都により決定されたと発表した。</p>
      <p>この都市計画は、2013年12月19日より東京都知事に対して提案されていたもので、渋谷駅中心地区の都市基盤整備を完成させる重要なプロジェクトとなっている。</p>
      <p>今後、周辺再開発と連携した縦動線アーバン・コア、歩行者デッキ、ネットワークの整備を行うほか、街区再編と併せた都市計画道路の整備および地下車路ネットワーク等の整備により、利便性・安全性の向上を図っていくとのこと。</p>
      <figure>
          <img src="img.png">
          <figcaption>完成イメージ</figcaption>
      </figure>
        ]]></content>
    <category>iphone,テクノロジー,東京</category>
    <author>須磨戸 太郎</author>
    <dc:language>ja</dc:language>
    <media:thumbnail url="http://times.smartnews.co.jp/2014/06/16/sakuragaoka/img.png" />
    <snf:advertisement>
     <snf:sponsoredLink link="http://times.smartnews.com/sponsored/article1.html" thumbnail="http://times.smartnews.com/sponsored/image1.jpg" title="桜丘に新スイーツ店が誕生!" advertiser="桜丘スイーツ"/>
     <snf:sponsoredLink link="http://times.smartnews.com/sponsored/article2.html" thumbnail="http://times.smartnews.com/sponsored/image2.jpg" title="sponsored link 2" advertiser="Example Company"/>
    </snf:advertisement>
    <snf:analytics><![CDATA[
      <script>
    (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
    (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
    m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
    })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

    ga('create', 'UA-xxx-2', 'examplecom');
    ga('require', 'displayfeatures');
    ga('set', 'referrer', 'http://www.smartnews.com/');
    ga('send', 'pageview', '/260984/upsee/');
      </script>
      ]]>
    </snf:analytics>
  </entry>
  <entry>
    ...
  </entry>
</feed>