Excel Add-In for Facebook Ads

Build 24.0.9062

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です。

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