updateAdset: Update an adset

In JohnCoene/oRion: Integrate R & Cheetah Mobile Orion

Description

Update adset settings, see details and example.

Usage

updateAdset(adset.id, body)

Arguments

adset.id	id of adset to update
body	Body of request that includes adset settings. See examples and details.

Details

Valid values for body:

• switch Ad switch, use switchIt otherwise, 1: On, 0: Off.

• name Ad set name (unique)

• unit_price Unit Price. Amount you want to spend to pay per click (CPC) or per 1,000 impressions (CPM)

• click_url click_url, protocol is required (http://, https://).

• deeplink Deep link is the ability to link into a specific page or function inside of your app, making an app linkable just like a web site. If you are only targeting people who already installed your app, you do not need to add deferred deep linking. Used when the objective of campaign which ad set belonged to is "Get App Reengagement" (objective = 4)

• imp_url Impression Tracking. An Impression tracking is an optional URL that allows you to track how many people viewed your ads through third-party tracking system, and our system supported macro is Gaid, e.g. http://host/imp?gaid=gaid. Used when the bid type is "CPM" bid_type = 4

• budget_lifetime Your budget is the maximum amount you want to spend. If you choose lifetime, the amount you enter is the maximum you'll spend during the lifetime of your ad set. At least one of budget_daily and budget_lifetime is filled.

• budget_daily Your budget is the maximum amount you want to spend. If you choose Per Day, the amount you enter is the maximum you'll spend each day. At least one of "budget_daily" and "budget_lifetime" is filled.

• start_time Start time for the adset (i.e.: 2015-09-09 10:10)

• end_time End time for the adset (i.e.: 2015-09-09 10:10)

• ad_scheduling Your ad set will either run continuously within some days or within some hours range you select. (JSON) i.e.: {1:[1,2],7:[1,2,23]}

• delivery_type Use deliveryType to generate otherwise, 0: Standard delivery, 1: Accelerated delivery. Standard delivery is recommended and the preferred option for most advertisers. Accelerated delivery can be useful for promoting time-sensitive events and quickly reaching a target audience.

• target_cpi Target CPI. Only for KA user. 3: Click (CPC)

• freq_type Frequency Capping type. Frequency capping controls frequency capping of the ad set per user.

• freq_times Frequency Capping type. Frequency capping controls frequency capping of the ad set per user.

• country Audience country code. Narrow your potential audience to the people in those countries. Using '|' separated if more than one country. i.e.: US|ID|CN. See dictCountry

• language Audience language code, i.e.: en see dictLanguage

• gender Use gender to generate otherwise, 0: All, 1: Male, 2 Female

• age Use age to generate otherwise, Audience age. 1: 18-24, 2: 25-30, 3: 32-40, 4: 41+.

• interest Audience interest. Reach users based on their specific interests. See dictInterest

• behavior Audience behaviour. Reach users based on app usage and other behaviors. See dictBehaviour

• device_brand Audience device brand. See dictDevice

• min_device_os Min OS version of audience used, blank for unrestricted. See dictOS

• max_device_os Max OS version of audience used, blank for unrestricted. See dictOS

• net_type Use netType to generate otherwise, 0: All, 1: Wifi, 2: 2G/3G/4G

• dsp_url Bid request url of DSP when this pre-targeting condition meets.

Author(s)

John Coene [e-mail]

See Also

orionOAuth, listAdsets, createAdset, helpers, dictCountry, dictLanguage, dictInterest, dictBehaviour, dictDevice, dictOS

Examples

## Not run: 
# authenticate
orionOAuth(client.id = 0000,
           client.secret = "0x00000000x00x0x000xxx0000x0xx0")
           
# list adsets
adsets <- listAdsets()

# update adset name
update <- updateCampaign(adset.id = adsets$id[1], body = list(
               switch = switchIt("on"), 
               name = "New adset Name - Running"))
               
# show updated campaign
showAdset(adset.id = adsets$id[1])

## End(Not run)

JohnCoene/oRion documentation built on June 13, 2019, 12:44 p.m.