香港電商品牌 Klaviyo 入門教學：從 Shopify 匯入名單到第一封自動化郵件

想在 Shopify 上跑 Klaviyo，最短路徑是：安裝官方整合、確認訂閱同意狀態正確匯入、驗證寄件網域，然後建立一條歡迎流程（Welcome Flow）。整個過程約 2 至 3 小時，難點不在介面操作，而在同意記錄與寄件信譽。

這篇教學以香港、台灣、新加坡的跨境電商情境為主軸——多數 APAC 品牌同時面對本地客戶與歐美市場買家，同意管理與寄件設定必須一次做對，否則後續補救成本遠高於初期設定。

開始前：你需要準備什麼

動手前先把以下項目備齊，可以省下大量來回：

1. Shopify 管理員權限（Store owner 或具備 Apps 安裝權限的 staff account）。Shopify Basic 以上方案皆可，不需要 Plus。
2. Klaviyo 帳號，並確認你的帳號區域。Klaviyo 目前提供 US 與 EU 資料托管選項，選定後無法自行遷移，跨境品牌若主要客戶在歐盟，應在開帳號時就選 EU。
3. 網域 DNS 管理權限（Cloudflare、GoDaddy、阿里雲或企業 IT）。你需要新增 CNAME 與 TXT 記錄。
4. 既有名單的來源清單：舊 EDM 平台（Mailchimp、Omnisend、SHOPLINE 內建）、實體門市收集的紙本表單、WhatsApp Business 名單、活動報名表。每一份都要能回答一個問題：這些人什麼時候、用什麼措辭同意接收行銷訊息？
5. 一個實際存在的實體地址。這不是選填欄位——香港《非應邀電子訊息條例》（Cap 593）要求商業電子訊息必須包含準確的寄件人資訊與退訂機制，OFCA 為執法機關。美國 CAN-SPAM 與歐盟規範亦有類似要求。

先確認一件事：你的名單是否「可以」匯入

根據香港個人資料私隱專員公署（PCPD）對《個人資料（私隱）條例》第 VIA 部的說明，機構在首次使用個人資料作直接促銷前，必須通知資料當事人並取得其同意；違反相關條文屬刑事罪行，最高可判罰款港幣 500,000 元及監禁 3 年。新加坡方面，PDPC 規定發送指定訊息前需檢查 Do Not Call Registry（電郵訊息的規範與電話/簡訊不同，但同意原則一致）。

實務建議：把名單分成三堆——有明確同意記錄（可匯入為 subscribed）、有交易關係但無明確行銷同意（匯入但先不發送，或先跑再確認流程）、來源不明（不要匯入）。第三堆丟進 Klaviyo 造成的退信與投訴，會拖垮整個網域的信譽，而信譽是全站共用的。

Klaviyo 與 Shopify 的整合實際上同步了什麼

很多人以為整合只是「同步 email 名單」，其實不是。根據 Klaviyo 官方文件，Shopify 整合會建立雙向資料流：

• Profiles（客戶檔案）：email、電話、地址、接受行銷的狀態、Shopify customer tags。
• 歷史訂單資料回補：安裝時 Klaviyo 會拉取既有訂單記錄，用以建立 Placed Order、Ordered Product 等 metrics，這是計算「歷史購買次數」「客戶生命週期價值」的基礎。
• 即時事件（webhooks）：Checkout Started、Placed Order、Fulfilled Order、Cancelled Order、Refunded Order。
• Catalog（商品目錄）：讓你在郵件中插入動態商品區塊。
• onsite tracking：透過 Klaviyo 的 JavaScript（klaviyo.js）追蹤 Active on Site、Viewed Product、Added to Cart。

沒有 onsite tracking，你就跑不了「瀏覽未購買」與「加入購物車未結帳」這兩條回報最直接的流程。Shopify 的新版整合會自動注入指令碼，但如果你用的是高度客製的 Hydrogen headless 前端，就需要手動處理（後面會講）。

步驟一：安裝整合並設定同步規則

1. 在 Klaviyo 後台左下角點 Integrations → Add integrations → Shopify。
2. 輸入你的 .myshopify.com 網域，授權安裝。
3. 在設定畫面上，你會看到三個關鍵開關：

Enable onsite tracking — 開啟。這會在你的 theme 中加入 Klaviyo 的追蹤指令碼。

Sync your Shopify subscribers — 開啟，但注意它只會把 Shopify 中 accepts_marketing = true 的客戶同步為 Klaviyo 的 subscribed 狀態。Shopify 中未勾選接受行銷的客戶會以 profile 形式存在（可用於交易郵件與分析），但不會收到行銷 campaign。這個行為是對的，不要試圖繞過。

Sync Klaviyo unsubscribes back to Shopify — 開啟。雙向同步能避免「客戶在 Klaviyo 退訂但 Shopify 仍顯示已訂閱」的資料不一致，這在被投訴時是重要的合規證據。

驗證整合是否真的通了

安裝完等 10 到 30 分鐘（歷史訂單量大的商店可能要數小時），然後檢查：

• Analytics → Metrics：應該看到 Placed Order、Checkout Started、Fulfilled Order 等指標，且有歷史資料點。
• Profiles：隨機打開一個舊客戶，右側 Activity Feed 應顯示歷史訂單。
• 前端驗證：在你的商店首頁開瀏覽器 console，執行：

1// 確認 Klaviyo 物件已載入
2console.log(typeof klaviyo);
3// 預期輸出："object"
4
5// 確認 public API key 正確
6klaviyo.identify({ email: '[email protected]' })
7  .then(() => console.log('identify OK'));

如果 typeof klaviyo 回傳 "undefined"，代表指令碼沒被注入。在 Shopify theme 的 layout/theme.liquid 中，於 </head> 前手動加入：

1<script async type="text/javascript"
2  src="https://static.klaviyo.com/onsite/js/klaviyo.js?company_id=YOUR_PUBLIC_API_KEY">
3</script>

YOUR_PUBLIC_API_KEY 是 Klaviyo 的 6 碼 site ID，在 Settings → API keys 找得到。注意 public key 可公開，private key（pk_ 開頭）絕對不能出現在前端程式碼中。

步驟二：匯入舊平台名單而不破壞同意記錄

Shopify 客戶會自動同步，但你從 Mailchimp、SHOPLINE 或 Excel 帶過來的名單需要手動處理。Klaviyo 支援 CSV 匯入，關鍵在欄位命名。

建議的 CSV 格式：

1email,first_name,last_name,phone_number,country,consent_source,consent_timestamp,Email Marketing Consent
2[email protected],Ka Ming,Chan,+85298765432,HK,popup_2024_q3,2024-08-14T09:22:11Z,subscribed
3[email protected],Wei,Lim,+6598765432,SG,instore_form,2025-01-30T04:10:00Z,subscribed

幾個要點：

• phone_number 必須是 E.164 格式（含國碼、無空格、無連字號）。香港號碼是 +852，台灣 +886 且要去掉開頭的 0，新加坡 +65。格式錯誤的號碼會被拒收，之後要跑 SMS 就得重做。
• consent_source 與 consent_timestamp 是你自訂的 custom properties。它們不影響 Klaviyo 運作，但在有人質疑「你為什麼有我的 email」時，這兩個欄位就是你的答案。跨境品牌尤其需要——GDPR 下的責任是舉證責任在企業方。
• 匯入時 Klaviyo 會問你要不要把這批人設為 subscribed。只有在你能對每一筆都回答「同意來源是什麼」時才勾選。

匯入後立刻做的事

對超過 12 個月沒有開信或購買的舊名單，不要直接混進主流程。做法是建立一個 Sunset Segment，先單獨發一封重新確認郵件，只把有互動的人放回主池。這一步會讓你的名單數字變難看，但保住的是送達率。

步驟三：驗證寄件網域（這一步不能跳過）

2024 年 2 月起，Google 與 Yahoo 對批量寄件者實施新規。根據 Google Workspace 管理說明，每日向 Gmail 帳戶發送 5,000 封以上郵件的寄件者必須：設定 SPF 與 DKIM、為寄件網域設定 DMARC 記錄、提供一鍵退訂（List-Unsubscribe header），並將垃圾郵件投訴率維持在 0.3% 以下（Google 建議目標為 0.1% 以下）。

Klaviyo 的做法是要你設定一個專用寄件子網域（dedicated sending domain）。在 Settings → Domains and hosting 中新增，Klaviyo 會產生一組 CNAME 記錄，形式類似：

1# 在你的 DNS 供應商新增（實際值以 Klaviyo 後台顯示為準）
2klaviyo1._domainkey.send.yourbrand.com   CNAME   dkim1.klaviyomail.com
3klaviyo2._domainkey.send.yourbrand.com   CNAME   dkim2.klaviyomail.com
4send.yourbrand.com                        CNAME   sendingdomain.klaviyomail.com

DMARC 記錄則加在主網域上，起步時用寬鬆政策觀察報告：

1_dmarc.yourbrand.com   TXT   "v=DMARC1; p=none; rua=mailto:[email protected]; fo=1"

觀察兩到四週、確認所有合法寄件來源（Klaviyo、Shopify 交易郵件、Google Workspace、客服系統）都通過驗證後，再逐步收緊到 p=quarantine，最後 p=reject。直接跳到 p=reject 而漏掉某個寄件來源，會讓你的訂單確認信全部被丟掉——這是我們在協助品牌做郵件基礎設定時最常見的自傷。

用 CLI 驗證 DNS 是否生效：

1# 檢查 DKIM CNAME
2dig +short klaviyo1._domainkey.send.yourbrand.com CNAME
3# 預期輸出：dkim1.klaviyomail.com.
4
5# 檢查 DMARC
6dig +short _dmarc.yourbrand.com TXT
7# 預期輸出："v=DMARC1; p=none; rua=mailto:..."

DNS 傳播通常 15 分鐘到 48 小時。回到 Klaviyo 後台按 Verify，狀態轉綠即完成。

亞太品牌的額外考量

如果你的客戶大量使用中國內地郵箱（QQ、163、126）或日本的 docomo/au 網域，這些收件方的規則與 Gmail 不同，需要更長的 warm-up 期。實務上建議前兩週每天發送量控制在名單的 10% 左右、優先發給最近 30 天有互動的人，讓收件方逐步建立對新子網域的信任。

步驟四：建立第一個有意義的 Segment

不要用「所有訂閱者」發第一封信。建立一個高互動 segment 作為暖機對象：

Segment 名稱：Engaged 90 Days

條件設定（Klaviyo 的 segment builder 用 AND / OR 組合）：

1. Person can receive email marketing is true
2. AND Opened Email at least once in the last 90 days
3. OR Placed Order at least once in the last 180 days

給跨境品牌的補充：如果你同時經營香港與東南亞市場，加一層地區條件會讓時區排程與語言版本更好處理：

4. AND Location / Country equals Hong Kong or Singapore or Taiwan

Klaviyo 的 segment 是動態的——條件符合時人員自動進出，不需要手動維護。這與傳統 list 的差別，是你設計自動化時的核心心智模型。

步驟五：建立第一封自動化郵件（Welcome Flow）

選 Welcome Flow 作為起點，原因是觸發邏輯最單純、內容最容易寫、而且訂閱後幾分鐘內的開信意願最高。

建立流程

1. Flows → Create Flow → Create from scratch。
2. Trigger 選 List → 選擇你的 newsletter list（Klaviyo 的 sign-up form 預設會寫入這個 list）。
3. 加入第一個 Time Delay：設 0 hours（即時發送）或 15 minutes。若你有提供折扣碼，即時發送較好；若是內容型品牌，15 分鐘的延遲能避開與 Shopify 帳號建立通知撞在一起。
4. 拖入 Email 節點。

郵件內容的最低要求

第一封歡迎信該做三件事：確認訂閱、說明你會發什麼與多久發一次、給一個立即可用的行動。

在 template 中用 Klaviyo 的 template language 做個人化，注意一定要設 fallback：

1<p>
2  {% if person.first_name %}
3    {{ person.first_name }} 你好，
4  {% else %}
5    你好，
6  {% endif %}
7</p>
8
9<p>多謝訂閱。我們每兩星期發一次新品與選物筆記，不會賣你的資料，隨時可以退訂。</p>
10
11{% if person.country == 'Hong Kong' %}
12  <p>香港訂單滿 HK$500 免運，順豐站取件。</p>
13{% elsif person.country == 'Singapore' %}
14  <p>Free local delivery on Singapore orders above S$80.</p>
15{% endif %}

這種條件式區塊，讓你用一封郵件覆蓋多個市場，而不需要為每個市場複製整條流程。對只有一兩個人負責 CRM 的亞太團隊來說，維護成本差異很大。

頁尾與退訂

Klaviyo 的預設 footer 已包含 {% unsubscribe %} 標籤與 {{ organization.name }}、{{ organization.full_address }}。不要刪掉它們。Cap 593 要求商業電子訊息提供有效的取消接收選項與正確的寄件人資訊，這不是設計問題。

發送前的檢查清單

1. 用 Preview → Send test email 發給至少三個不同的收件方（Gmail、Outlook、一個公司網域）。
2. 檢查暗色模式下 logo 是否消失（透明背景 PNG 在暗色模式常常變成黑底黑字）。
3. 手機預覽——多數亞太市場的開信裝置以手機為主，單欄版面比較安全。
4. 檢查所有連結是否帶 UTM 參數。Klaviyo 可在 Settings → UTM tracking 全域自動加上。
5. Flow 狀態從 Draft 改為 Live。這一步常被漏掉，然後困惑為什麼沒有人收到信。

驗證流程真的在跑

用一個測試 email 走一次完整的前台訂閱動作（不要用後台手動加人，那不一定會觸發 list trigger）。回到 Flow 頁面，Recipients 數字應在幾分鐘內 +1。

步驟六：用 API 補上 Shopify 以外的資料

如果你有 POS、會員系統或 headless 前端，官方整合覆蓋不到的部分要靠 API。Klaviyo 目前的 API 版本以日期標示（revision header），呼叫時必須指定。

訂閱一個 profile 到指定 list（後端呼叫，使用 private key）：

1curl -X POST 'https://a.klaviyo.com/api/profile-subscription-bulk-create-jobs' \
2  -H 'Authorization: Klaviyo-API-Key pk_xxxxxxxxxxxxxxxx' \
3  -H 'revision: 2024-10-15' \
4  -H 'Content-Type: application/json' \
5  -d '{
6    "data": {
7      "type": "profile-subscription-bulk-create-job",
8      "attributes": {
9        "profiles": {
10          "data": [{
11            "type": "profile",
12            "attributes": {
13              "email": "[email protected]",
14              "subscriptions": {
15                "email": { "marketing": { "consent": "SUBSCRIBED" } }
16              }
17            }
18          }]
19        }
20      },
21      "relationships": {
22        "list": { "data": { "type": "list", "id": "YOUR_LIST_ID" } }
23      }
24    }
25  }'

成功會回 202 Accepted（非同步處理，不會立即在介面看到結果）。

在 headless（Hydrogen / Next.js）前端追蹤 Viewed Product：

1// 用 client-side public key，不要在前端放 private key
2window.klaviyo = window.klaviyo || [];
3window.klaviyo.push(['track', 'Viewed Product', {
4  ProductName: product.title,
5  ProductID: product.id,
6  SKU: product.variants[0].sku,
7  Categories: product.collections.map(c => c.title),
8  ImageURL: product.featuredImage.url,
9  URL: `https://yourbrand.com/products/${product.handle}`,
10  Price: parseFloat(product.priceRange.minVariantPrice.amount),
11  CompareAtPrice: parseFloat(product.compareAtPriceRange.minVariantPrice.amount)
12}]);

屬性名稱要與 Klaviyo 的 browse abandonment 範本預期一致，否則動態商品區塊會抓不到圖。

常見問題排查

客戶已在 Shopify 訂閱，Klaviyo 卻顯示 unsubscribed

最常見原因是雙向同步下，Klaviyo 端的退訂狀態覆蓋了 Shopify。檢查該 profile 的 Activity Feed 有無 Unsubscribed 事件與時間戳。若確實退訂過，不要手動改回——這正是系統該有的行為。

歷史訂單沒有出現

檢查 Klaviyo 的 Shopify 整合頁面是否顯示錯誤。常見情況是 Shopify app 權限在店鋪轉移或方案變更後失效，需要 disconnect 再重新授權。重新授權不會刪除既有資料。

Flow 顯示 Live，但收件人數是 0

依序檢查三件事：（1）trigger 的 list 是否就是表單實際寫入的 list；（2）Flow filter 中是否有 has not been in this flow in the last X days 之類的限制；（3）Smart Sending 是否把人擋掉了——Klaviyo 預設在 16 小時內不會對同一人重複發送，測試時可暫時關閉。

郵件進了 Gmail 促銷分頁

促銷分頁不等於垃圾郵件。除非開信率明顯異常，否則不必為此改寫內容。真正該盯的是 Klaviyo Deliverability 報表中的 spam complaint rate，依 Google 的批量寄件者規範應維持在 0.3% 以下。

中文郵件在部分客戶端亂碼

確認 template 使用 UTF-8，並避免在主旨行放過多 emoji——部分企業郵件閘道會因此提高評分。繁體與簡體版本建議用 Klaviyo 的 conditional block 依 person.country 或自訂 language 屬性切換，而非開兩條平行 flow。

把 AI 用在對的地方

Klaviyo 內建的生成功能可以寫主旨行與郵件初稿，但真正省時間的用法是把 LLM 放在流程前的資料整理：把三份格式不一致的舊名單正規化成統一 CSV、把商品描述批次改寫成郵件用的短文案、把 90 天的 flow 表現整理成可讀的檢討摘要。

我們協助一家在香港與台灣同時經營的多品牌服飾零售商做 Shopify 遷移時，就把「舊平台匯出檔的欄位對映」交給指令碼加 LLM 輔助審核，人只負責判斷同意狀態這個無法自動化的部分。原則很簡單：格式轉換可以自動化，法律判斷不行。

對跨時區營運的品牌，這種分工還有另一個好處——資料整理可以在亞洲工作時段完成，歐美市場團隊早上上班時直接審核結果。

上線後 30 天的推進順序

1. 第 1 週：Welcome Flow 上線，觀察送達率與投訴率。
2. 第 2 週：加入 Abandoned Checkout Flow（觸發 Checkout Started，通常設 4 小時、24 小時、48 小時三封）。
3. 第 3 週：加入 Browse Abandonment（需要 onsite tracking 正常運作）。
4. 第 4 週：加入 Post-Purchase Flow，分「首次購買」與「回購」兩個分支。

這個順序的邏輯是由觸發訊號強度排序——結帳中斷的購買意圖高於瀏覽，瀏覽高於單純訂閱。先做訊號強的，回報最快，也讓你在投入更複雜的分眾之前先累積乾淨的行為資料。

Branch8 總部設於香港，在新加坡、台灣、越南、馬來西亞、印尼、菲律賓與澳洲設有交付團隊，協助 APAC 與歐美品牌處理 Shopify Plus、Adobe Commerce 與 SHOPLINE 的建置、遷移與 CRM 自動化整合。如果你的名單分散在多個平台、或需要在多個市場同時處理同意管理與送達率問題，歡迎與我們談談你的實際情況。

Sources

• Klaviyo — Help Center
• Klaviyo — Developer Documentation
• Shopify — Help Center
• Google Workspace Admin Help — Email sender guidelines
• Office of the Privacy Commissioner for Personal Data, Hong Kong — Direct Marketing
• Office of the Communications Authority, Hong Kong — Unsolicited Electronic Messages Ordinance
• Personal Data Protection Commission Singapore — PDPA
• DMARC.org — DMARC Overview