getSmartlyData: Get Smartly.io Data

In RSmartlyIO: Loading Facebook and Instagram Advertising Data from 'Smartly.io'

Description

getSmartlyData posts the query and downloads the data. The data are retrieved from the API as a dataframe.

Usage

getSmartlyData(start, end, date = "date", accountID, accountInfo = F,
  campaignStructure = NULL, billing = NULL, targeting = NULL,
  creative = NULL, facebook = NULL, attribution = "28d", apiToken,
  metrics)

Arguments

start	Beginning of date range. Format: "2019-01-01"
end	End of date range. Format: "2019-01-10"
date	Date aggregation level. One out of date, year, month, weekofyear, weekday
accountID	Smartly.io Account ID. Input as character: "1234abcdefg5678"
accountInfo	Account Information. TRUE/FALSE
campaignStructure	Campaign Information Selection. Vector with multiple arguments out of: campaign_name, campaign_fb_id, adgroup_name, adgroup_fb_id, name, id, fb_objective, campaign_start_date
billing	Billing Information Selection. Vector with multiple arguments out of: bid.optimization_goal, bid.billing_event
targeting	Targeting Settings of Campaigns. Vector with multiple arguments out of: targeting.geo_locations.countries, targeting.geo_locations.cities, targeting.genders, targeting.age_min, targeting.age_max, targeting.interests, targeting.behaviors, targeting.custom_audiences, targeting.excluded_custom_audiences, targeting.connections, targeting.user_os, targeting.user_device, targeting.page_types
creative	Creative/Ad Characteristics. Vector with multiple arguments out of: creative_meta.call_to_action, creative_meta, creative_meta.type, creative_meta.post_type, creative_meta.name, creative_meta.picture, creative_meta.post_fb_id, creative_meta.post_fb_link, creative_meta.text, creative_meta.title, creative_meta.link, creative_meta.url_tags
facebook	Facebook Settings. One argument out of: age, country, gender, age_gender, placement, cross_device, region, hourly_stats_aggregated_by_advertiser_time_zone, hourly_stats_aggregated_by_audience_time_zone
attribution	Attribtuion Time Window, defaults to 28 days. One of: "1d","7d" or "28d".
apiToken	API Token. Character. Usually the API token is provided within the Smartly.io web interface or by the account manager.
metrics	Metrics. Note: There are more metrics available. See the reporting section in the smartly.io interface. Vector with multiple argumets out of: impressions, ctr, cpm, cpc, spent, conversions, inline_link_clicks, clicks, cpa, reach, frequency, roi, revenue, social_impressions, social_clicks, website_clicks, newsfeed_clicks, deeplink_clicks, app_store_clicks, call_to_action_clicks, inline_post_engagement

Value

Dataframe

RSmartlyIO documentation built on May 2, 2019, 9:37 a.m.