diff --git a/_docs/_user_guide/data_and_analytics/braze_currents/setting_up_currents.md b/_docs/_user_guide/data_and_analytics/braze_currents/setting_up_currents.md index f97b2300154..a35bc14ece3 100644 --- a/_docs/_user_guide/data_and_analytics/braze_currents/setting_up_currents.md +++ b/_docs/_user_guide/data_and_analytics/braze_currents/setting_up_currents.md @@ -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. diff --git a/_docs/_user_guide/message_building_by_channel/line.md b/_docs/_user_guide/message_building_by_channel/line.md index 16750a4b004..07fe0cb3a47 100644 --- a/_docs/_user_guide/message_building_by_channel/line.md +++ b/_docs/_user_guide/message_building_by_channel/line.md @@ -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.

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.

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.

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.

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: diff --git a/_docs/_user_guide/message_building_by_channel/line/create.md b/_docs/_user_guide/message_building_by_channel/line/create.md index 90ba18d14f9..b7ed39d9c1e 100644 --- a/_docs/_user_guide/message_building_by_channel/line/create.md +++ b/_docs/_user_guide/message_building_by_channel/line/create.md @@ -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.

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 @@ -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 @@ -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. @@ -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!". diff --git a/_docs/_user_guide/message_building_by_channel/line/create/message_types.md b/_docs/_user_guide/message_building_by_channel/line/create/message_types.md index 80c2a8e044e..cbd69a87896 100644 --- a/_docs/_user_guide/message_building_by_channel/line/create/message_types.md +++ b/_docs/_user_guide/message_building_by_channel/line/create/message_types.md @@ -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. diff --git a/_docs/_user_guide/message_building_by_channel/line/line_setup.md b/_docs/_user_guide/message_building_by_channel/line/line_setup.md index e9786a2663f..81a8a68b5ce 100644 --- a/_docs/_user_guide/message_building_by_channel/line/line_setup.md +++ b/_docs/_user_guide/message_building_by_channel/line/line_setup.md @@ -7,29 +7,26 @@ 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 | @@ -37,7 +34,7 @@ You'll need the following to integrate LINE with Braze: | 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.

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 @@ -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: @@ -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). @@ -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`. @@ -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 @@ -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 @@ -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`.

Any follower of the LINE channel that doesn't have a Braze user profile with the `native_line_id` will have:
- An anonymous user profile created with `native_line_id` set to the user LINE ID following the channel
- A user alias `line_id` set to the user LINE ID following the channel
- 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.

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:

- An anonymous user profile created with `native_line_id` set to the user LINE ID following the channel
- A user alias `line_id` set to the user LINE ID following the channel
- 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`.

- All Braze user profiles with a matching `native_line_id` will be automatically updated.
- 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`.

- All Braze user profiles with a matching `native_line_id` will be automatically updated.
- 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`. diff --git a/_docs/_user_guide/message_building_by_channel/line/line_users.md b/_docs/_user_guide/message_building_by_channel/line/line_users.md index 3f49525fee6..fd64c7831bd 100644 --- a/_docs/_user_guide/message_building_by_channel/line/line_users.md +++ b/_docs/_user_guide/message_building_by_channel/line/line_users.md @@ -4,5 +4,4 @@ config_only: true noindex: true layout: blank_config page_order: 4 -hidden: true --- diff --git a/_docs/_user_guide/message_building_by_channel/line/line_users/subscription_groups.md b/_docs/_user_guide/message_building_by_channel/line/line_users/subscription_groups.md index 0d252e34468..8c4798ca961 100644 --- a/_docs/_user_guide/message_building_by_channel/line/line_users/subscription_groups.md +++ b/_docs/_user_guide/message_building_by_channel/line/line_users/subscription_groups.md @@ -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.

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 | | --- | --- | diff --git a/_docs/_user_guide/message_building_by_channel/line/line_users/user_management.md b/_docs/_user_guide/message_building_by_channel/line/line_users/user_management.md index c0653dd9b9b..169beaa37a8 100644 --- a/_docs/_user_guide/message_building_by_channel/line/line_users/user_management.md +++ b/_docs/_user_guide/message_building_by_channel/line/line_users/user_management.md @@ -6,13 +6,12 @@ description: "This article covers the LINE user ID and how to set it." page_type: reference channel: - LINE -hidden: true -permalink: /line/user_management/ +alias: /line/user_management/ --- # LINE user management -> The LINE user ID is stored on the user profile attribute called `native_line_id`. This identifier is used to send messages on a user on the LINE channel. This article covers the `native_line_id` attribute and is part of the LINE beta collection. [Return to the main page](https://www.braze.com/docs/line/). +> The LINE user ID is stored on the user profile attribute called `native_line_id`, which is used to send messages to a user on the LINE channel. This article covers how to set and find the `native_line_id` attribute. Customer user data is represented in a [Braze user profile]({{site.baseurl}}/user_guide/data_and_analytics/user_data_collection/user_profile_lifecycle/). A user profile stores information and attributes about a company’s users, such as first names and email addresses. diff --git a/_docs/_user_guide/message_building_by_channel/line/messaging_users.md b/_docs/_user_guide/message_building_by_channel/line/messaging_users.md index 81b96fa3a97..4cbe6d6b6d2 100644 --- a/_docs/_user_guide/message_building_by_channel/line/messaging_users.md +++ b/_docs/_user_guide/message_building_by_channel/line/messaging_users.md @@ -6,20 +6,15 @@ description: "This reference article covers how chat with users by using templat page_type: reference channel: - LINE -hidden: true -permalink: /line/messaging_users/ +alias: /line/messaging_users/ --- # Messaging LINE users -> LINE is a two-way communication channel. You can go beyond sending users messages and engage in conversations with users by using templated campaigns and Canvases.

This article is part of the LINE beta collection. [Return to the main page](https://www.braze.com/docs/line/). +> LINE is a two-way communication channel. You can go beyond sending users messages and engage in conversations with users by using templated campaigns and Canvases. This article covers the details of messaging users, such as how to set trigger words for inbound messages and unrecognized responses. There are various methods to converse with users through LINE, such as using LINE trigger words. You can also use calls-to-action (CTAs) to encourage user engagement with your LINE messaging. -{% 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 %} - ## Action-based triggers You can create campaigns and Canvases that start, branch, and have mid-journey changes when you receive an inbound LINE message (a message sent from a user) that contains a trigger word. Make sure you choose trigger words that match what you expect users to send. diff --git a/_docs/_user_guide/message_building_by_channel/line/reporting.md b/_docs/_user_guide/message_building_by_channel/line/reporting.md index 2a11e779ceb..2c94550b596 100644 --- a/_docs/_user_guide/message_building_by_channel/line/reporting.md +++ b/_docs/_user_guide/message_building_by_channel/line/reporting.md @@ -12,7 +12,7 @@ permalink: /line/reporting/ # LINE reporting -> After launching your campaign or Canvas, you can view key metrics on the campaign details page or Canvas analytics.

This article is part of the LINE beta collection. [Return to the main page](https://www.braze.com/docs/line/). +> After launching your campaign or Canvas, you can view key metrics on the campaign details page or Canvas analytics. This article covers where you can find those metrics and what they represent. {% alert tip %} Looking for definitions for the terms and metrics in your report? Refer to [Report metrics glossary]({{site.baseurl}}/user_guide/data_and_analytics/report_metrics/). @@ -49,6 +49,7 @@ If you want to simplify your view, select **+ Add/Remove Columns** and clear any Here are some key LINE metrics you may see in your analytics. To see the definitions of all LINE metrics used in Braze, refer to [Report metrics glossary]({{site.baseurl}}/user_guide/data_and_analytics/report_metrics/). | Term | Definition | +| --- | --- | | Sends | The total number of sends successfully communicated between Braze and LINE. This does not mean the message was received by the user. | | Unique Opens | The total number of LINE messages sent that were opened by users after a minimum threshold of 20 messages per day has been reached. | | Total Opens | The total number of times that the LINE messages sent were opened by users after a minimum threshold of 20 messages per day has been reached. | @@ -70,9 +71,5 @@ The **Conversion Event Details** panel shows you the performance of your convers The **Conversion Correlation** panel gives you insight into what user attributes and behaviors help or hurt the outcomes you set for campaigns. For more information, refer to [Conversion correlation]({{site.baseurl}}/user_guide/engagement_tools/testing/conversion_correlation). -## LINE user IDs - -LINE user IDs are specific to each user per provider. Users are unlikely to know their LINE ID (unlike their email or phone number), as their LINE ID changes for each brand they follow. - [1]: {% image_buster /assets/img/line/line_performance.png %} \ No newline at end of file diff --git a/assets/img/line/line_composer.png b/assets/img/line/line_composer.png index 3a9a2f82c3b..2cc404224c2 100644 Binary files a/assets/img/line/line_composer.png and b/assets/img/line/line_composer.png differ diff --git a/assets/img/line/test_preview.png b/assets/img/line/test_preview.png index 8b5c74e5f72..38b7a03cc96 100644 Binary files a/assets/img/line/test_preview.png and b/assets/img/line/test_preview.png differ diff --git a/assets/img/line/webhook_settings.png b/assets/img/line/webhook_settings.png index 287c6a6f6b4..cb936220d28 100644 Binary files a/assets/img/line/webhook_settings.png and b/assets/img/line/webhook_settings.png differ