オープングラフとは何ですか？

スクレイプレスユニバーサルスクレイピングAPIは、Open Graphプロパティとそのリンクされたアセットを検査するメタデータ抽出ワークフローのためにウェブページを取得します。

Open Graphは、ウェブページが表すオブジェクトを説明するメタデータプロトコルです。出版社はドキュメントのヘッダーにメタ要素を置き、共有サービスはその値を使用してリッチプレビューを構築できます。このプロトコルはソーシャル共有の文脈で始まりましたが、同じプロパティセットは現在、多くのメッセージング、コラボレーション、出版、リンク展開システムによって利用されています。

ルール: 1. 出力は翻訳されたテキストのみ — 説明や追加のラッピングコードはなし。 2. Markdown/HTML構造 (見出し、リスト、リンク、テーブル) を正確に保つ。 3. @@CODEBLOCK_0@@ や @@INLINECODE_0@@ のようなプレースホルダートークンはそのまま保持; 決して翻訳、再順序、結合、または書式を変更しない。 4. ``` コードフェンスを追加したり削除したりせず、通常のテキストをコードブロックにラップしない。 公式Open Graphプロトコル 基本的なメタデータとオプションの拡張を定義します。Open Graph はページタイトル、表示見出し、またはカノニカルリンクの戦略を置き換えるものではありません。プロパティ名を理解しているクライアントのために、明示的なプレゼンテーション指向の説明を提供します。

基本的なオープングラフプロパティの4つ

Open Graphオブジェクトは次のように始まります。 og:title, og:type, og:image, および og:url. タイトルはグラフやカードに表示されるオブジェクト名です。タイプはオブジェクトを分類し、画像は代表的なアセットを指し、URLはオブジェクトのために使用される恒久的なアイデンティティを供給します。

基本的なカードはしばしば追加されます og:description そして og:site_name画像メタデータは、安全なURL、メディアタイプ、幅、高さ、および代替テキストを記述できます。ビデオおよびオーディオオブジェクトには、同様の構造化されたプロパティがあります。これらの追加により、消費者は資産を選択し、プレビューをアクセス可能にするのに役立ちますが、サポートはクライアントによって異なります。

リンクプレビューがどのように構築されるか

リンクプレビュークロールラーはURLをリクエストし、利用可能なメタデータを読み取り、アセットURLを解決し、独自のキャッシュに表現を保存します。消費者は、Open Graphを通常のHTMLメタデータ、プラットフォーム固有のタグ、ページコンテンツ、前のキャッシュエントリ、または安全ルールと組み合わせることができます。生成されたカードは、その消費者のインターフェースに属し、発行者のHTMLには属しません。

これは、2つのアプリが同じページの異なる画像を表示できる理由を説明しています。1つは最初の有効なものを好むかもしれません。 og:image; 別の者は、寸法、ファイルサイズ、メディアタイプ、リダイレクト、認証、または取得ポリシーのために資産を拒否するかもしれません。第三者は、まだ古いキャッシュされたカードを保持している可能性があります。テストでは、消費者、URL、取得時間、最終資産、およびデバッガー出力を記録すべきであり、一回の成功したプレビューを普遍的な証拠として扱うべきではありません。

オープングラフ画像にはURL以上のものが必要です

プレビュー画像は、ソーシャルカードで最も目立つ部分であり、最も一般的な欠陥の原因です。アセットはセッションクッキーなしに公開で取得可能であるべきで、安定したHTTPS URLを通じて解決され、HTMLエラーページではなく期待される画像コンテンツを返すべきです。サイトが署名付きまたは短期間のアセットURLを使用している場合、キャッシュされたプレビューがリンクよりも長生きすることがあります。

構造化画像プロパティは曖昧さを減少させます。幅と高さはクライアントがフルアセットをダウンロードする前にレイアウトを計画するのを助けます。メディアタイプはフォーマットを特定するのに役立ちます。代替テキストは、それに触れる消費者にテキストによる説明を提供します。このプロトコルは複数の画像エントリをサポートしますが、順序と選択の動作は実際の配信チャネルでテストする必要があります。

オープングラフ対他のメタデータ

オープングラフ、HTMLのタイトルと説明メタデータ、カノニカルリンク、Schema.orgの構造化データ、およびプラットフォーム固有のカードタグはすべて共存できます。それらは、タイトル、概要、画像、およびURLが互いに矛盾しないように、共有コンテンツモデルから生成されるべきです。各フィールドを独立して保存するコンテンツ管理システムは、エディタが1つの表面だけを更新した後にドリフトを招きます。

MDNのページメタデータガイダンス は、ソーシャルメタデータをより広範なヘッダーメタデータコンテキストに配置します。Schema.orgのマークアップは、構造化データ消費者向けのエンティティと関係を説明します。オープングラフは共有のためのグラフオブジェクトを説明します。カノニカルリンクは、重複または類似のページに対する優先URLを表現します。それらのフィールドは見慣れたものに見えるかもしれませんが、その処理の目的は異なります。

実装ワークフロー

1. オブジェクトのための恒久的な公共URLを設定する前に選択します og:url.
2. 同じ権威あるコンテンツレコードからタイトル、説明、タイプ、および画像を生成します。
3. 画像や他のメディアには絶対URLを使用して、クローラーがページコンテキストの仮定を必要としないようにします。
4. 認証されたブラウザセッションなしで最終ページを取得し、受信したヘッダーメタデータを確認します。
5. 画像を独立して取得し、リダイレクトに従い、メディアタイプを確認し、実際のバイトを検査します。
6. キャンペーンの開始前に消費者固有の共有デバッガーを実行し、キャッシュ更新動作を記録します。

クライアントレンダリングされたメタデータは特別な注意を必要とします。一部のクローラーはほとんどまたは全くJavaScriptを実行しないため、初期HTMLの配信後に挿入されたタグは観察されない可能性があります。最終的なオープングラフプロパティをサーバーでレンダリングすることは、より依存性の高い共有表面を提供します。レンダリング動作が調査中の場合は、ソースHTMLをブラウザレンダリングされたDOMと比較し、各消費者がどの表現を見たかを記録します。

一般的なオープングラフの問題

• 相対画像URL。 消費者はそれらを異なる方法で解決したり、拒否したりする可能性があります。絶対公共URLを使用してください。
• 古くなったキャッシュプレビュー。 ページを更新しても、すべてのプラットフォームがその保存されたカードを直ちに更新するわけではありません。
• カノニカルの不一致。 他の場所を指す og:url は意図しないオブジェクトの周りのエンゲージメントやアイデンティティを統合することができます。
• ブロックされた資産。 認証、ホットリンク管理、トラフィックルール、または画像URLでのHTMLレスポンスがメディアなしのカードを残します。
• 矛盾するメタデータ。 オープングラフ、プラットフォームタグ、ページタイトル、および構造化データは異なる名前や画像を提示する可能性があります。
• アクセス可能な説明が欠落している。 画像は表示できるが、サポートされているクライアント用に有用な代替テキストが不足している場合があります。

HTML標準はmeta要素を文書メタデータとして定義していますが、正確なプロパティ語彙はオープングラフから来ています。 WHATWGのメタ要素定義 は、消費者固有のプロパティ解釈から有効なヘッダー配置を区別するのに役立ちます。バリデーターは、文書構造とオープングラフの意味を両方確認する必要があります。

抽出と監視パイプラインにおけるオープングラフ

メタデータの抽出は、カノニカルアイデンティティ、タイトル、説明、メディアURL、タイプ、ロケール、およびサイト名を含むコンパクトなレコードにページを変換できます。そのデータセットは、リンク監査、ソーシャルカードQA、コンテンツインベントリ、移行チェック、および予期しない変更の監視をサポートします。抽出者は、複数の画像やロケールが意図的な場合があるため、ソース順序で重複プロパティを保持する必要があります。

正規化は、生の値が保存された後に行われるべきです。URLを解決し、ロケール表記を標準化し、メディアレスポンスを検証し、 og:url リダイレクトとカノニカルリンクと比較します。ページテキストからの推測で欠落値を静かに置き換えないでください。派生フォールバックは有用かもしれませんが、オープングラフメタデータとして宣言されるのではなく、派生としてラベル付けされるべきです。

Scrapeless Universal Scraping API は、ワークフローが必要な場合にレンダリングされたコンテンツを含むメタデータ検査のための公共ページを取得できます。取得を決定論的HTML解析と資産チェックと組み合わせます。 Scrapelessの価格 をレビューして、大規模なカタログ監査をスケジュールする前に確認します。

公開チェックリスト

公開前に、共有URLが最終的で、公共で、安定していることを確認します。ページから分離したときにタイトルと説明が意味を成すことを確認します。画像が適切にトリミングされ、有意義な代替テキストがあり、公共のHTTPSロケーションと実際の画像レスポンスを持っていることを確認します。重要な消費者がスクリプトを実行しない場合、メタデータが初期HTMLに表示されることを確認します。

公開後、プレビュー環境ではなく正確な本番URLをテストします。ユニークなターゲット消費者を 1 つ以上使用します。1 つのカードだけでは広範な互換性を証明できません。観察されたカードを保存し、結果を取得し、リリース記録とともにメタデータスナップショットを取得します。後の編集が画像やURLを変更した場合、サポートされているキャッシュを更新し、再確認します。

結論

オープングラフは、URLが共有されたときに Web オブジェクトがどのように表現されるべきかを説明するためのコンパクトなプロトコルです。基本プロパティはタイトル、タイプ、画像、およびアイデンティティを確立し、オプションのプロパティは説明、サイト、ロケール、およびメディアの詳細を追加します。信頼できるカードは、サーバーが可視化したメタデータ、安定したアセット、整合性のあるカノニカルURL、およびプレビューをレンダリングする実際の消費者に対するテストから生まれます。