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 | 広告の対象となるページの種類。有効値は、desktop、feed、desktopfeed、mobile、rightcolumn、rightcolumn-and-mobile、home、mobilefeed-and-external、desktop-and-mobile-and-external、feed-and-external、rightcolumn-and-mobile-and-external です。 |
| LearningStageInfoStatus | String | 広告セットの情報収集期間の進捗状況。 |
| LearningStageInfoConversions | Integer | 情報収集期間中に最後の重要な編集以降に広告セットが生成したコンバージョン数。 |
| LearningStageInfoAttributionWindows | String | ユーザーが広告を閲覧またはクリックしてからアクションを実行するまでの日数。 |
| LearningStageInfoLastSigEditTime | Datetime | 広告セットが情報収集期間に再突入する原因となった最後の重要な編集のタイムスタンプ。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。
| Name | Type | Description |
| DateStart | Date | 広告セットの取得開始日。 |
| DateEnd | Date | 広告セットの取得終了日。 |
| DatePreset | String | DateStart およびDateEnd を指定する代替手段。日付の範囲は前もって指定された値に基づき自動的に計算されます。
使用できる値は次のとおりです。maximum, today, yesterday, this_week_sun_today, this_week_mon_today, last_week_sun_sat, last_week_mon_sun, last_3d, last_7d, last_14d, last_28d, last_30d, last_90d, this_month, last_month |
| IsCompleted | Boolean | 完了ステータスでフィルタリングします。 |