Search & Promote Product Feed

AEM integrates with Search&Promote and allows you to:

• use the eCommerce API, independently of the underlying repository structure and commerce platform.
• leverage the Index Connector feature of Search&Promote to provide a product feed in XML format.
• leverage the Remote Control feature of Search&Promote to perform on-demand or scheduled requests of the product feed
• feed generation for different Search&Promote accounts, configured as cloud services configurations.

You need to have a valid acount and to configure the connection to Search&Promote. You also have to verify that you are using the correct data center and make sure that the Remote server URI is configured.

Set up the Product Feed

You first have to enter a web site root and an identifier attribute. To do this:

• Navigate to your Search&Promote configuration.
• Click Edit.
• Click the Index Connector Feed Configuration tab.
• Enter the Web site root and Identifier attribute
• Note:

  The Web site root is the root of your eCommerce website, for example /content/geometrixx-outdoors/en.

  The Identifier attribute is a JCR property that uniquely identifies the product: identifier.

Click OK.

Then you also have to edit two configurations in the Web Console before you can generate product feeds.

Configuring the Day CQ Search&Promote Products Crawler Implementation for Geometrixx

Navigate to http://localhost:4502/system/console/configMgr.
Click Day CQ Search&Promote products crawler implementation for Geometrixx.
Specify the Search&Promote account number that this crawler is linked to. It will be used to look up the cloud services configuration used by this crawler.
Click Save.

Configuring the Day CQ Search&Promote Products Feed Generator for Geometrixx

Navigate to http://localhost:4502/system/console/configMgr.
Click Day CQ Search&Promote products feed generator for Geometrixx.
Specify the Search&Promote account number that this generator is linked to. It will be used to look up the cloud services configuration used by this generator.
Click Save.

Schedule the Product Feed

To enable scheduled feed generation, you must configure a scheduler for it.
A scheduler is configured as a child configuration of your specific Search&Promote cloud services configuration.

Navigate to your Search&Promote configuration.
Click + next to Scheduler configuration.
Enter a Title that is recognizable to page authors, and a unique Name.
Click Create. A dialog opens.

Enter the Remote Control Password. It is the password you configured in your Search&Pronote account.
Note:
This is not the password to your Search&Promote account. You can find and change this password by logging into your Search&Promote account and going to Index and then to  Remote control.
Check Enable schedule box.
Select a Schedule. It is the actual feed generation schedule.
Enable the On-demand indexing or not. This feature is used to manually call the Search&Promote index. If Request full products feed is checked, Search&Promote will request a full products feed. Otherwise, an incremental products feed is requested.
Note:
The on-demand indexing feature makes use of the Remote Control feature of Search&Promote. When a remote indexing is called, the indexing will not start immediately, but an indexing request will be posted to Search&Promote using the remote control feature.
Click OK.

Now that you configured everything, you can see an XML page containing all the products under the configured web site root:  http://localhost:4502/etc/commerce/searchpromote/feed/full.

Adding Search&Promote Features To Your Page

To integrate Search&Promote capabilities in your web site, use the Search&Promote components to add the following features to your pages:

• Keyword search
• Search results page
• Search refinement
• Banners

Note:

Details on adding Search&Promote features to your page are available in the classic UI authoring documentation. See Adding Search & Promote Features to Your Page for more information.

Adobe Search & Promote integration with AEM

To call the Adobe Search&Promote service from your website, perform the following tasks:

1. Specify the URL of the Cloud.
2. Configure the connection to the Search&Promote service.
3. Add Search&Promote components to Sidekick.
4. Use the components to author the content. (See Adding Search&Promote Features to a Web Page.)
5. Add banners to your pages. Banner images are sensitive to Search&Promote data.
6. Generate a site map for the Search&Promote service to consume.

Note:

If you are using Search&Promote with a custom proxy configuration, you need to configure both HTTP Client proxy configurations as some functionalities of AEM are using the 3.x APIs and some others the 4.x APIs:

• 3.x is configured with http://localhost:4502/system/console/configMgr/com.day.commons.httpclient
• 4.x is configured with http://localhost:4502/system/console/configMgr/org.apache.http.proxyconfigurator

Changing the Search&Promote service URL

The default URL that is configured for the Search&Promote service is http://searchandpromote.omniture.com/px/. To use a different service, use the OSGi console to specify a different URL.

1. Open the OSGi console and click the Configuration tab. (http://localhost:4502/system/console/configMgr.)
2. Click the Day CQ Search&Promote Configuration item.
3. Enter the URL in the Remote Server URI box, and click Save.

Configuring the connection to Search&Promote

Configure one or more connections to Search&Promote so that your web pages can interact with the service. To connect, you need the member identification and account number of your Search&Promote account.

From the Tools icon > Deployment, select Cloud Services.
This takes you to the Cloud Services Dashboard. If on a local machine, the url of the dashboard will look something like this:
http://localhost:4502/libs/cq/core/content/tools/cloudservices.html
In the Cloud Services page, click on the Adobe Search&Promote link or the Search&Promote icon.
If this is the first time you are configuring Adobe Search&Promote, click Configure Now to open the Create Configuration panel.
If you would like to learn more about Search&Promote click Learn More instead.

Enter a Title that is recognizable to page authors, and enter a unique Name, then click Create.
The Edit Component window opens.

Also, the newly created Configuration appears below Available Configurations on the Cloud Services dashboardAdobe Search&Promote list item.

Add the following to the fields in the Edit Component dialog box.
• Member ID
• Account number
Note:
In order to get this information yourself, first you need to log into 
http://searchandpromote.omniture.com/center/
using your valid Seach&Promote credentials (email/password).
Then, you need to look at your url in your brouser's address bar which should look something like this:

http://searchandpromote.omniture.com/px/home/?sp_id=XXXXXXXX-spYYYYYYYY
Where:
• XXXXXXXX corresponds with your Member id
• spYYYYYYYY corresponds with your Account Number
Click Connect To Search&Promote.
When the connection success message appears, click OK.
(After connecting, the button text changes to Re-Connect To Search&Promote.)
Click OK. The Search&Promote Settings page appears for the configuration that you have just created.

Configuring the Data Center

If your Search&Promote account is in Asia or Europe, you need to change the default data center so it points to the right one (the default data center is for North American accounts).

To configure the data center:

Navigate to the Web console at http://localhost:4502/system/console/configMgr/com.day.cq.searchpromote.impl.SearchPromoteServiceImpl

Depending on the location of the server, change the URI to one of the following:
• North America: https://center.atomz.com/px/
• EMEA: https://center.lon5.atomz.com/px/
• APAC: https://center.sin2.atomz.com/px/
Click Save.

Adding Search&Promote components to Sidekick

In Design mode, edit a par component to allow the Search&Promote components in Sidekick. (See the Componentsdocumentation for more information.)

For information about using the components, see See Adding Search&Promote Features to a Web Page.)

Specifying the Search&Promote service that your pages use

Configure web pages so that they use a specific Search&Promote service. Search&Promote components automatically use the service of their host page.

When you configure the Search&Promote properties for a page, all child pages inherit the settings. If required, you can configure child pages to override the inherited settings.

Note:

The service connection must already be configured. (See Configure the connection to Search&Promote.)

Open the Page Properties dialog box. For example, on the Websites page, right-click the page and click Properties.
Click the Cloud Services tab.
To disable the inheritance of cloud services configurations from a parent page, click the padlock icon next to the inheritance path.

Click Add Service, select Adobe Search&Promote, and click OK.
Select the connection configuration for your Search&Promote account, and then click OK.

Product Feed

 The Search&Promote integration allows you to:

• use the eCommerce API, independently of the underlying repository structure and commerce platform.
• leverage the Index Connector feature of Search&Promote to provide a product feed in XML format.
• leverage the Remote Control feature of Search&Promote to perform on-demand or scheduled requests of the product feed
• feed generation for different Search&Promote accounts, configured as cloud services configurations.

For more information, read Product Feed.