Skip to content

Commit

Permalink
Merge pull request #8272 from braze-inc/bd-3574
Browse files Browse the repository at this point in the history
BD-3574 Update LINE docs for GA
  • Loading branch information
lydia-xie authored Oct 24, 2024
2 parents 10cbe2e + 996ed07 commit 006853f
Show file tree
Hide file tree
Showing 13 changed files with 37 additions and 72 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ If you are using the [older navigation]({{site.baseurl}}/navigation), you can fi

## Step 3: Add partner

Add a partner, sometimes called a "Currents connector", by clicking the dropdown at the top of the screen.
Add a partner, sometimes called a "Currents connector," by selecting the dropdown at the top of the screen.

Each partner requires a different set of configuration steps. To enable each integration, refer to our list of [available partners]({{site.baseurl}}/user_guide/data_and_analytics/braze_currents/available_partners/) and follow the instructions in their respective pages.

Expand Down
5 changes: 2 additions & 3 deletions _docs/_user_guide/message_building_by_channel/line.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,10 +6,9 @@ layout: dev_guide
channel:
- LINE
guide_top_header: "LINE"
guide_top_text: "[LINE](https://www.lycbiz.com/sites/default/files/media/jp/download/LINE%20Business%20Guide_202310-202403.pdf) is the most popular messaging app in Japan, with over 95 million monthly active users. In addition to messaging, LINE offers its users an “all-in-one” platform for social media, gaming, shopping, and payments.<br><br>You can integrate your LINE accounts with Braze to leverage your zero- and first-party customer data to send compelling LINE messages to the right customers based on their preferences, behaviors, and cross-channel interactions.<br><br>LINE access is in beta and only available in select Braze packages. Reach out to your account manager or customer success manager to get started."
guide_top_text: "[LINE](https://www.lycbiz.com/sites/default/files/media/jp/download/LINE%20Business%20Guide_202310-202403.pdf) is the most popular messaging app in Japan, with over 95 million monthly active users. In addition to messaging, LINE offers its users an “all-in-one” platform for social media, gaming, shopping, and payments.<br><br>You can integrate your LINE accounts with Braze to leverage your zero- and first-party customer data to send compelling LINE messages to the right customers based on their preferences, behaviors, and cross-channel interactions.<br><br>Sending LINE messages from Braze will draw from your account's Message Credits."
description: "This landing page is home to the LINE channel. Here, you can find articles on setting up LINE, LINE subscription groups, LINE campaigns, LINE reporting, and more."
hidden: true
permalink: /line/
alias: /line/

guide_featured_title: "LINE"
guide_featured_list:
Expand Down
17 changes: 6 additions & 11 deletions _docs/_user_guide/message_building_by_channel/line/create.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,17 +8,12 @@ tool:
- Campaigns
channel:
- LINE
hidden: true
permalink: /line/create/
alias: /line/create/
---

# Creating a LINE message

> LINE campaigns can directly reach and programmatically chat with your customers. You can use Liquid and other dynamic content to create a personal experience with your users and create an environment that fosters and enhances an unobtrusive user experience with your brand.<br><br>This article is part of the LINE beta collection. [Return to the main page](https://www.braze.com/docs/line/).
{% alert important %}
LINE access is in beta and only available in select Braze packages. Reach out to your account manager or customer success manager to get started.
{% endalert %}
> LINE campaigns can directly reach and programmatically chat with your customers. You can use Liquid and other dynamic content to create a personal experience with your users and create an environment that fosters and enhances an unobtrusive user experience with your brand.
## Prerequisites

Expand All @@ -28,6 +23,7 @@ Before creating a LINE message, do the following:
2. Acknolwedge policies, limits, and content rules.
3. [Set up your LINE connection]({{site.basesurl}}/user_guide/message_building_by_channel/line/line_setup/).

Sending LINE messages from Braze will draw from your account's Message Credits.

## Step 1: Choose where to build your message

Expand All @@ -47,9 +43,8 @@ If you are using the [older navigation]({{site.baseurl}}/navigation), you can fi
2. Select **LINE**, or, for campaigns targeting multiple channels, select **Multichannel Campaign**.
3. Name your campaign something clear and meaningful.
4. Add [Teams]({{site.baseurl}}/user_guide/administrative/manage_your_braze_users/teams/) and [Tags]({{site.baseurl}}/user_guide/administrative/app_settings/manage_app_group/tags/) as needed.
* Tags make your campaigns easier to find and build reports out of. For example, when using the [Report Builder]({{site.baseurl}}/user_guide/data_and_analytics/reporting/report_builder/), you can filter by particular tags.
* Tags make your campaigns easier to find and build reports out of.
5. Add and name as many variants as you need for your campaign. You can choose different platforms, message types, and layouts for each of your added variants. For more on this topic, refer to [Multivariate and A/B testing]({{site.baseurl}}/user_guide/engagement_tools/testing/multivariant_testing/).
6. Select a [subscription group]({{site.baseurl}}/user_guide/message_building_by_channel/sms/sms_subscription_group/) to ensure you're sending your message to the proper users. When selecting a subscription group, Braze will automatically add a segmenting filter, ensuring that only users subscribed will receive the campaign. Only long codes and short codes that belong to that subscription group will be used to send SMS to target users.

{% alert tip %}
If all of the messages in your campaign are going to be similar or have the same content, compose your message before adding additional variants. You can then choose **Copy from Variant** from the **Add Variant** dropdown.
Expand All @@ -72,9 +67,9 @@ If all of the messages in your campaign are going to be similar or have the same

## Step 2: Compose your LINE message

Write your message using languages and personalization (such as Liquid or Connected Content) as needed. LINE allows up to five message bubbles in each message, which can be text or image messages.
Write your message using personalization (such as Liquid or Connected Content) as needed. LINE allows up to five message bubbles in each message, which can be any of the available messages layouts: text, image, rich, or card-based.

![LINE composer with a message displayed in the preview.][1]{: style="max-width:70%;"}
![LINE composer with a message displayed in the preview.][1]

{% alert tip %}
If you plan to use Liquid, be sure to include a default value for your personalization. This will prevent recipients with incomplete user profiles from receiving a blank placeholder. For example, instead of a user receiving the message "Hi, !", they might receive the message "Hi, new subscriber!".
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,17 +8,12 @@ tool:
- Campaigns
channel:
- LINE
hidden: true
permalink: /line/create/message_types/
alias: /line/create/message_types/
---

# LINE message types

> This article covers the LINE message types you can compose, including aspects and limitations, and is part of the LINE beta collection. [Return to the main page]({{site.baseurl}}/line/).
{% alert important %}
LINE access is in beta and only available in select Braze packages. Reach out to your account manager or customer success manager to get started.
{% endalert %}
> This article covers the LINE message types you can compose, including aspects and limitations.
When you compose a LINE message, you can drag-and-drop message types into the composer and then customize them.

Expand Down
45 changes: 18 additions & 27 deletions _docs/_user_guide/message_building_by_channel/line/line_setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,37 +7,34 @@ search_tag: Partner
page_order: 0
channel:
- LINE
hidden: true
permalink: /line/line_setup/
alias: /line/line_setup/
---


# LINE setup

> This article covers how to set up the LINE channel in Braze and is part of the LINE beta collection. [Return to the main page](https://www.braze.com/docs/line/).
{% alert important %}
LINE access is in beta and only available in select Braze packages. Reach out to your account manager or customer success manager to get started.
{% endalert %}
> This article covers how to set up the LINE channel in Braze, including how to set up users, reconcile user IDs, and create LINE test users in Braze.
## Prerequisites

You'll need the following to integrate LINE with Braze:

- [LINE business account](https://www.linebiz.com/jp-en/manual/OfficialAccountManager/tutorial-steps/?list=7171)
- [Premium or verified account](https://www.infobip.com/docs/line/get-started#premium-id-line-official-account) status (necessary for syncing existing followers)
- Premium or verified account status (necessary for syncing existing followers)
- View [LINE's account guidelines](https://terms2.line.me/official_account_guideline_oth)
- [LINE developers account](https://developers.line.biz/en/docs/line-developers-console/login-account/)
- [LINE messaging API channel](https://developers.line.biz/en/docs/line-developers-console/overview/#channel)

Sending LINE messages from Braze will draw from your account's Message Credits.

## Types of LINE accounts

| Account type | Description |
| --- | --- |
| Unverified account | An unreviewed account that can be obtained by anyone (individual or corporate). This account is represented with a gray badge and won't appear in search results within the LINE app. |
| Verified account | An account that has passed the LINE Yahoo screening. This account is represented with a blue badge and will appear in search results within the LINE app.<br><br>This account is only available for accounts based in Japan, Taiwan, Thailand, and Indonesia. |
| Premium account | An account that has passed the LINE Yahoo screening. This account is represented with a green badge and will appear in search results within the LINE app. This account type is automatically granted during the screening at LINE's discretion. |
{: .reset-td-br-1 .resest-td-br-2}
{: .reset-td-br-1 .reset-td-br-2}

### Required account type

Expand All @@ -54,8 +51,6 @@ Verified accounts are only available for accounts based in Japan, Taiwan, Thaila
3. Enter the required information.
4. Wait for a notification with the review results.

If you want to sync users who followed a specific channel before that channel was synced with Braze, ask your customer success manager or account manager to [submit a request](https://servicedesk.braze.com/plugins/servlet/desk/portal/12) to the WhatsApp team.

## Integrating LINE

To set up consistent user updates, bring over existing users' LINE IDs, and sync them all to LINE’s subscription states:
Expand All @@ -68,6 +63,8 @@ To set up consistent user updates, bring over existing users' LINE IDs, and sync

## Step 1: Import or update existing LINE users

This step is necessary if you have an existing and identified LINE user, as Braze will later automatically pull their subscription state and update the correct user profile. If you haven’t previously reconciled users with their LINE ID, skip this step.

You can import or update users using any of the methods that Braze supports, including the [`/users/track`]({{site.baseurl}}/api/endpoints/user_data/post_user_track/) endpoint, [CSV import]({{site.baseurl}}/user_guide/data_and_analytics/user_data_collection/user_import/#csv-import), or [Cloud Data Ingestion]({{site.baseurl}}/user_guide/data_and_analytics/cloud_ingestion/).

Regardless of the method you use, update the `native_line_id` to provide the user’s LINE ID. To learn more the `native_line_id`, see [User setup](#user-setup).
Expand All @@ -78,9 +75,9 @@ The subscription group state shouldn't be specified, and it will be ignored. LIN

## Step 2: Integrate LINE channel

After your existing LINE user base is imported into or updated in Braze, you can integrate your channel. After integration, new followers of your LINE channel will have unidentified user profiles created when they follow the channel.
After the integration process completes, Braze will automatically pull that channel’s LINE followers into Braze. For any LINE IDs that are already associated with a Braze user profile, each profile will be updated with the “subscribed” status, and any LINE IDs that are remaining will generate anonymous users. Additionally, new followers of your LINE channel will have unidentified user profiles created when they follow the channel.

### Step 2.1: Connect your LINE channel to Braze
### Step 2.1: Edit webhook settings

1. In LINE, go the **Messaging API** tab and edit your **Webhook settings**:
- Set the **Webhook URL** to `https://anna.braze.com/line/events`.
Expand All @@ -104,7 +101,7 @@ After your existing LINE user base is imported into or updated in Braze, you can

![Response settings page with toggles for how your account will handle chats.][2]{: style="max-width:80%;"}

### Step 2.2: Set up your LINE subscription group in Braze
### Step 2.2: Generate LINE subscription groups in Braze

1. Go to the Braze Technology Partners page for LINE and input the information you noted from your LINE **Providers** tab:
- Provider ID
Expand All @@ -119,9 +116,9 @@ After your existing LINE user base is imported into or updated in Braze, you can

![LINE subscription groups section displaying one subscription group for the "LINE" channel.][4]{: style="max-width:80%;"}

## Step 3: Request a subscription status sync
## Step 3: Reconcile user IDs

We recommend syncing all LINE followers before going live. This updates all followers' user profiles with the correct subscription status. That way, if users follow your LINE channel before they're identified in your app, there's an existing user profile to update or merge.
Combine your users' LINE IDs with their existing Braze user profiles by following the steps in [User ID reconciliation](#user-id-reconciliation).

## Step 4: Change your user update methods

Expand Down Expand Up @@ -201,34 +198,28 @@ To learn more about managing duplicate users in Braze, see [Duplicate Users]({{s

## User setup

LINE is the source of truth for user subscription states. Even if you have the LINE ID for a user (`native_line_id`), if that user hasn't followed the LINE channel you're sending from, LINE won't deliver that channel's messages to the user.
LINE is the source of truth for user subscription states. Even if you have the LINE ID for a user (`native_line_id`), if that user hasn't followed the LINE channel you're sending from, LINE won't deliver messages to the user.

To help manage this, Braze offers tooling and logic that supports a well-integrated user base, including subscription syncing and event updates for LINE follows and unfollows.

### Subscription syncing and event logic

1. **Subscription sync tool:** This can be used to gather the list of all the LINE IDs that are following your channel. There are two ways to use this tool:

| Usage | Description |
| --- | --- |
| Only update existing user profiles | All Braze user profiles that have a `native_line_id` that follows the LINE channel will be updated to have a subscription group status of `subscribed`. |
| Update existing profile and create new | All Braze user profiles that have a `native_line_id` that follows the LINE channel will be updated to have a subscription group status of `subscribed`. <br><br> Any follower of the LINE channel that doesn't have a Braze user profile with the `native_line_id` will have:<br> - An anonymous user profile created with `native_line_id` set to the user LINE ID following the channel <br>- A user alias `line_id` set to the user LINE ID following the channel <br>- A subscription group status of `subscribed`. |
{: .reset-td-br-1 .reset-td-br-2}
1. **Subscription sync tool:** This tool is automatically deployed after a successful LINE channel integration. Use it to update existing profiles and create new profiles.<br><br>All Braze user profiles that have a `native_line_id` that follows the LINE channel will be updated to have a subscription group status of `subscribed`. Any follower of the LINE channel that doesn't have a Braze user profile with the `native_line_id` will have:<br><br>- An anonymous user profile created with `native_line_id` set to the user LINE ID following the channel <br>- A user alias `line_id` set to the user LINE ID following the channel <br>- A subscription group status of `subscribed`

{: start="2"}
2. **Event updates:** These can be used to update a user's subscription status. When Braze receives user event updates for the integrated LINE channel and the event is a follow, the user profile will have a subscription group status of `subscribed`. If the event is an unfollow, the user profile will have a subscription group status of `unsubscribed`.<br><br>- All Braze user profiles with a matching `native_line_id` will be automatically updated. <br>- If no matching user profile exists for an event, Braze will [create an anonymous user](https://www.braze.com/docs/line/user_management/).
2. **Event updates:** These are used to update a user's subscription status. When Braze receives user event updates for the integrated LINE channel and the event is a follow, the user profile will have a subscription group status of `subscribed`. If the event is an unfollow, the user profile will have a subscription group status of `unsubscribed`.<br><br>- All Braze user profiles with a matching `native_line_id` will be automatically updated. <br>- If no matching user profile exists for an event, Braze will [create an anonymous user](https://www.braze.com/docs/line/user_management/).

## Use cases

These are use cases of how users can be updated after you follow the setup steps above.

##### Existing user profile follows LINE channel
##### Existing Braze user profile already follows LINE channel

1. The Braze user profile is updated with a `native_line_id` attribute. Its default subscription status is `unsubscribed`.
2. The subscription sync tool is run, finds that the user is following the LINE channel, and then updates the user profile with the subscription status `subscribed`.
3. If any subscription status changes occur (such as the user blocks, unfriends, or refollows the channel), Braze receives the update from LINE and updates the user profile with the `native_line_id` accordingly.

##### Existing user profile blocks, unfriends, or unfollows LINE channel
##### Existing user profile has blocked, unfriended, or unfollowed LINE channel

1. The Braze user profile is updated with a `native_line_id` attribute. Its default subscription status is `unsubscribed`.
2. The subscription sync tool doesn't find that the user is following the LINE channel and the user’s subscription status remains as `unsubscribed`.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -4,5 +4,4 @@ config_only: true
noindex: true
layout: blank_config
page_order: 4
hidden: true
---
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,12 @@ description: "This article covers LINE message subscription groups."
page_type: reference
channel:
- LINE
hidden: true
permalink: /line/subscription_groups/
alias: /line/subscription_groups/
---

# LINE subscription groups

> There are two subscription states for LINE users: subscribed and unsubscribed. LINE can have up to 100 subscription groups per workspace, with each subscription group connected to its own LINE channel.<br><br>This article is part of the LINE beta collection. [Return to main page](https://www.braze.com/docs/line/).
{% alert important %}
LINE access is in beta and only available in select Braze packages. Reach out to your account manager or customer success manager to get started.
{% endalert %}
> There are two subscription states for LINE users: subscribed and unsubscribed. LINE can have up to 100 subscription groups per workspace, with each subscription group connected to its own LINE channel.
| State | Definition |
| --- | --- |
Expand Down
Loading

0 comments on commit 006853f

Please sign in to comment.