Heap

Heap is an analytics platform that automatically tracks and analyzes all user interactions on a website or app.

Heap integration replicates data from Avro files published to Amazon S3 via Heap’s Connect for Amazon S3 feature.

See the Schema section for a list of objects available for replication.

便利なリンクやサポートされている機能など、このコネクタの概要について説明します。

機能/性能	サポートの詳細
サポートされている Qlik Talend Data Integration プロジェクト	レプリケーションプロジェクトのみ。データパイプラインプロジェクトはサポートされていません。
ターゲットの更新方法	レプリケーションタスク: 変更を適用変更の保存データレイクタスクにデータをランディング: 変更データキャプチャ (CDC)
メタデータの管理	手動でのメタデータ生成は必要ありません。
スキーマの進化	[列のデータ型を変更] 操作のみサポートされています。
LOB 列 (NCLOB、CLOB、BLOB) のレプリケーション	サポートされていません。
スケジュールされた CDC	必須。これにより、ソースの変更に応じてターゲットが最新の状態に保たれます。レプリケーションタスクについては、「タスクのスケジューリング」を参照してください。レイクランディングタスクについては、「レイクランディングタスクの CDC のスケジュール設定」を参照してください。
通知	部分的にサポート動作変更時の通知の設定
監視	このコネクタではフルロードは関係ないため、CDC のみ。個々のデータタスクの監視
JSON 列ペイロードの自動ネスト解除	サポートされていません。ソースデータセット内の JSON 列ペイロードは、ターゲット上で自動的にネスト解除されません。

Preparing for authentication

To access your data, you need to authenticate the connection with your account credentials.

使用するアカウントに、フェッチするテーブルへのアクセス権があることを確認してください。

To obtain your account ID:

Log into your Amazon Web Services (AWS) account.
Click the user menu, located between the bell and Global menus in the top-right corner of the page.
Click My Account.
In the Account Settings section of the page, locate the Account Id field:
Copy the ID.

Creating the connection

詳細については、「SaaSアプリケーションへの接続」を参照してください。

必要な接続プロパティを入力します。
接続名に接続の名前を入力します。
接続メタデータを開くを選択して、作成時の接続のメタデータを定義します。
[作成] をクリックします。

Connection settings
Setting	Description
Data gateway	ユースケースに応じて Data Movement gateway を選択します。情報メモ Qlik Talend Cloud スターターサブスクリプションでは Data Movement gateway をサポートしていないため、この項目は使用できません。別のサブスクリプションティアを利用しており、Data Movement gateway を使用しない場合は、 [None] (なし) を選択します。 Data Movement gateway の利点とそれを必要とするユースケースの詳細については、「Qlik データゲートウェイ - データ移動」を参照してください。
Start Date	ソースからターゲットにデータをレプリケートする必要がある日付を `MM/DD/YYYY` 形式で入力します。
S3 Bucket	The name of the S3 bucket.
AWS Account ID	AWS account ID.

Schema

Schemas and naming conventions can change from version to version. It is recommended to verify your version before continuing.

The schema and info displayed below is for version 1.

Custom attributes

Heap’s data model is dynamic, meaning it changes as custom attributes are added to object types in your account. For example: Adding new user attributes to the user object.

This means that the Heap schema in your destination may also change over time as you add new attributes in Heap.

When a new attribute is added to an object in Heap, it will display as a selectable field in the Stitch app. Note: To include the field in replication, you’ll need to select it in Stitch. Stitch will not automatically select new fields.

The schema documentation following this section outlines the default attributes for each object type according to Heap’s documentation.

Event tables

For each event type you define in Heap, a table for that event will be available for selection in Stitch.

For example: If there’s a Sign up - Click button event, there will be a table named sign_up_click_button.

Refer to the [event_type] schema documentation for a list of default event attributes.

Note: When new event types are added in Heap, you will need to select the table and fields in Stitch to include it in replication.

Depending on your destination, table and column names may not appear as they are outlined below.

event_tables

For every event type defined in Heap, a table will display in the Stitch app. The name of the table will be the event name, which Heap will first strip the non-alphanumeric characters from. For example: The table name for Sign Up - Click Link will be transformed into sign_up_click_link by Heap.

Note: Custom attributes are supported b for this table. As Heap schemas are dynamic, event_tables documentation will only list the non-custom attributes outlined in Heap’s documentation.

Replication Method

CDC

Primary Key

event_id

Useful links

Heap documentation

Join event_tables with	on
pageviews	event_tables.event_id = pageviews.event_id event_tables.session_id = pageviews.session_id event_tables.user_id = pageviews.user_id
sessions	event_tables.event_id = sessions.event_id event_tables.session_id = sessions.session_id event_tables.user_id = sessions.user_id
user_migrations	event_tables.user_id = user_migrations.to_user_id
users	event_tables.user_id = users.user_id

STRING

action_method

STRING

app_name

STRING

app_version

STRING

browser

STRING

carrier

STRING

city

STRING

country

STRING

device

STRING

device_type

STRING

event_id

STRING

hash

STRING

href

STRING

landing_page

STRING

library

STRING

path

STRING

platform

STRING

query

STRING

referrer

STRING

region

STRING

screen_ally_id

STRING

screen_ally_label

STRING

search_keyword

STRING

session_id

INTEGER

session_time

STRING

target_ally_id

STRING

target_ally_label

STRING

target_text

STRING

target_view_class

STRING

target_view_name

STRING

time

STRING

title

STRING

type

STRING

user_id

INTEGER

utm_campaign

STRING

utm_content

STRING

utm_medium

STRING

utm_source

STRING

utm_term

STRING

view_controller

STRING

pageviews

The pageviews table contains info about pageviews.

Note: Custom attributes are supported for this table. As Heap schemas are dynamic, pageviews documentation will only list the non-custom attributes outlined in Heap’s documentation.

Replication Method

CDC

Primary Key

event_id

Useful links

Heap documentation

Join pageviews with	on
event_tables	pageviews.event_id = event_tables.event_id pageviews.session_id = event_tables.session_id pageviews.user_id = event_tables.user_id
sessions	pageviews.event_id = sessions.event_id pageviews.session_id = sessions.session_id pageviews.user_id = sessions.user_id
user_migrations	pageviews.user_id = user_migrations.to_user_id
users	pageviews.user_id = users.user_id

STRING

app_name

STRING

app_version

STRING

browser

STRING

carrier

STRING

city

STRING

country

STRING

device

STRING

device_type

STRING

event_id

STRING

hash

STRING

landing_page

STRING

library

STRING

path

STRING

platform

STRING

query

STRING

referrer

STRING

region

STRING

screen_ally_id

STRING

screen_ally_label

STRING

search_keyword

STRING

session_id

INTEGER

session_time

STRING

time

STRING

title

STRING

user_id

INTEGER

utm_campaign

STRING

utm_content

STRING

utm_medium

STRING

utm_source

STRING

utm_term

STRING

view_controller

STRING

sessions

The sessions table contains info about sessions. In Heap, a web session ends after 30 minutes of user inactivity, while in iOS, a session ends after the app has entered the background.

Note: Custom attributes are supported for this table. As Heap schemas are dynamic, sessions documentation will only list the non-custom attributes outlined in Heap’s documentation.

Replication Method

CDC

Primary Key

event_id

Useful links

Heap documentation

Join sessions with	on
event_tables	sessions.event_id = event_tables.event_id sessions.session_id = event_tables.session_id sessions.user_id = event_tables.user_id
pageviews	sessions.event_id = pageviews.event_id sessions.session_id = pageviews.session_id sessions.user_id = pageviews.user_id
user_migrations	sessions.user_id = user_migrations.to_user_id
users	sessions.user_id = users.user_id

STRING

app_name

STRING

app_version

STRING

browser

STRING

carrier

STRING

city

STRING

country

STRING

device

STRING

device_type

STRING

event_id

STRING

landing_page

STRING

library

STRING

platform

STRING

referrer

STRING

region

STRING

search_keyword

STRING

session_id

INTEGER

time

STRING

user_id

INTEGER

utm_campaign

STRING

utm_content

STRING

utm_medium

STRING

utm_source

STRING

utm_term

STRING

user_migrations

The user_migrations table contains info about user migrations.

Note: Custom attributes are supported for this table. As Heap schemas are dynamic, user_migrations documentation will only list the non-custom attributes outlined in Heap’s documentation.

Replication Method

CDC

Primary Key

from_user_id

Useful links

Heap documentation

Join user_migrations with	on
event_tables	user_migrations.to_user_id = event_tables.user_id
pageviews	user_migrations.to_user_id = pageviews.user_id
sessions	user_migrations.to_user_id = sessions.user_id
users	user_migrations.to_user_id = users.user_id

from_user_id

STRING

time

STRING

to_user_id

INTEGER

users

The users table contains info about users.

Note: Custom attributes are supported for this table. As Heap schemas are dynamic, users documentation will only list the non-custom attributes outlined in Heap’s documentation.

Replication Method

CDC

Primary Key

user_id

Useful links

Heap documentation

Join users with	on
event_tables	users.user_id = event_tables.user_id
pageviews	users.user_id = pageviews.user_id
sessions	users.user_id = sessions.user_id
user_migrations	users.user_id = user_migrations.to_user_id

email

STRING

handle

STRING

identity

STRING

joindate

STRING

last_modified

STRING

user_id

STRING

このページは役に立ちましたか?

このページまたはコンテンツにタイポ、ステップの省略、技術的エラーなどの問題が見つかった場合はお知らせください。

こちらにフィードバックをお寄せください