{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"Engage Studio","type":"markdown"},"seo":{"title":"Event Tracking for LINE Campaigns in Engage Studio","description":"Understand what LINE Webhook events can be collected via Streaming Ingress, why per-user open and click data is unavailable, and how to use LINE OA Insights for aggregate campaign stats.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"event-tracking-for-line-campaigns","__idx":0},"children":["Event Tracking for LINE Campaigns"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page explains what user interaction data is available from LINE, the technical constraints of LINE's Webhook API, and how Engage Studio combines multiple data sources to provide campaign reporting."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-line-webhook-can-and-cannot-collect","__idx":1},"children":["What LINE Webhook Can and Cannot Collect"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LINE's Messaging API Webhook delivers events to Treasure Data via the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Streaming Ingress Connector (LINE Messaging API Webhook)"]},". However, LINE does not include per-user open or click events in Webhook payloads by design."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"events-available-via-webhook","__idx":2},"children":["Events Available via Webhook"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following events are delivered in real time and can be stored in Treasure Data CDP:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Event Type"},"children":["Event Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["follow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User followed the LINE Official Account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unfollow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User unfollowed or blocked the LINE Official Account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User sent a message to the LINE Official Account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postback"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User tapped a postback action button (Flex or Template messages)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["videoViewingComplete"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User finished watching a video message (1-on-1 only)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beacon"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User entered a beacon-equipped physical location"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountLink"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["User linked their account via the account link feature"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-is-not-available","__idx":3},"children":["What Is Not Available"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LINE does not expose the following events through its Webhook or Messaging API:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Message opens"]}," — Whether an individual user opened a delivered message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Link clicks"]}," — Whether an individual user clicked a URL in a Text or Imagemap message"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Read receipts"]}," — Per-user read status"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These limitations are by design in LINE's platform. Per-user engagement data of this type is not provided through any LINE API endpoint."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Aggregate stats via LINE OA Insights"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While per-user open and click events are unavailable, LINE provides ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["aggregate statistics per broadcast"]}," (total opens, total clicks, etc.) through its Insights API. Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/line-oa-insights-import-integration"},"children":["LINE OA Insights Import Integration"]}," to import these aggregate metrics into Treasure Data. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/line/line-oa-reporting"},"children":["LINE Campaign Reporting"]}," for details."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"utm-tracking","__idx":4},"children":["UTM Tracking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Despite the limitations above, you can measure link-level engagement by appending ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["UTM parameters"]}," to all URLs in your LINE messages. When recipients tap a link and load the destination page, the UTM parameters are captured by your web analytics platform (e.g., Google Analytics), giving you URL-level traffic attribution per campaign."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-utm-parameters-are-applied","__idx":5},"children":["How UTM Parameters Are Applied"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["UTM parameters configured on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["UTM Tracking"]}," tab are automatically appended to every URL in the campaign messages at delivery time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Default UTM parameters for LINE campaigns:"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default Value"},"children":["Default Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_medium"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["social"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_campaign"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Campaign name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_content"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(optional, configurable per campaign)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["utm_term"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(optional, configurable per campaign)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"url-merge-policy","__idx":6},"children":["URL Merge Policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a URL already contains query parameters, UTM parameters are appended without overwriting existing values unless the same key already exists, in which case the campaign-level value takes precedence."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Original URL in Imagemap tap area:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://example.com/product?ref=banner\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delivered URL after UTM injection:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://example.com/product?ref=banner&utm_source=line&utm_medium=social&utm_campaign=spring_sale_2026\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scope-of-utm-application","__idx":7},"children":["Scope of UTM Application"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Message Type"},"children":["Message Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"UTM Applied To"},"children":["UTM Applied To"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Text (v2)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All URLs in the text body"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Imagemap"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uri"]}," action URLs in tap areas"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Flex Message (future)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All action button URLs"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"delivery-log-schema","__idx":8},"children":["Delivery Log Schema"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Delivery and error events are written at send time to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery_line_{system_identifier}"]}," database. This log records per-profile delivery outcomes (success or failure) but does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," include open or click events, as these are not available from LINE."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Column"},"children":["Column"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["event"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivery"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unix timestamp of the event"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["channel_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LINE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["campaign_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Engage Studio campaign ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line_channel_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LINE Sender Account name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line_user_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient LINE User ID (hashed)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Message object type: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["textV2"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["imagemap"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["success"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["LINE API error code (error events only)"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"constraints-and-considerations","__idx":9},"children":["Constraints and Considerations"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"external-redirects-and-url-shorteners","__idx":10},"children":["External Redirects and URL Shorteners"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you use a URL shortener or intermediate redirect:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["UTM parameters are appended to the URL before delivery."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the redirect strips query parameters, UTM data will not reach your analytics platform. Verify your redirect configuration preserves query parameters."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"line-privacy-policy","__idx":11},"children":["LINE Privacy Policy"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["LINE's platform design intentionally restricts per-user behavioral data (opens, clicks) from being accessible to LINE Official Account operators. This applies regardless of account tier or API plan."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition, LINE's development guidelines explicitly prohibit the following:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not attempt to identify the attributes of specific users by their user ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not use the audience management API or send narrowcast messages for the purpose of identifying user attributes."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Refer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://developers.line.biz/en/docs/messaging-api/development-guidelines/#prohibiting-identify-users-attribute"},"children":["LINE Messaging API development guidelines"]}," for current policies."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-documentation","__idx":12},"children":["Related Documentation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/line/line-oa-reporting"},"children":["LINE Campaign Reporting"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/line/line-oa-campaigns"},"children":["Create a One-off LINE Campaign"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/marketing-cloud/engage-studio/channels/line/line-oa-message-types"},"children":["LINE Message Types"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/int/line-oa-insights-import-integration"},"children":["LINE OA Insights Import Integration"]}]}]}]},"headings":[{"value":"Event Tracking for LINE Campaigns","id":"event-tracking-for-line-campaigns","depth":1},{"value":"What LINE Webhook Can and Cannot Collect","id":"what-line-webhook-can-and-cannot-collect","depth":2},{"value":"Events Available via Webhook","id":"events-available-via-webhook","depth":3},{"value":"What Is Not Available","id":"what-is-not-available","depth":3},{"value":"UTM Tracking","id":"utm-tracking","depth":2},{"value":"How UTM Parameters Are Applied","id":"how-utm-parameters-are-applied","depth":3},{"value":"URL Merge Policy","id":"url-merge-policy","depth":3},{"value":"Scope of UTM Application","id":"scope-of-utm-application","depth":3},{"value":"Delivery Log Schema","id":"delivery-log-schema","depth":2},{"value":"Constraints and Considerations","id":"constraints-and-considerations","depth":2},{"value":"External Redirects and URL Shorteners","id":"external-redirects-and-url-shorteners","depth":3},{"value":"LINE Privacy Policy","id":"line-privacy-policy","depth":3},{"value":"Related Documentation","id":"related-documentation","depth":2}],"frontmatter":{"seo":{"title":"Event Tracking for LINE Campaigns in Engage Studio","description":"Understand what LINE Webhook events can be collected via Streaming Ingress, why per-user open and click data is unavailable, and how to use LINE OA Insights for aggregate campaign stats."}},"lastModified":"2026-03-11T17:17:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/marketing-cloud/engage-studio/channels/line/line-oa-click-tracking","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}