CData Cmdlets for Facebook 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。