greenrobotllc / Adserver

GreenRobot Open-source Adserver

This adserver rotates banner ads between AdSense/AdMob, LifeStreetmedia, and others based on RPM. For AdSense/AdMob and Lifestreetmedia, the RPM is automatically retrieved by the server using network APIs, for other networks you will have to edit the RPM yourself.

This adserver is for desktop sites and mobile web, as well as native mobile apps. Specifically, I use it on a Facebook app, which is also accessible outside of the Facebook frame once you're logged in via Facebook connect. It should also work fine on desktop or mobile web sites not using Facebook login. For mobile apps, I have made some code available to work with the adserver. I am still working on this, including adding documentation.

For iOS: https://github.com/greenrobotllc/adserver-ios-sdk

For Android: https://github.com/greenrobotllc/adserver-android-sdk

Requirements:

I recommend using Linux or Mac OS X. I have not tried this under Windows. For production/linux, I have it deployed to a Centos 7 server on Linode and it's running currently. For development, I used Mac OS X with Laravel Homestead development environment. I later switched to Laradock.

Steps to install for production:

For installing to Centos Linux using Docker, please check out these install instructions: INSTALL ON CENTOS 7

Steps to install for development on Mac OS X:

For installing to Mac OS X using Docker, please check out these install instructions: INSTALL ON MAC_OS_X

FAQ:

What is the route I am suppose to provide for the Adsense Oauth Callback when setting up the google_clients_secrets.json? The route would be the address of your webserver. You should setup a domain or subdomain for it to work. For example: https://yoursubdomain.greenrobot.com/refresh

Developer Notes

Note for developers: I have set debug to false in config/app.php so this is ready to go for production installs. If you wish to debug, set this value to true. Setting it to true may cause your database password to be exposed if a connection error occurs.

Contact / Security Bugs

You can use Github issues for regular bugs and feature requests. For security issues or if you have any questions you don't want to discuss publicly you can email me: [email protected]

Facebook Discussion Group

Join the discussion on Facebook about GreenRobot Adserver: https://www.facebook.com/groups/greenrobotadserver/

Twitter Updates

Follow GreenRobot Adserver on Twitter: https://twitter.com/GRAdserver

TODO

-Fix errors from phpcs

-Document iOS & Android sdk integration

-I would like to add Facebook Audience network to this adserver.

Contributing

We take openness and inclusivity very seriously. To that end we have adopted the following code of conduct.

Contributor Code of Conduct