Destinations

Introduction

Destinations are where the rubber meets the road. They provide push button ease for delivering the highly targeted audiences constructed from rich behavioral insights to all of your marketing delivery tools. This section will cover the tools and interface for managing data sync with your preferred Destination.

📘

The landscape in which your consumers interact is broad. To ensure Lytics makes it easy to both collect and deliver essential data, insights, and audiences, we have a variety of integration options.

The Basics

Data Destination integrations are managed primarily by Decision Engine but may also be available in Conductor to streamline the delivery of raw events and profiles to your warehouse. Creating a Destination is simple:

Adding a Destination

New Source integrations are added from the Decision Engine interface by first navigating to the Jobs option under the Data section in the main navigation.

From there, you'll click "+ Create New Job" at the top of the list and enter the wizard to guide you through the creation process.

Configuring a Job

Select a Provider

Each Destination is first categorized by the provider, making it easy to narrow down the channel you'd like to integrate with. To select a provider, click the tile representing your desired provider, such as "Google."

Select Job Type

With the provider selected, we'll surface the various ways you can integrate with that particular provider. This will vary significantly by the provider.

Select Authorization Method

Each provider and job type may require additional authorization to finalize the connection. On the "select authorization" step, you can either select an existing authorization or create a new one. When creating a new authorization, you will be asked to provide the required credentials, such as key and secret, to proceed.

Configure Destination

The final step lets you provide the specific configuration details for your chosen provider and job type. Again, the options supported by each provider will vary greatly, and provider-specific integration details should be leveraged to determine the optimal approach.

Monitoring a Destination

Once you have one or more Destination jobs running, they will be accessible from the Jobs list view, as pictured below. This view provides quick access to essential details:

  • Name: Name of job, such as "Export of High-Value Users to Facebook."
  • Authorization: Name of the associated authorization.
  • Provider: Third-party tool that you are connecting with Lytics.
  • Type: Indicates whether the job is an import, export, or enrichment.
  • Status: Current state of a job such as running, paused, completed, etc.
  • Created: Date the job was initially created.

Job Status

Detailed states are provided to understand better what is happening in the background during a job's lifecycle. These states will vary by job but include:

Job StatusDescription
RunningThe job is actively running.
SleepingThe job is not actively running but is scheduled to run again after a given period. A job is sleeping either because the job runs on a periodic cadence with scheduled sleep in between job runs or the job has encountered an error and is sleeping before retrying the request.
FailedThe job has encountered consecutive errors over 10 hours and is removed from running again. Check the logs to see if there are any fixable issues. Failed works can be resumed, which will schedule it to run again. Failed jobs will be automatically purged after 90 days.
PausedA user has paused the job. The work can be scheduled to run again by resuming the job. Paused works will be automatically purged after 90 days.
CompletedThe job has completed all its scheduled tasks and will not be rerun. These will be purged from the job history after 90 days.

For more information on job states or troubleshooting failed jobs, see job processing.

Job Summary

Clicking on any of the items in the Source list will navigate to its dedicated summary view for greater detail. This summary provides all the relevant information about each job you've created in Lytics and an entry point to alter the configuration or status.

At the top of the Job Summary page, you’ll find the following quick-access information:

  • Status: Indicates the current state of a job. See the table below for descriptions of each status.
  • Provider: Third-party tool that you are connecting with Lytics, such as Facebook, Google, Mailchimp, etc.
  • Type: Indicates whether the job is an import, export, or enrichment.
  • Job Name: Name of the job, such as “Import Users & Activity” or “Export Audiences.”
  • Authorization: Name of the authorization, such as “Main Salesforce auth.”
  • Created By: Lytics user who created the authorization.
  • Last Updated: Date the job was most recently edited.

📘

You can edit the name and description of an existing job from its summary page to improve the organization and clarity of your account's list of jobs.

Configuration

The details section displays your job's current configuration. This includes details such as the authorization used, where data is coming from, which data is being pulled in, etc.

Logs

The Logs section records the history of events for this job, details about the work completed, and the time each job was run. The logs are helpful to ensure your work is running as expected and for troubleshooting if any issues arise. Below are descriptions of the job events you may see in the logs.

Job EventsDescription
StartedThe job has started running for the first time.
SyncedThe job has completed a unit of work successfully and will continue to run.
ErrorThe job has encountered an error and will retry automatically.
SleepingThe job is currently sleeping due to external restrictions, such as hitting a provider's API limits.
FailedThe job has encountered consecutive errors over 10 hours and is removed from running again.
CompletedThe job has completed all its scheduled tasks and will not be rerun.