Skip to main content

Kissmetrics Data Source

Nexla's bi-directional connectors allow data to flow both to and from any location, making it simple to create a FlexFlow, DB-CDC, Spark ETL, or Replication data flow that ingests data from a Kissmetrics source.
kissmetrics.png

Kissmetrics

Follow the instructions below to create a new data flow that ingests data from a Kissmetrics source in Nexla.

Create a New Data Flow​

  1. To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Then, select the desired flow type from the list, and click the Create button.

  2. Select the Kissmetrics connector tile from the list of available connectors. Then, select the credential that will be used to connect to the Kissmetrics account, and click Next; or, create a new Kissmetrics credential for use in this flow.

  3. In Nexla, Kissmetrics data sources can be created using pre-built endpoint templates, which expedite source setup for common Kissmetrics endpoints. Each template is designed specifically for the corresponding Kissmetrics endpoint, making source configuration easy and efficient.
    • To configure this source using a template, follow the instructions in Configure Using a Template.

    Kissmetrics sources can also be configured manually, allowing you to ingest data from Kissmetrics endpoints not included in the pre-built templates or apply further customizations to exactly suit your needs.
    • To configure this source manually, follow the instructions in Configure Manually.

Configure Using a Template​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Kissmetrics endpoints. Each template is designed specifically for the corresponding Kissmetrics endpoint, making data source setup easy and efficient.

Endpoint Settings​

  • Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below. Click on an endpoint to see more information about it and how to configure your data source for this endpoint.

    Get Products

    Get Products

    • This endpoint automatically retrieves a list of products for the authorized user from your Kissmetrics account. No additional configuration is required beyond selecting this endpoint template.
    • The endpoint uses GET requests to https://query.kissmetrics.io/v3/products. The endpoint URL is fixed and does not require any path parameters.
    • The endpoint uses pagination (iteration.type: paging.incrementing.offset) to retrieve all products. Pagination starts from offset 0 and uses the offset query parameter to navigate through pages. The limit parameter controls how many records are returned per page, with an expected 50 records per page. The endpoint will automatically fetch all pages until all products are retrieved.
    • The response data path is $.data[*], which extracts all product objects from the data array in the API response.

    This endpoint retrieves a list of all products associated with your Kissmetrics account. The endpoint requires Basic Authentication with your username and password, which is handled automatically by your credential configuration. The endpoint supports pagination through the offset and limit parameters, which allows you to retrieve large lists of products efficiently. For detailed information about fetching products, pagination, and API response formats, see the Kissmetrics API reference.

Configure Manually​

Kissmetrics data sources can be manually configured to ingest data from any valid Kissmetrics API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations.

With manual configuration, you can also create more complex Kissmetrics sources, such as sources that use custom query parameters, different HTTP methods, or custom data transformations.

Content Format​

  1. Select the format in which the data from the Kissmetrics API will be received from the Content Format pulldown menu. Nexla will automatically parse the data in the selected format. The Kissmetrics API typically returns data in JSON format.

API Endpoint URL​

  1. Enter the URL of the Kissmetrics API endpoint from which this source will fetch data in the Set API URL field. This should be the complete URL including the protocol (https://) and any required path parameters. Kissmetrics API endpoints typically follow the pattern https://query.kissmetrics.io/v3/{endpoint_path}.

Ensure the API endpoint URL is correct and accessible with your current credentials. You can test the endpoint using the Test button after configuring the URL. The endpoint requires Basic Authentication with your username and password, which is handled automatically by your credential configuration. For detailed information about Kissmetrics API endpoints, authentication, and available APIs, see the Kissmetrics API reference.