fuxictr
pypi i fuxictr

fuxictr

A configurable, tunable, and reproducible library for CTR prediction

by xue-pai

1.2.2 (see all)License:Apache-2.0 License
pypi i fuxictr
Readme
Logo
Tutorials Python version Pytorch version Pypi version Downloads License Wechat QR code

Click-through rate (CTR) prediction is a critical task for many industrial applications such as online advertising, recommender systems, and sponsored search. FuxiCTR provides an open-source library for CTR prediction, with key features in configurability, tunability, and reproducibility. We hope this project could benefit both researchers and practitioners with the goal of open benchmarking for CTR prediction.

This repo is the community dev version of the original release at huawei-noah/benchmark/FuxiCTR.

πŸ”” If you find our code or benchmarks helpful in your research, please kindly cite the following papers.

Jieming Zhu, Jinyang Liu, Shuai Yang, Qi Zhang, Xiuqiang He. Open Benchmarking for Click-Through Rate Prediction. The 30th ACM International Conference on Information and Knowledge Management (CIKM), 2021. [Bibtex]

Key Features

  • Configurable: Both data preprocessing and models are modularized and configurable.

  • Tunable: Models can be automatically tuned with easy configuration.

  • Reproducible: All the benchmarks can be easily reproduced.

Model List

NoPublicationModelPaperBenchmark
1WWW'07LRPredicting Clicks: Estimating the Click-Through Rate for New Ads 🚩Microsoft↗️
2ICDM'10FMFactorization Machines↗️
3CIKM'13DSSMLearning Deep Structured Semantic Models for Web Search using Clickthrough Data 🚩Microsoft↗️
4CIKM'15CCPMA Convolutional Click Prediction Model↗️
5RecSys'16FFMField-aware Factorization Machines for CTR Prediction 🚩Criteo↗️
6RecSys'16YoutubeDNNDeep Neural Networks for YouTube Recommendations 🚩Google↗️
7DLRS'16Wide&DeepWide & Deep Learning for Recommender Systems 🚩Google↗️
8ICDM'16IPNNProduct-based Neural Networks for User Response Prediction↗️
9KDD'16DeepCrossDeep Crossing: Web-Scale Modeling without Manually Crafted Combinatorial Features 🚩Microsoft↗️
10NIPS'16HOFMHigher-Order Factorization Machines↗️
11IJCAI'17DeepFMDeepFM: A Factorization-Machine based Neural Network for CTR Prediction 🚩Huawei↗️
12SIGIR'17NFMNeural Factorization Machines for Sparse Predictive Analytics↗️
13IJCAI'17AFMAttentional Factorization Machines: Learning the Weight of Feature Interactions via Attention Networks↗️
14ADKDD'17DCNDeep & Cross Network for Ad Click Predictions 🚩Google↗️
15WWW'18FwFMField-weighted Factorization Machines for Click-Through Rate Prediction in Display Advertising 🚩Oath, TouchPal, LinkedIn, Alibaba↗️
16KDD'18xDeepFMxDeepFM: Combining Explicit and Implicit Feature Interactions for Recommender Systems 🚩Microsoft↗️
17KDD'18DINDeep Interest Network for Click-Through Rate Prediction 🚩Alibaba
18CIKM'19FiGNNFiGNN: Modeling Feature Interactions via Graph Neural Networks for CTR Prediction↗️
19CIKM'19AutoInt/AutoInt+AutoInt: Automatic Feature Interaction Learning via Self-Attentive Neural Networks↗️
20RecSys'19FiBiNETFiBiNET: Combining Feature Importance and Bilinear feature Interaction for Click-Through Rate Prediction 🚩Sina Weibo↗️
21WWW'19FGCNNFeature Generation by Convolutional Neural Network for Click-Through Rate Prediction 🚩Huawei↗️
22AAAI'19HFM/HFM+Holographic Factorization Machines for Recommendation↗️
23Arxiv'19DLRMDeep Learning Recommendation Model for Personalization and Recommendation Systems 🚩Facebook↗️
24NeuralNetworks'20ONNOperation-aware Neural Networks for User Response Prediction↗️
25AAAI'20AFN/AFN+Adaptive Factorization Network: Learning Adaptive-Order Feature Interactions↗️
26AAAI'20LorentzFMLearning Feature Interactions with Lorentzian Factorization 🚩eBay↗️
27WSDM'20InterHAtInterpretable Click-through Rate Prediction through Hierarchical Attention 🚩NEC Labs, Google↗️
28DLP-KDD'20FLENFLEN: Leveraging Field for Scalable CTR Prediction 🚩Tencent↗️
29CIKM'20DeepIMDeep Interaction Machine: A Simple but Effective Model for High-order Feature Interactions 🚩Alibaba, RealAI↗️
30WWW'21FmFMFM^2: Field-matrixed Factorization Machines for Recommender Systems 🚩Yahoo↗️
31WWW'21DCN-V2DCN V2: Improved Deep & Cross Network and Practical Lessons for Web-scale Learning to Rank Systems 🚩Google↗️
32CIKM'21DESTINEDisentangled Self-Attentive Neural Networks for Click-Through Rate Prediction 🚩Alibaba↗️
33CIKM'21EDCNEnhancing Explicit and Implicit Feature Interactions via Information Sharing for Parallel Deep CTR Models 🚩Huawei↗️
34DLP-KDD'21MaskNetMaskNet: Introducing Feature-Wise Multiplication to CTR Ranking Models by Instance-Guided Mask 🚩Sina Weibo↗️
35SIGIR'21SAMLooking at CTR Prediction Again: Is Attention All You Need? 🚩BOSS Zhipin↗️
36KDD'21AOANetArchitecture and Operation Adaptive Network for Online Recommendations 🚩Didi Chuxing↗️

Installation

Please follow the guide for installation. In particular, FuxiCTR has the following dependent requirements.

  • python 3.6
  • pytorch v1.0/v1.1
  • pyyaml >=5.1
  • scikit-learn
  • pandas
  • numpy
  • h5py
  • tqdm

Tutorials | 中文教程

  1. Run the demo to understand the overall workflow

  2. How to use dataset and model config files

  3. How to preprocess raw csv data to h5 data

  4. How to use h5 data as input

  5. How to make configurations?

  6. How to tune the model hyper-parameters via grid search

  7. How to use sequence features

  8. How to load pretrained embeddings as features

API Documentation

Check an overview of code structure for details on API design.

Discussion

Welcome to join our WeChat group for any question and discussion.

Scan QR code

Join Us

We have open positions for internships and full-time jobs. If you are interested in research and practice in recommender systems, please send your CV to jamie.zhu@huawei.com.

GitHub Stars

251

LAST COMMIT

5mos ago

MAINTAINERS

1

CONTRIBUTORS

4

OPEN ISSUES

2

OPEN PRs

2
VersionTagPublished
1.2.2
1mo ago
1.2.1
2mos ago
1.2.0
4mos ago
1.1.1
4mos ago
No alternatives found
No tutorials found
Add a tutorial