トレンド、データフィード、およびデータ処理
最終更新日 約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": "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が保存データを報告しているわけではないため、このエクスポートでは、保存データを提供しているソースのみを対象としています。
エンゲージメントファイル:コンテンツの説明
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日間保存されます。
この追加サービスにご加入をご希望の場合は、担当の営業担当者までご連絡ください。