Ads
特定の広告セット、キャンペーン、広告アカウントの広告情報をクエリします。広告情報へのアクセスには、ads_read アクセス許可が必要です。
テーブル固有の情報
Facebook のAds は、作成された個々の広告です。
Select
広告アカウントをクエリする場合は、結果をフィルタするには、ID またはTarget のいずれかを指定する必要があります。次に例を示します。
SELECT * FROM Ads WHERE Target = 'act_123456'
さらに、> または >= 演算子とともにUpdatedTime を使うことで、特定の日付より新しいレコードのみを取得できます。次に例を示します。
SELECT * FROM Ads WHERE Target = 'act_123456' AND UpdatedTime > '01/01/2016'
Columns
Name | Type | Description |
ID [KEY] | String | 広告のID。 |
Target | String | 広告の取得元になる広告アカウントID、キャンペーンID、または広告セットID。 |
Name | String | 広告の名前。 |
AdStatus | String | 広告のステータス。
使用できる値は次のとおりです。ACTIVE, PAUSED, CAMPAIGN_PAUSED, CAMPAIGN_GROUP_PAUSED, CREDIT_CARD_NEEDED, DISABLED, DISAPPROVED, PENDING_REVIEW, PREAPPROVED, PENDING_BILLING_INFO, ARCHIVED, DELETED |
BidInfo | String | 広告セットから取得された入札情報の値。 |
BidType | String | 広告セットから取得された入札タイプの値。
使用できる値は次のとおりです。CPM, CPC, MULTI_PREMIUM, ABSOLUTE_OCPM, CPA |
CampaignId | String | 広告が含まれるキャンペーンのID。 |
AdSetId | String | 広告が含まれる広告セットのID。 |
AdCreativeId | String | 広告と関連のある広告クリエイティブのID。 |
ConfiguredStatus | String | 広告のコンフィギュレーションステータス。'Status' の利用を推奨します。
使用できる値は次のとおりです。ACTIVE, PAUSED, DELETED, ARCHIVED |
CreatedTime | Datetime | 広告の作成時刻。 |
UpdatedTime | Datetime | 広告が最後に更新された時刻。 |
ConversionSpecs | String | 広告のコンバージョン仕様。 |
FailedDeliveryChecks | String | 広告が表示されないことを回避するための確認。 |
Recommendations | String | 広告に推薦がある場合はこのフィールドに含まれます。ない場合は、このフィールドは空になります。 |
TrackingSpecs | String | 広告のトラッキング仕様。NONE に設定されていない場合、デフォルト値は目的、または広告に基づき設定されます。 |
AdActiveTime | String | 広告が最近アクティブになった時間。 |
AdScheduleEndTime | Datetime | 個々の広告の終了時間を定義するオプションのパラメータ。終了時間が定義されていない場合、広告はキャンペーンのスケジュールで実行されます。 |
AdScheduleStartTime | Datetime | 個々の広告の開始時間を定義するオプションのパラメータ。開始時間が定義されていない場合、広告はキャンペーンのスケジュールで実行されます。 |
BidAmount | Integer | オークションで使用されるこの広告への入札額。 |
LastUpdatedByAppId | String | 広告の直近の更新に使用されたアプリを示します。 |
PreviewShareableLink | String | ユーザーがさまざまな配置の広告をプレビューできるようにするリンク。 |
SourceAdId | String | この広告のコピー元の広告ID。 |