Phiên bản API Đồ thị

Ad Account Business Constraints

Represents business constraints on an Ad Account.

Đọc

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

Thông số

Điểm cuối này không có bất kỳ thông số nào.

Trường

Trường thông tinMô tả
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

Tạo

Bạn có thể tạo yêu cầu POST đến cạnh account_controls từ các đường dẫn sau:
Khi đăng lên cạnh này, hệ thống sẽ tạo an AdAccountBusinessConstraints.

Thông số

Thông sốMô tả
audience_controls
JSON or object-like arrays

audience_controls

Bắt buộc
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}>

Kiểu trả về

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

Mã lỗi

LỗiMô tả
100Invalid parameter
2641Your ad includes or excludes locations that are currently restricted
200Permissions error

Cập nhật

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

Bạn không thể thực hiện thao tác này trên điểm cuối này.

Xóa

Bạn không thể thực hiện thao tác này trên điểm cuối này.