From 4d2b5dcae540b1b76ca8c65055c1ab7d1227229e Mon Sep 17 00:00:00 2001 From: Jo Date: Mon, 12 Aug 2024 16:50:52 +0100 Subject: [PATCH 1/8] first draft --- .../pxm/custom-relationships/crcharacteristics.mdx | 6 ++++++ docs/partials/pxm/custom-relationships/croveriew.mdx | 9 +++++++++ .../products/custom-relationships/_category_.json | 5 +++++ .../products/custom-relationships/characteristics.mdx | 10 ++++++++++ .../products/custom-relationships/overview.mdx | 10 ++++++++++ 5 files changed, 40 insertions(+) create mode 100644 docs/partials/pxm/custom-relationships/crcharacteristics.mdx create mode 100644 docs/partials/pxm/custom-relationships/croveriew.mdx create mode 100644 guides/key-concepts/product-experience-manager/products/custom-relationships/_category_.json create mode 100644 guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx create mode 100644 guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx diff --git a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx new file mode 100644 index 00000000..2a2809d6 --- /dev/null +++ b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx @@ -0,0 +1,6 @@ +Custom relationships have the following characteristics: + +- Each relationship that you define must have a unique slug. +- Each relationship slug is prefixed with CRP. Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship. +- A product can be included in 5 or less custom relationships. +- Custom relationships can have 2000 or less products. diff --git a/docs/partials/pxm/custom-relationships/croveriew.mdx b/docs/partials/pxm/custom-relationships/croveriew.mdx new file mode 100644 index 00000000..cd027b9f --- /dev/null +++ b/docs/partials/pxm/custom-relationships/croveriew.mdx @@ -0,0 +1,9 @@ +You can create custom relationships between products in Product Experience Manager. This enables you to link or associate your products in certain ways based on various criteria. These relationships help improve user experience, boost sales, and enhance product discoverability. + +There are some common custom relationship types. + +- Cross-selling: Suggesting related products that customers who might want to buy in addition to the product they are viewing. For example, if a customer is looking at laptops, you might suggest memory cards, laptop bags, external mouse, and so on. Cross-selling encourages customers to purchase complementary items. +- Up-selling or alternative products: Suggesting products that serve the same function as the product a customer is viewing, but may be different brands, prices, better specifications, or additional features. This ensures customers find the best product for their needs and may increase the order value by guiding customers to more premium options. +- Custom collections: Create custom collections of products that share a theme, like **Back to School** or **Summer Holiday Fashion**. These guide customers to multiple products that fit a specific purpose or occasion. + + diff --git a/guides/key-concepts/product-experience-manager/products/custom-relationships/_category_.json b/guides/key-concepts/product-experience-manager/products/custom-relationships/_category_.json new file mode 100644 index 00000000..3909f80a --- /dev/null +++ b/guides/key-concepts/product-experience-manager/products/custom-relationships/_category_.json @@ -0,0 +1,5 @@ +{ + "position": 31, + "label": "Custom Relationships", + "collapsible": true +} diff --git a/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx b/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx new file mode 100644 index 00000000..9a4d76a1 --- /dev/null +++ b/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx @@ -0,0 +1,10 @@ +--- +title: Custom Relationship Characteristics +nav_label: Custom Relationship Characteristics +sidebar_position: 10 +--- + +import CrCharacteristics from "/docs/partials/pxm/customrelationships/crcharacteristics.mdx"; + + + diff --git a/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx b/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx new file mode 100644 index 00000000..b67d4bb2 --- /dev/null +++ b/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx @@ -0,0 +1,10 @@ +--- +title: Overview +nav_label: Overview +sidebar_position: 5 +--- + +import CrOverview from "/docs/partials/pxm/customrelationships/croverview.mdx"; + + + From aaf5fd9ed61d0cfe0fd133cf7ac6fb581baccf70 Mon Sep 17 00:00:00 2001 From: Jo Date: Mon, 12 Aug 2024 17:32:30 +0100 Subject: [PATCH 2/8] first draft --- .../pxm/custom-relationships/{croveriew.mdx => croverview.mdx} | 0 .../products/custom-relationships/characteristics.mdx | 2 +- .../products/custom-relationships/overview.mdx | 2 +- 3 files changed, 2 insertions(+), 2 deletions(-) rename docs/partials/pxm/custom-relationships/{croveriew.mdx => croverview.mdx} (100%) diff --git a/docs/partials/pxm/custom-relationships/croveriew.mdx b/docs/partials/pxm/custom-relationships/croverview.mdx similarity index 100% rename from docs/partials/pxm/custom-relationships/croveriew.mdx rename to docs/partials/pxm/custom-relationships/croverview.mdx diff --git a/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx b/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx index 9a4d76a1..01a9c94f 100644 --- a/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx +++ b/guides/key-concepts/product-experience-manager/products/custom-relationships/characteristics.mdx @@ -4,7 +4,7 @@ nav_label: Custom Relationship Characteristics sidebar_position: 10 --- -import CrCharacteristics from "/docs/partials/pxm/customrelationships/crcharacteristics.mdx"; +import CrCharacteristics from "/docs/partials/pxm/custom-relationships/crcharacteristics.mdx"; diff --git a/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx b/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx index b67d4bb2..546b8a6c 100644 --- a/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx +++ b/guides/key-concepts/product-experience-manager/products/custom-relationships/overview.mdx @@ -4,7 +4,7 @@ nav_label: Overview sidebar_position: 5 --- -import CrOverview from "/docs/partials/pxm/customrelationships/croverview.mdx"; +import CrOverview from "/docs/partials/pxm/custom-relationships/croverview.mdx"; From b5d4cabf55b0bf274243e175c3c87c61c1884510 Mon Sep 17 00:00:00 2001 From: Jo Date: Wed, 21 Aug 2024 10:01:51 +0100 Subject: [PATCH 3/8] first draft --- .../pxm/custom-relationships/crcharacteristics.mdx | 8 +++++--- docs/partials/pxm/custom-relationships/croverview.mdx | 4 ++-- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx index 2a2809d6..10f2453e 100644 --- a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx +++ b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx @@ -1,6 +1,8 @@ Custom relationships have the following characteristics: +- Custom relationships are bidirectional. For example, if Product A is linked to Product B, then Product B is automatically linked to Product A as well. If a customer views Product A and there's a bidirectional relationship with Product B, Product B will be suggested or related to Product A, and vice versa. This helps in improving product discoverability and ensuring consistent user experiences across your storefront. - Each relationship that you define must have a unique slug. -- Each relationship slug is prefixed with CRP. Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship. -- A product can be included in 5 or less custom relationships. -- Custom relationships can have 2000 or less products. +- Each relationship slug is prefixed with CRP (custom relationship product). Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship. +- A product can be included in up to 5 relationships. +- Custom relationships can have up to 2000 products. + diff --git a/docs/partials/pxm/custom-relationships/croverview.mdx b/docs/partials/pxm/custom-relationships/croverview.mdx index cd027b9f..590399dc 100644 --- a/docs/partials/pxm/custom-relationships/croverview.mdx +++ b/docs/partials/pxm/custom-relationships/croverview.mdx @@ -1,9 +1,9 @@ -You can create custom relationships between products in Product Experience Manager. This enables you to link or associate your products in certain ways based on various criteria. These relationships help improve user experience, boost sales, and enhance product discoverability. +You can create custom relationships between products in Product Experience Manager, allowing you to link or associate your products in certain ways based on criteria of your choosing. These relationships help improve user experience, boost sales, and enhance product discoverability. There are some common custom relationship types. - Cross-selling: Suggesting related products that customers who might want to buy in addition to the product they are viewing. For example, if a customer is looking at laptops, you might suggest memory cards, laptop bags, external mouse, and so on. Cross-selling encourages customers to purchase complementary items. -- Up-selling or alternative products: Suggesting products that serve the same function as the product a customer is viewing, but may be different brands, prices, better specifications, or additional features. This ensures customers find the best product for their needs and may increase the order value by guiding customers to more premium options. +- Up-selling or alternative products: Suggesting products that serve the same function as the product a customer is viewing, but may be different brands, prices, better specifications, or have additional features. This ensures customers find the best product for their needs and may increase the order value by guiding customers to more premium options. - Custom collections: Create custom collections of products that share a theme, like **Back to School** or **Summer Holiday Fashion**. These guide customers to multiple products that fit a specific purpose or occasion. From 48619e0ba823dba6963f8e4011d50ca080df005b Mon Sep 17 00:00:00 2001 From: Jo Date: Fri, 23 Aug 2024 10:57:15 +0100 Subject: [PATCH 4/8] first draft --- docs/partials/pxm/custom-relationships/crcharacteristics.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx index 10f2453e..423e2b8b 100644 --- a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx +++ b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx @@ -2,7 +2,7 @@ Custom relationships have the following characteristics: - Custom relationships are bidirectional. For example, if Product A is linked to Product B, then Product B is automatically linked to Product A as well. If a customer views Product A and there's a bidirectional relationship with Product B, Product B will be suggested or related to Product A, and vice versa. This helps in improving product discoverability and ensuring consistent user experiences across your storefront. - Each relationship that you define must have a unique slug. -- Each relationship slug is prefixed with CRP (custom relationship product). Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship. +- Each relationship slug is prefixed with `CRP_` (custom relationship product). Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship. - A product can be included in up to 5 relationships. - Custom relationships can have up to 2000 products. From 6306e702ebc04cdb6bbb91c890f82c1bd0a29aa9 Mon Sep 17 00:00:00 2001 From: Jo Date: Tue, 10 Sep 2024 11:26:49 +0100 Subject: [PATCH 5/8] first draft --- docs/partials/pxm/custom-relationships/croverview.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/partials/pxm/custom-relationships/croverview.mdx b/docs/partials/pxm/custom-relationships/croverview.mdx index 590399dc..5d28c8ae 100644 --- a/docs/partials/pxm/custom-relationships/croverview.mdx +++ b/docs/partials/pxm/custom-relationships/croverview.mdx @@ -1,5 +1,15 @@ You can create custom relationships between products in Product Experience Manager, allowing you to link or associate your products in certain ways based on criteria of your choosing. These relationships help improve user experience, boost sales, and enhance product discoverability. +## Parent/Child Groupings + +You can create parent/child relationships between products using custom relationships instead of using variations. Using custom relationships instead of variations has several benefits. + +- You can use existing products. You do not have to create new products to get started. Simply, create a custom relationship and start relating products. +- If your catalog's source of truth is maintained externally, outside of Elastic Path, you do not need to make changes to the way your product data is generated or managed. The data can flow into Elastic Path and, once the product data reaches Elastic Path, you can immediately relate products using custom relationships, without having to evaluate, change and build variations and options data. +- Custom relationships allow more flexible and complex associations. Large numbers of variations are difficult to maintain and Variations are often limited to predefined attributes like size or color, which can restrict how products are related. + +## Product Groupings + There are some common custom relationship types. - Cross-selling: Suggesting related products that customers who might want to buy in addition to the product they are viewing. For example, if a customer is looking at laptops, you might suggest memory cards, laptop bags, external mouse, and so on. Cross-selling encourages customers to purchase complementary items. From bebbf95d4e17711f83071ff82d2e7013ee9ae4f1 Mon Sep 17 00:00:00 2001 From: Jo Date: Tue, 10 Sep 2024 11:44:46 +0100 Subject: [PATCH 6/8] incorporating review comments --- docs/partials/pxm/custom-relationships/crcharacteristics.mdx | 2 +- docs/partials/pxm/custom-relationships/croverview.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx index 423e2b8b..dd5eb83f 100644 --- a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx +++ b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx @@ -4,5 +4,5 @@ Custom relationships have the following characteristics: - Each relationship that you define must have a unique slug. - Each relationship slug is prefixed with `CRP_` (custom relationship product). Product Experience Manager adds this automatically if you do not provide it when creating the custom relationship. - A product can be included in up to 5 relationships. -- Custom relationships can have up to 2000 products. +- 2000 products can be related to a product per custom relationship. diff --git a/docs/partials/pxm/custom-relationships/croverview.mdx b/docs/partials/pxm/custom-relationships/croverview.mdx index 5d28c8ae..e934300e 100644 --- a/docs/partials/pxm/custom-relationships/croverview.mdx +++ b/docs/partials/pxm/custom-relationships/croverview.mdx @@ -6,7 +6,7 @@ You can create parent/child relationships between products using custom relation - You can use existing products. You do not have to create new products to get started. Simply, create a custom relationship and start relating products. - If your catalog's source of truth is maintained externally, outside of Elastic Path, you do not need to make changes to the way your product data is generated or managed. The data can flow into Elastic Path and, once the product data reaches Elastic Path, you can immediately relate products using custom relationships, without having to evaluate, change and build variations and options data. -- Custom relationships allow more flexible and complex associations. Large numbers of variations are difficult to maintain and Variations are often limited to predefined attributes like size or color, which can restrict how products are related. +- Custom relationships allow more flexible and complex associations. Large numbers of variations are difficult to maintain and variations are often limited to predefined attributes like size or color, which can restrict how products are related. ## Product Groupings From d3e9178cf9f3766adebc435f6cfba3aa64b16e5c Mon Sep 17 00:00:00 2001 From: Jo Date: Fri, 13 Sep 2024 16:43:09 +0100 Subject: [PATCH 7/8] first draft --- .../pxm/custom-relationships/crcharacteristics.mdx | 1 + docs/partials/pxm/custom-relationships/croverview.mdx | 9 ++++++++- 2 files changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx index dd5eb83f..b3c91991 100644 --- a/docs/partials/pxm/custom-relationships/crcharacteristics.mdx +++ b/docs/partials/pxm/custom-relationships/crcharacteristics.mdx @@ -6,3 +6,4 @@ Custom relationships have the following characteristics: - A product can be included in up to 5 relationships. - 2000 products can be related to a product per custom relationship. + diff --git a/docs/partials/pxm/custom-relationships/croverview.mdx b/docs/partials/pxm/custom-relationships/croverview.mdx index e934300e..09eea474 100644 --- a/docs/partials/pxm/custom-relationships/croverview.mdx +++ b/docs/partials/pxm/custom-relationships/croverview.mdx @@ -1,4 +1,4 @@ -You can create custom relationships between products in Product Experience Manager, allowing you to link or associate your products in certain ways based on criteria of your choosing. These relationships help improve user experience, boost sales, and enhance product discoverability. +You can create custom relationships between products in Product Experience Manager, allowing you to link or associate your products in certain ways based on criteria of your choosing. These relationships help improve user experience, boost sales, and enhance product discoverability. You can create custom relationships in both the [Product Experience Manager API](/docs/api/pxm/products/product-experience-manager-introduction) and [Commerce Manager](/ui). ## Parent/Child Groupings @@ -16,4 +16,11 @@ There are some common custom relationship types. - Up-selling or alternative products: Suggesting products that serve the same function as the product a customer is viewing, but may be different brands, prices, better specifications, or have additional features. This ensures customers find the best product for their needs and may increase the order value by guiding customers to more premium options. - Custom collections: Create custom collections of products that share a theme, like **Back to School** or **Summer Holiday Fashion**. These guide customers to multiple products that fit a specific purpose or occasion. +## Custom Relationships in Catalog Releases + +Once you have created your custom relationships and attached and associated your products, these relationships are automatically available when you publish your catalogs. You can then program your storefront to dynamically display the custom relationships. + +## Custom Relationships in Organizations + +You can use custom relationships in Organizations. For more information, see Organization Custom Relationships. From a13f4f2e5246c71aed5277c80a84bd1e620bed2e Mon Sep 17 00:00:00 2001 From: Jo Date: Fri, 20 Sep 2024 11:11:55 +0100 Subject: [PATCH 8/8] first draft --- docs/partials/pxm/custom-relationships/croverview.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/partials/pxm/custom-relationships/croverview.mdx b/docs/partials/pxm/custom-relationships/croverview.mdx index 09eea474..3e94d44e 100644 --- a/docs/partials/pxm/custom-relationships/croverview.mdx +++ b/docs/partials/pxm/custom-relationships/croverview.mdx @@ -1,6 +1,6 @@ You can create custom relationships between products in Product Experience Manager, allowing you to link or associate your products in certain ways based on criteria of your choosing. These relationships help improve user experience, boost sales, and enhance product discoverability. You can create custom relationships in both the [Product Experience Manager API](/docs/api/pxm/products/product-experience-manager-introduction) and [Commerce Manager](/ui). -## Parent/Child Groupings +### Parent/Child Groupings You can create parent/child relationships between products using custom relationships instead of using variations. Using custom relationships instead of variations has several benefits. @@ -8,7 +8,7 @@ You can create parent/child relationships between products using custom relation - If your catalog's source of truth is maintained externally, outside of Elastic Path, you do not need to make changes to the way your product data is generated or managed. The data can flow into Elastic Path and, once the product data reaches Elastic Path, you can immediately relate products using custom relationships, without having to evaluate, change and build variations and options data. - Custom relationships allow more flexible and complex associations. Large numbers of variations are difficult to maintain and variations are often limited to predefined attributes like size or color, which can restrict how products are related. -## Product Groupings +### Product Groupings There are some common custom relationship types. @@ -16,11 +16,11 @@ There are some common custom relationship types. - Up-selling or alternative products: Suggesting products that serve the same function as the product a customer is viewing, but may be different brands, prices, better specifications, or have additional features. This ensures customers find the best product for their needs and may increase the order value by guiding customers to more premium options. - Custom collections: Create custom collections of products that share a theme, like **Back to School** or **Summer Holiday Fashion**. These guide customers to multiple products that fit a specific purpose or occasion. -## Custom Relationships in Catalog Releases +### Custom Relationships in Catalog Releases Once you have created your custom relationships and attached and associated your products, these relationships are automatically available when you publish your catalogs. You can then program your storefront to dynamically display the custom relationships. -## Custom Relationships in Organizations +### Custom Relationships in Organizations You can use custom relationships in Organizations. For more information, see Organization Custom Relationships.