Content Display

Loading more reviews

As shown previously, you should use a ReviewsRequest to load the first page of CGC that your users will see (up to 20 items). When loading reviews, you should request and display reviews in a BVUiReviewsRecyclerView or BVUiReviewsContainerView container:

        BVConversationsClient client = new BVConversationsClient.Builder(BVSDK.getInstance()).build(); // Use one instance
        ReviewsRequest reviewsRequest = new ReviewsRequest.Builder("test1", 10, 20).build();
        reviewsRecyclerView = (BVUiReviewsRecyclerView) findViewById(R.id.my_reviews_recycler_view);
        reviewsRecyclerView.loadAsync(client.prepareCall(reviewsRequest), new ConversationsCallback<ReviewResponse>() {
          @Override
          public void onSuccess(ReviewResponse response) {
            //called on Main Thread
            response.getResults(); //contains reviews
          }

          @Override
          public void onFailure(BazaarException exception) {
            //called on Main Thread
          }
        });
      

A ReviewsRequest requires three parameters:

• productId - the productId that you want reviews for
  or
  primaryFilter and ~Id - i.e. to get reviews by author you'd use primaryFilter.AuthorId and the Author's Id. Valid primaryFilters include Id, AuthorId, ProductId, SubmissionId, and CategoryAncestorId.
• limit - max number of reviews to fetch (maximum of 20)
• offset - the index to start on

A combination of limit and offset should be used to load more pages of reviews upon the user's request.

You can add filters and sorts to the request, as shown below:

        ReviewsRequest request = new ReviewsRequest.Builder("test1", 10, 0)
         .addFilter(ReviewOptions.Filter.HasPhotos, EqualityOperator.EQ, "")
         .addSort(ReviewOptions.Sort.Rating, SortOrder.DESC)
         .build();
      

Loading reviews is simply done by calling the loadAsync() method on the chosen Reviews View container as shown above.

Displaying Ratings & Reviews

Multiple reviews should be shown in one of the following container view:

• BVUiReviewsRecyclerView
• BVUiReviewsContainerView

Each review should be shown using a ReviewView.

Loading more Questions & Answers

Similarly to reviews, you should use a QuestionAndAnswerRequest to load the first page of Questions & Answers (up to the first 20 questions). When loading questions, you should request and display questions in a BVUiQuestionsRecyclerView or BVUiQuestionsContainerView container:

        BVConversationsClient client = new BVConversationsClient.Builder(BVSDK.getInstance()).build(); // Use one instance
        QuestionAndAnswerRequest questionsRequest = new QuestionAndAnswerRequest.Builder("test1", 10, 20).build();
        questionsRecyclerView = (BVUiQuestionsRecyclerView) findViewById(R.id.my_questions_recycler_view);
        questionsRecyclerView.loadAsync(client.prepareCall(questionsRequest), new ConversationsCallback<QuestionAndAnswerResponse>() {
          @Override
          public void onSuccess(QuestionAndAnswerResponse response) {
            //called on Main Thread
            response.getResults();
          }

          @Override
          public void onFailure(BazaarException exception) {
            //called on Main Thread
          }
        });
      

A QuestionsAndAnswersRequest requires the same three parameters as a ReviewsRequest:

• productId - the productId that you want questions for
• limit - max number of questions to fetch (maximum of 20)
• offset - the index to start on

A combination of limit and offset should be used to load more pages of questions upon the user's request.

You can add filters and sorts to the request, as shown below:

        QuestionsAndAnswersRequest request = new QuestionsAndAnswersRequest.Builder("test1", 10, 0)
         .addFilter(QuestionOptions.Filter.HasPhotos, EqualityOperator.EQ, "")
         .addQuestionSort(QuestionOptions.Sort.TotalAnswerCount, SortOrder.DESC)
         .addAnswerSort(AnswerOptions.Sort.SubmissionTime, SortOrder.ASC)
         .build();
      

Displaying Questions & Answers

Questions & Answers should be shown in one of the following container view:

• BVUiQuestionsRecyclerView
• BVUiQuestionsContainerView
• AnswersRecyclerView
• AnswersContainerView

Each question should be shown using a QuestionView, and each answer should be shown using an AnswerView.

Loading review comments

Comments can be loaded either by a single comment ID, or you can load comments by a review ID with limit and offset parameters. Simply construct a CommentsRequest object and choose one of the default constructors provided. The example provided below demonstrate how to fetch a list of comments from a given review ID.

        BVConversationsClient client = new BVConversationsClient.Builder(BVSDK.getInstance()).build(); // Use one instance

        CommentsRequest request = new CommentsRequest.Builder(reviewId, 20, 0)
          // Add other optional parameters
          .addSort(CommentOptions.Sort.SUBMISSION_TIME, SortOrder.DESC)
          .addIncludeContent(CommentIncludeType.PRODUCTS, 99)
          .addFilter(CommentOptions.Filter.CONTENT_LOCALE, EqualityOperator.EQ, "en_US")
          .build();

        client.prepareCall(request).loadAsync(new ConversationsCallback() {
          @Override
          public void onSuccess(CommentsResponse response) {
            // successful response, get the comments and draw your UI
          }

          @Override
          public void onFailure(BazaarException exception) {
            // add your error handling logic here
          }
        });
      

Showing bulk ratings

To show product rating statistics on a category page, use a BulkRatingsRequest. For example, on a category page like this one:

Getting each product's rating statistics can be done with the following single request:

        List productIds = Arrays.asList("test1", "test2", "test3", "test4");
        BulkRatingsRequest request = new BulkRatingsRequest
          .Builder(productIds, BulkRatingOptions.StatsType.All).build();
      

Which can be loaded with:

        BVConversationsClient client = new BVConversationsClient.Builder(BVSDK.getInstance()).build(); // Use one instance
        client.prepareCall(request).loadAsync(new ConversationsCallback<BulkRatingsResponse>() {
          @Override
          public void onSuccess(BulkRatingsResponse response) {
            //called on Main Thread
            for (Statistics stats : response.getResults()) {
              String productId = "";
              Float avgRating = Float.NaN;
              Integer totalReviewCount = 0;
              ProductStatistics productStats = stats.getProductStatistics();
              if (productStats != null) {
                productId = productStats.getProductId();
                ReviewStatistics reviewStats = productStats.getReviewStatistics();
                if (reviewStats != null) {
                  avgRating = reviewStats.getAverageOverallRating();
                  totalReviewCount = reviewStats.getTotalReviewCount();
                }
              }
              String msg = String
                .format("productId: %s, avgRating: %f, totalReviewCount: %d",
                productId, avgRating, totalReviewCount);
              Log.d("BulkRatings", msg);
            }
          }

          @Override
          public void onFailure(BazaarException exception) {
            //called on Main Thread
            Log.e("BulkRatings", "Failed to get bulk ratings", exception);
          }
        });
      

Showing authors profile

Badge display

Please note that image links are not returned from the Conversations API. The display for Conversation API clients is left up to the client's creative interpretation. For more information please see the Conversations Developer documentation on Badges.

To show an Authors profile, use an AuthorsRequest. For example:

        AuthorsRequest request = new AuthorsRequest.Builder("authorId")
          .addIncludeContent(AuthorIncludeType.REVIEWS, 10)
          .addIncludeContent(AuthorIncludeType.QUESTIONS, 11)
          .addIncludeContent(AuthorIncludeType.ANSWERS, 12)
          .addIncludeContent(AuthorIncludeType.COMMENTS, 12)
          .addReviewSort(ReviewOptions.Sort.SubmissionTime, SortOrder.DESC)
          .addQuestionSort(QuestionOptions.Sort.SubmissionTime, SortOrder.DESC)
          .addAnswerSort(AnswerOptions.Sort.AuthorId, SortOrder.DESC)
          .addIncludeStatistics(AuthorIncludeType.REVIEWS)
          .addIncludeStatistics(AuthorIncludeType.QUESTIONS)
          .addIncludeStatistics(AuthorIncludeType.ANSWERS)
          .build();
      

Which can be loaded with:

        BVConversationsClient client = new BVConversationsClient.Builder(BVSDK.getInstance()).build(); // Use one instance
        client.newCall(request).enqueue(new ConversationsCallback() {
          @Override
          public void onSuccess(AuthorsResponse response) {
            if (response.getHasErrors()) {
              // Handle API request errors
              return;
            }

            List authors = response.getResults();
            if (authors.size() > 0) {
              Author author = authors.get(0);
              // Use the author object
            }
          }

          @Override
          public void onFailure(BazaarException exception) {
            exception.printStackTrace();
          }
        );
      

Loading Review Highlights

Load Review Highlights (PROS and CONS) by specifying a product ID and client ID.

      ReviewHighlightsRequest request = new ReviewHighlightsRequest.Builder("productId").build();
      BVConversationsClient client = new BVConversationsClient.Builder(BVSDK.getInstance()).build(); // Use one instance 

      client.prepareCall(request).loadAsync(new ConversationsDisplayCallback<ReviewHighlightsResponse>() {
        @Override
        public void onSuccess(ReviewHighlightsResponse response) {
          List<ReviewHighlight> positives = response.getReviewHighlights().getPositives();
          List<ReviewHighlight> negatives = response.getReviewHighlights().getNegatives();

          for (ReviewHighlight positive : positives) {
            String title = positive.title; // PRO TITLE
          }

          for (ReviewHighlight negative : negatives) {
            String title = negative.title; // CON TITLE
          }
        }

        @Override
        public void onFailure(ConversationsException exception) {
          // HANDLE ERROR
        }
      });