Integrasi Oracle Responsys dengan AppsFlyer

ESP (Penyedia Layanan Email) dapat menjadi sumber yang bagus untuk lalu lintas pengguna yang tersegmentasi.

Salah satu tantangan dengan ESP adalah melakukan atribusi dan tautan langsung yang benar. ESP menggabungkan URL tautan langsung dengan domain catatan klik ESP mereka sendiri. Prosedur ini sering kali merusak fungsi Tautan Universal iOS dan Tautan Aplikasi Android. 

Namun, tautan langsung dan pencatatan klik masih dapat dilakukan dengan ESP yang mendukung Tautan Universal dan Tautan Aplikasi di atas domain pencatatan kliknya. Selain itu, Anda dapat menyiapkan domain klik Anda sendiri untuk bertindak sebagai domain pencatatan klik.

Prasyarat

• Konfigurasikan aplikasi Anda untuk mendukung tautan langsung dengan OneLink.
• Verifikasi versi SDK Anda (Android dan iOS)

Menyiapkan domain klik Oracle Responsys

Ikuti bagian ini untuk menyiapkan domain klik Anda (domain pencatatan klik) di Oracle Responsys.

Langkah 1: Siapkan domain klik di Oracle Responsys

Untuk menyiapkan domain klik, ikuti panduan resmi Oracle Responsys tentang cara membuat domain klik. Oracle Responsys menggunakan Tabel Tautan untuk membantu mencatat klik untuk kampanye tertentu

Catatan, di tabel Tautan, Anda dapat menentukan URL tautan IOS agar sama dengan URL Tautan:

Setelah Anda mengatur domain klik di Tabel Tautan, Responsys menggunakan domain ini untuk menggabungkan OneLink yang Anda sertakan dalam kampanye email. Dengan cara ini, Responsys dapat mencatat klik di sistem mereka sambil mempertahankan OneLink dan fungsionalitas tautan langsung.

Langkah 2: Berikan Responsys file AASA (iOS) dan file Tautan Aset (Android)

Mengatur aplikasi Anda

<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>

Langkah 2: Mengatur aplikasi untuk menyelesaikan domain klik

SDK perlu menyelesaikan OneLink di balik domain klik untuk mendapatkan detail kampanye. Detailnya dikembalikan dalam metode onAppOpenAttribution .

Untuk mengatasi domain klik:

1. Pastikan versi SDK Anda minimal 4.9.0.
2. Cantumkan domain klik di properti SDK resolveDeepLinkURLs. Properti ini perlu disetel sebelum inisialisasi SDK. Untuk informasi lebih lanjut, silakan lihat dokumentasi SDK di sini.
   
   Objective-C Swift

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

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

   • Penting! Jika Anda menggunakan Movable Ink (MI) bersama dengan Oracle, Anda perlu mendapatkan MI CNAME dan domain internal dari manajer akun MI Anda dan menambahkannya ke setResolveDeepLinkURLs, selain tautan klik untuk Oracle. Contoh domain:
     • Domain Oracle: oracle-klik.example.com
     • Domain MI CNAME: mi.example.com
     • Domain internal MI: example.micpn.com
3. Tambahkan kode berikut agar SDK dapat mengatasi domain pencatatan klik:
   
   Objective-C Swift

   Tambahkan kode ini di AppDelegate.m

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

   Tambahkan kode ini di AppDelgate.swift

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

Mengirim email pertama Anda

1. Buat URL OneLink di halaman Manajemen Tautan (atau secara manual).
2. Saat membuat URL OneLink, pastikan URL mengkodekan semua nilai parameter.
3. Parameter berikut sangat disarankan untuk digunakan:
   • pid (sumber media) - Gunakan sumber media yang menandakan penggunaan ini seperti Email.
   • c (kampanye) - Nama kampanye yang ingin Anda ukur.
   • af_dp - Skema URI tautan langsung ke mana Anda ingin tautkan pengguna Anda secara langsung.
   • af_web_dp - Tempat mengarahkan pengguna dengan mengeklik tautan di desktop.
   • af_ios_url - Tempat mengalihkan pengguna yang tidak memiliki aplikasi dengan mengeklik tautan di perangkat iOS.
   • af_android_url - Tempat mengarahkan pengguna yang tidak memiliki aplikasi dengan mengeklik tautan di perangkat Android.
4. Tempatkan URL OneLink di email yang Anda buat di Responsys. Contoh:

   <a href="greatapp.onelink.me/abcd/1234567">Unduh aplikasi keren saya!</a>

   Pada tahap ini, Responsys menggabungkan tautan di atas dengan domain klik yang Anda atur pada langkah sebelumnya. Setiap klik pada domain klik mengalihkan ke tautan atribusi OneLink. Jika aplikasi diinstal pada perangkat pengguna, domain klik akan ditautkan langsung ke aplikasi.

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

Menguji tautan Anda

Setelah mengikuti semua langkah wajib yang disebutkan di atas, membuat URL OneLink yang sesuai, dan menempatkannya di email, kirimkan email percobaan kepada diri Anda sendiri.

Apa yang Anda harapkan?

Jika Anda telah menginstal aplikasi tersebut, aplikasi tersebut harus dijalankan. Jika API relevan yang ditautkan langsung ke AppsFlyer SDK sudah diterapkan, Anda seharusnya sudah ditautkan secara langsung ke konten yang relevan.
Selain itu, sebuah klik akan muncul di dashboard AppsFlyer, yang dikaitkan dengan sumber media dan kampanye yang disediakan, dan juga di data Responsys.