AdSets
特定の広告セット、キャンペーン、広告アカウントの広告情報をクエリします。広告セット情報へのアクセスには、ads_read アクセス許可が必要です。
テーブル固有の情報
Facebook のAdSets は、Facebook 内のAds のコレクションです。
Select
広告セットをクエリする場合は、結果をフィルタするには、ID またはTarget のいずれかを指定する必要があります。ターゲットとしては、広告アカウントまたはキャンペーンを指定できます。次に例を示します。
SELECT * FROM AdSets WHERE Target = 'act_123456'
Columns
Name | Type | Description |
ID [KEY] | String | 広告セットのID。 |
Target | String | 広告セットの取得元になる広告アカウントIDまたはキャンペーンID。 |
Name | String | 広告セットの名前。 |
BudgetRemaining | Integer | この広告セットのために残っている予算。 |
CampaignId | String | この広告セットが含まれる広告キャンペーン。 |
AdSetStatus | String | 広告セットのステータス。
使用できる値は次のとおりです。ACTIVE, PAUSED, ARCHIVED, DELETED |
BillingEvent | String | 広告セットが使っている請求イベント。APP_INSTALLS:アプリがインストールされたときに支払う。CLICKS:広告のどこかがクリックされたときに支払う。IMPRESSIONS:広告が表示されたときに支払う。LINK_CLICKS:広告のリンクがクリックされたときに支払う。OFFER_CLAIMS:クーポンが発行されたときに支払う。PAGE_LIKES:ページがいいね!されたときに支払う。POST_ENGAGEMENT:投稿が読まれたときに支払う。VIDEO_VIEWS:動画が視聴されたときに支払う。 |
CreatedTime | Datetime | 広告セットの作成時刻。 |
DailyBudget | Integer | アカウントの通貨で定義されている広告セットの毎日の予算。24時間を超える広告セットでのみ指定できます。 |
LifetimeBudget | Decimal | アカウントの通貨で定義されている広告セットのライフタイムの予算。 |
EndTime | Datetime | 広告セットの終了日。 |
StartTime | Datetime | 広告セットの開始日。 |
UpdatedTime | Datetime | 広告セットが最後に更新された時刻。 |
Recommendations | String | 広告セットに推薦がある場合はこのフィールドに含まれます。ない場合は、このフィールドは空になります。 |
TargetingGenders | Integer | 性別によってリーチするオーディエンス。0=すべて、1=男性、2=女性。
使用できる値は次のとおりです。0, 1, 2 |
TargetingAgeMax | Integer | 広告の対象となる最大年齢層。設定する場合、65以下。 |
TargetingAgeMin | Integer | 広告の対象となる最低年齢層。設定する場合、13以上。設定しないと、デフォルトで18に設定されます。 |
TargetingCountries | String | 広告の対象となる国。 |
TargetingLocationTypes | String | 広告の対象となる地域。 |
TargetingRegions | String | 広告の対象となる都道府県、市区町村、地域。 |
TargetingCities | String | 広告の対象となる都市を半径と距離でターゲットする。 |
TargetingZips | String | 広告の対象となる郵便番号。 |
TargetingCustomLocations | String | 広告の対象となるカスタム地域。 |
TargetingGeoMarkets | String | 広告の対象となるDesignated Market Areas(指定マーケット地域)。キーの形式はDMA:NUMBER(例、DMA:501)です。 |
TargetingInterests | String | 広告の対象となる趣味・関心。 |
TargetingBehaviors | String | 広告の対象となる行動。 |
TargetingDevicePlatforms | String | 広告の対象となるデバイスプラットフォーム。 |
TargetingPublisherPlatforms | String | 広告の対象となるパブリッシャープラットフォーム。 |
TargetingInstagramPositions | String | 広告の対象となるInstagram のポジション。 |
TargetingPageTypes | String | 広告の対象となるページの種類。有効値は、デスクトップ、フィード、デスクトップ・フィード、モバイル、右列、右列・モバイル、ホーム、モバイルフィード・外部、デスクトップ・モバイル・外部、フィード・外部、右列・モバイル・外部です。 |
LearningStageInfoStatus | String | 広告セットの情報収集期間の進捗状況。 |