SmartFormat仕様書（Atom準拠）

feed
entry
サンプル（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>`
snf:darkModeLogo		サイトを象徴するロゴ画像（ダークモード対応）	`<url>http://times.smartnews.co.jp/snlogo-darkmode.png</url>`
entry	◯	記事情報（後述）

feed.title

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

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

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

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 の形式に則って記述していただく必要があります。

タイムゾーンについて

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

グリニッジ標準時(+0000)
サイト運営者の属するタイムゾーン(+0900)

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

2014-05-16T06:00:00+0000
2014-05-16T15:00:00+0900

feed.snf:logo

<snf:logo>
    <url>http://times.smartnews.co.jp/snlogo.png</url>
</snf:logo>

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

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

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

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

feed.snf:darkModeLogo

iOSアプリリリース6.5.0以降、ダークモードをサポートしています。SmartView面上部に固定表示するためのダークモードに対応したサイトのロゴ画像を指定します。

<snf:darkModelogo>
    <url>http://times.smartnews.co.jp/snlogo-darkmode.png</url>
</snf:darkModelogo>

<snf：darkModeLogo>挿入時のイメージ

<snf:darkModeLogo>を指定しない場合であっても、snf:logoに指定したデータを変更する必要はありません。<snf:darkModeLogo>を指定しない場合、ダークモード表示時のサイトロゴには白背景が自動で挿入されます。

<snf：darkModeLogo>未挿入時のイメージ

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>
summary		記事の概要文	渋谷区の市街地再開発等の都市開発計画が東京都により決定されたと発表した
category		記事を代表、もしくは象徴する、任意のキーワード（複数存在する場合はカンマ区切りにて表現）	iphone,テクノロジー,東京
author		記事の作成者	須磨戸太郎
dc:language		記事に使用されている主たる言語（channel.languageと異なる場合、特に指定が必要な場合に指定）	ja
media:thumbnail		記事を代表するサムネイル画像の URL (200☓200px以上必須, 400px以上推奨。一定値以下の場合、表示に反映されない。長辺=L, 短辺=S の場合、 L<=3.3S)	http://times.smartnews.co.jp/2014/06/16/sakuragaoka/img.png
snf:video		埋め込み動画を指定	後述
media:status		記事のステータス（有効の場合は active、削除済みの場合は deleted を指定）	active
snf:relatedLink		おすすめ枠に掲載する関連記事を指定	後述
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」を指定してください。
- カノニカルURLとは、記事のWebページのHTMLにおいて、 <link rel="canonical" href="xxxxxxxxxxx" > というタグで指定されている、記事を一意に表すURLです。多くの場合PC版のURLですが、システムの都合上、調整が必要な場合あります。
記事のURLはパラメータが付いていないURLを記述してください。
記事がリダイレクトする場合、リダイレクト後の記事URLを記述してください。
日本語URLには対応しておりません。エンコード後の記事URLを記述してください。

entry.updated

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

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

日付の書式について

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

タイムゾーンについて

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

グリニッジ標準時(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サーバーを通してデバイス向けに最適化されて配信されます。
記事本文中に設置可能なリンクには制限があります。下記ガイドラインをお読みください。
- SmartFormat外部リンクガイドライン

entry.category

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

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

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

entry.author

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

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

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面上部にプレイヤー表示されます。

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

entry.media:status

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

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

弊社サーバの記事保持期間（2週間）以内の記事の削除を希望される場合は、
記事自体を削除するのではなく、media:status に deleted の値をご指定ください。参考：記事配信の停止・削除を行う
端末のキャッシュ状況により即時反映されない場合があります。

<snf:relatedLink title="渋谷区桜丘エリアの再開発計画が決定" thumbnail="http://times.smartnews.co.jp/2014/06/16/sakuragaoka/img.png" link="http://times.smartnews.co.jp/2014/06/16/sakuragaoka"/>

おすすめ枠に掲載する関連記事を媒体社で指定します。
なお、指定は Media Prosper Program 参加媒体社のみ可能です。

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

<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面本文下部に付与する記事広告等を指定します。

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

Google Analytics 4のID が、G-XXXXXXXX、ページビューの対象となる記事のURLが、https://exsample.com/news/12345 だった場合

<snf:analytics ><![CDATA[
    <script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXX"></script>
    <script>
        window.dataLayer = window.dataLayer || [];
        function gtag(){dataLayer.push(arguments);}
        gtag('js', new Date());

        gtag('config', 'G-XXXXXXXX',{'page_path':'/news/12345',
        'page_referrer':'http://www.smartnews.com/',
         'campaign_source':'SmartNews',
        'campaign_medium':'app'
        });
    </script>
    ]]>
</snf:analytics>

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

上記のスクリプトはあくまでサンプルとなります。実際には、ご利用のサードパーティの仕様に沿ってご記述ください。
弊社側から解析用コードの提供および解析スクリプトのサポートは行っておらず、ご質問も受け付けておりません。
Google Analytics 4と既存のGAを同時に使用することができます。詳しくはGoogle Analytics 4には対応していますか？をご覧ください。

サンプル(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>
  <snf:logo><url>http://times.smartnews.co.jp/snlogo.png</url></snf:logo>
  <snf:darkModeLogo><url>http://times.smartnews.co.jp/snlogo-darkmode.png</url></snf:darkModeLogo>
  <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>
    <summary><![CDATA[渋谷駅桜丘口地区再開発準備組合と東急不動産株式会社は、2014年6月16日、渋谷区の市街地再開発等の都市開発計画が東京都により決定されたと発表した。]]</summary>
    <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 async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXX"></script>
    <script>
        window.dataLayer = window.dataLayer || [];
        function gtag(){dataLayer.push(arguments);}
        gtag('js', new Date());

        gtag('config', 'G-XXXXXXXX',{'page_path':'/news/12345',
        'page_referrer':'http://www.smartnews.com/',
         'campaign_source':'SmartNews',
        'campaign_medium':'app'
        });
    </script>
    ]]>
</snf:analytics>
  </entry>
  <entry>
    ...
  </entry>
</feed>

feed

feed.title

feed.link

feed.updated

日付の書式について

タイムゾーンについて

feed.snf:logo

feed.snf:darkModeLogo

entry

entry.title

entry.link

entry.updated

日付の書式について

タイムゾーンについて

entry.content

entry.category

entry.author

entry.media:thumbnail

entry.snf:video

entry.media:status

entry.snf:relatedLink

entry.snf:advertisement

snf:sponsoredLink

entry.snf:analytics

サンプル(Atom準拠)

このセクションの記事