#Tích hợp Adobe Analytics, Adobe Target và Adobe Launch với AEM 6.5 On-Premise

Adobe Analytics, Adobe Target và Adobe Launch thường xuất hiện cùng nhau trong một dự án AEM, nhưng chúng không phải là ba phiên bản của cùng một sản phẩm:

• Adobe Analytics thu thập và phân tích hành vi: page view, search, booking start, booking complete, doanh thu.
• Adobe Target phân phối trải nghiệm cá nhân hóa và chạy A/B test hoặc multivariate test.
• Adobe Launch, tên hiện tại là Adobe Experience Platform Tags, quản lý data element, rule, extension và việc load các thư viện marketing trên trình duyệt.

Trong AEM 6.5 on-premise, AEM vẫn chịu trách nhiệm render nội dung và quản lý author/publish. Các dịch vụ Analytics, Target và Tags chạy trong Adobe Experience Cloud. Vì vậy tích hợp thường là một hệ thống hybrid: AEM cấu hình và render context, còn browser gửi dữ liệu hoặc nhận trải nghiệm từ Adobe.

#1. Bức tranh kiến trúc

Một request page thường có các bước:

1. AEM Publish render HTML và data layer cho trang.
2. Browser tải embed code của Tags theo environment tương ứng.
3. Tags chạy các rule, gửi event tới Analytics và gọi Target nếu trang có activity.
4. Target trả experience hoặc offer; Analytics ghi nhận impression, interaction và conversion.

Launch không thay thế Analytics hoặc Target. Nó là lớp orchestration phía client giúp triển khai hai dịch vụ này cùng những extension khác mà không phải sửa HTL cho mỗi thay đổi tracking.

#2. Phân biệt trách nhiệm

Một nguyên tắc quan trọng: không hardcode secret hoặc credential vào HTL, JavaScript hay clientlib. Tracking ID, report suite, property và environment ID có thể là configuration; client-side code vẫn luôn có thể được người dùng nhìn thấy.

#3. Điều kiện trước khi tích hợp

#3.1. Kiểm tra phiên bản AEM và Service Pack

AEM 6.5 on-premise nhận nhiều cải tiến tích hợp qua Service Pack. Trước khi triển khai cần xác nhận:

• AEM 6.5 và Service Pack đang chạy;
• phiên bản Core Components và clientlibs;
• browser support matrix;
• phiên bản extension hoặc SDK mà tổ chức được Adobe hỗ trợ;
• license và quyền truy cập Adobe Analytics, Target, Tags.

Không nên sao chép cấu hình từ AEM as a Cloud Service vào AEM 6.5 on-premise mà không kiểm tra. Hai mô hình có thể khác nhau ở IMS, pipeline, deployment và cách quản lý cloud configuration.

#3.2. Xác định hostname và môi trường

Tối thiểu nên có các môi trường:

Không dùng embed code Production trên author hoặc staging. Điều đó dễ làm dữ liệu test lọt vào report suite production và khiến Target activity chạy ngoài ý muốn.

#3.3. Quyết định data layer và consent

Trước khi tạo rule trong Tags, cần thống nhất schema dữ liệu:

<script type="application/ld+json" data-site-data="analytics">
  {
    "page": {
      "name": "rooms/deluxe",
      "type": "room-detail",
      "language": "vi-VN"
    },
    "hotel": {
      "code": "hotel-da-nang",
      "roomType": "deluxe"
    }
  }
</script>

Ví dụ trên chỉ minh họa dữ liệu ứng dụng; schema thực tế cần theo chuẩn data layer của dự án. Không nhúng tên, email, số điện thoại, mã đặt phòng hoặc dữ liệu cá nhân trực tiếp vào Analytics/Target nếu chưa có quy trình privacy phù hợp.

Consent phải được xác định trước khi fire marketing tags:

• người dùng chưa đồng ý thì không gửi event không cần thiết;
• trạng thái consent cần có sẵn trước khi Tags chạy rule page view;
• preference center và cơ chế thu hồi consent phải được hỗ trợ;
• privacy policy cần mô tả các vendor, cookie và mục đích xử lý dữ liệu.

#4. Tích hợp Adobe Launch (Tags)

#4.1. Tags làm gì trong AEM?

Tags cung cấp một property cho website. Trong property đó, team cấu hình:

• Extensions: Adobe Analytics, Adobe Target, consent platform và các extension khác;
• Data elements: đọc giá trị từ data layer, DOM, cookie hoặc URL;
• Rules: điều kiện và hành động khi page load, click hoặc custom event xảy ra;
• Libraries: build theo Development, Staging hoặc Production;
• Environments: tạo embed code khác nhau cho từng môi trường.

Thay vì nhúng riêng nhiều script vào từng component AEM, nên để page shell hoặc template include một embed code duy nhất của Tags. Các component chỉ phát event hoặc đẩy dữ liệu vào data layer.

#4.2. Cấu hình phía AEM 6.5

Tùy Service Pack và cách tổ chức dự án, có thể dùng Adobe Launch Cloud Service configuration trong AEM hoặc quản lý embed code qua template/page policy. Flow tổng quát:

1. Tạo Tags property và các environment trong Adobe Experience Cloud.
2. Cấu hình extension, data element và rule.
3. Tạo cloud configuration hoặc site configuration trong AEM.
4. Liên kết configuration với site root/template hoặc page cần tracking.
5. Render embed code đúng environment trong page head và body theo hướng dẫn của Tags.
6. Activate configuration và nội dung liên quan sang Publish.
7. Kiểm tra request sau Dispatcher, không chỉ kiểm tra trên Author.

Nếu dự án có nhiều site hoặc locale, có thể lưu các giá trị site-specific trong Context-Aware Configuration dưới /conf:

/conf/
  hotel-vn/
    sling:configs/
      com.example.site.AnalyticsConfig/
        tagsProperty = "hotel-vn"
        tagsEnvironment = "staging"
  hotel-jp/
    sling:configs/
      com.example.site.AnalyticsConfig/
        tagsProperty = "hotel-jp"
        tagsEnvironment = "staging"

Không để cùng một environment ID production được hardcode trong mọi site nếu các site có lifecycle khác nhau.

#4.3. Embed code trong HTL

Nếu không dùng integration có sẵn, một Sling Model có thể expose embed code hoặc environment-specific URL cho HTL. Giá trị phải được kiểm soát từ cấu hình server-side và escape đúng context:

<sly data-sly-use.tags="com.example.core.models.TagsModel" />

<script
  src="${tags.libraryUrl @ context='uri'}"
  async>
</script>

Không cho author nhập tùy ý một URL script rồi render thẳng vào page. Với script, nên allowlist host và environment ở code/config. Trong hầu hết dự án, template hoặc cloud service integration an toàn hơn một text field tùy ý trong dialog.

#5. Tích hợp Adobe Analytics

#5.1. Những gì cần thống nhất

Trước khi cấu hình Analytics extension, hãy tạo measurement plan:

Quy ước tên nên ổn định giữa AEM component, data layer, Tags rule và Analytics report. Không dùng text author nhập làm tên biến nếu chưa normalize; cùng một page không nên lúc là Deluxe Room, lúc là deluxe-room.

#5.2. Luồng page view

Một luồng phổ biến:

1. AEM render pageType, pageName, language và site code.
2. Tags đọc data element từ data layer.
3. Rule page view set eVar/prop/event tương ứng.
4. Adobe Analytics extension gửi beacon.
5. Debugger xác nhận report suite, variables, event và payload.

Nên để Tags xử lý mapping giữa data layer và Analytics. AEM chỉ cung cấp context ổn định, tránh nhúng trực tiếp nhiều lệnh Analytics vào từng component.

#5.3. Conversion và doanh thu

Chỉ gửi conversion sau khi backend xác nhận transaction. Không gửi booking complete ở bước click nút submit, vì người dùng có thể refresh, lỗi thanh toán hoặc bỏ flow.

Để tránh double counting:

• có transaction ID ổn định;
• phát event ở một điểm duy nhất;
• xử lý refresh confirmation page;
• không lấy giá trị từ query string nếu người dùng có thể sửa;
• kiểm tra currency và timezone;
• đối soát Analytics với hệ thống booking backend.

#6. Tích hợp Adobe Target

#6.1. Target dùng để làm gì?

Target nhận context của visitor và trả về experience/offer theo activity. Trong AEM 6.5, các use case thường gặp là:

• A/B test tiêu đề hoặc CTA;
• thay banner theo thị trường hoặc mùa;
• cá nhân hóa ưu đãi theo nhóm audience;
• export Experience Fragment từ AEM sang Target làm offer.

Target không thay thế AEM authoring. AEM quản lý nội dung và component; Target quyết định biến thể nào được phân phối cho visitor trong activity.

#6.2. Hai cách triển khai

Client-side delivery phù hợp khi page đã render trên browser và chấp nhận thay đổi sau khi Target trả response. Tags load Target library, gửi mbox/request và render offer.

Server-side hoặc hybrid delivery phù hợp khi cần giảm flicker, có SSR, hoặc business logic cần quyết định trước khi render. Cách này cần API/SDK tương ứng và thiết kế cache cẩn thận; không nên tự xây một endpoint giả lập Target.

Với AEM 6.5 on-premise, cần xác định rõ integration được Adobe hỗ trợ cho Service Pack hiện tại trước khi chọn SDK. Không copy một snippet cũ của mbox.js, at.js hoặc Web SDK mà không kiểm tra compatibility và migration path.

#6.3. Experience Fragment làm Target offer

Experience Fragment có thể được export sang Target trong những use case được hỗ trợ:

1. Tạo XF variation dành cho Web.
2. Dùng các component có markup và asset ổn định.
3. Cấu hình Adobe Target Cloud Service cho site hoặc XF folder.
4. Publish XF và asset dependency.
5. Export offer sang Target.
6. Tạo activity, audience và success metric trong Target.
7. Kiểm tra offer ở staging trước khi activate activity production.

Nếu offer chứa ảnh hoặc clientlib từ AEM, phải kiểm tra URL publish, quyền truy cập và rewrite qua Dispatcher. Export thành công không có nghĩa mọi resource phụ thuộc đã sẵn sàng cho visitor.

#6.4. Tránh flicker và cache sai

Target client-side có thể làm trang hiển thị nội dung mặc định trước rồi mới thay bằng offer. Để giảm flicker:

• load quyết định Target ở thời điểm phù hợp trong page lifecycle;
• dùng pre-hide với timeout hợp lý nếu integration yêu cầu;
• không cache HTML đã personalize bằng Dispatcher/CDN nếu response phụ thuộc visitor;
• phân biệt cache public với response có cookie hoặc audience context;
• test Web Vitals và timeout khi Adobe service không phản hồi.

Không nên đưa nội dung Target-personalized vào một cache public dùng chung cho mọi visitor. Đây là lỗi vừa ảnh hưởng trải nghiệm vừa có thể làm lộ nội dung sai audience.

#7. Vai trò của Dispatcher và on-premise operations

Trong AEM as a Cloud Service, nhiều hạ tầng được Adobe quản lý. Với AEM 6.5 on-premise, đội vận hành phải tự kiểm soát:

• outbound DNS và HTTPS từ browser/server tới Adobe domains;
• CSP script-src, connect-src, img-src, frame-src và nonce nếu dùng;
• cookie policy, SameSite và consent;
• Dispatcher filter cho clientlibs, JSON, XF và các endpoint cần thiết;
• cache rule cho page có Target personalization;
• replication của cloud configuration, clientlib và Experience Fragment;
• TLS inspection, proxy, WAF và ad-blocker behavior;
• logging và monitoring request tới Analytics/Target/Tags.

Dispatcher không nên mở rộng quyền truy cập bằng cách allow toàn bộ /libs, /apps hoặc endpoint debug. Chỉ allow các path và method cần thiết cho publish runtime.

#8. Author, Publish và cache

Cloud configuration trong AEM thường được liên kết theo site context. Hãy thiết kế rõ:

/conf/hotel-site/settings/cloudconfigs/
  adobe-launch/
  adobe-analytics/
  adobe-target/

Tên path có thể khác theo phiên bản, package và project implementation; điều quan trọng là configuration được scope theo site và được deploy/replicate có kiểm soát.

Checklist môi trường:

• Author dùng embed code Development hoặc không fire production tracking.
• Publish staging dùng Tags Staging và report suite staging.
• Publish production dùng Tags Production và report suite production.
• Dispatcher không cache nhầm HTML có experience theo visitor.
• Clientlib và configuration cùng version với content release.
• Rollback có thể trả cả AEM content và Tags library về phiên bản tương thích.

#9. Kiểm thử end-to-end

#Kiểm tra HTML và clientlib

Trên Publish, kiểm tra:

• embed code có đúng environment;
• script không bị CSP hoặc WAF chặn;
• data layer xuất hiện trước khi rule Tags chạy;
• không có duplicate Launch embed code;
• không có Analytics beacon từ Author khi test content.

#Kiểm tra request

Dùng browser DevTools và Adobe Experience Platform Debugger để kiểm tra:

• request tới Tags library trả 200;
• Analytics request có đúng report suite, page name và event;
• Target request có đúng property, activity và mbox/scope;
• consent được áp dụng trước các request cần hạn chế;
• click hoặc refresh không làm gửi duplicate conversion.

#Kiểm tra vận hành

• test khi Adobe endpoint timeout hoặc bị chặn;
• kiểm tra trang vẫn dùng được nếu Target không phản hồi;
• kiểm tra CDN/Dispatcher không trả offer của visitor A cho visitor B;
• kiểm tra publish cluster có cùng configuration;
• kiểm tra log và alert khi tracking volume giảm bất thường.

#10. Những lỗi thường gặp

#Dùng sai environment

Staging page tải Production Tags library, hoặc Author gửi dữ liệu thật vào report suite production. Luôn gắn hostname và environment bằng configuration, không copy-paste embed code thủ công giữa các môi trường.

#Nhúng Analytics và Target nhiều lần

Một page có Tags embed code và thêm trực tiếp Analytics/Target script trong component sẽ tạo duplicate request. Chọn một owner cho mỗi integration, thường là Tags.

#Chặn script bằng CSP

HTML hiển thị bình thường nhưng tracking không chạy vì CSP thiếu Adobe domains. Khi thay extension hoặc library host, cần cập nhật CSP theo allowlist tối thiểu và kiểm tra lại bằng browser console.

#Cache nhầm trải nghiệm cá nhân hóa

Dispatcher cache một HTML response đã được Target thay đổi theo visitor. Cần quyết định personalization xảy ra trước cache, sau cache ở browser, hay dùng server-side delivery; không trộn các mô hình mà không có cache strategy.

#Gửi PII vào Analytics hoặc Target

Email, tên, số điện thoại và booking reference có thể là dữ liệu nhạy cảm. Dùng ID đã được phê duyệt, hashing/tokenization theo chính sách của tổ chức và không gửi PII chỉ vì thuận tiện cho report.

#Publish XF nhưng quên asset

Target offer hiện text nhưng mất ảnh vì XF hoặc asset dependency chưa activate, URL bị rewrite sai hoặc Dispatcher không allow resource. Kiểm tra toàn bộ dependency trên Publish.

#11. Kiến trúc khuyến nghị

Với một ứng dụng AEM 6.5 on-premise thông thường:

1. AEM component render semantic HTML và data layer, không tự gọi Analytics/Target.
2. Template/page policy load một Tags embed code theo environment.
3. Tags quản lý extension, consent, Analytics mapping và Target delivery.
4. AEM Context-Aware Configuration giữ các giá trị khác nhau theo site/locale.
5. Analytics nhận page view và business event sau khi có điều kiện hợp lệ.
6. Target chỉ personalize vùng được phép; AEM vẫn là nguồn nội dung gốc.
7. Dispatcher/CDN có cache policy riêng cho public page và personalized response.
8. Dashboard đối soát Analytics với dữ liệu backend, đặc biệt cho booking và revenue.

Tách trách nhiệm như vậy giúp author thay đổi content trong AEM, marketing thay đổi rule trong Tags/Target, còn developer duy trì schema và contract. Mỗi nhóm có thể làm việc độc lập hơn mà không biến toàn bộ tracking thành JavaScript rải rác trong component.

#Tài liệu tham khảo

• AEM 6.5 Cloud Services
• Adobe Experience Manager 6.5 documentation
• Adobe Experience Platform Tags documentation
• Adobe Analytics documentation
• Adobe Target documentation