Android: Search Page

Return Personalization

Use this code when you are requesting and serving personalized product recommendations.

Replace the following placeholders in the code:

• <placement name> with your Placement name. You can find a list of placements in your Dashboard.
• <search keywords>with the search keywords the customer typed to perform this search.

Placement placement = new Placement(Placement.PlacementType.SEARCH, "<placement name>");

RichRelevance.buildRecommendationsForPlacements(placement)
  .setSearchTerm("<search keywords>")
  .setCallback(new Callback<PlacementResponseInfo>() {
      @Override
      public void onResult(PlacementResponseInfo result) {          
          int index = 0;
          for(PlacementResponse placement : result.getPlacements()) {
              for(final RecommendedProduct recommendedProduct : placement.getRecommendedProducts()) {
                  // Add your view init logic. The actual implementation will depend on your code.
                  // In this example we will assume items are rendered as TableRows in a TableView.
                  TableRow row = new TableRow(context);
                  row.setId(index);
                  row.addView(detailView);
                  index++;
                  tableView.addLayout(row);
              }
          }
      }
      @Override
      public void onError(Error error) {
          // Use this code block to handle errors
          Log.e(getClass().getSimpleName(), "Error: " + error.getMessage());
      }
  }).execute();

Calling multiple placements

If you want to call multiple placements, simply define your placements and pass them to RichRelevance.buildRecommendationsForPlacements() either as individual arguments or as a Collection<Placement>.

IMPORTANT Placements must always be of the same type per request.

// This example defines placements as individual arguments.
Placement topPlacement = new Placement(Placement.PlacementType.SEARCH, "recs_top");
Placement middlePlacement = new Placement(Placement.PlacementType.SEARCH, "recs_middle");

RichRelevance.buildRecommendationsForPlacements(topPlacement, middlePlacement)
// Add callback logic
.execute();

// This example defines placements as an ArrayList. It is equivalent to the example above.
ArrayList<Placement> placements = new ArrayList<>(
    Arrays.asList(
        new Placement(Placement.PlacementType.SEARCH, "recs_top"),
        new Placement(Placement.PlacementType.SEARCH, "recs_middle"))
    );

RichRelevance.buildRecommendationsForPlacements(placements)
// Add callback logic
.execute();

Listening Mode

When you do not render personalization in your Search UX, you must still send a Home request using the SDK. This is required so that Personalization Cloud can gather usage data in order to train your personalization models. In this specific case, you will create a listening placement. Listening placements are a special type of placement that can only log usage data without returning personalization data.

Replace <search keywords>with the search keywords the customer typed to perform this search.

Placement placement = new Placement(Placement.PlacementType.SEARCH);

RichRelevance.buildRecommendationsForPlacements(placement)
  .setSearchTerm("<search keywords>")
  .execute();