checkStatus: Check object status

In JohnCoene/fbadsinsightsr: Get data on performances of facebook ads

Description

Returns effective as well as configured status and created time, name, account id of object requested (campaign, adset or ad).

Usage

checkStatus(id, token, fields = "effective_status")

Arguments

id	The id of the campaign, adset or ad you want to retrieve (Required), see how to find yours.
token	A valid token as returned by fbAuthenticate or a short-term token from facebook Graph API Explorer.
fields	default ("effective_status") returns the most popular ones. Run findFields to see all valid fields.

Details

• configured_status: The configured status of the object (campaign, adset or ad). If object is campaign and this status is PAUSED, all its active ad sets and ads will be paused and have an effective status CAMPAIGN_PAUSED.

• effective_status The effective status of this campaign/adset/ad; enum {ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED}

Author(s)

John Coene [e-mail]

See Also

grabAds

Examples

## Not run: 
# set token
TK <- "XXXXXXXXXXXXXXXX"

# get information on account
ads <- grabAds(account.id = "act_123456789012345", token = TK)

# loop through ads to find active one (to then get data)
i <- 1

while (status != "ACTIVE"){

   # check status
   status <- checkStatus(ads$id[i], TK)[,effective_status]

   # iterate
   i <- i + 1

   # stop if all ads gone through
   if(i == nrow(ads)) stop("No ACTIVE ads found", call. = FALSE)
}

# exctract active ad
active_ad <- ad[i,]

# get data
ad_data <- getAd(active_ad)

## End(Not run)

JohnCoene/fbadsinsightsr documentation built on May 28, 2019, 12:55 p.m.