Singularデータ送信先に関する一般的な情報、その仕組み、およびエクスポート可能なデータの種類については、「Singularデータ送信先（ETL）FAQ」を参照してください。
Singularデータ送信先を使用すると、Singularは異なるソースからのデータを同一のデータスキーマに標準化するため、データベース内で簡単にクエリを実行できます。
Singularでは選択可能な複数のデータスキーマを提供しています。各スキーマは、Singularデータデスティネーションがデータベースにロードするフィールド群を定義します。
コンバージョンとイベントは全データ送信先ユーザーが利用可能ですが、その他のスキーマはプレミアム機能です。以下の表を参考に、ニーズに最適なデータスキーマを選択してください。
ユーザーレベルデータスキーマ
各フィールドの詳細については、「エクスポートログ：サポート対象フィールド」を参照してください。各種タイムスタンプフィールドについては、下記の「タイムスタンプの意味と形式」を参照してください。
デフォルトスキーマ
以下のスキーマは、すべての顧客が利用できます。
アトリビューション（v7）データスキーマ
インストールおよび再エンゲージメントイベントに関する情報、それらの帰属先、および帰属に関するその他の詳細（例：確定的帰属か 確率的帰属か）を含みます。
注記：コンバージョンイベントの位置情報は、イベントに関連付けられた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
attribution__touchpoint__agency_id
attribution__event__device_id_type イベント（v5）データスキーマ
アプリ内イベント（セッション、登録、購入、および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
banner name (from v4)
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
estimated_skan_user (from V5)
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アシストユーザーレベルデータスキーマ
アシストインストールに関するユーザーレベルのデータを含み、コンバージョンに寄与したものの最終的なアトリビューションではなかったタッチポイントの詳細を提供します。
affiliate_id
affiliate_name
android_id
android_id_md5
android_sha1
app_longname
app_version
assist_touchpoints_count
assisted_level
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
gaid
gaid_md5
gaid_sha_1
google_click_id
idfa
idfa_md5
idfa_sha_1
idfv
is_fingerprinted
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_id
touchpoint_ip
touchpoint_timestamp
touchpoint_timestamp_unix_utc
tracker_name
waidその他のスキーマ
以下のスキーマのいずれかを使用するには、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アプリ、およびポストバック転送を含むSingularとのSKAdNetwork連携を実施しているパートナーに対してのみ利用可能です。
Singularは集計済みSKAdNetworkデータも提供しています：詳細は「SKAdNetwork生データスキーマ」および「SKAdNetworkデータスキーマ」を参照してください。
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に転送可能です。詳細は「SingularへのSKAdNetworkポストバック送信方法（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不正防止システムの生出力（詳細は「Singular不正防止の仕組み」および「不正レポートと不正ログに関する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は各データ行に対して複数のタイムスタンプフィールドを提供します。ほとんどのタイムスタンプフィールドには2つのバージョンがあります（例: "event_timestamp" と "event_timestamp_unix_utc"）。
- _timestampで終わるフィールドは、データベース宛先ではタイムゾーン対応のタイムスタンプ列として、ファイルベースの宛先（S3/SFTP/GCS）ではタイムゾーン情報付きタイムスタンプとしてフォーマットされます。タイムゾーンは広告主のタイムゾーンです。
- _timestamp_unix_utcで終わるフィールドは、UTC における UNIX タイムスタンプ形式（整数）の時刻を含みます。
- BigQuery 宛先はタイムゾーンをサポートしていないことに注意してください。BigQuery に送信されるすべてのタイムスタンプは UTC です。
| タイムスタンプフィールド | 説明 |
|---|---|
| etl_record_processing_hour_utc | Singularによるデータの完全処理が完了した時刻。 これはイベント発生時刻やサーバータイムスタンプより遅い場合があります。 毎時、Singularは前時間に完全処理されたデータについてこの値を更新します。 |
| アトリビューション | |
|
event_timestamp event_timestamp_unix_utc |
アトリビューションイベント（例：インストール）がデバイス上で発生した時刻。 |
|
touchpoint_timestamp touchpoint_timestamp_unix_utc |
アトリビューションイベントにつながったタッチポイント（広告クリックまたは広告インプレッション）の発生時刻。 |
| イベント | |
|
調整済みタイムスタンプ 調整済みタイムスタンプ_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 |
アトリビューションイベントにつながったタッチポイント（広告クリックまたは広告インプレッション）の発生時刻。 |
データスキーマの変更
データ宛先を作成して保存すると、別のデータスキーマに切り替えることはできません。これは、既存データが存在する稼働中のデータベースでテーブル構造を変更すると、多くの危険性と複雑さが伴うためです。
データスキーマの変更が必要な場合は、新しい宛先を作成してください。新しい宛先を作成する前に古いテーブルを削除するか、新しい宛先を異なる名前の新規テーブルにデータをロードするよう設定できます。このプロセスにより、データの安全性が確保され、既存のクエリやワークロードが継続して動作します。