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 | キャンペーンが最後に更新された時刻。 |