Excel Add-In for Facebook Ads

Build 24.0.9062

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。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062