Content Display

As shown previously, you should use a ProductDisplayPageRequest to load the first page of CGC that your users will see (up 20 reviews). When loading reviews, you should request and display reviews in a BVReviewsCollectionView or BVReviewsTableView container. Reviews can also include Products and Comments.

• Objective-C
• Swift

// Add a BVReviewsTableView to your UIViewController and connect the outlet.
@IBOutlet weak var reviewsTableView : BVReviewsTableView!
var reviews : [BVReview] = []
...

// Now load the reviews from the BVReviewsTableView.
// request 10 reviews, starting at index 20
let reviewsRequest = BVReviewsRequest(productId: "test1", limit: 10, offset: 20)

// Add in other options for includes, filters, and sorts on the reviewsRequest object

reviewsTableView.load(reviewsRequest, success: { (response) in

    self.reviews = response.results
    self.reviewsTableView.reloadData()

    }) { (error) in

    print(error)

}

// Add a BVReviewsTableView to your UIViewController and connect the outlet.
@property (weak, nonatomic) IBOutlet BVReviewsTableView *reviewsTableView;
@property NSArray *reviews;
...

// Now load the reviews from the BVReviewsTableView.
// request 10 reviews, starting at index 20
BVReviewsRequest* request = [[BVReviewsRequest alloc] initWithProductId:@"test1" limit:10 offset:20];

// Add in other options for includes, filters, and sorts on the reviewsRequest object

[self.reviewsTableView load:request success:^(BVReviewsResponse * _Nonnull response) {
    self.reviews = response.results;
    [self.reviewsTableView reloadData];
} failure:^(NSArray * _Nonnull errors) {
    NSLog(@"Error loading reviews");
}];

A BVReviewsRequest requires three parameters:

• productId - the productId that you want reviews for
• 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:

• Objective-C
• Swift

// request 10 reviews that have photos, starting at index 0, sorted by overall rating.
let request = BVReviewsRequest(productId: "test1", limit: 10, offset: 0)
  .filter(on: .hasPhotos, relationalFilterOperatorValue: .equalTo, value: "true")
  .sort(by: .reviewRating, monotonicSortOrderValue: .ascending)

 // request 10 reviews that have photos, starting at index 0, sorted by overall rating.
BVReviewsRequest* request = [[BVReviewsRequest alloc] initWithProductId:@"test1" limit:10 offset:20];
[request filterOnReviewFilterValue:BVReviewFilterValueHasPhotos relationalFilterOperatorValue:BVRelationalFilterOperatorValueEqualTo value:@"true"];
[request sortByReviewsSortOptionValue:BVReviewsSortOptionValueReviewSubmissionTime monotonicSortOrderValue:BVMonotonicSortOrderValueDescending];

Similarly to the ProductDisplayPageRequest, loading reviews is simply done by calling the load() method on the BVReviewsCollectionViewor BVReviewsTableView container as shown above.

Displaying reviews

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

• BVReviewView
• BVReviewsTableView
• BVReviewsCollectionView

Each review should be shown using one of the following views:

• BVReviewView
• BVReviewTableViewCell
• BVReviewCollectionViewCell

Let's create a UIViewController that holds a BVReviewsTableView and display 10 reviews in it using BVReviewTableViewCell.

• Create a new Cocoa Touch Class called DemoReviewViewController and make it subclass UIViewController:

  

• Import BVSDK from DemoReviewViewController, and add an instance of BVReviewsTableView.

  • Objective-C
  • Swift

  import UIKit
  import BVSDK
  
  class DemoReviewsViewController: UIViewController {
  
      @IBOutlet weak var tableView : BVReviewsTableView!
  
      override func viewDidLoad() {
          super.viewDidLoad()
      }
  
  }
  

  @import BVSDK;
  
  @interface DemoReviewsViewController: UIViewController
  
  @property (nonatomic, weak) IBOutlet BVReviewsTableView *tableView;
  
  @end
  
  // ...
  
  @implementation DemoReviewsViewController
  
  - (void)viewDidLoad {
      [super viewDidLoad];
  }
  
  @end
  

• In DemoReviewViewController.xib, add a UITableView to your view and add appropriate constraints. Change its class to BVReviewsTableView, and hook it up to your IBOutlet:

  

• Create a subclass of UITableViewCell named DemoReviewTableViewCell:

  

• Change the type of DemoReviewTableViewCell to BVReviewTableViewCell and add appropriate UI elements. In the code below you can override the review property to update the UI elements:

  • Objective-C
  • Swift

  import UIKit
  import BVSDK
  
  class DemoReviewTableViewCell: BVReviewTableViewCell {
  
      @IBOutlet weak var reviewTitle : UILabel!
      @IBOutlet weak var reviewText : UILabel!
  
      override var review: BVReview! {
          didSet {
              reviewTitle.text = review.title
              reviewText.text = review.reviewText
          }
      }
  
  }
  

  @import BVSDK;
  
  @interface DemoReviewTableViewCell : BVReviewTableViewCell
  
  @property (nonatomic, weak) IBOutlet UILabel *reviewTitle;
  @property (nonatomic, weak) IBOutlet UILabel *reviewText;
  
  @end
  
  // ...
  
  @implementation DemoReviewTableViewCell
  
  -(void)setReview:(BVReview *)review {
      [super setReview:review];
  
      self.reviewTitle.text = review.title;
      self.reviewText.text = review.reviewText;
  }
  
  @end
  

• Add your reviewText and reviewTitle UILabels to DemoReviewTableViewCell.xib, and hook up your outlets:

  

• Finally, inside DemoReviewViewController, use a BVReviewsRequest object to load 10 reviews. Use instances of DemoReviewTableViewCell to display:

  • Objective-C
  • Swift

  import UIKit
  import BVSDK
  
  class DemoReviewsViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {
      @IBOutlet weak var tableView : BVReviewsTableView!
      var reviews : [BVReview] = []
  
      override func viewDidLoad() {
          super.viewDidLoad()
          self.tableView.delegate = self
          self.tableView.dataSource = self
          self.tableView.register(UINib(nibName: "DemoReviewTableViewCell", bundle: nil), forCellReuseIdentifier: "DemoReviewTableViewCell")
  
          let request = BVReviewsRequest(productId: "test1", limit: 10, offset: 20)
  
          self.tableView.load(request, success: { (response: BVReviewsResponse) in
              self.reviews = response.results
              self.tableView.reloadData()
          }) { (errors: [Error]) in
              // handle failure appropriately
  
          }
       }
  
      func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
          return self.reviews.count
      }
  
      func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
          let cell = tableView.dequeueReusableCell(withIdentifier: "DemoReviewTableViewCell") as! DemoReviewTableViewCell
          cell.review = self.reviews[indexPath.row]
          return cell
      }
  }
  

  @import BVSDK;
  
  @interface DemoReviewsViewController : UIViewController
  
  @property (nonatomic, weak) IBOutlet BVReviewsTableView *tableView;
  @property (nonatomic, strong) NSArray* reviews;
  
  @end
  
  // ...
  
  @implementation DemoReviewsViewController
  
  -(void)viewDidLoad {
      [super viewDidLoad];
  
      self.tableView.delegate = self;
      self.tableView.dataSource = self;
      [self.tableView registerNib:[UINib nibWithNibName:@"DemoReviewTableViewCell" bundle:nil] forCellReuseIdentifier:@"DemoReviewTableViewCell"];
  
      BVReviewsRequest* request = [[BVReviewsRequest alloc] initWithProductId:@"test1" limit:10 offset:20];
      [self.tableView load:^(BVReviewsResponse * _Nonnull response) {
  
          self.reviews = response.results;
          [self.tableView reloadData];
  
      } failure:^(NSArray * _Nonnull errors) {
          // handle failure appropriately
      }];
  }
  
  - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
      return [self.reviews count];
  }
  
  - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
  
      DemoReviewTableViewCell* cell = [tableView dequeueReusableCellWithIdentifier:@"DemoReviewTableViewCell"];
  
      cell.review = [self.reviews objectAtIndex:indexPath.row];
  
      return cell;
  
  }
  
  @end
  

Similarly to reviews, you should use a ProductDisplayPageRequest to load the first page of Questions/Answers (up the first 20 questions). When loading questions, you should request and display questions in a BVQuestionsCollectionView or BVQuestionsTableView container::

• Objective-C
• Swift

// Add a BVQuestionsTableView to your UIViewController and connect the outlet.
@IBOutlet weak var questionsTableView : BVQuestionsTableView!
var questions : [BVQuestion] = []
...

// Now load the questions from the BVQuestionsTableView.
// request 10 questions, starting at index 20
let questionsRequest = BVQuestionsAndAnswersRequest(productId: "test1", limit: 10, offset: 20)

questionsTableView.load(questionsRequest, success: { (response) in

            self.questions = response.results
            self.questionsTableView.reloadData()

            }) { (error) in

            print(error)

        }

// Add a BVQuestionsTableView to your UIViewController and connect the outlet.
@property (weak, nonatomic) IBOutlet BVQuestionsTableView *questionsTableView;
@property NSArray *questions;

// Now load the questions from the BVQuestionsTableView.
    // request 10 questions, starting at index 20
    BVQuestionsAndAnswersRequest* request = [[BVQuestionsAndAnswersRequest alloc] initWithProductId:@"test1" limit:10 offset:20];
    [self.questionsTableView load:request success:^(BVQuestionsAndAnswersResponse * _Nonnull response) {
        self.questions = response.results;
        [self.questionsTableView reloadData];
    } failure:^(NSArray * _Nonnull errors) {
         NSLog(@"Error loading questions");
    }];

A QuestionsAndAnswersRequest requires the three parameters:

• 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 quesitons upon the user's request.

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

• Objective-C
• Swift

// request 10 questions that have answers, starting at index 0, sorted by the number of answers each question has.
let request = BVQuestionsAndAnswersRequest(productId: "test1", limit: 10, offset: 20)
  .filter(on: .questionHasAnswers, relationalFilterOperatorValue: .equalTo, value: "true")
  .sort(by: .questionSubmissionTime, monotonicSortOrderValue: .ascending)

// request 10 questions that have answers, starting at index 0, sorted by the number of answers each question has.
BVQuestionsAndAnswersRequest* request = [[BVQuestionsAndAnswersRequest alloc] initWithProductId:@"test1" limit:10 offset:0];
[request filterOnQuestionFilterValue:BVQuestionFilterValueQuestionHasAnswers relationalFilterOperatorValue:BVRelationalFilterOperatorValueEqualTo value:@"true"];
[request sortByQuestionsSortOptionValue:BVQuestionsSortOptionValueQuestionLastModeratedTime monotonicSortOrderValue:BVMonotonicSortOrderValueDescending];

Displaying Questions & Answers

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

• BVQuestionsView
• BVQuestionsTableView
• BVQuestionsCollectionView
• BVAnswersView
• BVAnswersTableView
• BVAnswersCollectionView

Each question/answer should be shown using one of the following views:

• BVQuestionView
• BVQuestionTableViewCell
• BVQuestionCollectionViewCell
• BVAnswerView
• BVAnswerTableViewCell
• BVAnswerCollectionViewCell

Let's create a UIViewController that holds a BVQuestionTableView and display 10 questions in it using BVQuestionTableViewCells.

• Create a new Cocoa Touch Class called DemoQuestionViewController and make it subclass UIViewController:

  

• Import BVSDK from DemoQuestionViewController, and add an instance of BVQuestionsTableView.

  • Objective-C
  • Swift

  import UIKit
  import BVSDK
  
  class DemoQuestionViewController: UIViewController {
  
      @IBOutlet weak var questionsTableView : BVQuestionsTableView!
  
      override func viewDidLoad() {
          super.viewDidLoad()
      }
  }
  

  @import BVSDK;
  
  @interface DemoQuestionsViewController: UIViewController
  
  @property (nonatomic, weak) IBOutlet BVQuestionsTableView *tableView;
  
  @end
  
  // ...
  
  @implementation DemoQuestionsViewController
  
  - (void)viewDidLoad {
      [super viewDidLoad];
  }
  
  @end
  

• In DemoQuestionViewController.xib, add a UITableView to your view and add appropriate constraints. Change its class to BVQuestionsTableView, and hook it up to your IBOutlet:

  

• Create a subclass of UITableViewCell named DemoQuestionTableViewCell:

  

• Change the type of DemoQuestionTableViewCell to BVQuestionTableViewCell and add appropriate UI elements. In the code below you can override the question property to update the UI elements:

  • Objective-C
  • Swift

  import UIKit
  import BVSDK
  
  class DemoQuestionTableViewCell: BVQuestionTableViewCell {
  
      @IBOutlet weak var questionSummary : UILabel!
      @IBOutlet weak var questionDetails : UILabel!
  
      override var question: BVQuestion! {
          didSet {
              questionSummary.text = question.questionSummary
              questionDetails.text = question.questionDetails
          }
      }
  }
  

  @import BVSDK;
  
  @interface DemoQuestionTableViewCell : BVQuestionTableViewCell
  
  @property (nonatomic, weak) IBOutlet UILabel *questionSummary;
  @property (nonatomic, weak) IBOutlet UILabel *questionDetails;
  
  @end
  
  // ...
  
  @implementation DemoQuestionTableViewCell
  
  -(void)setQuestion:(BVQuestion *)question {
      [super setQuestion:question];
  
      self.questionSummary.text = question.questionSummary;
      self.questionDetails.text = question.questionDetails;
  }
  
  @end
  

• Add your questionSummary and questionDetails UILabels to DemoQuestionTableViewCell.xib, and hook up your outlets:

  

• Finally, inside DemoQuestionViewController, use a BVQuestionsAndAnswersRequest object to load 10 questions and their associated answers. Use instances of DemoQuestionTableViewCell to display:

  

  Answers are not displayed in this tutorial but should be displayed alongside questions.
  • Objective-C
  • Swift

  import UIKit
  import BVSDK
  
  class DemoQuestionViewController: UIViewController, UITableViewDelegate, UITableViewDataSource {
      @IBOutlet weak var tableView : BVQuestionsTableView!
      var questions : [BVQuestion] = []
  
      override func viewDidLoad() {
          super.viewDidLoad()
          self.tableView.delegate = self
          self.tableView.dataSource = self
          self.tableView.register(UINib(nibName: "DemoQuestionTableViewCell", bundle: nil), forCellReuseIdentifier: "DemoQuestionTableViewCell")
  
          let request = BVQuestionsAndAnswersRequest(productId: "test1", limit: 10, offset: 20)
          self.tableView.load(request, success: { (response: BVQuestionsAndAnswersResponse) in
              self.questions = response.results
              self.tableView.reloadData()
          }) { (errors: [Error]) in
              // handle failure appropriately
  
          }
      }
      func tableView(_ tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
          return self.questions.count
      }
  
      func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
        let cell = tableView.dequeueReusableCell(withIdentifier: "DemoQuestionTableViewCell") as! DemoQuestionTableViewCell
        cell.question = self.questions[indexPath.row]
  
        return cell
      }
  }
  

  @import BVSDK;
  
  @interface DemoQuestionsViewController : UIViewController<UITableViewDelegate, UITableViewDataSource>
  
  @property (nonatomic, weak) IBOutlet BVQuestionsTableView *tableView;
  @property (nonatomic, strong) NSArray<BVQuestion*>* questions;
  
  @end
  
  // ...
  
  @implementation DemoQuestionsViewController
  
  -(void)viewDidLoad {
      [super viewDidLoad];
      self.tableView.delegate = self;
      self.tableView.dataSource = self;
      [self.tableView registerNib:[UINib nibWithNibName:@"DemoQuestionTableViewCell" bundle:nil] forCellReuseIdentifier:@"DemoQuestionTableViewCell"];
  
      BVQuestionsAndAnswersRequest* request = [[BVQuestionsAndAnswersRequest alloc] initWithProductId:@"test1" limit:10 offset:20];
      [self.tableView load:request success:^(BVQuestionsAndAnswersResponse * _Nonnull response) {
           self.questions = response.results;
           [self.tableView reloadData];
      } failure:^(NSArray<NSError *> * _Nonnull errors) {
          // handle failure appropriately
      }];
  
  }
  
  - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
      return [self.questions count];
  }
  
  - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
  
      DemoQuestionTableViewCell* cell = [tableView dequeueReusableCellWithIdentifier:@"DemoQuestionTableViewCell"];
  
      cell.question = [self.questions objectAtIndex:indexPath.row];
  
      return cell;
  
  }
  
  @end
  

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 BVCommentsRequest object and choose one of the default initializers provided. The examples provided below demonstrate how to fetch a list of comments from a given review ID.

• Objective-C
• Swift

let limit : UInt16  = 99
let offset : UInt16 = 0

let request = BVCommentsRequest(reviewId: "myReviewId", limit: limit, offset: offset)
// Optionally, comments can have includes, filters, and sorts added to the request.
request.addInclude(.reviews)
request.addFilter(.contentLocale, filterOperator: .equalTo, value: "en_US")
request.addCommentSort(.commentsLastModeratedTime, order: .descending)

request.load({ (response) in

    self.comments = response.results // Array of BVComment objects
    // display comments in your UI

}) { (error) in

    print("ERROR fetching comments: \(error.first!.localizedDescription)")

}

BVCommentsRequest *request = [[BVCommentsRequest alloc] initWithProductId:@"myProductId" andReviewId:@"myReviewId" limit:99 offset:0];

// Optionally, comments can have includes, filters, and sorts added to the request.
[request includeCommentIncludeTypeValue:BVCommentIncludeTypeValueCommentReviews];
[request sortByCommentsSortOptionValue:BVCommentsSortOptionValueCommentLastModeratedTime monotonicSortOrderValue:BVMonotonicSortOrderValueDescending];
[request filterOnCommentFilterValue:BVCommentFilterValueCommentContentLocale relationalFilterOperatorValue:BVRelationalFilterOperatorValueEqualTo value:@"en_US"];

[request load:^(BVCommentsResponse * _Nonnull response) {
  // success
  self.comments = response.results; // Array of BVComment objects

  // display comments in your UI

} failure:^(NSArray<NSError *> * _Nonnull errors) {
  // error
  NSLog(@"ERROR Loading Comments: %@", errors.firstObject.localizedDescription);
}];

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

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

• Objective-C
• Swift

// Load rating statistics for four products. Can load up to 50 per request.
let productIds = ["test1", "test2", "test3", "test4"]
let request = BVBulkRatingsRequest(productIds: productIds, statistics: .bulkRatingAll)

// Load rating statistics for four products. Can load up to 50 per request.
NSArray* productIds = @[@"test1", @"test2", @"test3", @"test4"];
BVBulkRatingsRequest* request = [[BVBulkRatingsRequest alloc] initWithProductIds:productIds statistics: BVBulkRatingIncludeTypeValueBulkRatingReviews];

Which can be loaded with:

• Objective-C
• Swift

request.load({ (response: BVBulkRatingsResponse) in

    let ratings = response.results

    for rating in ratings {
        let productId = rating.productId
        let averageOverallRating = rating.reviewStatistics?.averageOverallRating
        let totalReviewCount = rating.reviewStatistics?.totalReviewCount
    }

}) { (errors: [Error]) in
    // handle failure appropriately
}

[request load:^(BVBulkRatingsResponse * _Nonnull response) {

    NSArray* ratings = response.results;

    for (BVProductStatistics* rating in ratings) {
        NSString* productId = rating.productId;
        NSNumber* averageOverallRating = rating.reviewStatistics.averageOverallRating;
        NSNumber* totalReviewCount = rating.reviewStatistics.totalReviewCount;
    }

} failure:^(NSArray * _Nonnull errors) {
    // handle failure appropriately
}];

An author's profile for Conversations begins with a BVAuthorRequest object. This request object is all you need to create parameters and obtain an author's profile. The response for an author is found in the response object BVAuthorResponse. Author profile responses can include Reviews, Questions, and Answers written by the author and approved for publishing.

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.

• Objective-C
• Swift

let request = BVAuthorRequest(authorId: "theAuthorsId")
  // stats includes, optional
  .includeStatistics(.authorAnswers)
  .includeStatistics(.authorQuestions)
  .includeStatistics(.authorReviews)

  // other includes, optional
  .include(.authorReviews, limit: 10)
  .include(.authorQuestions, limit: 10)
  .include(.authorAnswers, limit: 10)
  .include(.authorReviewComments, limit: 10)

  // sorts, optional
  .sort(by: .answerSubmissionTime, monotonicSortOrderValue: .descending)
  .sort(by: .reviewSubmissionTime, monotonicSortOrderValue: .descending)
  .sort(by: .questionSubmissionTime, monotonicSortOrderValue: .descending)

  request.load({ (response) in
    // success -- load data into your UI
    print(response)
  }) { (error) in
    // error - handle error
    print(error)
  }

BVAuthorRequest *request = [[BVAuthorRequest alloc] initWithAuthorId: @"authorId"];
[request includeStatistics:BVAuthorIncludeTypeValueAuthorReviewComments];
[request includeStatistics:BVAuthorIncludeTypeValueAuthorQuestions];
[request includeStatistics:BVAuthorIncludeTypeValueAuthorAnswers];
[request includeAuthorIncludeTypeValue:BVAuthorIncludeTypeValueAuthorAnswers limit:5];
[request includeAuthorIncludeTypeValue:BVAuthorIncludeTypeValueAuthorQuestions limit:5];
[request includeAuthorIncludeTypeValue:BVAuthorIncludeTypeValueAuthorReviewComments limit:5];
[request includeAuthorIncludeTypeValue:BVAuthorIncludeTypeValueAuthorReviews limit:5];

[request load:^(BVAuthorResponse * _Nonnull response) {

  // Success!
  NSLog(@"Succesfully loaded profile: %@", response);
} failure:^(NSArray * _Nonnull errors) {

  // Error : (
    NSLog(@"ERROR loading author: %@", errors.description);
}];

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

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

• Objective-C
• Swift

// Load rating statistics for four products. Can load up to 50 per request.
let productIds = ["test1", "test2", "test3", "test4"]
let request = BVBulkRatingsRequest(productIds: productIds, statistics: .All)

// Load rating statistics for four products. Can load up to 50 per request.
NSArray* productIds = @[@"test1", @"test2", @"test3", @"test4"];
BVBulkRatingsRequest* request = [[BVBulkRatingsRequest alloc] initWithProductIds:productIds statistics:BulkRatingsStatsTypeReviews];

Which can be loaded with:

• Objective-C
• Swift

request.load({ (response: BVBulkRatingsResponse) in

    let ratings = response.results

    for rating in ratings {
        let productId = rating.productId
        let averageOverallRating = rating.reviewStatistics?.averageOverallRating
        let totalReviewCount = rating.reviewStatistics?.totalReviewCount
    }

}) { (errors: [NSError]) in
    // handle failure appropriately
}

[request load:^(BVBulkRatingsResponse * _Nonnull response) {

    NSArray* ratings = response.results;

    for (BVProductStatistics* rating in ratings) {
        NSString* productId = rating.productId;
        NSNumber* averageOverallRating = rating.reviewStatistics.averageOverallRating;
        NSNumber* totalReviewCount = rating.reviewStatistics.totalReviewCount;
    }

} failure:^(NSArray * _Nonnull errors) {
    // handle failure appropriately
}];

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

1. Construct a BVReviewHighlightsRequest object with the initializer provided and pass the product ID. The example provided below demonstrates how to fetch Review Highlights for a given product ID.
   • Objective-C
   • Swift

   let request = BVReviewHighlightsRequest(productId: "productId")
   request.load({ (response) in
   
   if let positives = response.reviewHighlights.positives { // Array of BVReviewHighlight objects
     // display positives in your UI
   
     for positive in positives {
       let title = positive.title // PRO title
     }
   }
   
   if let negatives = response.reviewHighlights.negatives { // Array of BVReviewHighlight objects
     // display negatives in your UI
   
     for negative in negatives {
       let title = negative.title // CON title
     }
   }
   
   }) { (error) in
     // handle failure appropriately
   }
   

   BVReviewHighlightsRequest *reviewHighlightsRequest = [[BVReviewHighlightsRequest alloc] initWithProductId:@"productId"];
   [reviewHighlightsRequest load:^(BVReviewHighlightsResponse * _Nonnull response) {
     NSArray<BVReviewHighlight *> *positives = response.reviewHighlights.positives;
   
     for (BVReviewHighlight *positive in positives) {
       NSString *title = positive.title; // PRO title
     }
   
     NSArray<BVReviewHighlight *> *negatives = response.reviewHighlights.negatives;
   
     for (BVReviewHighlight *negative in negatives) {
       NSString *title = negative.title; // CON title
     }
   
   } failure:^(NSArray<NSError *> * _Nonnull errors) {
     // error
     NSLog(@"ERROR Loading Review Highlights: %@", errors.firstObject.localizedDescription);
   }];
   

2. Pass the client ID to the configuration before creating the request to fetch Review Highlights, as shown in the following code block:
   • Objective-C
   • Swift

   let configDict = ["clientId": "YOUR_CLIENT_ID",
   "apiKeyConversations": "YOUR_API_KEY"];
   BVSDKManager.configure(withConfiguration: configDict, configType: .staging)
   

   NSDictionary *configDict = @{@"clientId" : @"YOUR_CLIENT_ID", @"apiKeyConversations":@"YOUR_API_KEY"};
   [BVSDKManager configureWithConfiguration:configDict
   configType:BVConfigurationTypeStaging];