setting up buzzcity account - server side api
TRANSCRIPT
Setting up BuzzCity Account
Server Side API
SETTING UP YOUR ACCOUNT
•Fill up account & contact information on the form.
Step 2 Fill up Account & Contact Information
Step 3 BuzzCity’s Publisher Agreement
• Select “ Publisher”
• Please take a few moment to read through our agreement.
• Click on “Sign Up Now”
Step 4 Setting up your account
• IMPORTANT: Click on “Get Started as Publisher”. This step is needed to authorize you for using our Publisher APIs. You will not receive ads if you do not complete this step.
• You will be directed to the following steps below to setup your publisher settings. Click on “Start”.
Step 5 Setting up your account: Site URL
Key in your Site URL / Market Download Page: Example: Mobile Website m.mobilewap.com Example: Android App https://play.google.com/store/apps/details?id=com.abc.com Example: Blackberry App http://appworld.blackberry.com/webstore/content/680/ Example: iOS App https://itunes.apple.com/gb/app/instagram/id389801252?mt=8 Example: Java ME App http://store.ovi.com/content/238066?clickSource=homepage&pos=7 Example: Windows App http://www.windowsphone.com/en-us/store/app/youtube/dcbb1ac6-a89a-df11-a490-00237de2db9e
Step 6: Setting your account: Site Category
• General Content Sites/ Apps contain many varieties of
download (such as mobile games, ringtones, wallpaper downloads and content, etc)
• Community Sites/ Apps contain services based on user-
generated content. Sites (or applications) include chat, Message, WAP domain hosts, Dating, Forums, Social Network, Memberships etc.
• Glamour & Dating Sites/ Apps contain dating, match making
services and/ “pin-up” art.
**Brand Safe Channels would be classified by
BuzzCity
IMPORTANT: You are required to select a “Site category”. This will determine the type of ads you receive.
Step 7: Setting your account: Traffic Type
• Select the type of traffic of your site / App
– Mobile Web
– Android Application
– Blackberry Application
– iOS Application
– JavaME Application
– Windows Application
IMPORTANT: You are required to select “Traffic”. This will determine the type of ads you receive. It is advisable to create separate account for different platforms
Click on “Continue”
Step 8 Setting your account: Settings
• Select “Publisher” Menu
• Click on “ Publisher Info”
• Click on “Settings”
Step 9 : Setting your account : Advertiser Category
Select the type of advertiser categories whose ads you want to accept (** See next slide for description of the categories)
IMPORTANT: You are required to select “Advertiser Category”. This will determine the type of ads you receive.
Click on “Save
Changes”
Advertiser Categories
Brand
General Content
Glamour & Dating
Advertisements promoting tools for mobile phones such as Anti-virus,
Phone Cleaner, Browser, Download tools, Battery Optimization, Speed
optimizer and etc.
Application / Content Advertisements promoting by advertisers to drive
for application or content downloads or websites. This includes
wallpaper, app, music, video downloads, and etc.
Brand Advertisements promoting products and services
Gambling &
Sweepstakes
Advertisements that contain dating services and/or ‘pin-up’ art.
Utilities
Advertisements promoting campaigns contain gambling and lotteries
elements
Advertisements promoting alcohol and tobacco related product. This
includes any sites/apps e-cigarettes, alcohol and tobacco brand
campaigns and alcohol & tobacco related products. Alcohol & Tobacco
Community
Advertisements that promote communication or social networking
services, such as, Facebook Messenger, Google +, Line, Skype,
WhatsApp, etc.
Religious Religious Advertisements promoting products and services
Optional: Ad Exchange ads
• BuzzCity now support 3rd party demand ads source to achieve higher fill rate
** Only available for Publishers who integrate using JavaScript
Not advisable for Ad Network, as it may cause high latency
Select the type of advertiser categories if you wish to accept 3rd party ads
SETTING UP PAYMENT INFORMATION
Payment Information
• BuzzCity offers 2 payment mode to the publishers:
(1) Paypal
(2) Bank Transfer
• Payment will be made once your earnings has accumulated to USD$200
** Please note that there might be admin charges incurred by your selected payment processor for each of the payment.
Step 1
• Select “Home” Menu
• Click on “ My Account Details”
Step 2 - Paypal
• Select Paypal as the mode of payment and key in your paypal account. ** Ensure that your paypal account is set to receive money. For more information, please refer to https://www.paypal.com/us/webapps/helpcenter/helphub/article/?solutionId=FAQ2397&topicID=&m=ARA
• Click Save Payment Information
Step 2 – Bank Transfer
• Select Bank Transfer as the mode of payment
• Fill up the Bank Transfer information
• Click Save Payment Information
SERVER SIDE API
Ad Codes
Before You Start
From Account
Dashboard
Please copy down the Partner ID at the right hand corner after you have login to www.buzzcity.com
It is advisable to split into multiple accounts
for each application/sites and platform to track the
performance and ability to see which app/site might have abnormal
traffic.
Server Side Flow
1. Visitor's Mobile requests for a page on the Publisher's Site from the publisher's Server
2. Publisher's Server detects the IP and User Agent of the Visitor's request and sends a request with this information to the BuzzCity Server using API. The exposure counts for all Campaigns will be incremented.
3. BuzzCity Server will analyze the request and return a batch of up to 10 Campaigns with targeting options that matches the request, together with the Campaign IDs.
4. The Publisher Server interprets the BuzzCity server response and chooses a Campaign Banner to show to the Visitor. The server inserts the HTML code for the chosen Campaign Banner on the Publisher Site page.
5. The page with the Campaign Banner is served to the Visitor's Mobile. 6. Click will be registered with BuzzCity Server when user click on it. Please refer the following for retrieving UA/IP: http://docs.buzzcity.net/wiki/Standard_Server_Side_API/3.3#Retrieving_IP_.2F_UA_.2FBrowser_Detection_.28PHP_Example.29
Server Side API Flow
1. Request for ads
Publisher Server
2. Call for BuzzCity’s using showads.php with User Agent
and IP address
** BuzzCity will registered the requests as exposures
3. Text responses with list of matching BuzzCity campaigns
4a. Publisher call for text/ image/rich banner creative
using img.php
4b. BuzzCity will return with text/ image banner. Caching is
not advisable.
5. Publisher server will served the
chosen banner using html_code
parameter to user
6. If User click on the text /image banner ,
the click will be registered via
click.php
Sample Server Request
• http://show.buzzcity.net/showads.php?partnerid=xxxxx&get=rich&ip=124.122.78.193&ua=SAMSUNG-GT-S5620/1.0&limit=3&browser=app_j2me&v=3
• For more information, please refer to : http://docs.buzzcity.net/wiki/Standard_Server_Side_API/3.2#Example_2
Server Response
Serve the banner using html_code
No Ads Available
• When the Standard Server Side API has no ads available, the Standard Server Side API will return the following API response:
– {"error":{"errcode":"1","errmsg":"No matching ads available. Please try again later."},"data":null}
Wiki Page
• Please refer to our wiki page :
http://docs.buzzcity.net/wiki/Standard_Server_Side_API
• Contact us @ [email protected]
AD FORMATS
• Suitable for display on mobile sites
• Banners are sized and formatted appropriately to fit all screens GIF,
PNG, JPG for still images ( max: 3 frames)
• Animated GIF for animations File size for basic banners
Able to IP filter and detect mobile users
50 Characters
UTF-8 enabled (support all languages)
Could be display as a banner
Standard Ad Units
• Feature Phone Small Banner (120x20) max size: 10KB
• Feature Phone Medium Banner (168x28) max size: 10KB
• Feature Phone Large Banner (216x36) max size: 10KB
• Smartphone Static Banner (300x50) max size: 15KB
• Smartphone Static Wide Banner (320 x 50) max size: 15KB
• Smartphone Static Interstitial (300x250) max size: 15KB
Ad Formats: Image & Text Ads
Image Ads
Text Ads
Suitable for display on smartphones or sites / apps on tablets/
websites
• Large Portrait (320x480) max size: 40KB
• Rectangle (300x250) max size: 40KB
• Square (250x250) max size: 20KB
• (468x60) max size: 20KB
• Leaderboard (728x90) max size: 40KB
Ad Formats: Larger Image Ads
Larger Image Ads
