Klaviyo connector for Zoho DataPrep

Klaviyo connector for Zoho DataPrep [BETA]


Zoho DataPrep allows you to bring in data from Klaviyo, a marketing automation platform that combines marketing automation, analytics, and customer service into one unified solution, making it easy for businesses. With this integration, you can prepare data and gain deeper insights into campaign performance, customer behavior, and trends, enabling informed decisions and enhanced marketing strategies. With this connector, you can streamline your ETL workflows, enable smooth data movement, and simplify data integration between Klaviyo and Zoho DataPrep.

To import data from Klaviyo

1. Open an existing pipeline or create a pipeline from the Home Page, Pipelines tab or Workspaces tab and click the Add data option.

InfoInfo: You can also click the Import data  icon at the top of the pipeline builder to bring data from multiple sources into the pipeline.


2. Choose the Marketing category from the left pane and click Klaviyo. You can also search for Klaviyo in the search box.



NotesNote: If you had already added a connection earlier, click the required connection and proceed to import. You can also find your saved connections under the Saved connections category from the left pane. To learn more about Saved connections, click here.

3. Select an account from the saved connections or connect a new account using Add new option.


To authenticate your Klaviyo account

4. Provide a unique Connection name and Secret key of your project from Klaviyo in the respective fields and click Authenticate.



5. Enter the API key from your Klaviyo organization. 

To get the API key 

  1. Click the profile icon from the bottom of the left pane and click Settings. Choose the API Keys option under the Account section.

b. Click the Create Private API Key button and provide a name for the API key. 
c. Select the required Access level and then click the Create button.



d. Once your API key is created, copy paste it in the DataPrep import screen.

6. Choose one of the options to import data from your Klaviyo account.

All Data - This option imports all data from your account.
From date - This option imports data from a specific date till the current date.
Note: The From date option is available for the following modules. For modules that do not support this option, all data will be imported.
  1. Bounced Email_Klaviyo
  2. Clicked Email_Klaviyo
  3. Opened Email_Klaviyo
  4. Received Email_Klaviyo
  5. Dropped Email_Klaviyo
  6. Marked Email as Spam_Klaviyo



Here's a list of modules supported
  1. ListsAndSegments
  2. EmailCampaigns
  3. EmailCampaignsVsListsIncluded
  4. EmailCampaignsVsListsExcluded
  5. Flows
  6. Profiles
  7. Bounced Email_Klaviyo
  8. Clicked Email_Klaviyo
  9. Opened Email_Klaviyo
  10. Received Email_Klaviyo
  11. Dropped Email_Klaviyo
  12. Marked Email as Spam_Klaviyo

7. Once you have completed importing data, Pipeline builder page opens and you can start applying transforms to the ETL pipeline. You can also right-click the stage and choose the Prepare data option and prepare your data in the DataPrep Studio page. Click here to know more about the transforms.


Note: When you import more than one module from your Klaviyo organization, each dataset will be created as a stage in DataPrep as above.

8. Once you are done creating your data flow and applying necessary transforms in your stages, you can right-click a stage and add a destination to complete your data flow.
NotesNote:  After adding a destination to the pipeline, you can try executing your ETL pipeline using a manual run at first. Once you make sure manual run works, you can then set up schedule to automate the pipeline and data movement. Learn about the different types of runs here.

Schedule

You can schedule your pipeline using the Schedule option. 

Schedule configuration

1. Select the Schedule option in the pipeline builder.

2. Select a Repeat method (hourly, daily, weekly, monthly) and set frequency using Perform every dropdown. The options of the Perform every dropdown change with the Repeat method. Click here to know more.




3. Select the GMT at which you want to import new data found in the source. By default, your local time zone will be selected.


4. Pause schedule after: This option allows you to choose to pause the schedule after n number of failures.
InfoInfo: The range can be between 2-100. The default value is 2.

Import configuration

You can configure how to import and fetch data from your Klaviyo organization using the Import configuration option. 
Note: The import configuration needs to be mandatorily setup for all the sources in the pipeline. Without setting up the import configuration, the schedule cannot be saved. 

Refer to the below sheet to view the available import configuration options for each module.



5. Select the Click here link to set the import configuration. 

6. Select the required option from the How to import data from source? drop down. You can choose to import all data, modified and new data, or only new data using this option.

Import all data  

If you want to import all data, select the date from when data needs to be imported in the From field. This option will import all available data from the selected date.



Note: The From date option is available for the following modules. For modules that do not support this option, all data will be imported.
  1. Bounced Email_Klaviyo
  2. Clicked Email_Klaviyo
  3. Opened Email_Klaviyo
  4. Received Email_Klaviyo
  5. Dropped Email_Klaviyo
  6. Marked email as Spam_Klaviyo

Incremental data fetch

Only modified and new data

To import the modified and new data incrementally from the last imported time, select Only modified and new data option from the drop-down.

Note: This option is available for the below modules only
  1. Bounced Email_Klaviyo
  2. Clicked Email_Klaviyo
  3. Opened Email_Klaviyo
  4. Received Email_Klaviyo
  5. Dropped Email_Klaviyo
  6. Marked Email as Spam_Klaviyo

 

Use existing data if new data is not available: 

During incremental import,

  1. If the checkbox is checked: When there is no new data in the source, the last fetched data will be imported again.
  2. If the checkbox is unchecked: When there is no new data in the source, the import will fail and no files will be imported. This will, in turn, cause the entire pipeline job to fail.


InfoThe modified and new data will be fetched using the Created_At and Updated_At columns from the last imported time.

Do not import data

The data is imported only once. The second time, the rules gets applied on the same data and gets exported.



7. Click Save to schedule import for your data.

Note: If you have already configured a schedule from Klaviyo, data will be reloaded based on your earlier configuration under the Import configuration section when you click on the Edit schedule option and set a new schedule.

Schedule settings

Stop export if data has invalid values: Enabling this will stop the export when prepared data still has invalid values.



Order exports

You can use this option when you have configured multiple destinations and would like to determine in what order the data has to be exported to destinations.

If not enabled, export will run in the default order.

Note: This option will be visible only if you have added more than one destination in your pipeline.

To rearrange the order of your export destinations

1) Click the Order exports toggle


2) You can drag and drop to change the order of the destinations and then click Save.



Note: Click the Edit order link if you want to rearrange the order again.


8. After you configure the schedule configuration, click Save to execute the schedule. This will start the pipeline.



Each scheduled run is saved as a job. When a pipeline is scheduled, the data will be fetched from your data sources, prepared using the series of transforms you have applied in each of the stages, and then data will be exported to your destination through data integration at regular intervals. This complete process is captured in the job history.


9. To go to the jobs list of a particular pipeline, go to the  ellipses icon in the pipeline builder, and click on the Job history menu to check the job status of your pipeline.

10. Click the required job ID in the Jobs history page to navigate to the Job summary of a particular job.

The Job summary shows the history of a job executed in a pipeline flow. Click here to know more.

11. When the schedule is completed, the data prepared in your pipeline will be exported to the configured destinations.

Info: You can also view the status of your schedules later on the Jobs page.

Note: If you make any further changes to the pipeline, the changes are saved as a draft version. Choose the Draft option and mark your pipeline as ready for the changes to reflect in the schedule.




After you set your schedule, you can choose to Pause schedule or Resume schedule, Edit schedule and Remove schedule using the Schedule Active option in the pipeline builder.

When you edit and save a schedule, the next job will be from the last schedule run time to the next scheduled data interval.


Important: Adding Klaviyo as destination and pushing data to Klaviyo from DataPrep is not supported yet.