コレクション
コレクションは、製品をグループ化してショッパーがより速く見つけられるようにするものです。例えば「ランニングシューズ」や「サマーセール」などです。
DataEaseを使用すると、以下のことが可能です:
- 1回のアップロードで数百のコレクションを作成または名前変更できます。
- 製品、ルール、ソース、条件を一括で追加または削除できます。
- 並べ替え順序、画像、SEOテキストを迅速に変更できます。
Shopifyの新しいコレクションモデル(Admin API 2026-07)。 Shopifyはコレクションを「スマート」と「カスタム」に分けなくなりました。コレクションは1つ以上のソースから構成され、各ソースには含める/除外する条件、または手動で選んだ製品・バリアント・サブコレクションが設定できます。DataEaseはSources & conditions列を通じてこのモデルをサポートします(詳細は下記)。従来のルール列・製品列を使ったファイルは、classicの列で表現できるコレクションについてはそのまま動作します。
Shopifyコレクションガイド。
2. エクスポート
Section titled “2. エクスポート”- CSVまたはExcelを選択します。
- エンティティとしてコレクションを選びます。
- 必要なフィールドを選択します-title, sortOrder, ruleColumnなど。新しいモデルで構築されたコレクションをエクスポートするには、Sources & conditions列グループを有効にします。
- オプション: Matrixify-style headers and valuesにチェックを入れると、ソース・条件の列をAPI値(
sourceType,INCLUDE,ANY)ではなくMatrixifyのヘッダーと値(例:Source: Type,Include,any condition)で書き出します。 - タスクを実行し、ファイルをダウンロードします。
classicの列では表現できないコレクション。 コレクションが新しいモデルを、classicのルール列では表現できない形で使っている場合(例えば複数のソース、除外条件、バリアントソース、条件と手動選択の混在など)、その
ruleColumn/ruleRelation/ruleCondition/appliedDisjunctivelyのセルは空のままになり、エクスポートログにSources & conditions列を有効にするよう促す警告が表示されます。classicの列のみを有効にした場合、そのようなコレクションはメイン行のみがエクスポートされます。
ステップバイステップ: エクスポートガイド
3. インポート
Section titled “3. インポート”commandでサポートされるコマンド: CREATE, UPDATE, REPLACE, DELETE, IGNORE
ラインアイテムコマンド(ルールまたは製品): CREATE, MERGE, UPDATE, DELETE, IGNORE
- 手動コレクションの場合は製品行(productId)を使用します。
- スマートコレクションの場合はルール行(ruleColumn / ruleCondition…)を使用します。
- 新しいモデルを使うコレクション(複数のソース、除外条件、バリアントソース、サブコレクション)にはSources & conditions列を使用します。
モードはコレクションごとに決まります。コレクションのいずれかの行がSources & conditions列(例えばsourceTypeやconditionField)を埋めている場合、そのコレクション全体が新しいモードでインポートされ、productId / productHandle / productPositionの行は並び順のみを設定します(製品の追加・削除はしません)。それ以外の場合はclassicの動作が適用され、製品行が手動で選ばれた製品を追加(CREATE, MERGE)、移動(UPDATE)、削除(DELETE)します。
スマートコレクションでのclassic製品行。 既存のスマートコレクションに対して製品行(
productId+itemCommandCREATE)を使ったclassicファイルをインポートすると、それらの製品は手動選択として追加され、コレクションは条件と手動選択が混在した状態になります。その後、そのコレクション(保存済みのスケジュールインポートを含む)へのclassicルールインポートは*“The collection uses the new collections model (MIXED_SELECTIONS_AND_CONDITIONS)“*で失敗します。このようなコレクションにはSources & conditions列を使用してください。
ヒント:
sortOrder = MANUALのコレクションのみがproductPositionを設定できます。
- サンプルファイルをダウンロードします: Collection-import-sample.xlsx
- 必要なフィールドを入力します: CREATEにはtitleとhandle; UPDATE/DELETEにはidまたはhandleを含めます。
- DataEaseで列をマッピングし、アップロードしてインポートを開始します。
完全な手順: インポートガイド
4. フィールドリファレンス
Section titled “4. フィールドリファレンス”-
id— コレクションID。UPDATE、REPLACE、またはDELETEに必要です。 -
command— コレクション行のアクション: CREATE, UPDATE, REPLACE, DELETE, IGNORE。 -
title— ショッパーに表示される名前。 -
handle— URLに適した文字列。ユニークである必要があります。 -
descriptionHtml— HTMLを含むリッチテキストの説明。 -
templateSuffix— 代替のLiquidテンプレート(.liquidを含まない)。 -
sortOrder— デフォルトの製品順序:ALPHA_ASC,ALPHA_DESC,CREATED,CREATED_DESC,MANUAL,MOST_RELEVANT,PRICE_ASC,PRICE_DESC。Admin API 2026-07以降、Shopifyはベストセラー順のコレクションをMOST_RELEVANTとして返すようになったため、エクスポートではBEST_SELLINGの代わりにMOST_RELEVANTが書き出されます。DataEaseはBEST_SELLINGをサポートしなくなりました — ファイルではMOST_RELEVANTを使用してください。 -
updatedAt— 最終更新日(ISO 8601)。エクスポートのみ。
-
seoTitle— カスタムページタイトルタグ。 -
seoDescription— カスタムメタディスクリプション。
-
imageUrl— 特集画像のURL。 -
imageAltText— 画像の代替テキスト。 -
imageHeight— 画像の高さ(px)。エクスポートのみ。 -
imageWidth— 画像の幅(px)。エクスポートのみ。
ラインアイテム(ルールまたは製品)
Section titled “ラインアイテム(ルールまたは製品)”itemCommand— この行のCREATE, MERGE, UPDATE, DELETE, またはIGNORE。
スマートコレクションルールフィールド
Section titled “スマートコレクションルールフィールド”これらのclassic列は、コレクションが単一のルールセットとして表現できる場合のみエクスポート時に埋められます。それ以外の場合は空のままです(エクスポートを参照)。
-
ruleColumn— ルールの製品属性(例: TITLE, TAG, VENDOR)。 -
ruleCondition— ルールが比較する値、例えばShoes。 -
ruleConditionObjectId— 一部のルールタイプに対する追加情報(例: カテゴリーID)。 -
ruleRelation— 演算子: EQUALS, CONTAINS, NOT_EQUALSなど。 -
appliedDisjunctively—true= 任意のルールに一致;false= すべてのルールに一致。
手動コレクション製品フィールド
Section titled “手動コレクション製品フィールド”-
productId— 含める製品のID。 -
productPosition— 位置番号(sortOrder = MANUALの場合のみ機能)。 -
productTitle— 製品タイトル。エクスポートのみ。 -
productHandle— 製品ハンドル。エクスポートのみ。
publicationScope— コレクションが公開される販売チャネル。
メタフィールド
Section titled “メタフィールド”metafields— 追加のアプリフィールド。メタフィールドガイドを参照。
5. フィルター
Section titled “5. フィルター”-
CollectionType— Smart (with conditions)またはCustom (manual only)。Shopifyの新しいモデルにはコレクションタイプがないため、DataEaseはコレクションのソースから判定します: smart = 少なくとも1つの含める条件を持つソースがある場合、custom = それ以外(手動で選んだ製品・サブコレクションのみ、またはソースがない場合)。このフィルターはShopifyがコレクションを返した後に適用されるため、エクスポートフォームのコレクション数が**≤ N**(N以下)と表示される場合があります。 -
Handle— handleに入力したテキストを含むコレクションをエクスポートします。 -
Id— idで単一のコレクションをエクスポートします。 -
ProductId— 特定のproductIdを含むコレクションをエクスポートします。 -
ProductPublicationStatus— コレクション内の製品公開ステータスでフィルターします。 -
PublishableStatus— 準備完了、スケジュール済み、または未公開のコレクションを選択します。 -
PublishedAt— コレクションが表示された日付範囲。 -
PublishedStatus— 公開済みの場合はtrue、非表示の場合はfalse。 -
Title— titleに入力したテキストを含むコレクションをエクスポートします。 -
UpdatedAt— 最終更新日範囲でフィルターします。
ソースと条件
Section titled “ソースと条件”Sources & conditions列グループを有効にすると、Shopifyの新しいコレクションモデルでコレクションをエクスポート・インポートできます。1行 = 1つのソースの1つの条件または1つの手動選択アイテムで、ソースの列はそのソースのすべての行で繰り返されます。コレクションの基本列(handle, titleなど)は通常どおり繰り返されます。
値はAPIスタイル(INCLUDE, ALL, TAGGED_WITH, COMPARE_AT_PRICE)またはMatrixifyスタイル(Include, all conditions, Includes, Compare at price)のいずれでも大文字小文字を区別せずに受け付けます。MatrixifyのCollectionsシートからエクスポートされたファイルは、そのヘッダー(Source: ID, Condition: Fieldなど)で認識されます。
-
sourceId— ソースのID。既存のソースを変更するにはエクスポートされたIDを使い、新しいソースの行をグループ化するには任意のラベル(例:s1)を使います。 -
sourceCommand—MERGE(デフォルト)はソースに行を追加します。REPLACEはソースをクリアしてファイルの内容で埋め直します。DELETEはソースを削除します。 -
sourceType—PRODUCTS,VARIANTS,COLLECTIONS(サブコレクション)、または他のアプリが共有するソース(インポート時は読み取り専用)用のAPP <app id> | PRODUCTS/APP <app id> | VARIANTS。UNKNOWNはエクスポート専用です。 -
sourceTitle— ソースのタイトル。ソース作成時に空の場合、DataEaseがコレクションタイトルから自動生成します。 -
sourceDescription— ソースの説明。 -
inclusionType—INCLUDE(デフォルト)またはEXCLUDE。 -
inclusionMatch—ALLまたはANY: 製品がソースの含める(または除外する)条件のすべてに一致する必要があるか、いずれかに一致すればよいか。新しいソースのデフォルトはALLです。 -
conditionCommand—MERGE(デフォルト)はまだ存在しない条件を追加します。DELETEは条件を削除します。条件の値を変更するには、古い条件を削除して新しい条件を追加するか、sourceCommand=REPLACEを使用します。 -
conditionField—TAG,TITLE,TYPE,VENDOR,STATUS,CATEGORY,CATEGORY_WITH_SUBCATEGORIES,PRICE,COMPARE_AT_PRICE,INVENTORY_STOCK,WEIGHT,VARIANT_TITLE,COLLECTION(除外専用),MANUAL_SELECTION,METAFIELD: namespace.key,VARIANT_METAFIELD: namespace.key。UNKNOWNはエクスポート専用です(DataEaseが書き出せない条件で、インポート時にはこの行は警告付きでスキップされます)。 -
conditionRelation— 演算子。例:TAGGED_WITH,EQUALS,CONTAINS,DOES_NOT_CONTAIN,GREATER_THAN,IS_SET,INCLUDES。MANUAL_SELECTIONとCOLLECTIONでは空にします。 -
conditionValue— 値(カンマ区切り、リテラルのカンマは\,)。価格は通貨をオプションで指定できます(12.50 EUR、デフォルトはショップの通貨)。重量は単位をオプションで指定できます(1.5 kg、デフォルトはショップの単位)。MANUAL_SELECTIONでは1行につき1つの製品handleまたはID、バリアントの場合はproduct-handle | Variant Title、COLLECTIONSソースの場合はコレクションhandleを使用します。エクスポートはファイルをストア間で移動できるようhandleを書き出します。 -
conditionMatch— 複数の値を持つ条件に対してANY(デフォルト)またはALL。インポート時はOR/ANDも受け付けます。
新しいモードでは、productId / productHandle / productPositionの行は(sortOrder = MANUALの場合の)並び順のみを設定します。新しいモデルのShopifyの制限は、インポートがShopifyを呼び出す前にチェックされます: コレクションあたり最大10ソース、ソースあたり最大60条件(値ごとにカウント)、除外コレクション最大5、サブコレクション最大10、手動除外最大1,000です。
例 — 1つのソースにタグ条件、手動選択、手動除外をまとめる:
handle,title,sourceId,sourceType,sourceTitle,inclusionType,inclusionMatch,conditionField,conditionRelation,conditionValue,conditionMatchvegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,ANY,TAG,TAGGED_WITH,"vegan,plant-based",ANYvegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,,MANUAL_SELECTION,,oat-milk,vegan,Vegan picks,s1,PRODUCTS,Vegan tag,EXCLUDE,,MANUAL_SELECTION,,leather-belt,同じファイルを再インポートしても、ソースや条件が重複して作成されることはありません。
お困りですか?サポートチームが24時間以内にお答えします。
追加フィールド
Section titled “追加フィールド”このエンティティに対してDataEaseがサポートするその他の列:
productsCount— コレクション内の製品数。