CreateAdGroup

From MdotM API
Jump to: navigation, search
  • Coming soon.
  • The advertiser can call the MdotM API to create new Ad Group. The response will be a adGroupID.

Specs

Method: Create
Rate Limit: Every 60 seconds.
URL: http://ads.mdotm.com/api/1.0/createAdGroup
with required parameters (email, secretkey):

Name Description Type Compulsion Example
email
Your email address
String
Required
email=api@mdotm.com
secretKey
Alphanumeric authentication code
String
Required
secretKey=4431141f1f341afaacd

Users must specify an adGroupName when creating Ad Group.

Name Description Type Compulsion Example
set_adGroupName
Set Ad Group Name
String
Required
set_adGroupName=Example_US_GB_SA_CN
set_countryTargeting
Set Countries Included
String
Optional
set_countryTargeting=US_GB_SA_CN
set_excludeCountries
Set Countries Excluded
String
Optional
set_excludeCountries=SG_KW
set_osTargeting
Set Minimum Operating System
String
Optional
set_osTargeting=iOS_4.2
set_totalSpendMax
Set Total Spend Cap
Float
Optional
set_totalSpendMax=500000 (0 = no cap)
set_monthSpendMax
Set Monthly Spend Cap
Float
Optional
set_monthSpendMax=5000 (0 = no cap)
set_daySpendMax
Set Daily Spend Cap
Float
Optional
set_daySpendMax=500 (0 = no cap)
set_cpc
Set Cost-per-Click
Float
Optional
set_cpc=0.10
set_cpa
Modify Cost-per-Action
Float
Optional
set_cpa=3.00
set_cpm
Set Cost-per-Thousand Impressions
Float
Optional
set_cpm=2.75
set_status
Set Status: Paused or Active
String
Optional
set_status=Paused; Possible Values: { Active, Paused }

Notes:

  • Ad Groups will not run until reviewed and approved by MdotM. The ad group status will be indicated as Pending.

Example

Request:

http://ads.mdotm.com/api/1.0/createAdGroup?email=your@email.com&secretKey=yoursecretkey&campaignID=0a1b2c3d&set_cpa=1.50

Response:

{
"error":0,
"description":"Success",
"response":true
"adGroupID":"a1b2c3d4"
}