メインコンテンツへスキップ
トレンド

トレンド、データフィード、およびデータ処理

最終更新日 約1か月前

Trendsでの新しいデータフィードの設定

Trendsサービスにご登録いただいている場合、Labelcampチームの担当営業までご連絡いただき、技術的な詳細や資料、関連するDSPチームの担当者、および契約形態(例:Merlin、直接契約など)をご提示いただくことで、新しいデータフィード/ソースの追加をリクエストすることができます。 ご依頼内容は、契約上の枠組みおよび技術的な実現可能性を考慮の上、弊社チームによって審査されます。

承認された場合、DSPのデータAPI、またはデータレポートがアップロードされているサーバーディレクトリにアクセスするための、貴社の認証情報を提供するようお願いいたします。

また、Labelcampのシステムによるデータ取得を可能にするため、当該DSPのCMSアカウントで特定の操作を行うよう依頼される場合があります。

データの取り込みと処理

日次の消費データは、DSP データレポートのダウンロード(公開時期は情報源によって異なります)、当社の分析データベースへの取り込みおよび処理を経て、Trends のユーザーインターフェースで利用可能になるまでの、限られた遅延期間をもって Trends に表示されます。

Labelcampの管理の及ばない様々な理由(例:データソースによるデータの未公開、データエクスポート形式の予期せぬ変更など)により、追加の遅延やデータの欠落が時折発生する場合があります。

この種の問題が発生した場合は、Labelcampのチーム(help@labelcamp.io)までご連絡いただければ、調査いたします。

データの JSON エクスポート

ディストリビューターは、Google Cloud Storage バケットに保存されたトレンドデータの毎日エクスポートを取得できます。詳細については、担当の営業担当者にお問い合わせください。

エクスポートデータは、以下の2つの異なるファイルで構成されています:

  • Trendsファイル:コンシューマイベント(ストリーム、ダウンロード、コピースキャン、コンテンツ制作)。

  • エンゲージメントファイル:エンゲージメントイベント(現時点では保存数)。これらは、該当するデータを報告しているDSPについて記録されます。

ファイルの説明

ファイルは毎日、JSON改行形式でエクスポートされます(詳細はこちら:https://jsonlines.org/)。

毎日、新しいエクスポートデータが生成され、Google Cloud Storageのバケットで利用可能になります(詳細はこちら:https://cloud.google.com/products/storage)。

ファイル名は以下の通りです:

gs://<bucket>/<distributor>trends_extract<timestamp>.json_<partnumber>
gs://<bucket>/<distributor>trends_engagement_extract<timestamp>.json_<partnumber>

partnumber - エクスポートのサイズによっては、ファイルが複数のパートに分割される場合があります。お客様は、利用可能なすべてのパートをインポートするようにしてください。

timestamp - このタイムスタンプは、イベントが当社のデータベースにインデックス登録された日を指します。ファイル内のイベントは常にこのタイムスタンプより古いものであるため、イベントが発生した日時を知るには、transaction_date を参照してください。

トレンドファイル:内容の説明

フィールド

説明

eq_track_quantity

このイベントで消費されたトラック数(例:トラック数5、数量2のアルバムの場合、10)

数量

イベント数

product_age

イベント開催日時点でのリリースからの経過日数(日単位)

artists

アーティスト名の配列

再生率

再生されたトラックの割合

played_seconds

トラックの再生時間(秒単位)

gender

性別ID

birth_year

リスナーの生年

user_id

リスナーのDSP ID

transaction_date

イベントの日付

creator

作成者ID

source

ソースID

playlist_xid

プレイリストのDSP ID

retail_id

小売ID

retail_name

小売店名

company_id

会社ID

company_name

会社名

label_id

ラベルID

label_name

ラベル名

product_id

商品ID

product_name

商品名

product_upc_code

商品UPCコード

track_id

トラックID

track_name

トラック名

track_subtitle

トラックサブタイトル

track_artists

文字列形式のトラック出演者

isrc_code

ISRCコード

video_name

動画名

territory_id

地域ID

territory_name

地域名

code_alpha_2

地域アルファコード(2文字)

product_genre_name

ジャンル名

product_subgenre_name

サブジャンル名

product_genre_id

ジャンルID

product_subgenre_id

サブジャンルID

性別名

性別名(男性、女性)

creator_name

コンテキストの種類(自動、編集、ユーザー)

ソース名

コンテキスト名(アーティストまたはアルバム、ライブラリ、プレイリスト、ラジオ、検索)

playlist_name

プレイリスト名

playlist_curator

プレイリストのキュレーター名

use_type

イベントの利用タイプ(ストリーミング、ダウンロード、コピー・スキャン、コンテンツ制作)

city_name

リスナーの都市名

raw_dsp_data

DSPソースファイルから受信したままの完全な原文の行で、変換やデータ補完を行う前にJSON形式にシリアライズされたものです。レコード内の他の列と重複する場合があります。

サンプル

{
  "eq_track_quantity": "1",
  "quantity": "1",
  "product_age": "191289600",
  "artists": [
    "Lorem Ipsum"
  ],
  "played_percent": 1,
  "played_seconds": "249",
  "gender": "1",
  "birth_year": "1976",
  "user_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
  "transaction_date": "2026-03-22",
  "creator": "3",
  "source": "4",
  "retail_id": "10001",
  "company_id": "100001",
  "label_id": "200001",
  "use_type": "stream",
  "product_id": "300001",
  "track_id": "400001",
  "territory_id": "150",
  "product_genre_id": "6",
  "product_subgenre_id": "38321",
  "raw_dsp_data": {
    "audio_format": "Vorbis 96 kbps",
    "cached": false,
    "completion_flag": true,
    "content_type_flag": "audio",
    "country": "MX",
    "device_type": "cell phone",
    "discovery_flag": true,
    "is_canvas_viewed": false,
    "is_lyrics_viewed": false,
    "is_promoted_context": false,
    "length": 249,
    "message": "APIStreamData",
    "os": "Android",
    "repeat_play": false,
    "shuffle": true,
    "source": "others_playlist",
    "source_uri": "",
    "timestamp": "20260322T16:28:00",
    "track_id": "f00000000000000000000000000000aa",
    "user_id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2",
    "utc_timestamp_offset": "-05:00",
    "version": 4
  },
  "retail_name": "Spotify",
  "company_name": "Lorem Company A",
  "label_name": "Lorem Label A",
  "product_name": "Lorem Album A",
  "product_upc_code": "5000000000001",
  "track_name": "Lorem Track A",
  "track_subtitle": "Lorem",
  "track_artists": "Lorem Ipsum",
  "isrc_code": "LRXX0000001",
  "territory_name": "Mexico",
  "code_alpha_2": "MX",
  "product_genre_name": "World",
  "product_subgenre_name": "Latin",
  "gender_name": "Male",
  "creator_name": "Automated",
  "source_name": "Playlist"
}

{
  "eq_track_quantity": "1",
  "quantity": "1",
  "product_age": "221184000",
  "artists": [
    "Dolor Sit Amet"
  ],
  "transaction_date": "2026-03-23",
  "creator": "1",
  "source": "3",
  "retail_id": "10002",
  "company_id": "100002",
  "label_id": "200002",
  "use_type": "stream",
  "product_id": "300002",
  "track_id": "400002",
  "territory_id": "223",
  "product_genre_id": "4",
  "product_subgenre_id": "38304",
  "raw_dsp_data": {
    "Apple_Identifier": 1000000001,
    "Audio_Format": "Compressed Audio",
    "Channel_Partner": null,
    "Container_ID": null,
    "Container_Name": null,
    "Container_Sub_Type": 1,
    "Container_Type": 2,
    "Datestamp": "2026-03-23",
    "Device_Type": 1,
    "End_Reason_Type": 0,
    "Ingest_Datestamp": "2026-03-23",
    "Offline": 0,
    "Source_of_Stream": 1,
    "Storefront_Name": "US",
    "Streams": 1,
    "Subscription_Mode": "PAID",
    "Subscription_Type": "Apple One Premier Monthly",
    "Time_Bucket": 5
  },
  "retail_name": "Apple Music",
  "company_name": "Lorem Company B",
  "label_name": "Lorem Label B",
  "product_name": "Lorem Album B",
  "product_upc_code": "5000000000002",
  "track_name": "Lorem Track B",
  "track_subtitle": "Lorem",
  "track_artists": "Dolor Sit Amet",
  "isrc_code": "LRXX0000002",
  "territory_name": "United States",
  "code_alpha_2": "US",
  "product_genre_name": "Electronic",
  "product_subgenre_name": "Electronic",
  "creator_name": "User",
  "source_name": "Library"
}

{
  "eq_track_quantity": "1",
  "quantity": "1",
  "product_age": "224035200",
  "artists": [
    "Consectetur Adipiscing"
  ],
  "played_percent": 1,
  "played_seconds": "246",
  "gender": "1",
  "birth_year": "1973",
  "user_id": "b3c4d5e6f7a8b3c4d5e6f7a8b3c4d5e6f7a8b3c4d5e6f7a8b3c4d5e6f7a8b3c4",
  "transaction_date": "2026-03-23",
  "creator": "1",
  "source": "4",
  "retail_id": "10003",
  "company_id": "100003",
  "label_id": "200003",
  "use_type": "stream",
  "product_id": "300003",
  "track_id": "400003",
  "territory_id": "29",
  "product_genre_id": "6",
  "product_subgenre_id": "38294",
  "raw_dsp_data": {
    "Album": "Lorem Album C",
    "Artist": "Consectetur Adipiscing",
    "Birth_year": 1973,
    "Cached_play": 0,
    "Context_type": "playlist",
    "Country": "BR",
    "Device_type": "mobile",
    "END_REPORT": "23-03-2026",
    "Gender": "M",
    "ISRC": "LRXX0000003",
    "Label": "Lorem Label C",
    "Nb_of_Plays": 1,
    "OS": "android",
    "Play_percent": 100,
    "Playlist_Id": "9000000001",
    "Playlist_name": "Lorem Playlist C",
    "Provider": "Lorem distributor (MERLIN)",
    "Royalties": 0,
    "START_REPORT": "23-03-2026",
    "Service": "BPP",
    "Service_name": "TIM BR Premium+ Bundle. 1 device",
    "Title": "Lorem Track C",
    "Track_duration": 246,
    "UPC": 5000000000003,
    "User_id": "b3c4d5e6f7a8b3c4d5e6f7a8b3c4d5e6f7a8b3c4d5e6f7a8b3c4d5e6f7a8b3c4",
    "provider_id": 55
  },
  "retail_name": "Deezer",
  "company_name": "Lorem Company C",
  "label_name": "Lorem Label C",
  "product_name": "Lorem Album C",
  "product_upc_code": "5000000000003",
  "track_name": "Lorem Track C",
  "track_subtitle": "",
  "track_artists": "Consectetur Adipiscing",
  "isrc_code": "LRXX0000003",
  "territory_name": "Brazil",
  "code_alpha_2": "BR",
  "product_genre_name": "World",
  "product_subgenre_name": "Brazilian",
  "gender_name": "Male",
  "creator_name": "User",
  "source_name": "Playlist"
}

エンゲージメント JSON エクスポート

「トレンド」エクスポートに加え、2つ目の日次ファイルにはエンゲージメントデータが含まれます。これは現在、「保存」を指します。つまり、ユーザーがトラックをライブラリやプレイリストに追加したことを意味します。すべてのDSPが保存データを報告しているわけではないため、このエクスポートでは、保存データを提供しているソースのみを対象としています。

エンゲージメントファイル:コンテンツの説明

engagement_type_id

エンゲージメントの種類。1 = 保存

quantity

エンゲージメントの数

eq_track_quantity

この行でエンゲージされたトラックの数(トラックの保存数と同じ)

transaction_date

エンゲージメントの日付

import_date

当データベースへの登録日

product_age

エンゲージメント発生日時点でのリリースからの経過時間(秒単位)

artists

アーティスト名の配列

retail_id

小売ID

retail_name

小売店名

company_id

会社ID

company_name

会社名

label_id

ラベルID

label_name

ラベル名

product_id

製品ID

product_name

商品名

product_upc_code

商品のUPCコード

track_id

トラックID

track_name

トラック名

track_subtitle

トラックサブタイトル

track_artists

文字列形式のトラック出演者

isrc_code

ISRCコード

video_id

動画ID

video_name

動画名

territory_id

地域ID

territory_name

地域名

code_alpha_2

地域アルファコード(2文字)

product_genre_id

ジャンルID

product_genre_name

ジャンル名

product_subgenre_id

サブジャンルID

product_subgenre_name

サブジャンル名

raw_dsp_data

DSPソースから受信したそのままの完全なレコードで、変換やデータ補完を行う前にJSON形式でシリアライズされたものです。1つのDSPレコードは複数の地域をカバーする場合があります。エクスポートでは各地域が1行となり、これらの各行にはレコード全体が含まれます。行の地域については、territory_id / code_alpha_2 を使用してください。

Spotifyの「保存」数:各保存は、トラックがライブラリに追加されたかプレイリストに追加されたかに関わらず、ユーザーごと、トラックごとに1回としてカウントされます。Spotifyは削除数を報告しないため、これらは総計であり、ライブラリへの保存とプレイリストへの追加を別々のチャートに分けて表示する「Spotify for Artists」に表示される保存数よりも多くなる場合があります。

サンプル

{
  "company_id": "100001",
  "track_id": "400001",
  "product_id": "300001",
  "label_id": "200001",
  "video_id": null,
  "territory_id": "29",
  "quantity": "1",
  "eq_track_quantity": "1",
  "engagement_type_id": "1",
  "artists": [
    "Lorem Ipsum"
  ],
  "transaction_date": "2026-09-26",
  "import_date": "2026-09-27",
  "raw_dsp_data": {
    "date": "2026-09-26",
    "saves": {
      "country": {
        "BR": { "product": { "premium": 1 }, "total": 1 }
      },
      "total": 1
    },
    "trackv2": {
      "href": "spotify:track:0000000000000000000001",
      "isrc": "LRXX0000001"
    }
  },
  "retail_id": "10001",
  "product_genre_id": "28",
  "product_subgenre_id": "38336",
  "product_age": "153619200",
  "retail_name": "Spotify",
  "company_name": "Lorem Company A",
  "label_name": "Lorem Label A",
  "product_name": "Lorem Album A",
  "product_upc_code": "5000000000001",
  "track_name": "Lorem Track A",
  "track_subtitle": null,
  "track_artists": "Lorem Ipsum",
  "isrc_code": "LRXX0000001",
  "video_name": null,
  "territory_name": "Brazil",
  "code_alpha_2": "BR",
  "product_genre_name": "Singer/Songwriter / Folk",
  "product_subgenre_name": "Singer/Songwriter"
}

{
  "company_id": "100002",
  "track_id": "400002",
  "product_id": "300002",
  "label_id": "200002",
  "video_id": null,
  "territory_id": "223",
  "territory_id": "223",
  "quantity": "7",
  "eq_track_quantity": "7",
  "engagement_type_id": "1",
  "artists": [
    "Dolor Sit Amet"
  ],
  "transaction_date": "2026-09-26",
  "import_date": "2026-09-27",
  "raw_dsp_data": {
    "date": "2026-09-26",
    "saves": {
      "country": {
        "GB": { "product": {}, "total": 0 },
        "US": { "product": { "free": 7 }, "total": 7 }
      },
      "total": 7
    },
    "trackv2": {
      "href": "spotify:track:0000000000000000000002",
      "isrc": "LRXX0000002"
    }
  },
  "retail_id": "10001",
  "product_genre_id": "3",
  "product_subgenre_id": "38287",
  "product_age": "33955200",
  "retail_name": "Spotify",
  "company_name": "Lorem Company B",
  "label_name": "Lorem Label B",
  "product_name": "Lorem Album B",
  "product_upc_code": "5000000000002",
  "track_name": "Lorem Track B",
  "track_subtitle": null,
  "track_artists": "Dolor Sit Amet",
  "isrc_code": "LRXX0000002",
  "video_name": null,
  "territory_name": "United States",
  "code_alpha_2": "US",
  "product_genre_name": "Alternative/Indie",
  "product_subgenre_name": "Alternative"
}

保持期間

ファイルはバケット上に90日間保存されます。

この追加サービスにご加入をご希望の場合は、担当の営業担当者までご連絡ください。