Skip to content

Latest commit

 

History

History
53 lines (38 loc) · 2.01 KB

README.md

File metadata and controls

53 lines (38 loc) · 2.01 KB

Starbucks-offers-recommender

This model can predict whether to send a customer an offer based on offer properties and user demographics.

Dataset

The data set used contains simulated data that mimics customer behavior on the Starbucks rewards mobile app. Once every few days, Starbucks sends out an offer to users of the mobile app. An offer can be merely an advertisement for a drink or an actual offer such as a discount or BOGO (buy one get one free). Some users might not receive any offer during certain weeks.

This dataset is private dataset.

The data is contained in three files:

  • portfolio.json - containing offer ids and meta data about each offer (duration, type, etc.)
  • profile.json - demographic data for each customer
  • transcript.json - records for transactions, offers received, offers viewed, and offers completed

Here is the schema and explanation of each variable in the files:

portfolio.json

  • id (string) - offer id
  • offer_type (string) - type of offer ie BOGO, discount, informational
  • difficulty (int) - minimum required spend to complete an offer
  • reward (int) - reward given for completing an offer
  • duration (int) - time for offer to be open, in days
  • channels (list of strings)

profile.json

  • age (int) - age of the customer
  • became_member_on (int) - date when customer created an app account
  • gender (str) - gender of the customer (note some entries contain 'O' for other rather than M or F)
  • id (str) - customer id
  • income (float) - customer's income

transcript.json

  • event (str) - record description (ie transaction, offer received, offer viewed, etc.)
  • person (str) - customer id
  • time (int) - time in hours since start of test. The data begins at time t=0
  • value - (dict of strings) - either an offer id or transaction amount depending on the record

Model

  • Model is implemented using Amazon SageMaker framework
  • Model training/evaluation/deploying can be found in /Model Folder
  • Model achieved 0.89 F1 score

Libraries used

  • sagemaker
  • sklearn
  • pandas
  • numpy
  • seaborn