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.

Présentation générale de ce connecteur, y compris des liens utiles et les fonctions supportées.

Caractéristique/Fonctionnalité	Détails du support
Projets Qlik Talend Data Integration supportés	Projets de réplication uniquement. Les projets de pipeline de données ne sont pas supportés.
Méthodes de mise à jour de la cible	Tâches de réplication : Appliquer les modifications Stocker les modifications Tâches de dépôt temporaire de données dans un lac de données : Change Data Capture (CDC)
Gestion des métadonnées	La génération manuelle de métadonnées n'est pas nécessaire.
Évolution du schéma	Seule l'opération Modifier le type de données de la colonne est supportée.
Réplication de colonnes LOB (NCLOB, CLOB et BLOB)	Non supporté.
Opération CDC planifiée	Requis. C'est ainsi que la cible est mise à jour en fonction des modifications apportées à la source. Pour les tâches de réplication, consultez Planification de tâches . Pour les tâches de dépôt temporaire dans un lac, consultez Planification de CDC pour les tâches de dépôt temporaire dans un lac.
Notifications	Partiellement supporté Définition de notifications en cas de modifications du fonctionnement
Monitoring	CDC uniquement, car Chargement complet n'est pas pertinent pour ce connecteur. Surveillance d'une tâche de données individuelle
Désimbrication automatique des charges utiles des colonnes JSON	Non supporté. Les charges utiles des colonnes JSON des jeux de données sources ne sont pas automatiquement désimbriquées sur la cible.

Preparing for authentication

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

Assurez-vous que le compte que vous utilisez dispose d'un accès en lecture sur les tables à récupérer.

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

Pour plus d'informations, consultez Connexion à des applications SaaS.

Complétez les propriétés de connexion requises.
Fournissez un nom pour la connexion dans Nom de la connexion.
Sélectionnez Ouvrir les métadonnées de connexion pour définir les métadonnées de la connexion lors de sa création.
Cliquez sur Créer.

Connection settings
Setting	Description
Data gateway	Sélectionnez une Passerelle de déplacement des données si cela est nécessaire pour votre cas d'utilisation. Note Informations Ce champ n'est pas disponible avec l'abonnement Démarreur Qlik Talend Cloud, car il ne supporte pas Passerelle de déplacement des données. Si vous avez un autre niveau d'abonnement et si vous ne souhaitez pas utiliser Passerelle de déplacement des données, sélectionnez Aucune. Pour des informations sur les avantages de Passerelle de déplacement des données et les cas d'utilisation qui la nécessitent, consultez Passerelle de données Qlik - Déplacement des données.
Start Date	Saisissez la date, au format `MM/DD/YYYY`, à partir de laquelle les données doivent être répliquées de votre source vers votre cible.
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

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – faites-le-nous savoir.

Laissez vos commentaires ici