Introduction = What is This Thing?

To create an introduction, start with the PRD. The introduction should address the reader's question of "What is it?. The Technical Writer will review the introduction and make changes. 

PRD Problem Statements Example

Braze is a famous Customer Engagement Platform that connects consumers and brands. Its solution supports the pushing of targeted ads to the consumer-ends mobile applications and websites via their SDK. In addition, the scalable user profiles management as well as schedule cleaning up of the opt-out users and segments.

Technical Writer Final Version

The Braze platform provides insight into new growth opportunities and brand interactions that can help you build transformative campaigns and take strategic actions. Treasure Data supports the Braze platform by allowing you to write job results from Treasure Data directly to Braze. 

LINE is in Asia what Facebook Messaging and Instagram are to US mobile users—a fast and easy way to communicate with friends and to discover new promotions about your favorite products and services. LINE is the number one mobile messaging platform in Taiwan. It is also one of the largest mobile messaging platforms in Japan and Thailand. Through Crescendo Labs MAAC API, we are developing an out-of-the-box integration to activate LINE. This integration allows you to authenticate using the API token, upload members with tags, and create and update segments with Line UIDs. 

Include a bulleted list (at least two bullets) of what the customer can do with the integration. 

PRD Use Cases Example

Use Cases

  • As a marketing operator, I want to incrementally send segmented user attributes to Braze, where I can easily create the segments based on this information for targeting correct consumers.

  • As a data engineer, I want to automatically map the custom Ids of the consumers to Braze unidentified users so that I can facilitate multiple marketing tools on the marketing campaign

  • As a marketing operator, I want to remove opt-out consumers from the list on Braze to provide the matching privacy level for the target consumers.

PRODUCT MANAGERS: Please condense the use cases into easily consumed bullets.

Technical Writer Final Version

  • Map external ids: For example, you can map ids from your CRM system to the Braze user account. 

  • Opt-out: When an end-user updates the consent choosing not to participate.

  • Upload your own tracking of events, purchases, or custom profile attributes. This information can help you build precise customer segments that enhance the user experience for your campaigns.


This article contains

Prerequisites

Requirements and Limitations

The Connector implements minimal data validation, you must make sure your data is valid Line/Crescendo Lab spec to avoid job fail. For example, line_uid, email, mobile must be valid Line's data, birthday must be valid ISO format e.g. 1985-04-06.

For the heading, replace the current text, keep a Heading 1, and change the text color to black.

In this section, include information that the customer needs to set up the integration.

For example:

  • Obtain REST API Key
  • Fetch Data
  • Obtain/Define Credentials
  • Basic Usage

Use the TD Console to Create Your Connection

Create a New Connection

In Treasure Data, you must create and configure the data connection prior to running your query. As part of the data connection, you provide authentication to access the integration.

Open TD Console.
Navigate to Integrations Hub Catalog.
Search for and select Line via Crescendo.

Select Create Authentication.
Type the credentials to authenticate.

Type a name for your connection.
Select Done.



Define your Query

Depend on the Data Object you've chosen, the supporting columns will be different.

Data Object: Members

ColumnData TypeRequiredDescription
line_uidstringYes (if import key is line_uid)The unique user ID of the member in the LINE official account
line_display_namestringNoThe name defined by the member in the official LINE account
emailstringYes (if import key is email)Member email address
mobilestringYes (if import key is mobile)Member phone number
customer_idstringYes (if import key is customer_id)User ID of the third-party system
genderstringNoThe gender of the member (default is predicted by MAAC AI)
male: male
female: female
birthdaystringNoMember's birthday (ISO Format) E.g. 2000-02-23
tagscomma-separated stringsNotags to tag to individual members

Data Object: Segments

ColumnData TypeRequiredDescription
line_uidstringYesLine UID to be imported



Integration Parameters for Line via Crescendo Lab

ParametertypeRequiredDescription
Access Token (api_token)StringYesAccess token
Data Object (data_object)

StringYesMembers (members) or Segments (segments)
Import Key (import_key)StringYes (if Data Object is Members)

Value: line_uidcustomer_idemail, or mobile

Tags (tags)StringYesComma-separated strings of tags
Segment Name (segment_name)StringYes (if Data Object is Segments)Segment name
Description (segment_description)StringNoSegment description
Skip Invalid Records (skip_invalid_records)BooleanNoSkip invalid records and continue the job (default: true)
update_segment)BooleanNoUpdate existing segment

Example Query

SELECT 
  line_uid,
  customer_id,
  display_name,
  gender,
  email,
  tags,
  birthday
FROM
  line_members

Optionally Schedule the Query Export Jobs

You can use Scheduled Jobs with Result Export to periodically write the output result to a target destination that you specify.

Optionally Configure Export Results in Workflow

Example Workflow for Line via Crescendo


timezone: UTC
 
_export:
  td:
    database: sample_datasets
 
+td-result-into-line:
  td>: queries/sample.sql
  result_connection: your_connection_name
  result_settings:
    api_token: ###
    data_object: members
    import_key: line_uid
    tags: import210707, apple product interested