SEO 機能

JSON-LD 構造化データ出力

ショートコードに jsonld="yes" を指定すると、表示している動画のメタ情報を schema.org の ItemList + VideoObject 形式で JSON-LD として出力します。Google の動画リッチリザルトの候補として認識される可能性が高まります。

[ks_tubelist channel="UCxxxx" count="12" cols="3" mode="loadmore" per_page="6" jsonld="yes"]

出力される JSON-LD の構造

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "ItemList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "item": {
        "@type": "VideoObject",
        "name": "動画タイトル",
        "thumbnailUrl": "https://i.ytimg.com/vi/.../maxresdefault.jpg",
        "contentUrl": "https://www.youtube.com/watch?v=...",
        "embedUrl": "https://www.youtube.com/embed/...",
        "uploadDate": "2026-04-01T09:00:00Z",
        "description": "動画の説明 (最大 5000 文字)",
        "duration": "PT12M34S",
        "interactionStatistic": {
          "@type": "InteractionCounter",
          "interactionType": { "@type": "WatchAction" },
          "userInteractionCount": 12345
        }
      }
    },
    // ... 他の動画
  ]
}
</script>

含まれるプロパティ

見出しレベル (heading_level) 制御

動画タイトルは既定で <h3> として出力されますが、heading_level 属性で h2〜h6 を選べます。ページの見出し階層や、目次プラグインの拾われ方に応じて調整できます。

[ks_tubelist channel="UCxxxx" count="12" cols="3" heading_level="4"]

ユースケース

その他の SEO 寄与要素

img 属性の最適化

• 初回 per_page 件のサムネに loading="eager" + fetchpriority="high" → LCP (Largest Contentful Paint) 改善
• それ以降は loading="lazy" + decoding="async" → ページ初期表示を高速化
• alt 属性に動画タイトルを設定 → 画像検索でのインデックス対象に

セマンティックな HTML 構造

• 外側 wrapper: <div role="region" aria-label="動画一覧">
• 動画リスト: <ul class="kstls-grid"><li class="kstls-item">
• 動画タイトル: <h2>〜<h6> (heading_level 属性で制御)
• 公開日: <time datetime="YYYY-MM-DD">
• ページネーション: <nav aria-label="ページ送り">

キャッシュとレスポンス時間

• YouTube API レスポンスを transient で保持 (デフォルト 3600 秒)
• 同一ショートコード呼び出しは DB 1 クエリで完結 → サーバー応答時間 (TTFB) を短縮
• API キー変更時はキャッシュを自動全消去 → 表示不整合を防止

JSON-LD 出力サンプルの検証