共通属性とクエリー文字列パラメータ

これらの属性とクエリー文字列パラメータは分析ルートで使われます。

ルート属性

次の表はすべてのルート属性を示します。

ルート属性 説明
asset_id アセットのIDを指定します。

タイプ:文字列

デフォルト: なし

例:

/v2/analytics/reports/asset/fjkl3s23fdsf2/engagement

city

すべての都市情報を返します。

タイプ:文字列

デフォルト:上位10都市を返します。

例:

[GET] /v2/analytics/reports/account/performance/cities/2011-08-01...2011-08-08 (すべての都市)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/california/cities/2011-08-01...2011-08-08 (カリフォルニア州のすべての都市)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/california/cities/san+francisco/2011-08-01...2011-08-08 (サンフランシスコのみ)

[GET] /v2/analytics/reports/asset/asset_id/performance/cities/2011-08-01...2011-08-08 (すべての都市の指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/california/cities/2011-08-01...2011-08-08 (カリフォルニア州のすべての都市の指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/california/cities/san+francisco/2011-08-01...2011-08-08 (サンフランシスコのみの指定アセット)

country

国(大文字と小文字の違いを無視)の情報を返します。

タイプ:文字列

デフォルト:上位10ヶ国を返します。

有効値:有効な国コードの一覧は、2文字のISO 3166-1 国コードを参照してください。不明な国には、Backlotu0を使用してください。

例:

[GET] /v2/analytics/reports/account/performance/countries/2011-08-01...2011-08-08 (すべての国)

[GET] /v2/analytics/reports/account/performance/countries/us/2011-08-01...2011-08-08 (米国 のみ)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/2011-08-01...2011-08-08 (すべての国の指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/2011-08-01...2011-08-08 (米国のみの指定アセット)

date_range

日付範囲を指定します。

タイプ:文字列

デフォルト:なし

例:

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01 (1日間)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-01-02 (1日間)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-01-08 (週間)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-02-01 (月間)

[GET] /v2/analytics/reports/account/performance/regions/2012-01-01...2012-04-01 (四半期)

Note: 期間最終日は結果に含まれません。
devicetype

デバイスタイプの情報を返します。

タイプ:文字列

有効値: mobile | tablet | desktop | settop | unknown.devicetype

デフォルト: なし

例: /analytics/reports/account/performance/device_types/tablet/2011-08-01...2011-08-08

dma

指定されたマーケティング地域 (DMA)の情報を返します。

デフォルト:上位10位のDMAを返します。

例:

[GET] /v2/analytics/reports/account/performance/dmas/2011-08-01...2011-08-08 (すべての DMA)

[GET] /v2/analytics/reports/account/performance/dmas/new+york/2011-08-01...2011-08-08 (ニューヨークのDMA)

[GET] /v2/analytics/reports/asset/asset_id/performance/dmas/2011-08-01...2011-08-08 (全DMAの指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/dmas/new+york/2011-08-01...2011-08-08 (ニューヨークの指定アセット)

domain

ドメインの情報を返します。

タイプ:文字列

デフォルト:上位10ドメインを返します。

例:

[GET] /v2/analytics/reports/account/performance/domains/2011-08-01...2011-08-08 (すべてのドメイン)

[GET] /v2/analytics/reports/account/performance/domains/ooyala.com/2011-08-01...2011-08-08 (ooyala.comのドメイン)

[GET] /v2/analytics/reports/asset/asset_id/performance/domains/2011-08-01...2011-08-08 (すべてのドメインの指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/domains/ooyala.com/2011-08-01...2011-08-08 (ooyala.comのドメインの指定アセット)

level

レポートをアカウントレベルまたはアセットレベルで実行するかを指定します。アセットを指定した場合、アセットIDを提供しなければいけません。

タイプ:文字列

デフォルト:なし

有効値: account | asset/asset_id

例:

[GET] /v2/analytics/reports/account/performance/total/2011-08-01...2011-08-08

[GET] /v2/analytics/reports/asset/fjkl3s23fdsf2/performance/total/2011-08-01...2011-08-08

platform

プラットフォーム(デバイスタイプ、オペレーションシステム、ブラウザ)の情報を返します。

タイプ:文字列

デフォルト: なし

例:

[GET] /v2/analytics/reports/account/performance/platforms/2011-08-01...2011-08-08 (すべてのプラットフォーム)

[GET] /v2/analytics/reports/account/performance/platforms/desktop:mac-chrome/2011-08-01...2011-08-08 (Chromeを起動しているMac)

[GET] /v2/analytics/reports/asset/asset_id/performance/platforms/2011-08-01...2011-08-08 (すべてのプラットフォームの指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/platforms/tablet:android-unknown.browser/2011-08-01...2011-08-08 (iOSタブレットの指定アセット)

[GET] /v2/analytics/reports/account/performance/device_types/desktop/platforms/2011-08-01...2011-08-08 (すべてのプラットフォーム)

region

地域(例:米国の州)の情報を返します。

タイプ:文字列

デフォルト:上位10地域を返します。

例:

[GET] /v2/analytics/reports/account/performance/regions/2011-08-01...2011-08-08 (すべての地域)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/2011-08-01...2011-08-08 (アメリカ国内のすべての州)

[GET] /v2/analytics/reports/account/performance/countries/us/regions/california/2011-08-01...2011-08-08 (カリフォルニア州のみ)

[GET] /v2/analytics/reports/asset/asset_id/performance/regions/2011-08-01...2011-08-08 (すべての地域の指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/2011-08-01...2011-08-08 (アメリカ国内のすべての州の指定アセット)

[GET] /v2/analytics/reports/asset/asset_id/performance/countries/us/regions/california/2011-08-01...2011-08-08 ((カリフォルニア州のみの指定アセット)

tag_id

タグのID。

タイプ:文字列

デフォルト:なし

例:/analytics/tags/extreme_couch_potato

ビデオ

上位のビデオが返ってきます。

タイプ:文字列

デフォルト:10

例:

[GET] /v2/analytics/reports/account/performance/videos/2011-08-01...2011-08-08&limit=20

クエリー文字列パラメータ

次の表はルートのクエリー文字列パラメータを説明しています。

Note: 明確にするために、ここに上げた例では、URLエンコードされていませんが、実際には、すべてのクエリー文字列パラメータと値にはURLエンコードを行ってください。
パラメータ 説明 必須?
breakdown_by

単一値として結果を返す代わりに、日間、週間、または月間の結果を返します。 このパラメータはディメンションがtotalでドリルダウンがない場合のみサポートされます。

タイプ:文字列

有効値: day | week | month

デフォルト:day

例: breakdown_by=month

いいえ
limit

返される結果の最大数。指定した値以上の結果が返ってきた場合、ページングのトークンとともに次のページに結果が表示されます。

タイプ:整数

デフォルト:10

有効値:1-500

例: limit=20

いいえ
order_by

降順でソートを行うためのフィールド。再生、表示、視聴時間でソートされるクエリは、最高1000件の結果まで返します。

タイプ:文字列

デフォルト: plays

有効値: plays | displays | time_watched | none

例: order_by=displays

いいえ
paging_token

または

page_token
次の結果ページへのURL。
Note: 指定したページに対する結果が、limitの値で分割可能な場合、サービスは404レスポンスを返します。

タイプ:文字列

デフォルト:なし

例:[GET] /v2/analytics/reports/account/performance/videos/2012-01-01...2012-01-24?page_token=W1siY29sdW1uIiwiMzRTYUun1yJdLFsiaW5kZXgiLDEwXSxbInZhbHVlIiwxXV0=

いいえ

この記事はお役にたちましたか?