JDBC Driver for Twitter Ads

Build 24.0.9062

AdStats

特定のエンティティのすべての利用可能な指標の情報をクエリします。

ビュー固有の情報

AdStats は、すべてのエンティティタイプの分析指標がすべて含まれています。このビューをクエリすると、指定されたエンティティによりサポートされる指標のみが値付きで生成されます。

Twitter Ads 非同期API のサポート

このビューはTwitter Ads 非同期API をサポートします。UseAsyncAPI プロパティをTRUE に設定するとAPI が有効になります。デフォルトはFALSE です。

Select

次のフィールドで結果セットをフィルタンリングできます。

AccountId これはTwitter 分析に関連するすべてのビューで一般的に必要とされるフィルタです。指定された場合、AccountId 接続プロパティの値をオーバーライドします。値が指定されない場合には、本製品 はAdAccount ビューから返されたリストの初めのアカウントを取得しに行きます。
StartTime and EndTime タイムウィンドウを指定するために使われます。この値は7日間を超える設定ができません。ウィンドウが指定されない場合、直近7日の分析が返されます。
SELECT * FROM AdStats WHERE StartTime = '12/02/2016' AND EndTime = '12/09/2016'
Entity および EntityId エンティティタイプは5個あります:
  • ACCOUNT
  • FUNDING_INSTRUMENT
  • CAMPAIGN
  • LINE_ITEM
  • PROMOTED_TWEET
  • ORGANIC_TWEET

それぞれのエンティティはビューを持ち、有効なアイテムのリストやそれぞれのID を取得するために使われます。デフォルトでこれらのフィルタの一つが指定されると、本製品 はAccountId 接続プロパティで指定されたID のアカウントの分析を取得します。

Note:Entity フィールドに"ORGANIC_TWEET" を設定した場合、WHERE 句にEntityId を設定する必要があります。

SELECT * FROM AdStats WHERE EntityId = '807000624822882304' AND Entity = 'ORGANIC_TWEET'

Granularityこの値は、返されるデータポイントの粒度を定義します。有効な値はTOTAL、DAY、およびHOUR です。TOTAL 以外の値に設定する場合、StartTime とEndTime で指定された期間のそれぞれのユニットにブレークダウンされた分析が返されます。例えば、DAY に設定された場合、指定された期間の日次の分析が返されます。デフォルトはDAY です。
SELECT * FROM AdStats WHERE Granularity = 'HOUR'
Placement Twitter、もしくはTwitter Audience Platform のすべてのプレースメントの指標を集計前に戻すために使われます。利用可能な値はALL_ON_TWITTER、およびPUBLISHER_NETWORK です。プレースメントは、1つの値しかとれません。Twitter のプレースメントとTwitter Audience Platform のプレースメントの分析データをフェッチするには別々のクエリが必要です。デフォルトはALL_ON_TWITTER に設定されています。
SELECT * FROM AdStats WHERE Placement = 'PUBLISHER_NETWORK'

フィルタのリストはオプションですが、Entity、EntityId、およびtime window は少なくとも指定することが推奨されます。

SELECT * FROM AdStats WHERE EntityId = '807000624822882304' AND Entity = 'ORGANIC_TWEET' AND StartTime = '12/02/2016' AND EndTime = '12/09/2016' 

Columns

Name Type Description
AccountId String 使用する広告アカウントのId。
Entity String クエリするエンティティ。
EntityId String クエリするエンティティのId。
StartTime Date StartTime とEndTime の間のタイムウィンドウで集められたデータと取得されたデータの範囲。1時間単位での設定となります。
EndTime Date StartTime とEndTime の間のタイムウィンドウで集められたデータと取得されたデータの範囲。1時間単位での設定となります。
IntervalStartTime String 現在のインターバルの開始時間。これはGranularity DAY およびHOUR にのみ適用されます。
IntervalEndTime String 現在のインターバルの終了時間。これはGranularity DAY およびHOUR にのみ適用されます。
Placement String プレースメント。有効な値は次のとおりです:ALL_ON_TWITTER、PUBLISHER_NETWORK。

使用できる値は次のとおりです。ALL_ON_TWITTER, PUBLISHER_NETWORK

Granularity String この値は、StartTime とEndTime で定義されるタイムレンジ内で返されるデータポイントの粒度を定義します。例えば、HOUR に設定すると、StartTime とEndTime の間の1時間ごとのデータポイントが表示されます。

使用できる値は次のとおりです。TOTAL, DAY, HOUR

Engagements Integer エンゲージメントの総数。
Impressions Integer インプレッションの総数。
Retweets Integer リツイートの総数。
Replies Integer リプライの総数。
Likes Integer いいねの総数。
Follows Integer フォローの総数。
CardEngagements Integer エンゲージメントの総数。
Clicks Integer クリックの総数。
AppClicks Integer アプリのインストール数、もしくはアプリを開こうとした回数。
UrlClicks Integer リンクURL のクリック数。
QualifiedImpressions Integer 有効なインプレッションの総数。
BilledEngagements Integer 有償エンゲージメントの総数。
BilledCharge Long ミクロでの総支払。
VideoTotalViews Integer ビデオビューの総数。
VideoViews25 Integer すくなくとも25%のビデオが見られたビューの総数。
VideoViews50 Integer すくなくとも50%のビデオが見られたビューの総数。
VideoViews75 Integer 少なくとも50%のビデオが見られたビューの総数。
VideoViews100 Integer 100%のビデオが見られたビューの総数。
VideoCTAClicks Integer call to action のクリック総数。
VideoContentStarts Integer ビデオのプレーバックスタートの総数。
VideoMrcViews Integer Media Rating Council ガイダンスによるビューの総数。
Video3s100pctViews Integer 100% のビューの内、少なくとも3秒は再生されたビューの総数。
MediaViews Integer ビデオ、vines、GIF、画像に渡るメディアのビュー(プレイバックおよびクリック)の総数。
MediaEngagements Integer ビデオ、vines、GIF、画像に渡るメディアのクリックの総数。
Purchases Integer PURCHASE タイプの会話の数。
SignUps Integer SIGN_UP タイプの会話の数。
SiteVisits Integer SITE_VISIT タイプの会話の数。
Downloads Integer DOWNLOAD タイプの会話の数。
ConversionCustom Integer CUSTOM タイプの会話の数。
MobileConversionSpentCredits Integer SPENT_CREDIT タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionInstalls Integer INSTALL タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionContentViews Integer CONTENT_VIEW タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionAddToWishlists Integer ADD_TO_WISHLIST タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionCheckoutsInitiated Integer CHECKOUT_INITIATED タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionReservations Integer RESERVATION タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionTutorialsCompleted Integer TUTORIAL_COMPLETED タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionAchievementsUnlocked Integer ACHIEVEMENT_UNLOCKED タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionSearches Integer SEARCH タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionAddToCarts Integer ADD_TO_CART タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionPaymentInfoAdditions Integer PAYMENT_INFO_ADDITION タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionReEngages Integer RE_ENGAGE タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionShares Integer SHARE タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionRates Integer RATE タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionLogins Integer LOGIN タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionUpdates Integer UPDATE タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionLevelsAchieved Integer LEVEL_ACHIEVED タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionInvites Integer INVITE タイプのモバイルコンバージョンのポストビュー、ポストエンゲージメント、whether assisted、注文量、および売上ごとのブレイクダウン。
MobileConversionKeyPageViews Integer KEY_VIEW タイプのモバイルコンバージョンのポストビューおよびポストエンゲージメント毎のコンバージョンのブレイクダウン。
LifetimeValuePurchases Integer PURCHASE タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueSignUps Integer SIGN_UP タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueUpdates Integer UPDATE タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueTutorialsCompleted Integer TUTORIAL_COMPLETED タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueReservations Integer RESERVATION タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueAddToCarts Integer ADD_TO_CART タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueAddToWishlists Integer ADD_TO_WISHLIST タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueCheckoutsInitiated Integer CHECKOUT_INITIATED タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueLevelsAchieved Integer LEVEL_ACHIEVED タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueAchievementsUnlocked Integer ACHIEVEMENT_UNLOCKED タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueShares Integer SHARE タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueInvites Integer INVITE タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValuePaymentInfoAdditions Integer PAYMENT_INFO_ADDITION タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueSpentCredits Integer SPENT_CREDIT タイプのモバイルコンバージョンのブレイクダウン。
LifetimeValueRates Integer RATE タイプのモバイルコンバージョンのブレイクダウン。

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