Background:
Integration of Adobe Search and Promote with AEM gives marketers extra edge to control their site search results compare to conventional OOTB Lucene or Solr searches. Marketers can control the ordering of results based on analytics performance, relevance and marketing needs. It gives capability to Inject promotional content with auto complete and type ahead features. Integrating S&P with AEM is quite simple.
Note: Adobe Search & Promote has been deprecated in AEM 6.5.
Prequisites:
1. You should have Adobe S&P license
2. S&P user account (Adobe will provide user account to manage S&P server settings once you purchase the license)
Integration Steps:
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. Configuring the Data Center
4. Add Search&Promote components to Sidekick.
5. Use the components to author the content. (See Adding Search&Promote Features to a Web Page.)
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.
a. Open the OSGi console and click the Configuration tab. (http://localhost:4502/system/console/configMgr.)
b. Click the Day CQ Search&Promote Configuration item.
c. Enter the URL in the Remote Server URI box, and click Save.
2. 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.
1. 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
2. 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. Any existing Search&Promote Configuration appears below Available Configurations on the Cloud Services dashboard Adobe Search&Promote list item.
3. Enter a Title that is recognizable to page authors, and enter a unique Name, then click Create.
The Edit Component window opens.
4. 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
5. 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.)
6. Click OK.
The Search&Promote Settings page appears for the configuration that you have just created.
3. 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:
1. Navigate to the Web console at http://localhost:4502/system/console/configMgr/com.day.cq.searchpromote.impl.SearchPromoteServiceImpl
2. 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/
3. Click Save.
4. Adding Search&Promote components to Sidekick
In Design mode, edit a par component to allow the Search&Promote components in Sidekick.
For information about using the components, see See Adding Search&Promote Features to a Web Page.)
5. Binding Search&Promote account to individual sites
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.
- 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.
6. Generating a sitemap
Generate a sitemap of your web site that the Search&Promote service can read for indexing purposes. Follow Adobe documentation for more details on this.
