Fanplayr Docs

日本語

English
Español
Italiano

日本語

English
Español
Italiano

Appearance

カタログフォーマット ​

Fanplayrは、このドキュメントに記載されている形式で製品データをネイティブに消費します。この形式でカタログを提供することが推奨される方法であり、最もスムーズな統合エクスペリエンスを保証します。

お使いのプラットフォームがこの形式を直接生成できない場合は、アカウントマネージャーにオプションについてご相談ください。データがどのように配信されるかに関わらず、この構造を理解することは重要です。これにより、Fanplayrがどのように連携できるかがわかり、提供できる製品データが多ければ多いほど、Fanplayrのレコメンデーションとターゲティングのパフォーマンスが向上します。

実装の準備はできましたか？完全な技術仕様については、フィールドリファレンスを参照してください。

コアコンセプト ​

製品とバリアント ​

Fanplayrは、ほとんどのEコマースストアが在庫を整理する方法にマッピングされる、PRIMARY / VARIANT（プライマリ/バリアント）関係を使用して製品をモデル化します。

PRIMARY（プライマリ）製品は、カタログに表示される最上位の製品です。例えば、「クラシックランニングシューズ」などです。VARIANT（バリアント）製品は、そのプライマリ製品の特定のバリエーションです。例えば、同じ靴のサイズ10、色ブルーなどです。

js
PRIMARY: Classic Running Shoe  // id: "shoe-001"
├── VARIANT: Size 8 / Red      // id: "shoe-001-8-red", primaryProductId: "shoe-001"
├── VARIANT: Size 8 / Blue
├── VARIANT: Size 10 / Red
└── VARIANT: Size 10 / Blue

バリアントは、親のPRIMARY製品と属性のほとんど（タイトル、説明、ブランドなど）を共有しますが、サイズ、色、価格などの属性は異なります。

これが重要な理由：Fanplayrのレコメンデーションは、デフォルトでPRIMARY製品レベルで動作します。正確なバリアントデータを提供することで、Fanplayrはレコメンデーションを行う際に、すべてのバリアントにおけるリアルタイムの在庫状況と価格を考慮に入れることができます。

データへのマッピング方法

お使いのストアでは、これらを「親/子製品」、「構成可能/シンプル製品」、または単に各バリアントを個別のSKUとして参照する場合があります。これらのいずれもPRIMARY/VARIANTモデルにマッピングできます。

カテゴリ ​

Fanplayrは、製品カテゴリを使用してカタログの構造を理解し、カテゴリを意識したレコメンデーションとターゲティングを強化します。

カテゴリは、ストア内の製品の完全なナビゲーションパスを>を区切り文字として使用して表現する必要があります。

"Shoes & Accessories > Shoes > Heels"
"Sports & Fitness > Athletic Clothing > Shoes"

1つの製品は複数のカテゴリに属することができます。カテゴリパスがより正確で完全であるほど、Fanplayrはストア内の特定のセクション内でレコメンデーションをより適切にターゲティングできます。

価格設定 ​

Fanplayrは、現在の価格と元の価格（割引前の価格）の両方をサポートしています。両方を提供することで、Fanplayrは以下のことが可能になります。

  • レコメンデーションウィジェットに正確な価格を表示する
  • セール品や割引製品を特定し、ターゲティングする
  • コストデータも提供されている場合に粗利益を報告する

在庫状況 ​

Fanplayrは製品の在庫状況を追跡し、在庫切れの製品が買い物客に推奨されないようにします。サポートされている在庫状況は次のとおりです。

値意味
IN_STOCK現在購入可能
OUT_OF_STOCK現在入手不可
PREORDER未発売だが、予約購入可能
BACKORDER一時的に在庫切れだが、バックオーダー可能

画像 ​

製品画像は、買い物客に表示されるレコメンデーションウィジェットに直接表示されます。500×500ピクセル以上の高品質な画像を提供することで、レコメンデーションの視覚的な魅力と効果が保証されます。

オーディエンス、色、その他の属性 ​

audience（性別、年齢層）、colorInfo、sizes、materials、patternsなどのフィールドは、Fanplayrが各製品の特性をより詳細に理解するのに役立ちます。これらの属性はレコメンデーションの関連性を向上させます。例えば、男性用シューズが女性カテゴリページで推奨されないようにするなどです。

これらのフィールドはオプションですが、特に幅広い多様な製品範囲を持つストアにとっては価値があります。

必須フィールドの概要 ​

以下のフィールドは、Fanplayrが製品を効果的にインデックス化し、推奨するために最低限必要なものです。

フィールド説明
id固有の製品識別子 — Fanplayr連携で追跡されるIDと一致する必要があります
title製品名
categories少なくとも1つのカテゴリパス
priceInfo現在の価格と通貨コード
uri製品ページのURL

その他のすべてのフィールドはオプションですが、より豊富なデータを提供することでレコメンデーションの品質が向上します。

カタログファイル形式 ​

製品カタログファイル形式には、以下の要件があります。

  • 各カタログアイテムは1行に収める必要があります。
  • ファイルの合計サイズは、圧縮されていない状態で50MBを超えてはなりません。カタログがこれを超える場合は、分割して複数のファイルでインポートしてください。
  • すべてのアイテムは同じ言語と通貨を使用する必要があります。AIモデルのトレーニングに影響を与えるため、単一のカタログ内で言語や通貨を混在させることはできません。ストアに異なる言語や通貨を持つ複数のビューがある場合は、別々のカタログを管理してください。

以下に、2つの製品を含む有効なカタログファイルを示します。

jsonl
{"id":"SHOE-001","type":"PRIMARY","categories":["Women > Shoes","Sports & Fitness > Athletic Clothing > Shoes"],"title":"Classic Running Shoe","description":"Lightweight everyday running shoe with cushioned sole.","brands":["Stridewell"],"availability":"IN_STOCK","availableQuantity":142,"languageCode":"en","priceInfo":{"price":89.99,"originalPrice":119.99,"currencyCode":"USD"},"uri":"https://www.store.com/shoes/classic-running-shoe","images":[{"uri":"https://www.store.com/images/SHOE-001.jpg","width":500,"height":500}],"colorInfo":{"colorFamilies":["White"],"colors":["Cloud White"]},"sizes":["US:WOMENS:7","US:WOMENS:8","US:WOMENS:9","US:WOMENS:10"],"audience":{"genders":["female"],"ageGroups":["adult"]}}
{"id":"JACK-042","type":"PRIMARY","categories":["Men > Clothing > Jackets","Sale > Men"],"title":"Merino Wool Jacket","description":"Slim-fit merino wool jacket suitable for smart casual occasions.","brands":["Nordvik"],"availability":"IN_STOCK","availableQuantity":37,"languageCode":"en","priceInfo":{"price":149.00,"currencyCode":"USD"},"uri":"https://www.store.com/jackets/merino-wool-jacket","images":[{"uri":"https://www.store.com/images/JACK-042.jpg","width":500,"height":500}],"colorInfo":{"colorFamilies":["Gray"],"colors":["Charcoal"]},"sizes":["US:MENS:S","US:MENS:M","US:MENS:L","US:MENS:XL"],"audience":{"genders":["male"],"ageGroups":["adult"]}}

次のステップ ​

  • サポートされているすべてのフィールドのタイプ、制約、例を含む完全な仕様については、フィールドリファレンスを参照してください。
  • 既存の製品フィードがこの構造にどのようにマッピングされるかについて、Fanplayr統合チームにご相談ください。

レガシーフォーマット ​

以前のカタログフォーマットも参照用に利用できます。新規統合には現在のフォーマットを使用する必要があります。

レガシーフォーマットのリファレンスを見る →

Copyright © 2011-present Fanplayr Inc