Campaigns
特定の広告アカウントのキャンペーン情報をクエリします。キャンペーン情報へのアクセスには、ads_read アクセス許可が必要です。
テーブル固有の情報
Facebook のCampaigns は、個々のAds またはAdSets が含まれている広告キャンペーンです。
Select
キャンペーンをクエリする場合は、結果をフィルタするには、ID またはTarget のいずれかを指定する必要があります。ターゲットは、広告アカウントである必要があります。次に例を示します。
SELECT * FROM Campaigns WHERE Target = 'act_123456'
Columns
| Name | Type | Description |
| ID [KEY] | String | キャンペーンのID。 |
| Target | String | キャンペーンを取得するためのターゲットまたは広告アカウントID。 |
| Name | String | キャンペーンの名前。 |
| BuyingType | String | このフィールドの値を基に、Facebook が将来に配信、価格設定、制限に関する最適化を行います。このキャンペーンに付属するすべての広告セットが購入タイプに一致する必要があります。
使用できる値は次のとおりです。AUCTION, FIXED_CPM, RESERVED |
| ConfiguredStatus | String | このステータスがPAUSED である場合、すべてのアクティブな広告セットおよび広告は停止され、CAMPAIGN_PAUSED ステータスが有効になります。'status' の利用を推奨します。
使用できる値は次のとおりです。ACTIVE, PAUSED, DELETED, ARCHIVED |
| EffectiveStatus | String | キャンペーンの有効なステータス。例えば、キャンペーン下のすべての広告セットが停止されている場合、有効なステータスはADSET_PAUSED です。
使用できる値は次のとおりです。ACTIVE, PAUSED, DELETED, PENDING_REVIEW, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO, CAMPAIGN_PAUSED, ARCHIVED, ADSET_PAUSED |
| Status | String | このステータスがPAUSED である場合、すべてのアクティブな広告セットおよび広告は停止され、CAMPAIGN_PAUSED ステータスが有効になります。フィールドは'configured_status' と同じ値を返し、こちらの利用が推奨されます。
使用できる値は次のとおりです。ACTIVE, PAUSED, DELETED, ARCHIVED |
| CreatedTime | Datetime | キャンペーンの作成時刻。 |
| Objective | String | この広告キャンペーンの目標。指定されている場合、API はキャンペーンの下で作成された広告グループがその目的と一致することを検証します。
使用できる値は次のとおりです。CANVAS_APP_ENGAGEMENT, CANVAS_APP_INSTALLS, EVENT_RESPONSES, MOBILE_APP_ENGAGEMENT, MOBILE_APP_INSTALLS, NONE, OFFER_CLAIMS, PAGE_LIKES, POST_ENGAGEMENT, VIDEO_VIEWS, WEBSITE_CLICKS, WEBSITE_CONVERSIONS |
| SpendCap | Int | キャンペーンの上限費用。これ以上費用を使わない上限です。設定した通貨のサブユニットの整数値で表わされます。 |
| DailyBudget | Int | キャンペーンの毎日の予算。 |
| BudgetRemaining | Int | キャンペーンの残りの予算。 |
| LifetimeBudget | Int | キャンペーンの通算予算。 |
| BidStrategy | String | キャンペーンの入札戦略。LOWEST_COST_WITHOUT_CAP、LOWEST_COST_WITH_BID_CAP、COST_CAP のいずれかになります。 |
| StartTime | Datetime | キャンペーンの開始日。 |
| StopTime | Datetime | キャンペーンの終了日。 |
| UpdatedTime | Datetime | キャンペーンが最後に更新された時刻。 |
| BoostedObjectId | String | このキャンペーンに関連付けられたブーストオブジェクト（存在する場合）。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。
| Name | Type | Description |
| DateStart | Date | キャンペーンの取得開始日。 |
| DateEnd | Date | キャンペーンの取得終了日。 |
| DatePreset | String | DateStart およびDateEnd を指定する代替手段。日付の範囲は前もって指定された値に基づき自動的に計算されます。
使用できる値は次のとおりです。maximum, today, yesterday, this_week_sun_today, this_week_mon_today, last_week_sun_sat, last_week_mon_sun, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, this_month, last_month |
| IsCompleted | Boolean | 完了ステータスでフィルタリングします。 |