//
//  Answers.h
//  Crashlytics
//
//  Copyright (c) 2015 Crashlytics, Inc. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <Fabric/FABAttributes.h>

FAB_START_NONNULL

@interface Answers : NSObject

/**
 *  Log a Sign Up event to see users signing up for your app in real-time, understand how
 *  many users are signing up with different methods and their success rate signing up.
 *
 *  @param signUpMethodOrNil     The method by which a user logged in, e.g. Twitter or Digits.
 *  @param signUpSucceededOrNil  The ultimate success or failure of the login
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logSignUpWithMethod:(NSString * FAB_NULLABLE)signUpMethodOrNil
                    success:(NSNumber * FAB_NULLABLE)signUpSucceededOrNil
           customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log an Log In event to see users logging into your app in real-time, understand how many
 *  users are logging in with different methods and their success rate logging into your app.
 *
 *  @param loginMethodOrNil      The method by which a user logged in, e.g. email, Twitter or Digits.
 *  @param loginSucceededOrNil   The ultimate success or failure of the login
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logLoginWithMethod:(NSString * FAB_NULLABLE)loginMethodOrNil
                   success:(NSNumber * FAB_NULLABLE)loginSucceededOrNil
          customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Share event to see users sharing from your app in real-time, letting you
 *  understand what content they're sharing from the type or genre down to the specific id.
 *
 *  @param shareMethodOrNil      The method by which a user shared, e.g. email, Twitter, SMS.
 *  @param contentNameOrNil      The human readable name for this piece of content.
 *  @param contentTypeOrNil      The type of content shared.
 *  @param contentIdOrNil        The unique identifier for this piece of content. Useful for finding the top shared item.
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this event.
 */
+ (void)logShareWithMethod:(NSString * FAB_NULLABLE)shareMethodOrNil
               contentName:(NSString * FAB_NULLABLE)contentNameOrNil
               contentType:(NSString * FAB_NULLABLE)contentTypeOrNil
                 contentId:(NSString * FAB_NULLABLE)contentIdOrNil
          customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log an Invite Event to track how users are inviting other users into
 *  your application.
 *
 *  @param inviteMethodOrNil     The method of invitation, e.g. GameCenter, Twitter, email.
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logInviteWithMethod:(NSString * FAB_NULLABLE)inviteMethodOrNil
           customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Purchase event to see your revenue in real-time, understand how many users are making purchases, see which
 *  items are most popular, and track plenty of other important purchase-related metrics.
 *
 *  @param itemPriceOrNil         The purchased item's price.
 *  @param currencyOrNil          The ISO4217 currency code. Example: USD
 *  @param purchaseSucceededOrNil Was the purchase succesful or unsuccesful
 *  @param itemNameOrNil          The human-readable form of the item's name. Example:
 *  @param itemIdOrNil            The machine-readable, unique item identifier Example: SKU
 *  @param itemTypeOrNil          The type, or genre of the item. Example: Song
 *  @param customAttributesOrNil  A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logPurchaseWithPrice:(NSDecimalNumber * FAB_NULLABLE)itemPriceOrNil
                    currency:(NSString * FAB_NULLABLE)currencyOrNil
                     success:(NSNumber * FAB_NULLABLE)purchaseSucceededOrNil
                    itemName:(NSString * FAB_NULLABLE)itemNameOrNil
                    itemType:(NSString * FAB_NULLABLE)itemTypeOrNil
                      itemId:(NSString * FAB_NULLABLE)itemIdOrNil
            customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Level Start Event to track where users are in your game.
 *
 *  @param levelNameOrNil        The level name
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this level start event.
 */
+ (void)logLevelStart:(NSString * FAB_NULLABLE)levelNameOrNil
     customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Level End event to track how users are completing levels in your game.
 *
 *  @param levelNameOrNil                 The name of the level completed, E.G. "1" or "Training"
 *  @param scoreOrNil                     The score the user completed the level with.
 *  @param levelCompletedSuccesfullyOrNil A boolean representing whether or not the level was completed succesfully.
 *  @param customAttributesOrNil          A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logLevelEnd:(NSString * FAB_NULLABLE)levelNameOrNil
              score:(NSNumber * FAB_NULLABLE)scoreOrNil
            success:(NSNumber * FAB_NULLABLE)levelCompletedSuccesfullyOrNil
   customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log an Add to Cart event to see users adding items to a shopping cart in real-time, understand how
 *  many users start the purchase flow, see which items are most popular, and track plenty of other important
 *  purchase-related metrics.
 *
 *  @param itemPriceOrNil         The purchased item's price.
 *  @param currencyOrNil          The ISO4217 currency code. Example: USD
 *  @param itemNameOrNil          The human-readable form of the item's name. Example:
 *  @param itemTypeOrNil          The type, or genre of the item. Example: Song
 *  @param itemIdOrNil            The machine-readable, unique item identifier Example: SKU
 *  @param customAttributesOrNil  A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logAddToCartWithPrice:(NSDecimalNumber * FAB_NULLABLE)itemPriceOrNil
                     currency:(NSString * FAB_NULLABLE)currencyOrNil
                     itemName:(NSString * FAB_NULLABLE)itemNameOrNil
                     itemType:(NSString * FAB_NULLABLE)itemTypeOrNil
                       itemId:(NSString * FAB_NULLABLE)itemIdOrNil
             customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Start Checkout event to see users moving through the purchase funnel in real-time, understand how many
 *  users are doing this and how much they're spending per checkout, and see how it related to other important
 *  purchase-related metrics.
 *
 *  @param totalPriceOrNil        The total price of the cart.
 *  @param currencyOrNil          The ISO4217 currency code. Example: USD
 *  @param itemCountOrNil         The number of items in the cart.
 *  @param customAttributesOrNil  A dictionary of custom attributes to associate with this purchase.
 */
+ (void)logStartCheckoutWithPrice:(NSDecimalNumber * FAB_NULLABLE)totalPriceOrNil
                         currency:(NSString * FAB_NULLABLE)currencyOrNil
                         itemCount:(NSNumber * FAB_NULLABLE)itemCountOrNil
                 customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Rating event to see users rating content within your app in real-time and understand what
 *  content is most engaging, from the type or genre down to the specific id.
 *
 *  @param ratingOrNil           The integer rating given by the user.
 *  @param contentNameOrNil      The human readable name for this piece of content.
 *  @param contentTypeOrNil      The type of content shared.
 *  @param contentIdOrNil        The unique identifier for this piece of content. Useful for finding the top shared item.
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this event.
 */
+ (void)logRating:(NSNumber * FAB_NULLABLE)ratingOrNil
      contentName:(NSString * FAB_NULLABLE)contentNameOrNil
      contentType:(NSString * FAB_NULLABLE)contentTypeOrNil
        contentId:(NSString * FAB_NULLABLE)contentIdOrNil
 customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Content View event to see users viewing content within your app in real-time and
 *  understand what content is most engaging, from the type or genre down to the specific id.
 *
 *  @param contentNameOrNil      The human readable name for this piece of content.
 *  @param contentTypeOrNil      The type of content shared.
 *  @param contentIdOrNil        The unique identifier for this piece of content. Useful for finding the top shared item.
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this event.
 */
+ (void)logContentViewWithName:(NSString * FAB_NULLABLE)contentNameOrNil
                   contentType:(NSString * FAB_NULLABLE)contentTypeOrNil
                     contentId:(NSString * FAB_NULLABLE)contentIdOrNil
              customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Search event allows you to see users searching within your app in real-time and understand
 *  exactly what they're searching for.
 *
 *  @param queryOrNil            The user's query.
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this event.
 */
+ (void)logSearchWithQuery:(NSString * FAB_NULLABLE)queryOrNil
          customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

/**
 *  Log a Custom Event to see user actions that are uniquely important for your app in real-time, to see how often
 *  they're performing these actions with breakdowns by different categories you add. Use a human-readable name for
 *  the name of the event, since this is how the event will appear in Answers.
 *
 *  @param eventName             The human-readable name for the event.
 *  @param customAttributesOrNil A dictionary of custom attributes to associate with this purchase. Attribute keys
 *                               must be <code>NSString</code> and and values must be <code>NSNumber</code> or <code>NSString</code>.
 *  @discussion                  How we treat <code>NSNumbers</code>:
 *                               We will provide information about the distribution of values over time.
 *
 *                               How we treat <code>NSStrings</code>:
 *                               NSStrings are used as categorical data, allowing comparison across different category values.
 *                               Strings are limited to a maximum length of 100 characters, attributes over this length will be
 *                               truncated.
 *
 *                               When tracking the Tweet views to better understand user engagement, sending the tweet's length
 *                               and the type of media present in the tweet allows you to track how tweet length and the type of media influence
 *                               engagement.
 */
+ (void)logCustomEventWithName:(NSString *)eventName
              customAttributes:(NSDictionary * FAB_NULLABLE)customAttributesOrNil;

@end

FAB_END_NONNULL