إصدار ‏‎Graph API‎‏

Ad Account Business Constraints

Represents business constraints on an Ad Account.

قراءة

This node cannot be queried directly. To read this node, use the GET /<AD_ACCOUNT_ID>/account_controls endpoint.

المعلمات

لا تحتوي نقطة النهاية هذه على أي معلمات.

الحقول

الحقلالوصف
audience_controls

audience_controls

campaigns_with_error
list<numeric string>

Indicates the set of campaigns for which the account controls have not been applied due to one or more errors in the campaigns that conflict with the controls

placement_controls
PlacementControls

This field contains another field called placement_exclusion that provides information on which placements need to be excluded while targeting. All the other placements will be included. Each placement is denoted by a string that concatenates the publisher platform of the placement and a position inside the publisher platform, separated by an underscore. What is provided as parameter is a list of placements. For e.g. If we want to exclude the rewarded videos position from the audience network publisher platform, we provide the field as follows: { "placement_controls": { "placement_exclusions": ["audience_network_rewarded_video"] } } Only a few placements are allowed to be excluded: audience_network_classic (native, banner & interstitial positions of audience network) audience_network_rewarded_video (rewarded videos of audience network) audience_network_instream_video (instream videos of audience network) facebook_marketplace (marketplace section inside facebook) facebook_rhc (right hand column inside facebook)

status
enum {APPLICATION_IN_PROGRESS, ACTIVE, WITH_CAMPAIGN_ERROR}

Represents the status of account controls set.

APPLICATION_IN_PROGRESS indicates that the account controls are being applied to eligible campaigns. ACTIVE indicates that the account controls are successfully applied to all eligible campaigns. WITH_CAMPAIGN_ERROR indicates that the account controls may not have been applied to some eligible campaigns due to one or more errors in the campaigns that conflict with the controls

إنشاء

‎You can make a POST request to account_controls edge from the following paths:
‎When posting to this edge, an AdAccountBusinessConstraints will be created.‎

المعلمات

معلمةالوصف
audience_controls
JSON or object-like arrays

audience_controls

مطلوب
age_min
int64

geo_locations
JSON or object-like arrays

excluded_geo_locations
JSON or object-like arrays

exclusions
JSON or object-like arrays

placement_controls
JSON or object-like arrays

This field contains another field called placement_exclusion that provides information on which placements need to be excluded while targeting. All the other placements will be included. Each placement is denoted by a string that concatenates the publisher platform of the placement and a position inside the publisher platform, separated by an underscore. What is provided as parameter is a list of placements. For e.g. If we want to exclude the rewarded videos position from the audience network publisher platform, we provide the field as follows: { "placement_controls": { "placement_exclusions": ["audience_network_rewarded_video"] } } Only a few placements are allowed to be excluded: audience_network_classic (native, banner & interstitial positions of audience network) audience_network_rewarded_video (rewarded videos of audience network) audience_network_instream_video (instream videos of audience network) facebook_marketplace (marketplace section inside facebook) facebook_rhc (right hand column inside facebook)

placement_exclusions
array<enum {AUDIENCE_NETWORK_CLASSIC, AUDIENCE_NETWORK_REWARDED_VIDEO, AUDIENCE_NETWORK_INSTREAM_VIDEO, FACEBOOK_MARKETPLACE, FACEBOOK_RIGHT_HAND_COLUMN}>

‎Return Type‎

Struct {
id: string,
success: bool,
error_code: string,
error_message: string,
}

‎Error Codes‎

خطأالوصف
100Invalid parameter
2641Your ad includes or excludes locations that are currently restricted
200Permissions error

جارٍ التحديث

This node cannot be queried directly. To update this node, use the POST /act_<AD_ACCOUNT_ID>/account_controls endpoint.

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

جارٍ الحذف

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