AdCreatives
特定の広告アカウント、広告セット、または広告の、広告クリエイティブ情報をクエリします。広告クリエイティブ情報へのアクセスには、ads_read アクセス許可が必要です。
テーブル固有の情報
Facebook のAdCreatives は、Facebook の特定のAds のクリエイティブのコレクションです。
Select
広告クリエイティブをクエリする場合は、結果をフィルタするには、ID またはTarget のいずれかを指定する必要があります。ターゲットとしては、広告アカウント、広告セット、または広告を指定できます。次に例を示します。
SELECT * FROM AdCreatives WHERE Target = 'adid'
Columns
| Name | Type | Description |
| ID [KEY] | String | 広告クリエイティブのID。 |
| Target | String | 広告セットの取得元になる広告アカウントIDまたはキャンペーンID。 |
| Name | String | 広告クリエイティブの名前。 |
| ApplinkTreatment | String | 動的プロダクト広告においてアプリがインストールされていない場合のdeep link フォールバック。
使用できる値は次のとおりです。deeplink_with_web_fallback, deeplink_with_appstore_fallback, web_only |
| Body | String | 広告のボディ。 |
| CallToActionType | String | レガシー広告のアクション要求ボタンのテキストとヘッダー。
使用できる値は次のとおりです。OPEN_LINK, LIKE_PAGE, SHOP_NOW, PLAY_GAME, INSTALL_APP, USE_APP, INSTALL_MOBILE_APP, USE_MOBILE_APP, BOOK_TRAVEL, LISTEN_MUSIC, LEARN_MORE, SIGN_UP, DOWNLOAD, WATCH_MORE, NO_BUTTON, CALL_NOW, BUY_NOW, GET_OFFER, GET_OFFER_VIEW, GET_DIRECTIONS, MESSAGE_PAGE, SUBSCRIBE, SELL_NOW, DONATE_NOW, GET_QUOTE, CONTACT_US, RECORD_NOW, VOTE_NOW, REGISTER_NOW, OPEN_MOVIES |
| EffectiveInstagramMediaId | String | 広告で使われるInstagram 投稿のID。 |
| EffectiveInstagramStoryId | String | Instagram 広告として表示するInstagram 投稿のID。 |
| ImageHash | String | クリエイティブで利用できる画像の画像ハッシュ。 |
| ImageUrl | String | クリエイティブの画像のURL。このURL で指定された画像は広告アカウントの画像ライブラリに保存されます。 |
| InstagramActorId | String | Instagram アクターID。 |
| InstagramPermalinkUrl | String | Instagram のパーマリンク。 |
| InstagramUserId | String | 広告作成のためのInstagram ユーザーのID。 |
| LinkOgId | String | ランディングページがOG タグを持つ場合、このクリエイティブのリンクのOpen Graph (OG) ID。 |
| LinkUrl | String | ページのタブURL によるページへの特定のランディングページの指定に使用（e.g. ページタブアプリ）。 |
| ObjectId | String | 広告もしくは広告タイプに該当するPromoted_object もしくはobject のID。 |
| ObjectStoryId | String | 広告で使われるページ投稿のID。 |
| ObjectType | String | 広告されているもののタイプ。
使用できる値は次のとおりです。APPLICATION, DOMAIN, EVENT, OFFER, PAGE, PHOTO, SHARE, STATUS, STORE_ITEM, VIDEO, INVALID |
| ObjectUrl | String | リンク広告でページでつながっていない行先のURL。 |
| PageId | String | クリエイティブのアクターID（ページID）。 |
| ProductSetId | String | クリエイティブで設定されている製品のID。 |
| RunStatus | String | クリエイティブの実行ステータス。
使用できる値は次のとおりです。ACTIVE, DELETED |
| SourceInstagramMediaId | String | 広告作成のためのInstagram 投稿のID。 |
| TemplateUrl | String | 動的プロダクト広告のトラッキングURL。 |
| ThumbnailUrl | String | このクリエイティブのサムネイルへのURL。 |
| Title | String | リンク広告のタイトル（ページには接続されない）。 |
| UrlTags | String | ページ投稿広告、投稿のメッセージ、もしくはCanvas アプリのインストールクリエイティブからクリックされたURL に追記されるか、リプレースされるクエリ文字列パラメータのセット。 |
| UsePageActorOverride | Boolean | この値がtrue の場合、モバイルアプリ広告のページアクターを表示します。 |
| AdLabels | String | クリエイティブに関連する広告ラベル。 |
| ObjectStorySpecLinkData | String | 新しい非公開のページ投稿を作成するためのリンクデータ。他のObjectStorySpec カラムがnull の場合にのみ値を持ちます。 |
| ObjectStorySpecPhotoData | String | 新しい非公開のページ投稿を作成するための写真データ。他のObjectStorySpec カラムがnull の場合にのみ値を持ちます。 |
| ObjectStorySpecVideoData | String | 新しい非公開のページ投稿を作成するための動画データ。他のObjectStorySpec カラムがnull の場合にのみ値を持ちます。 |
| ObjectStorySpecTextData | String | 新しい非公開のページ投稿を作成するためのテキストデータ。他のObjectStorySpec カラムがnull の場合にのみ値を持ちます。 |
| ObjectStorySpecTemplateData | String | 新しい非公開のページ投稿を作成するためのテンプレートデータ。他のObjectStorySpec カラムがnull の場合にのみ値を持ちます。 |
Pseudo-Columns
SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。 詳細については、WHERE 句のセクションを参照してください。
| Name | Type | Description |
| ThumbnailHeight | String | ThumbnailUrl で指定したサムネイルのレンダリング高さ（ピクセル単位）。デフォルトは64です。 |
| ThumbnailWidth | String | ThumbnailUrl で指定したサムネイルのレンダリング幅。デフォルトは64です。 |