إصدار ‏‎Graph API‎‏

Ad Set Activities

قراءة

Event type descriptions

Here is a list of event_type by object:

Ad account related event

Name	Description
ad_account_update_spend_limit	update the spend limit of an ad account
ad_account_reset_spend_limit	reset the spend limit of an ad account.
ad_account_remove_spend_limit	remove the spend limit of an ad account. You would have unlimited spend limit if you remove spend limit
ad_account_set_business_information	set business information for this ad account.
ad_account_update_status	update account status, includes: disabled, active, test, unsettled, pending closure, closed, pending risk review, in grace period
ad_account_add_user_to_role	add user to ad account
ad_account_remove_user_from_role	remove user from ad account
add_images	add an image to ad account image library
edit_images	edit an image in ad account image library

Billing related event

Name	Description
ad_account_billing_charge	charge ad account
ad_account_billing_charge_back	undo the charging on ad account per bank's instructions
ad_account_billing_charge_back_reversal	reapply the undone charging
ad_account_billing_decline	billings was declined
ad_account_billing_refund	refund on ad account
add_funding_source	add funding source to ad account
remove_funding_source	remove funding source from ad account

Campaign related event

Name	Description
create_campaign	create campaign
update_campaign_name	update campaign friendly name
update_campaign_run_status	update campaign run status

Ad set related event

Name	Description
create_ad_set	create ad set
update_ad_set_bidding	update bid information
update_ad_set_target_spec	update ad set targeting
update_ad_set_name	update ad set friendly name
update_ad_set_run_status	update ad set run status
update_ad_set_budget	update ad set budget
update_ad_set_duration	update ad set duration

Adgroup related event

Name	Description
create_ad	create ad
update_ad_creative	update creative of ad, including image/title/text change.
update_ad_run_status	update adgroup run status
update_ad_friendly_name	update adgroup friendly name
ad_review_approved	ad review was approved
ad_review_declined	ad review was not approved

Other

Name	Description
create_audience	create custom audience
delete_audience	delete custom audience

مثال

Graph API Explorer

GET /v19.0/{ad-set-id}/activities HTTP/1.1
Host: graph.facebook.com

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{ad-set-id}/activities',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */

/* make the API call */
FB.api(
    "/{ad-set-id}/activities",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{ad-set-id}/activities",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{ad-set-id}/activities"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

إذا كنت تريد التعرف على كيفية استخدام واجهة Graph API، يرجى قراءة ‏دليل استخدام واجهة Graph API‏.

المعلمات

معلمة	الوصف
`after` string	after
`business_id` numeric string or integer	This parameter is a required parameter once the ad account is associated with any business account.
`category` enum {ACCOUNT, AD, AD_KEYWORDS, AD_SET, AUDIENCE, BID, BUDGET, CAMPAIGN, DATE, STATUS, TARGETING}	Filter events by category.
`limit` integer	limit
`since` datetime	The start time to query account history. Default is 7 days prior.
`uid` int	Filter events by the user id.
`until` datetime	The end time to query account history. Default is now.

الحقول

ستؤدي القراءة من عنصر الربط هذا إلى نتيجة بتنسيق JSON:

{
    "data": [],
    "paging": {}
}

`data`

قائمة عُقد ‏‎AdActivity‎‏.

`paging`

لمزيد من التفاصيل عن تقسيم الصفحات، يرجى الاطلاع على ‏دليل Graph API‏.

‎Error Codes‎

خطأ	الوصف
100	Invalid parameter
368	The action attempted has been deemed abusive or is otherwise disallowed

إنشاء

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ التحديث

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.

جارٍ الحذف

لا يمكنك تنفيذ هذه العملية في نقطة النهاية هذه.