Aident Loadout を通じて Meta Ads Tools の Metaads Get Insights を使用します。実行前に入力、出力、設定、料金、リスクを確認できます。
Get insights data for a Meta Ads object (ad account, campaign, ad set, or ad) using the Meta Marketing API. Supports various metrics, breakdowns, and filtering options with flexible date ranges. Results are paginated; follow `paging.cursors.after` or `paging.next` to retrieve al…
sortarrayFields to sort by with direction (_ascending or _descending suffix)
afterstringCursor for the next page of results, usually taken from paging.cursors.after in the previous response.
levelstringLevel at which to aggregate the data Must match the type of object referenced by `object_id` (e.g., 'account' for 'act_...' IDs, 'campaign' for campaign IDs, 'adset' for ad set IDs, 'ad' for ad IDs); mismatches return empty or misleading metrics. Allowed values: 'account', 'camp…
limitintegerMaximum number of insight rows to return for this page. Use paging.cursors.after or paging.cursors.before from the response to request another page.
beforestringCursor for the previous page of results, usually taken from paging.cursors.before in the previous response.
fieldsarrayList of metric fields to include in the response. Valid standalone fields include: impressions, clicks, spend, reach, cpc, cpm, ctr, frequency, account_name, account_id, campaign_name, campaign_id, adset_name, adset_id, ad_name, ad_id, objective, buying_type, date_start, date_st…
filteringarrayFilters to apply to the data
object_id必須stringID of the object to get insights for (ad account, campaign, ad set, or ad). For ad accounts, the ID must include the act_ prefix (e.g., act_123456789). Campaign, ad set, and ad IDs are numeric only.
breakdownsarrayList of breakdown dimensions to apply to the data, such as publisher_platform, platform_position, impression_device, age, gender, country, region, or device_platform.
time_rangeobjectCustom date range for the insights. If provided, date_preset should be set to null/None to use this custom range instead. Must be a dict with keys `since` and `until` in YYYY-MM-DD format (e.g., {'since': '2024-01-01', 'until': '2024-01-31'}). Never provide both time_range and d…
date_presetstringPredefined date range for the insights. Defaults to 'last_30d' if neither date_preset nor time_range is specified. Allowed values: 'today', 'yesterday', 'last_7d', 'last_30d', 'this_month', 'last_month', 'this_quarter'. Case-insensitive (e.g., 'LAST_30D' is normalized to 'last_3…
date_range_defaultedbooleanInternal field to track if date_preset was defaulted. Do not set this manually.
data必須Data from the action execution
errorstringError if any occurred during the execution of the action
successful必須booleanWhether or not the action execution was successful or not
API キー接続。リスクレベル 2/5。
無料 Action