checkUsers
, returns users and access permissions listAccounts
id parameter defaults to me
getAny
FUN where it sometimes would not return results when few fields were requested, also fixed sometimes returning weirdly named variables.getEstReach
, returns estimated reachbreakdown
parameter placement_rhc
has been removed in API v2.7getActivity
variable names returned corrected Version Three brings many changes. The package now calls the updated v2.6 of the API.
Changes:
checkTarget
has been deprecated in favour of:checkTargetSentence
AND checkTargetTree
which have been added, both retrieve targeting specifications but return the data in different formats and can be called on different objects (accounts, campaigns, adsets, ads). See documentation for more details.grabAccounts
and grabImages
have been deprecated in favour of listAccounts
and listImages
listApps
returns apps under accountlistAdApps
returns list of advertiseable applicationsfindFields
now also applies to getLabCampaigns
, getLabAdsets
and getLabAds
findParams
now also applies to limit.type
from new FUN checkTargetTree
listLabels
returns labels under accountgetLabCampaigns
fetch campaigns by labelsgetLabAdsets
fetch adsets by labelsgetLabAds
fetch ads by labelsgetLabCreatives
fetch creatives by labelscreateLabels
create labelsupdateCampaign
updateAdset
updateAd
Bug fixes:
limit
parameter and check-family functions now works correctly. Package overhauled; now internally functions on new S3 class for robustness, much optimisation and clean up of utils.R
, package now split into 4 families of functions (grab
, check
, find
and get
), and much more.
See updated documentation for details.
fbAutenticate
FUN fixedactions
, unique_actions
, cost_per_action_type
, cost_per_unique_action_type
and website_ctr
as respective variables (column names) regardless of parameters or fields passed to functions.simplify
argument is now irrelevant and has thus been deprecated.n > 100
in GET-family functions and findInfo
has been reduced from 3 seconds to 0.5 seconds.internal.R
speeds up some processes.n
and verbose
added to findAccounts
.verbose = TRUE
output to something more sensible.findStatus
function added, returns status of specific campaign, adset or ad.findCampaigns
, findAdsets
and findAds
functions added.findInfo
now call findObjects
getCreative
added to fetch ad Creatives from ads.warning
returned now more adequateBug Fixes
paginate
(internal funciton) no longer infinitely loops.toDF
(internal function) properly parse missing data.verbose = TRUE
toDF
(internal.R) - GET-family should no longer return errors.verbose = TRUE
has been fixed where it was not being paste o nnew line when used inside a loopsimplify = TRUE
in getAny
will ignore the fields that cause the issue.getImage
function to fetch URLs of images used by an ad account, adset, etc.findAccounts
also returns account name.Bug Fixes:
stop
message when using region as breakdowns
together with action_carousel_card_id
and/or action_carousel_card_name
as fields as it is not allowed by API and returned an error. The latter two fields have also been removed when using simplify=TRUE
.stop
message when no data - has been replaced by warning
.paginate
function (utils.R
) to clean up GET-family functions.verbose
arguement now also returns details on pagination.Bug Fixes:
findTarget
function where the presence of an argument broke the function - should no longer occur.findTarget
where NULL
was returned when few specifications were retrieved.findTarget
now correctly returns targeting specs.findAccount
is no longer "missing verbose"verbose
arguement to GET-family functions. See documentation.findTarget
function to retrieve targeting specs of an ad or adset.findAccounts
function added; retrieves all account IDs accessible by either a business.facebook.com or a user. See updated Manual or ?documentation. Bug fixes:
paginate
argument has been changed in the GET-family functions to n
and defaults to 100
. n
indicates the number of results desired (rows) rather the previous boolean argument (TRUE|FALSE
) avoids—or rather allows one to control—lengthy queries.Bug fixes:
token
appropriately used in findInfo
, it should no longer return an error when using that which is returned by fbAuthenticate
.paginate
argument removed in favour of n
(see documentation), it should no longer generate hour-long queries unless a massive amount of data is requested.plyr::rbind.fill
paginate = "next"
in getCampaign
, getAdset
, getAd
and getAny
. Changed to the more adequate (and mentioned in documentation) paginate = NULL
getInfo
to findInfo
.getInfo
to retrieve all campaigns, adset and ads IDs and names under an account!paginate
parameter in GET-family functions (i.e.: ?getAny
).date_preset
.get_account
to getAccount
while their arguements have changed from being underscore_separated to period.separated i.e.: app_id
changed to app.id
httr
moved from DEPENDS
to IMPORTS
to make te package more self-contained and avoid errors on install.Bug fixes:
fb_authneticate
.Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.