データの目的地:ユーザーレベル(イベントレベル)データスキーマ

Singularデータ送信先についての一般的な情報、どのように機能するか、エクスポートできるデータの種類については、Singularデータ送信先(ETL)FAQを参照してください。

Singularデータ送信先を使用すると、Singularは異なるソースからのデータを同じデータスキーマに標準化し、データベースで簡単にクエリできるようにします。

Singularは様々なデータスキーマを提供しています。各スキーマはSingularデータ送信先がデータベースに読み込むフィールドのセットを定義します。

その他のスキーマはプレミアム機能です。以下の表を参考に、お客様のニーズに合ったデータスキーマをお選びください。

ユーザーレベルのデータスキーマ

各フィールドの詳細については、「ログのエクスポート」を参照してください:さまざまなタイムスタンプフィールドについては、以下の「タイムスタンプの意味と形式」を参照してください。

注:ユーザーレベルのインプレッションは、S3のカスタムスキーマとして利用可能です。詳細については、カスタマー・サクセス・マネージャーにお問い合わせください。

デフォルトスキーマ

以下のスキーマは全てのお客様にご利用いただけます。

アトリビュート(v2)データスキーマ

インストールやリエンゲージメントイベントに関する情報、帰属先、帰属に関するその他の詳細(決定論的か 確率論的かなど)を含みます。

注:コンバージョンイベントに提供されるロケーションは、イベントに関連付けられたIPアドレスに基づいています。イベントの位置情報の他のソースがある場合は、アプリからSingularに送信されるパススルーパラメータを読み取ることで確認できます。

etl_record_processing_hour_utc
  affiliate_id
  affiliate_name
  android_id
  android_id_md5
  android_sha1
  app_longname
  app_version
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  country
  creative_id
  creative_name
  custom_user_ids
  device_id
  device_id_type
  device_make
  device_model
  event_timestamp
  event_timestamp_unix_utc
  fraud_reason
  fraud_status
  gaid
  gaid_md5
  gaid_sha_1
  google_click_id
  idfa
  idfa_md5
  idfa_sha_1
  idfv
  is_reengagement
  is_view_through
  method
  os_version
  partner
  passthrough
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  singular_campaign_name
  singular_partner_name
  state
  store
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
  waid
イベント (v3) データスキーマ

セッション、登録、購入、その他Singular SDK/S2Sを統合する際にアプリ内で定義されたイベントなど、アプリ内イベントに関するデータが含まれます。

etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through 
  name 
  os_version 
  partner 
  passthrough 
  platform 
  product_category
  product_name 
  product_price 
  product_quantity 
  product_sku 
  publisher_concatenated
  publisher_hashed_id 
  publisher_id 
  publisher_name 
  received_revenue 
  received_revenue_event
  revenue 
  server_timestamp 
  server_timestamp_unix_utc 
  session_id 
  singular_campaign_name
  state 
  sub_campaign_id 
  sub_campaign_name 
  sub_publisher_id 
  sub_publisher_name
  tag_id 
  touchpoint_timestamp 
  touchpoint_timestamp_unix_utc 
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term

その他のスキーマ

以下のスキーマのいずれかを使用するには、Singularプラットフォームからチケットを作成してください。
(ヘルプ > お問い合わせ).

クリック(v2)データスキーマ

インストールまたはリエンゲージメントのアトリビューションを決定するために調査されたすべてのクリックが含まれます。

etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through
  name
  os_version
  partner
  passthrough
  platform
  product_category
  product_name
  product_price
  product_quantity
  product_sku
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  received_revenue
  received_revenue_event
  revenue
  server_timestamp
  server_timestamp_unix_utc
  session_id
  singular_campaign_name
  state
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  tag_id
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  utm_campaign
  utm_content
  utm_medium
  utm_source
  utm_term
SKAdNetworkポストバックデータスキーマ

Singularが広告ネットワークパートナーから受け取ったすべてのSKAdNetworkポストバックを含みます。これらのポストバックは、SKAdNetworkのトラッキングを使用しているiOSアプリと、ポストバックの転送を含むSKAdNetworkの統合をSingularと行っているパートナーに対してのみ提供されます。

SingularはSKAdNetworkのデータも提供しています:SKAdNetwork Raw Data Schemasと SKAdNetworkDataSchemasをご覧ください。

etl_record_processing_hour_utc
  app_longname
  city
  conversion_model_measurement_period
  conversion_model_name
  conversion_model_types
  conversion_model_version
  conversion_value
  country
  decoded_conversion_value
  estimated_cohort_period
  estimated_conversion_date
  estimated_install_date
  fraud_reason
  fraud_status
  ip
  is_view_through
  max_install_date
  min_install_date
  partner
  partner_campaign_id
  partner_campaign_name
  partner_creative_id
  partner_creative_name
  partner_sub_campaign_id
  partner_sub_campaign_name
  partner_sub_publisher_name
  referrer
  region
  signature
  singular_partner_name
  skadnetwork_app_id
  skadnetwork_campaign_id
  skadnetwork_network_id
  skadnetwork_publisher_app_id
  skadnetwork_redownload
  skadnetwork_version
  timestamp
  timestamp_unix_utc
  transaction_id
  user_agent
skan_postback__source_identifier
skan_postback__source_domain
skan_postback__postback_sequence_index
skan_postback__coarse_conversion_value
アプリSKANポストバック

広告ネットワークがAppleから直接受け取る全てのSKAdNetworkポストバックを含みます。これらはSingularに転送することができます。SKAdNetworkポストバックをSingularに送信する方法(iOS 15+)を参照してください。

etl_record_processing_hour_utc
  app_longname
  skadnetwork_version
  transaction_id
  skadnetwork_network_id
  skadnetwork_campaign_id
  skadnetwork_app_id
  skadnetwork_publisher_app_id
  conversion_value
  signature
  skadnetwork_redownload
  is_view_through
  timestamp_unix_utc
  timestamp
  ip
  user_agent
  partner
  fraud_status
  fraud_reason
  decoded_conversion_value
  conversion_model_name
  conversion_model_version
  conversion_model_types
  conversion_model_measurement_period
  estimated_conversion_date
  estimated_install_date
  estimated_cohort_period
  min_install_date
  max_install_date
  singular_partner_name
skan_postback__source_identifier
skan_postback__source_domain
skan_postback__postback_sequence_index
skan_postback__coarse_conversion_value
不正データスキーマ

Singular Fraud Prevention System(詳しくは、Singular Fraud Preventionを理解する不正レポートと不正ログのFAQをご覧ください)の生の出力。

このデータには、インストールイベントに関連するすべてのクリックとインプレッションの行が含まれています。同じインストールに属するすべてのクリックとインプレッションをソートまたはグループ化するには、unique_install_identifier フィールドを使用します。

etl_record_processing_hour_utc
  app_longname
  app_version
  creative
  device_id
  device_make
  device_model
  fraud_external_reason
  fraud_reason
  fraud_status
  idfv
  install_city
  install_country
  install_ip
  install_timestamp
  install_timestamp_unix_utc
  is_view_through
  os_version
  partner
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  time_to_install
  touchpoint_campaign
  touchpoint_city
  touchpoint_country
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  unique_install_identifier
クロスデバイスユーザー属性データスキーマ
etl_record_processing_hour_utc
  affiliate_id
  affiliate_name
  android_id
  android_id_md5
  android_sha1
  app_longname
  app_version
  bid_type
  campaign_id
  campaign_name
  click_id
  country
  creative_id
  creative_name
  custom_user_ids
  device_id
  device_id_type
  event_timestamp
  event_timestamp_unix_utc
  gaid
  gaid_md5
  gaid_sha_1
  google_click_id
  idfa
  idfa_md5
  idfa_sha_1
  idfv
  is_view_through
  os_version
  partner
  passthrough
  platform
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  singular_campaign_name
  singular_partner_name
  state
  store
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  touchpoint_ip
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name
  waid
クロスデバイスイベントデータスキーマ
etl_record_processing_hour_utc
  adjusted_timestamp
  adjusted_timestamp_unix_utc
  affiliate_id
  affiliate_name
  app_longname
  app_version
  arguments
  attribution_event_timestamp
  attribution_event_timestamp_unix_utc
  bid_type
  campaign_id
  campaign_name
  city
  click_id
  converted_currency
  converted_revenue
  country
  creative_id
  creative_name
  currency
  custom_user_id
  device_id
  device_id_type
  install_source
  ip
  is_reengagement
  is_revenue_receipt_included
  is_revenue_valid
  is_view_through
  name
  os_version
  partner
  passthrough
  platform
  product_category
  product_name
  product_price
  product_quantity
  product_sku
  publisher_concatenated
  publisher_hashed_id
  publisher_id
  publisher_name
  received_revenue
  received_revenue_event
  revenue
  server_timestamp
  server_timestamp_unix_utc
  session_id
  singular_campaign_name
  state
  sub_campaign_id
  sub_campaign_name
  sub_publisher_id
  sub_publisher_name
  tag_id
  touchpoint_timestamp
  touchpoint_timestamp_unix_utc
  tracker_name

付録タイムスタンプの意味と形式

ヒントSingularはデータ行ごとにいくつかのタイムスタンプフィールドを提供します。例えば "event_timestamp "と "event_timestamp_unix_utc "です。

  • timestampで終わるフィールドは、データベースのデスティネーションではタイムゾーン対応のタイムスタンプカラムとして、ファイルベースのデスティネーション(S3/SFTP/GCS)ではタイムゾーン情報を含むタイムスタンプとしてフォーマットされる。タイムゾーンは広告主のタイムゾーンです。
  • timestamp_unix_utcで終わるフィールドには、UTCのUNIXタイムスタンプ形式(整数)の時刻が含まれます。
  • BigQueryの送信先はタイムゾーンをサポートしていないことに注意してください。BigQueryに送信されるタイムスタンプはすべてUTCです。
タイムスタンプ フィールド 説明
etl_record_processing_hour_utc データがSingularで完全に処理された時刻。1時間ごとに、Singularは前の時間に完全に処理されたデータについてこの値を更新する。
アトリビュート
event_timestamp
event_timestamp_unix_utc
デバイス上でアトリビューションイベント(インストールなど)が発生した時間。
touchpoint_timestamp
touchpoint_timestamp_unix_utc
アトリビューションイベントにつながったタッチポイント(広告クリックまたは広告インプレッション)の時間。
イベント
adjusted_timestamp
adjusted_timestamp_unix_utc
イベントがデバイス上で実際に発生した時間。
server_timestamp
server_timestamp_unix_utc
イベントがSingularサーバーに受信された時間。注意:イベントデータの送信に技術的な遅延があった場合、adjusted_timestampと大きく異なる場合があります。
attribution_event_timestamp
attribution_event_timestamp_unix_utc
アトリビューションイベント(アプリのインストールなど)がデバイス上で発生した時間。
touchpoint_timestamp
touchpoint_timestamp_unix_utc
アトリビューションイベントにつながったタッチポイント(広告クリックまたは広告インプレッション)の時間。

データスキーマの変更

いったんデータ保存先を作成して保存すると、別のデータスキーマに切り替えることはできません。これは、既存のデータがあるライブ データベースでテーブル構造を変更すると、多くの危険と複雑さが伴うためです。

データスキーマの変更が必要な場合は、単純に新しい保存先を作成してください。新しい宛先を作成する前に古いテーブルを削除するか、新しい宛先で異なる名前の新しいテーブルにデータをロードするように設定します。このプロセスにより、データは安全に保たれ、既存のクエリやワークロードは引き続き動作します。