メインコンテンツへスキップ
これはプレミアム機能です。Kameleoon アカウントで有効化するには、カスタマーサクセスマネージャーにお問い合わせください。
商品カタログを Kameleoon に同期する簡単な方法は 4 つあります。
  1. 各商品に必要なすべてのメタデータを含む XML ファイル を使用します。データレイヤーがなく、カタログに 50,000 未満の商品が含まれている場合は、この方法を使用してください。Kameleoon がカタログを同期する頻度は、ストア設定ページで簡単に選択できます。商品の在庫を Kameleoon に更新するには、24〜72 時間ごとに 1 回 XML インポートを実行する必要があります。
  2. Google Merchant Feed URL を使用します。既に Google Merchant Center に商品をアップロードしており、カタログに 50,000 未満の商品が含まれている場合は、この方法を使用してください。この方法を有効にするには、Kameleoon カスタマーサクセスマネージャーにお問い合わせください。次の手順に従って、Google Merchant と Kameleoon を同期してください。
  3. Kameleoon の REST API 経由。在庫が少なく入手可能な商品を扱う場合など、定期的な更新が必要な場合は、Kameleoon の REST API を使用してカタログを更新してください。
  4. Kameleoon の Product API 経由。商品および商品カテゴリに関する詳細情報を含むデータレイヤーがある場合は、この方法を使用する必要があります。Kameleoon の API を使用するには、商品ページから商品およびカテゴリのメタデータを利用できる（例：データレイヤー内）必要があり、Kameleoon がそれを読み取り、商品レコメンデーションアルゴリズムに供給できる必要があります。
制限（gzip 圧縮ファイル）は 2GB に設定されていますが、カタログが大きいほど、フィードの処理に時間がかかることに留意してください。そのため、6 時間以上の同期を選択してください。
Kameleoon は、フィードに存在しないすべての商品を自動的に在庫切れとしてマークします。したがって、フィード処理速度を向上させ、サイズを削減するために、在庫切れの商品はフィードから除外することをお勧めします。Product API メソッドの 1 つの欠点として、訪問者が商品を積極的に検索したり閲覧したりしない場合、Kameleoon がそれらの商品を認識せず、商品レコメンデーションブロックで提案されない可能性があることに注意してください。

​
Kameleoon Product API を使用した商品フィードの同期

Product API は、Kameleoon の商品レコメンデーションアルゴリズムと、商品インプレッションおよび購入カウンターや高度なターゲティング条件などのソーシャルプルーフィングメッセージングを強化します。 Kameleoon の Product API メソッドがウェブサイトで有効化されると、訪問者が商品またはカテゴリページを閲覧したり、商品をカートに追加したり、購入を行ったりするたびに、Kameleoon は商品詳細イベントの送信を開始します。また、特定の商品に関する統計の収集（例：過去 1 時間または 1 日に購入または閲覧された回数）を可能にし、事前定義された商品ターゲティング基準を使用してセグメントビルダーで使用できるオーディエンスグループの作成を強化します。 商品とのインタラクションを追跡し、商品レコメンデーションアルゴリズムに情報を提供するために、商品ページ、カテゴリページ、カートページ、Thank you ページのスニペットをソースコードに追加する必要があります。Global custom script 機能を使用してそれらを注入することもできます。

​
trackProductView()

商品ページ で trackProductView() メソッドを使用して、訪問者が商品を閲覧したことを追跡します。メソッドの詳細についてはこちらをご覧ください。
ソーシャルプルーフィング設定に必要なすべてのデータを提供してください。trackProductView() メソッドを介して送信されたデータのみが、後で obtainProductData() エンドポイントを通じて取得できます。

​
trackCategoryView()

カテゴリページ で trackCategoryView() メソッドを使用して、訪問者が商品カテゴリを閲覧したことを追跡します。メソッドの詳細についてはこちらをご覧ください。 ここで使用される カテゴリ ID が trackProductView() メソッドで送信されたものと一致することを確認してください。Category オブジェクトの詳細についてはこちらをご覧ください。

​
trackAddToCart()

訪問者が商品をカートに追加できる任意のページ で trackAddToCart() メソッドを使用します。例えば、ホームページ、商品ページ、カテゴリページ、カートページなどです。 trackAddToCart() メソッドの詳細についてはこちらをご覧ください。

​
trackTransaction()

訪問者が 購入または取引 を完了した後に表示される任意のページで trackTransaction() メソッドを使用します。メソッドの詳細についてはこちらをご覧ください。
Kameleoon は 2 時間ごとに商品カタログ全体を同期し、12 時間ごとに在庫切れ商品を自動的に「unavailable」としてタグ付けします。商品は、addProductView メソッドで渡される availableQuantity 属性がゼロに等しい場合に利用不可と見なされ、Kameleoon の商品レコメンデーションには在庫のある商品のみが含まれることが保証されます。addProductView メソッドを使用する際に、availableQuantity 属性を使用して商品を在庫切れに設定することもできます。

​
XML ファイルを使用した商品フィードの同期

XML ファイルを使用して商品カタログを同期するには、以下の手順が含まれます。
  1. 各商品、カテゴリ、場所（例：営業しており、商品の価格、在庫、または詳細が異なる国や場所）に必要なすべてのメタデータを含む XML ファイルを作成します。ファイルは離れた URL から利用可能でなければなりません。Kameleoon がアクセスできる安全な領域（例：S3 バケット）にホストしてください。
  2. XML ファイルを Kameleoon と同期し、ニーズに合った更新間隔を選択します（例：1 時間ごと、3 時間ごと、6 時間ごと）。
  3. 訪問者のイベントを追跡します。
複数言語のウェブサイトはサポートされていません。各言語に対して別々のプロジェクトを作成し、それぞれに 1 つのフィードを提供する必要があります。
シームレスな画像ダウンロードプロセスを保証するために、以下の IP アドレスをホワイトリストに登録してください。
  • 95.216.99.81/26
  • 95.216.99.220/26
  • 95.216.23.145/26
  • 95.216.10.183/26
  • 95.216.114.218/26
  • 95.217.32.105/26
  • 95.216.4.144/26
  • 95.216.102.29/26

​
ステップ 1: 商品フィードを作成する

商品フィードには、カタログに関する基本情報を含める必要があります。含める必要がある必須属性については、以下の表を参照してください。 
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
  <shop>
    <categories>
      <category id="270821163172" parentId="2708" url="https://myurl.com">Adidas</category>
       .......
    </categories>
    <offers>
      <offer id="6737859641508" available="true" leftovers="lot"></offer>
      ......	
    </offers>
   </shop>
</yml_catalog>

​
要素: yml_catalog

属性必須説明
dateはいXML ドキュメントの生成日。形式は YYYY-MM-DD hh:mm

​
要素: yml_catalog > shop

要素必須説明
categoriesはいストアカテゴリのリスト
locationsはいストアが代表される場所/国のリスト
offersはいストア商品のリスト

​
要素: yml_catalog > shop > categories

categories 要素には、カテゴリ要素のリストが含まれています。商品をグループ化またはタグ付けするために使用する各商品カテゴリは、別々の category 要素で記述されます。
属性必須説明
idはいカテゴリ ID
parentIdいいえ親カテゴリ ID
urlいいえカテゴリページへのリンク
aliasいいえカテゴリのエイリアス識別子
例: 
<categories>
  <category id="2" url="http://my-store.com/categories/discount/"> Category level 1</category>
  <category id="8" url="http://my-store.com/categories/men/">Category level 1</category>
  <category id="13" parentId="8" url="http://my-store.com/categories/men/shoes/">Category level 2</category>
  <category id="97" parentId="13" alias="men/shoes/leather" url="http://my-store.com/categories/men/shoes/leather">Category level 3</category>
</categories>

​
要素: yml_catalog > shop > locations

locations 要素には、ストアの場所のリストが含まれています。各場所は、別々の location 要素で記述されます。 locations 要素には次の属性を使用できます。
属性必須説明
idはい場所 ID
parentIdいいえ親の場所 ID
typeいいえ場所のタイプ。利用可能な値: state、city、store
nameいいえ場所の名前
例: 
<locations>
   <location id="1" type="city" name="New York" />
   <location id="2" type="city" name="Los Angeles" />
   <location id="145" parentId="1" type="store" name="New York City main store" />
</locations>

​
要素: yml_catalog > shop > offers

offers 要素には、商品のリストが含まれています。各商品は、別々の offer 要素で記述されます。
ある商品のすべてのバリアントがストアの同じ URL から利用可能で、商品バリアントの共通識別子がない場合、Kameleoon はこの商品を訪問者に推奨する際に最も安価な商品バリアントを選択します。この場合の在庫フラグは次のロジックに従う必要があります。少なくとも 1 つの商品バリアントが在庫にあれば、その商品は在庫ありと見なされます。

​
要素: yml_catalog > shop > offers > offer

offer 要素には次の属性を使用できます。
属性必須説明
idはい商品 ID / SKU / EAN
group_idいいえ商品グループ ID。商品バリアントを 1 つのグループに結合するために必要です。Kameleoon は、訪問者にこの商品を推奨する際に最も安価なバリアントを選択します
availableはい商品が在庫にあるかどうかの表示（「true/false」）。Kameleoon は、フィードに含まれていないすべての商品を自動的に在庫切れにします。したがって、フィード処理速度を上げ、サイズを削減するために、在庫切れの商品をフィードに追加しないでください。
leftoversいいえ特定の商品の在庫がどれだけ利用可能かの表示。次のいずれかの値を取ることができます: one（商品は 1 つのみ利用可能）、few（商品は限定数で利用可能 — 最大 10 ユニット）、lot（商品は 10 ユニット以上で利用可能）
offer 要素は次のタグを取ることができます。
要素必須説明
nameはい商品名
pictureはい商品のメイン画像
priceはい商品のベース価格
urlはい商品詳細ページへの URL（HTTP/HTTPS で始まる）
categoryIdはい商品カテゴリ。商品が複数のカテゴリに関連付けられている場合、必要な数の categoryId 要素を追加します
locationsいいえ商品のプロパティ（価格、在庫状況）が場所によって異なる場合に必須です。以下の表と例を参照してください
accessoriesいいえ現在の商品の補完または同等となる可能性のある商品のリスト。現在の商品と組み合わせて（または代替として）使用できる商品を推奨できます。通常、ファッションまたは自動車ストアに必要で、このタグは Store Recommendations アルゴリズムとのみ互換性があります。
oldpriceいいえアイテムの以前の価格。商品レコメンデーションブロックで割引価格を表示するために使用します。
price_marginいいえ商品の価格マージンの重み付け係数（0〜100）。商品レコメンデーションブロックでより高いマージンを持つ商品を表示するために使用します。
barcodeいいえ商品バーコードまたは SKU。Kameleoon の検索アルゴリズム用に使用されます。
typePrefixいいえ商品タイプ（例：「mobile phone」、「washing machine」、「corner sofa」）。Kameleoon の検索アルゴリズム用に使用されます。
vendorいいえ製造業者/ブランド
vendorCodeいいえ製造業者/ブランドのコード。Kameleoon の検索アルゴリズム用に使用されます。
modelいいえモデルと商品名（例：iPhone 17 128GB）。Kameleoon の検索アルゴリズム用に使用されます。
seasonalityいいえ商品の季節性。この商品を年間の一部の月のみ推奨することができます。必要な数の要素を追加します。以下の例を参照してください
is_newいいえ商品が新しい場合は「1」である必要があります。アルゴリズム「New arrivals」を使用する場合に必要です
ratingいいえ商品評価。0 から 5 までの値を取る必要があります。商品に評価がない場合は 0 でなければなりません
descriptionいいえ商品説明
stock_quantityいいえ商品の在庫数の表示
tagsいいえ商品を説明する追加情報。Kameleoon の検索アルゴリズム用に使用されます。最大 5 つのタグを追加できます。以下の表と例を参照してください
paramいいえKameleoon が提供する検索リスティングページでフィルタリングオプションを提供するために使用します。必要な数の param 要素を追加します。以下の例を参照してください
authorいいえオンラインで本を販売する場合のみ必要
publisherいいえオンラインで本を販売する場合のみ必要
seriesいいえオンラインで本を販売する場合のみ必要
yearいいえオンラインで本を販売する場合のみ必要
ISBNいいえオンラインで本を販売する場合のみ必要
例: 
<accessories>
    <accessory id="5574" />
    <accessory id="131" />
    <accessory id="99444" />
    <accessory id="334411" />
</accessories>

​
要素: yml_catalog > shop > offers > offer > locations

locations 要素には、場所のリストと、これらの場所での現在の商品の在庫状況と価格が含まれています。各場所は、offer タグ内の別々の location 要素で記述されます。 locations 要素には次の属性を使用できます。
属性必須説明
idはい現在の商品がリストされている場所の ID。Shop 要素の locations 要素のいずれかの ID である必要があります（前のセクションを参照）。必要な数の要素を追加します。
商品は、offer 要素にリストされている場所でのみ購入可能と見なされます。リストされていないその他の場所では、商品は在庫切れと見なされます。商品がすべての場所で利用可能な場合、場所を追加する必要はありません。Kameleoon は自動的にすべての場所で商品を在庫ありと見なします。
locations 要素は次のタグを取ることができます（商品が一部の場所で異なる価格/在庫数を持つ場合のみ必要）。
要素必須説明
priceいいえリストされた場所での商品の価格
oldpriceいいえ場所での商品の以前の価格
stock_quantityいいえ場所での商品の在庫数

​
要素: yml_catalog > shop > offers > offer > fashion

衣料品を販売している場合、fashion タグを使用します。 fashion 要素は次のタグを取ることができます。
要素必須説明
genderいいえ商品の性別。「f」（Female）または「m」（Male）でなければなりません。
typeいいえ商品タイプ。許可される値については、以下の表を参照してください。
sizesいいえ商品の利用可能なサイズ。許可される値については、以下の表を参照してください。
colorいいえ商品の色。以下の例を参照してください。
featureいいえ商品の特殊性。この要素を使用して、商品が大人専用か子供専用かを示します。値「child」または「adult」を取る必要があります。
関連性がない場合は gender 要素を指定しないでください。商品は「unisex」とラベル付けされ、同じ性別の他の商品よりもレコメンデーション優先度が低くなります。
type 要素は次の値を取ることができます。
要素の値（gender）説明
shoe靴
shirtシャツ、ブラウス、ドレス
tshirtT シャツ
underwear下着
trouserパンツ、ジーンズ、ショーツ、スカート、水着
jacketジャケット、コート、毛皮のコート
blazerブレザー、ベスト、ジャンパー
sockソックス
beltベルト
hat帽子
glove手袋
例: 
<offer ...>
    ...
    <fashion>
        <gender>f</gender>
        <type>shoe</type>
    </fashion>
</offer>
sizes パラメータを使用する場合、type パラメータは必須です。sizes 要素内に必要な数の size タグを追加することで、利用可能なサイズのリストを追加できます（以下の例を参照）。複数の locations があり、商品サイズの可用性が場所によって異なる場合は、各 size 要素内に利用可能なサイズのリストを持つ location タグを挿入してください（以下の例を参照）。
説明例
ヨーロッパサイズe38
国際サイズM、L、u30
UK サイズb6
高さ（子供向け商品の場合）h89-95
ワンサイズフィットオールnull
例: 
<offer ...>
    ...
    <fashion>
        <gender>f</gender>
        <type>shoe</type>
        <feature>adult</type>
        <sizes>
            <size>e41</size>
            <size>e42</size>
            <size>e44</size>
            <size>e48</size>
        </sizes>
    </fashion>
</offer>
<offer ...>
    ...
    <fashion>
        <gender>m</gender>
        <type>jacket</type>
        <sizes>
            <size value="M">
              <location id="3"/>
            </size>
        </sizes>
    </fashion>
</offer>
1 つの商品には複数の色を利用可能にすることができます。picture 属性を追加することで、色に対する特定の画像を設定できます。それ以外の場合は、メインの画像が表示されます。
例: 
<offer ...>
    ...
    <fashion>
        <gender>f</gender>
        <type>shirt</type>
        <color>white</color>
        <color picture="https://example.com/products/shirts/395532-blue.jpg">blue</color>
    </fashion>
</offer>

​
要素: yml_catalog > shop > offers > offer > auto

自動車部品およびアクセサリを販売している場合、auto タグを使用します。Kameleoon のアルゴリズムは、車のブランドやモデルなどの特定の特性を持つ潜在的な購入者を自動的に認識するように設計されています。特定の車のブランドおよびモデルとのみ互換性がある部品とアクセサリをレコメンデーションブロックに表示するために使用されます。 auto 要素には、互換性のある車のリストが含まれています。各車のブランドとモデルは、別々の compatibility 要素で記述されます。
商品がすべての車と互換性がある場合、compatibility 要素を追加する必要はありません。商品があるブランドのすべての車モデルと互換性がある場合、model 属性を追加する必要はありません。
compatibility 要素には次の属性を使用できます。
属性必須説明
brandはい車のブランド
modelいいえ車のモデル
商品が車のリストとのみ互換性がある場合、互換性のある各車に対して vds 要素を追加することもできます。vds には、車の指紋となる Vehicle Identification Number（VIN）が含まれます。 例: 
<offer ...>
    ...
    <auto>
        <compatibility brand="BMW" />
        <compatibility brand="Mini" model="Cooper S" />
        <compatibility brand="Mini" model="Cooper C" />
        <vds>BP8AN5</vds>
        <vds>BP8AN5</vds>
    </auto>
</offer>

​
要素: yml_catalog > shop > offers > offer > tags

tags 要素には、商品に関連付けられたタグのリストが含まれています。これは、Kameleoon の検索エンジンレコメンデーションを改善するのに役立ちます。各値は、別々の tag 要素で記述されます。
要素必須説明
tagはいタグ値
テンプレートとして使用できる XML ファイルの例は以下のとおりです:
  • XML 商品フィード - 例 1（locations 要素なし）:
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
	<shop>
		<categories>
			<category id="270821163172" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/adidas">Adidas</category>
			<category id="270821261476" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/asics">Asics</category>
			<category id="270821228708" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/converse">Converse</category>
			<category id="270821425316" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/drmartens">Dr Martens</category>
			<category id="270821490852" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/flex">Flex</category>
			<category id="2708211" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/trainers">Sneakers</category>
			<category id="2708" url="https://kameleoon-store.myshopify.com/collections/all">Shoes</category>
		</categories>
		<offers>
			<offer id="6737859641508" available="true" leftovers="lot">
				<url>https://kameleoon-store.myshopify.com/products/adidas-kids-stan-smith</url>
				<price>50.99</price>
				<oldprice>90</oldprice>
				<price_margin>45</price_margin>
				<categoryId>270821163172</categoryId>
				<categoryId>2708211</categoryId>
				<picture>https://cdn.shopify.com/s/files/1/0564/9180/2788/products/7883dc186e15bf29dad696e1e989e914_grande.jpg?v=1622707556</picture>
				<name>ADIDAS | KID'S STAN SMITH</name>
				<is_new>1</is_new>
				<rating>4</rating>
				<vendor>Adidas</vendor>
				<description>The Stan Smith owned the tennis court in the '70s. Today it runs the streets with the same clean, classic style. These kids' shoes preserve the iconic look of the original, made in leather with punched 3-Stripes, heel and tongue logos and lightweight step-in cushioning. </description>
				<stock_quantity>300</stock_quantity>
				<tags>
					<tag>Sneakers</tag>
					<tag>Lean low top sneakers</tag>
					<tag>Men sneakers</tag>
				</tags>
				<fashion>
					<type>shoe</type>
					<color>black</color>
					<sizes>
						<size>9</size>
					</sizes>
					<feature>child</feature>
				</fashion>
				<param name="Size" unit="EU">9</param>
				<param name="Color">white</param>
			</offer>
			<offer id="6737859641509" available="false">
			......
			</offer>	
		</offers>
	</shop>
</yml_catalog>
  • XML 商品フィード - 例 2（locations 要素あり）:
<?xml version="1.0" encoding="UTF-8"?>
<yml_catalog date="2022-10-03 22:00">
	<shop>
		<categories>
			<category id="270821163172" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/adidas">Adidas</category>
			<category id="270821261476" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/asics">Asics</category>
			<category id="270821228708" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/converse">Converse</category>
			<category id="270821425316" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/drmartens">Dr Martens</category>
			<category id="270821490852" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/flex">Flex</category>
			<category id="2708211" parentId="2708" url="https://kameleoon-store.myshopify.com/collections/trainers">Sneakers</category>
			<category id="2708" url="https://kameleoon-store.myshopify.com/collections/all">Shoes</category>
		</categories>		
		<locations>
			<location id="1" type="city" name="New York" />
			<location id="2" type="city" name="Los Angeles" />
			<location id="145" parentId="1" type="store" name="New York City main store" />
		</locations>		
		<offers>
			<offer id="6737859641508" available="true" leftovers="lot">
				<url>https://kameleoon-store.myshopify.com/products/adidas-kids-stan-smith</url>
				<price>50.99</price>
				<oldprice>90</oldprice>
				<categoryId>270821163172</categoryId>
				<categoryId>2708211</categoryId>
				<picture>https://cdn.shopify.com/s/files/1/0564/9180/2788/products/7883dc186e15bf29dad696e1e989e914_grande.jpg?v=1622707556</picture>
				<name>ADIDAS | KID'S STAN SMITH</name>
				<is_new>1</is_new>
				<rating>4</rating>
				<vendor>Adidas</vendor>
				<description>The Stan Smith owned the tennis court in the '70s. Today it runs the streets with the same clean, classic style. These kids' shoes preserve the iconic look of the original, made in leather with punched 3-Stripes, heel and tongue logos and lightweight step-in cushioning. </description>
				<stock_quantity>300</stock_quantity>
				<tags>
					<tag>Sneakers</tag>
					<tag>Men</tag>
				</tags>
				<locations>
					<location id="145">
						<price>63</price>
						<oldprice>90</oldprice>
						<stock_quantity>90</stock_quantity>
					</location>
				</location>
				<customerRecommendations>67378596415,673785964150821,673785964150,673785964150811</customerRecommendations>
			</offer>
			<offer id="6737859641509" available="false">
				......
			</offer>	
		</offers>
	</shop>
</yml_catalog>

​
ステップ 2: 商品フィードファイルを Kameleoon と同期する

デフォルトでは、Kameleoon フィードは XML ファイルと 24 時間ごとに同期されます。ただし、商品カタログがより頻繁に更新される場合は、この設定を変更できます。Store settings で調整できます。
特定の時間にインポートが開始されるようにスケジュールすることもできます。このオプションを有効にするには、Kameleoon カスタマーサクセスマネージャーにお問い合わせください。

​
ステップ 3: 訪問者のイベントを追跡する

XML 商品フィードを同期するだけでなく、商品閲覧、カート追加、取引などの商品イベントを追跡するためのイベントを実装する必要があります。

​
商品閲覧

trackProductView メソッドを使用する必要があります。 Kameleoon.API.Products.trackProductView("ProductID/SKU/EAN"); 詳細な手順を読む

​
trackAddToCart()

商品が訪問者のカートに追加されたとき、または訪問者がカートページにアクセスしたときは、必ず trackAddToCart() メソッドを使用する必要があります。 Kameleoon.API.Products.trackAddToCart("ProductID/SKU/EAN"); 詳細な手順を読む

​
Transaction

Kameleoon.API.Products.trackTransaction([
	{
	 "productID": "ProductID/SKU/EAN 1",
	 "quantity": 1
	}
]);
詳細な手順を読む

​
フィード同期ステータスを検証する

Kameleoon の Product API を使用している場合、obtainProductData メソッドを使用して実装が成功したかどうかを確認できます。このメソッドを使用すると、実装をリアルタイムで簡単に QA でき、Kameleoon が商品属性を正しく収集したことを確認できます。 Data feed メニューを使用して商品カタログを可視化できます。
インポートの問題をトラブルシューティングするために、Imports log メニューから直接インポートログにアクセスすることもできます。
次に、任意の行をクリックして詳細なインポートログにアクセスできます。