Singularデータ送信先についての一般的な情報、どのように機能するか、エクスポートできるデータの種類については、Singularデータ送信先(ETL)FAQを参照してください。
Singularデータ送信先を使用すると、Singularは異なるソースからのデータを同じデータスキーマに標準化し、データベースで簡単にクエリできるようにします。
Singularは様々なデータスキーマを提供しています。各スキーマはSingularデータ送信先がデータベースに読み込むフィールドのセットを定義します。
その他のスキーマはプレミアム機能です。以下の表を参考に、お客様のニーズに合ったデータスキーマをお選びください。
ユーザーレベルのデータスキーマ
各フィールドの詳細については、「ログのエクスポート」を参照してください:さまざまなタイムスタンプフィールドについては、以下の「タイムスタンプの意味と形式」を参照してください。
注:ユーザーレベルのインプレッションは、S3のカスタムスキーマとして利用可能です。詳細については、カスタマー・サクセス・マネージャーにお問い合わせください。
デフォルトスキーマ
以下のスキーマは全てのお客様にご利用いただけます。
インストールやリエンゲージメントイベントに関する情報、帰属先、帰属に関するその他の詳細(決定論的か 確率論的かなど)を含みます。
注:コンバージョンイベントに提供されるロケーションは、イベントに関連付けられた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
セッション、登録、購入、その他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プラットフォームからチケットを作成してください。
(ヘルプ > お問い合わせ).
インストールまたはリエンゲージメントのアトリビューションを決定するために調査されたすべてのクリックが含まれます。
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が広告ネットワークパートナーから受け取ったすべての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
広告ネットワークが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 |
アトリビューションイベントにつながったタッチポイント(広告クリックまたは広告インプレッション)の時間。 |
データスキーマの変更
いったんデータ保存先を作成して保存すると、別のデータスキーマに切り替えることはできません。これは、既存のデータがあるライブ データベースでテーブル構造を変更すると、多くの危険と複雑さが伴うためです。
データスキーマの変更が必要な場合は、単純に新しい保存先を作成してください。新しい宛先を作成する前に古いテーブルを削除するか、新しい宛先で異なる名前の新しいテーブルにデータをロードするように設定します。このプロセスにより、データは安全に保たれ、既存のクエリやワークロードは引き続き動作します。