Transferring data to LinkedIn Matched Audiences

This guide explains how to transfer data to LinkedIn Matched Audiences to store and further process information.

Concept

LinkedIn Matched Audiences is an Active Destination. After you set LinkedIn Matched Audiences as the Destination of a Datastream, data is transferred to LinkedIn Matched Audiences each time data is fetched for the Datastream. For more information, see Destination types.

You can assign multiple Destinations to a Datastream. For more information on possible limitations, see Assigning multiple Destinations to a Datastream.

Prerequisites

Before you complete the procedure in this guide, perform all of the following actions:

  • Create a Datastream whose data you want to transfer to LinkedIn Matched Audiences. For more information on creating a Datastream, see Introduction to collecting data.

  • Ensure the Data Extracts of the Datastream contain at least one field that can be used to identify users or companies.

    If the data is about users, the identifier fields must be at least one of the following:

    • Email

    • Apple ID

    • Google Advertising ID

    • Google User ID

    If the data is about companies, the identifier fields must be at least one of the following:

    • Company name

    • Company domain

    • Company website

    • URL of the company's LinkedIn page

    Adverity encrypts the identifier fields to ensure that your data is anonymized.

Procedure

To transfer data from a Datastream to LinkedIn Matched Audiences, follow these steps:

  1. Add LinkedIn Matched Audiences as a Destination to the Workspace which contains the Datastream or to one of its parent Workspaces.

  2. Assign the LinkedIn Matched Audiences Destination to the Datastream.

  3. Configure the Schema Mapping of your Datastream to conform with LinkedIn Matched Audiences Destination standards.

  4. Enable data transfer to the Destination from the Datastream.

  5. Configure transfer settings.

Adding LinkedIn Matched Audiences as a Destination

To add LinkedIn Matched Audiences as a Destination to a Workspace, follow these steps:

  1. Click the Transfer element and select the Workspace you work with in Connect, Enrich & Transfer.

  1. Click + Add.

  2. Click LinkedIn Matched Audiences.

  1. Click Setup a new Authorization.

  2. Click Next.

  1. Log in to your LinkedIn Matched Audiences account.

  1. In the Configuration page, fill in the following fields:

    Name

    (Optional) Rename the Destination.

    Sponsored account

    Select the account where to transfer data.

  1. Click Create.

Assigning LinkedIn Matched Audiences as a Destination

To assign the LinkedIn Matched Audiences Destination to a Datastream, follow these steps:

  1. Click the Connect element and select the Workspace you work with in Connect, Enrich & Transfer.

  1. Select the chosen Datastream.

  1. In the Destinations section, click + Add Destination.

  2. Click Assign Existing Destinations.

  1. Select the LinkedIn Matched Audiences checkbox in the list.

  2. Click Save.

Configuring Schema Mapping for LinkedIn Matched Audiences Destination

All data that you transfer to LinkedIn Matched Audiences must conform with LinkedIn Matched Audiences standards.

To configure Schema Mapping for the LinkedIn Matched Audiences Destination, follow these steps:

  1. Click the Connect element and select the Workspace you work with in Connect, Enrich & Transfer.

  1. Select the chosen Datastream.

  1. In the top navigation panel, click Schema Mapping.

  1. In the Name column, find the field in the Data Extract used to identify users or companies.

    If the data is about users, the identifier field must be one of the following:

    • Email

    • Apple ID

    • Google Advertising ID

    • Google User ID

    If the data is about companies, the identifier field must be one of the following:

    • Company name

    • Company domain

    • Company website

    • URL of the company's LinkedIn page

  2. In the cell in the Target column and the identifier field's row, write one of the following and press Enter. If you cannot find any value, click the blue link to create the target field with type string.

    • If email is the user identifier, write email.

    • If Apple ID is the user identifier, write appleidfa.

    • If Google Advertising ID is the user identifier, write googleaid.

    • If Google User ID is the user identifier, write googleuid.

    • If company name is the company identifier, write companyname.

    • If company domain is the company identifier, write companydomain.

    • If company website is the company identifier, write companywebsite.

    • If the URL of the company's LinkedIn page is the company identifier, write linkedincompanypageurl.

    For more information on adding a new field to the Schema Mapping, see Adding a target field.

  3. Click Save Mapping.

Enabling data transfer to LinkedIn Matched Audiences Destination

To enable data transfer to the LinkedIn Matched Audiences Destination from the Datastream, follow these steps:

  1. Click the Connect element and select the Workspace you work with in Connect, Enrich & Transfer.

  1. Select the chosen Datastream.

  1. In the list in the Destinations section, find the LinkedIn Matched Audiences Destination, and enable the toggle.

  2. In the All tasks tab, find the top element, and click Requeue for Import on the right.

Configuring transfer settings

To configure transfer settings, follow these steps:

  1. Click the Connect element and select the Workspace you work with in Connect, Enrich & Transfer.

  1. Select the chosen Datastream.

  1. In the Destinations section, find the LinkedIn Matched Audiences Destination in the list, and click on the right.

  2. Click Destination Settings.

  1. Action

    Select one of the following:

    • Select Update existing Audience to add data from the Data Extract to an existing table.

    • Select Create new Audience (for each Extract) to create a new table for each Data Extract.

    • Select Create new Audience (once, then update) to create a new table the first time you transfer data from this Datastream, and then update this table with all subsequent data from the Datastream.

    Segment type

    Select whether the data is about users or companies.

    Identifiers

    Select the columns in the Data Extract used to identify users. You must include at least one of the columns you used when you configured the Schema Mapping for the Datastream.

    Custom Audience Name Template

    This field is available when you select Create new Audience (for each Extract) or Create new Audience (once, then update) in Action. Specify the target table in the Destination where to transfer data from the Datastream. The name can contain alphanumeric characters and underscores. For example, target_table. To specify a schema, use the syntax schemaName.tableName.

    By default, Adverity saves data from each Datastream in a different table named [{datastream_name}] Custom Audience (for example, [mailgun_83] Custom Audience).

    You can specify the same target table for several Datastreams. If a column is shared between Datastreams, Adverity performs a full outer join and concatenates values. If a column is not shared between Datastreams, Adverity writes null values in the relevant cells.

    Use placeholders to create unique, dynamic table names in the Destination. Use the following placeholders:

    Placeholder

    Description

    {datastream_id}

    The Datastream ID.

    {datastream_name}

    The Datastream name.

    {datastream_type}

    The Datastream Type.

    {filename}

    The automatically generated filename of the Data Extract.

    {scheduled_day}

    The day from the start date of a date range for a scheduled data fetch.

    {scheduled_month}

    The month from the start date of a date range for a scheduled data fetch.

    {scheduled_year}

    The year from the start date of a date range for a scheduled data fetch.

    Matched Audiences

    This field is available when you select Update existing Audience in Action. Select the table in the Destination where to transfer data. You can only select tables created by Adverity. You cannot select tables created within LinkedIn Matched Audiences.

  2. Click Save.