Tích hợp Oracle Responsys với AppsFlyer

ESP (Nhà cung cấp Dịch vụ Email) có thể là nguồn tuyệt vời cho lưu lượng người dùng được phân đoạn.

Một trong những thách thức với ESP là thực hiện phân bổ chính xác và liên kết sâu. ESP bao bọc URL liên kết sâu bằng miền ghi lượt nhấp chuột của ESP. Quy trình này thường phá vỡ chức năng của Liên kết Chung iOS và Liên kết Ứng dụng Android. 

Tuy nhiên, bạn vẫn có thể thực hiện liên kết sâu và ghi lại lượt nhấp chuột với các ESP hỗ trợ Liên kết Chung và Liên kết Ứng dụng trên miền ghi lượt nhấp chuột của chúng. Ngoài ra, bạn có thể thiết lập miền nhấp chuột của riêng mình để hoạt động như miền ghi lượt nhấp chuột.

Điều kiện tiên quyết

• Cấu hình ứng dụng của bạn để hỗ trợ liên kết sâu với OneLink.
• Xác minh phiên bản SDK của bạn (cả Android và iOS)

Thiết lập miền nhấp chuột Oracle Responsys

Thực hiện theo phần này để thiết lập miền nhấp chuột của bạn (miền ghi lượt nhấp chuột) trong Oracle Responsys.

Bước 1: Thiết lập miền nhấp chuột trong Oracle Responsys

Để thiết lập miền nhấp chuột, hãy làm theo hướng dẫn chính thức của Oracle Responsys về cách tạo miền nhấp chuột. Oracle Responsys sử dụng Bảng liên kết để giúp ghi lại số lần nhấp chuột cho một chiến dịch cụ thể

Lưu ý, trong bảng Liên kết, bạn có thể xác định URL liên kết iOS giống với URL Liên kết:

Sau khi bạn đặt các miền nhấp chuột trong Bảng Liên kết, Responsys sẽ sử dụng các miền này để bao bọc các OneLink mà bạn đưa vào chiến dịch email. Bằng cách này, Responsys có thể ghi lại các lượt nhấp chuột trong hệ thống của họ đồng thời duy trì chức năng OneLink và liên kết sâu.

Bước 2: Cung cấp cho Responsys tệp AASA (iOS) và tệp Liên kết Nội dung (Android)

Thiết lập ứng dụng của bạn

<activity android:name=".DeepLinkActivity">
    <intent-filter  android:autoVerify="true">
        <action android:name="android.intent.action.VIEW" />
           <category android:name="android.intent.category.DEFAULT" />
           <category android:name="android.intent.category.BROWSABLE" />
           <data android:scheme="https"
               android:host="click.example.com"
               android:pathPrefix="/campaign" />
     </intent-filter>
</activity>

Bước 2: Thiết lập ứng dụng để phân giải các miền nhấp chuột

SDK cần phân giải OneLink đằng sau miền nhấp chuột để biết thông tin chi tiết chiến dịch. Các chi tiết được trả về trong phương thức onAppOpenAttribution .

Để phân giải các miền nhấp chuột:

1. Đảm bảo rằng phiên bản SDK của bạn ít nhất là 4.9.0.
2. Liệt kê các miền nhấp chuột trong thuộc tính SDK resolveDeepLinkURLs. Thuộc tính này cần được đặt trước khi khởi tạo SDK. Để biết thêm thông tin, vui lòng tham khảo tài liệu SDK tại đây.
   
   Objective-C Swift

   [AppsFlyerTracker sharedTracker].resolveDeepLinkURLs = @[@"example.com",@"click.example.com"];

   AppsFlyerTracker.shared().resolveDeepLinkURLs = ["example.com", "click.example.com"]
   

   • Quan trọng! Nếu bạn đang sử dụng Movable Ink (MI) kết hợp với Oracle, bạn cần lấy MI CNAME và các miền nội bộ từ người quản lý tài khoản MI của mình rồi thêm chúng vào setResolveDeepLinkURLs, ngoài liên kết nhấp chuột cho Oracle. Ví dụ về các miền:
     • Miền Oracle: oracle-click.example.com
     • Miền MI CNAME: mi.example.com
     • Miền nội bộ MI: example.micpn.com
3. Thêm mã sau để SDK có thể phân giải miền ghi lượt nhấp chuột:
   
   Objective-C Swift

   Thêm mã này vào AppDelegate.m

   - (NSDictionary *)allHTTPHeaderFieldsForResolveDeepLinkURL:(NSURL *)URL {
       if ([URL.host  isEqual: @"click.example.com"]) {
           return [NSDictionary dictionary];
       }
       else {
           return nil;
       }
   }

   Thêm mã này vào AppDelgate.swift

   func allHTTPHeaderFields(forResolveDeepLinkURL URL: URL!) -> [String : String]! {
       if (URL.host == "click.example.com") {
           /// Change User-Agent
           return [:]
       } khác {
           return nil;
       }
   }
   

Gửi email đầu tiên của bạn

1. Tạo URL OneLink trong trang Link Management (hoặc theo cách thủ công).
2. Khi tạo URL OneLink, hãy đảm bảo URL mã hóa tất cả các giá trị tham số.
3. Các thông số sau đây được đặc biệt khuyến khích sử dụng:
   • pid (nguồn truyền thông) - Sử dụng nguồn truyền thông biểu thị việc sử dụng này, chẳng hạn như Email.
   • c (chiến dịch) - Tên chiến dịch bạn muốn đánh giá.
   • af_dp - Lược đồ URI liên kết sâu mà bạn muốn liên kết sâu với người dùng của mình.
   • af_web_dp - Nơi chuyển hướng người dùng nhấp vào liên kết trên máy tính để bàn.
   • af_ios_url - Nơi chuyển hướng người dùng không có ứng dụng nhấp vào liên kết trên thiết bị iOS.
   • af_android_url - Nơi chuyển hướng người dùng không có ứng dụng, nhấp vào liên kết trên thiết bị Android.
4. Đưa URL OneLink vào email bạn tạo trong Responsys. Ví dụ:

   <a href="greatapp.onelink.me/abcd/1234567">Tải xuống ứng dụng tuyệt vời của tôi!</a>

   Ở giai đoạn này, Responsys bao bọc liên kết trên bằng miền nhấp chuột mà bạn đã đưa vào các bước trước. Bất kỳ nhấp chuột nào vào tên miền nhấp chuột đều chuyển hướng đến liên kết phân bổ OneLink. Nếu ứng dụng được cài đặt trên thiết bị của người dùng, miền nhấp chuột sẽ liên kết sâu vào ứng dụng.

https://greatapp.onelink.me/abcd?pid=Email&c=Spring_Newsletter&is_retargeting=true&
af_dp=testapp://path/to/content&af_web_dp=https://www.example.com/path/to/content&
af_ios_url=https://www.example.com/path/to/content&af_android_url=https://www.example.com/path/to/content

Kiểm tra liên kết của bạn

Sau khi làm theo tất cả các bước bắt buộc được đề cập ở trên, tạo URL OneLink phù hợp và đưa liên kết đó vào email, hãy gửi cho chính bạn một email kiểm tra.

Bạn nên dự kiến điều gì?

Nếu bạn đã cài đặt ứng dụng, ứng dụng sẽ được gọi. Nếu API liên kết sâu SDK AppsFlyer có liên quan được triển khai thì bạn nên liên kết sâu vào nội dung có liên quan.
Ngoài ra, một lượt nhấp chuột sẽ xuất hiện trong cả bảng điều khiển AppsFlyer, được quy cho nguồn truyền thông và chiến dịch được cung cấp cũng như trong dữ liệu của Responsys.