Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vanilla-rtb/extensions
Code Generators and Extensions for vanilla-rtb stack
https://github.com/vanilla-rtb/extensions
ad-tech ads adserver adtech beeswax bidder binding-generator campaign digital-media extensions handlebars handlebars-template integration iponweb mustache-templating openrtb programatic rtb stub vanilla-rtb
Last synced: 7 days ago
JSON representation
Code Generators and Extensions for vanilla-rtb stack
- Host: GitHub
- URL: https://github.com/vanilla-rtb/extensions
- Owner: vanilla-rtb
- Created: 2018-02-14T05:34:01.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-03T19:03:36.000Z (8 months ago)
- Last Synced: 2024-04-14T16:54:37.386Z (7 months ago)
- Topics: ad-tech, ads, adserver, adtech, beeswax, bidder, binding-generator, campaign, digital-media, extensions, handlebars, handlebars-template, integration, iponweb, mustache-templating, openrtb, programatic, rtb, stub, vanilla-rtb
- Language: Go
- Homepage: https://github.com/venediktov/vanilla-rtb
- Size: 241 KB
- Stars: 19
- Watchers: 5
- Forks: 5
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-rtb - vanilla-rtb extensions - Golang code generators for vanilla-rtb matchers and language extensions (Work in progess). ✊ (Table of Contents / Applications Engines and Frameworks)
README
[![alt text][1.1]][1]
[![alt text][2.1]][2]
[![alt text][3.1]][3]
[![alt text][4.1]][4]
[![alt text][5.1]][5]
[1.1]: http://i.imgur.com/tXSoThF.png (twitter icon with padding)
[2.1]: http://i.imgur.com/P3YfQoD.png (facebook icon with padding)
[3.1]: http://i.imgur.com/yCsTjba.png (google plus icon with padding)
[4.1]: http://i.imgur.com/YckIOms.png (tumblr icon with padding)
[5.1]: http://i.imgur.com/0o48UoR.png (github icon with padding)
[1]: http://www.twitter.com/vanilla_rtb
[2]: http://www.linkedin.com/company/vanillartb
[3]: https://plus.google.com/+VladimirVenediktov
[4]: http://forkbid.com
[5]: http://www.github.com/vanilla-rtb
# VanillaRTB extensions
Code Generators and Extensions for VanillaRTB framework in Node.js, Go, Java , PHP, Python.
[](https://gitter.im/vanilla-rtb/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](http://perso.crans.org/besson/LICENSE.html)
### Contributing [](https://github.com/vanilla-rtb/extensions/issues)
Recommended build environment and dependencies: [](https://github.com/vanilla-rtb/extensions/wiki/Installing-Dependencies)
**Linux or MacOS, Go >= 1.9 , CMake >= 3.8, GCC >= 7.0 or Clang >= 4.0, npm >= 5.7.1**
```npm --version```
Output:```5.7.1```
**npm installation(Linux):**
```
sudo apt-get remove nodejs ^node-* nodejs-*
sudo apt-get autoremove
sudo apt-get clean
curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
sudo apt-get install nodejs
```
Then :
```
curl https://raw.githubusercontent.com/creationix/nvm/v0.33.2/install.sh | sh
```
After this, open a new terminal and check the npm version:
```
npm --version
```
**npm installation(MacOS HomeBrew):**
```
brew update
brew install node
```
Go 1.9 ( Linux )
```
$ sudo add-apt-repository ppa:gophers/archive
$ sudo apt-get update
$ sudo apt-get install golang-1.9-go
$ sudo ln -s -f /usr/lib/go-1.9/bin/go /usr/bin/go
$ sudo ln -s -f /usr/lib/go-1.9/bin/gofmt /usr/bin/gofmt
```
Go 1.9 ( MacOS )
```
brew update
brew install go
```
### 1. To install vanilla-rtb-extensions golang libraries run ```install.sh``` or execute below commands
```bash
rm -rf $GOPATH/src/github.com/vanilla-rtb/
rm -rf $GOPATH/src/stubs
go get github.com/jessevdk/go-flags
go get -d github.com/vanilla-rtb/extensions
mv $GOPATH/src/github.com/vanilla-rtb/extensions/stubs $GOPATH/src/stubs
go install github.com/vanilla-rtb/extensions
go install stubs
```
Make sure you pass ```-d``` flag to ```go get``` command when installing vanilla-rtb/extensions it will clone our project
without actually installing in the ```$GOPATH\pkg``` folder .
The main reason behind such installation is ```import "stubs"``` directive in our bidder_generator.go uses relative path allowing you to import your own stubs and generate your own targeting cache not just what we provide with our examples
### 2. Download vanilla-rtb extensions to working folder
```
git clone --recursive https://github.com/vanilla-rtb/extensions
```
### 3. To generate targeting code and application utilizing it execute following command
s
```
cd extensions
go run bidder_generator.go --output-dir . --input-template templates/matcher.tmpl -g matchers
go run bidder_generator.go --output-dir . --input-template templates/biddergo.tmpl -g app -T ico -B APP
```
### 4. To generate bidder library for later binding to other languages like NodeJS/Go/etc run following command sequence
```
go run bidder_generator.go --output-dir . --input-template templates/matcher.tmpl -g matchers
go run ../bidder_generator.go --output-dir . --input-template ../templates/biddergo.tmpl -g app -T ico -B LIB
```
**For more information HELP in generator itself**
```
go run bidder_generator.go --help
```
**Our generator is referencing** ``` import "stubs" ``` **without full path to github repo , it's treated as your local package
where you will store all of your future stubs.**
The code you place in the stubs package needs to register your stub classes it's done with
```TypeRegistry``` exported package variable.
Just add more Objects to the registry and ```codegen``` will automatically regenerate all your stubs.
```
var TypeRegistry = []reflect.Type{
reflect.ValueOf(Domain{}).Type(),
reflect.ValueOf(ICOCampaign{}).Type(),
reflect.ValueOf(Geo{}).Type(),
reflect.ValueOf(GeoCampaign{}).Type(),
}
```
It also needs to group stubs types by targeting model as shown below , the order in array coresponds to order executed by bidder in real time
```
//agregate targetings based on the bidder model the execution in the bidder will preserve as order of declaration
var Targetings = map[string][]reflect.Type{
"ico": []reflect.Type{
reflect.ValueOf(Domain{}).Type(),
reflect.ValueOf(ICOCampaign{}).Type(),
},
"geo": []reflect.Type{
reflect.ValueOf(Geo{}).Type(),
reflect.ValueOf(GeoCampaign{}).Type(),
},
}
```
The type passed to registry must be annotated with golang tags for ability to wire in-proc and shared memory correctly
For types that allocate on the heap there needs to be a conversion ```cpp:"std::string" ipc:"shared_string"```
The Domain struct tags implicetely tells generator that the lookup is done by single key ```domain name``` , the sorage structure generated for shared memory acess can be expressed as Map where string type is a key and Domain type is a value. VanillaRTB relies on those structures when matching campaigns and it uses these set of ```implicitly chained structures``` where output from first becomes input for the next step in matching rule, if any matcher in the chain fails before it reaches the last matcher aka campaign-collector no bid is returned by vanilla-rtb stack.
The terminal function selectingthe Ads is not included in the stubs it's implicit it comes as library by default accepting collection of Campaigns.
When looking at "ico" or "geo" examples in both cases collection of ICOCampaign or GeoCampaign is automatically fed into terminal AdSelector which matches based on the campaign ids and size of ad.
```
type Domain struct {
name string `cpp:"std::string" ipc:"shared_string" is_key:"yes"`
domain_id uint32 `cpp:"uint32_t" ipc:"uint32_t"`
}
type ICOCampaign struct {
domain_id uint32 `cpp:"uint32_t" ipc:"uint32_t" is_key:"yes"`
campaign_id uint32 `cpp:"uint32_t" ipc:"uint32_t"`
}
type Geo struct {
city string `cpp:"std::string" ipc:"shared_string" is_key:"yes"`
country string `cpp:"std::string" ipc:"shared_string" is_key:"yes"`
geo_id uint32 `cpp:"uint32_t" ipc:"uint32_t" is_value:"yes"`
}
type GeoCampaign struct {
geo_id uint32 `cpp:"uint32_t" ipc:"uint32_t" is_key:"yes"`
campaign_id uint32 `cpp:"uint32_t" ipc:"uint32_t" is_value:"yes"`
}
```
Currently we generate C++ bidder code based on vanilla-rtb library API and manually code other languages bindings.
Ideally we should generate both the C++ layer and the bindings.
5. Experimental generator for vanilla-rtb stand alone C++ project
```bash
go run bidder_generator.go --output-dir . --input-template templates/cmake.tmpl -g cmake
```
[](https://gitter.im/vanilla-rtb/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[](https://github.com/vanilla-rtb/extensions/issues)
[](https://github.com/vanilla-rtb/extensions/wiki/Installing-Dependencies)
**VIDEO:**
[](http://www.youtube.com/watch?v=saJQ-Y_VkCA)