OneLink API

Sekilas: OneLink API membantu Anda melibatkan pengguna akhir dan memanfaatkan media yang dimiliki dengan menghasilkan tautan yang dipersonalisasi dalam kampanye skala besar, melalui SMS, dan masih banyak lagi. Mengharuskan pengiklan dan pengembang untuk menerapkan.

OneLink API

OneLink API digunakan untuk:

  • Buatdapatkanperbarui, dan  hapus URL singkat OneLink dengan parameter yang disesuaikan secara otomatis.
    Parameter dapat berupa:
    • Parameter terkait atribusi, digunakan untuk mengukur dan memantau upaya pemasaran, seperti sumber media, kampanye, dan adset. Perhatikan: Parameter sumber media (pid) itu wajib. 
    • Parameter personalisasi, yang memungkinkan Anda mengonfigurasi pengalaman pengguna yang disesuaikan saat membuka aplikasi dari tautan yang relevan. Parameter ini memungkinkan Anda mengarahkan pengguna ke konten dalam aplikasi yang disesuaikan, misalnya, laman produk tertentu, kode kupon, atau promosi.
  • Izinkan berbagi konten situs web dan aplikasi langsung ke pengguna seluler (sehingga meningkatkan interaksi dan penginstalan seluler).
  • Hasilkan banyak tautan atribusi khusus OneLink secara instan.
    Catatan : Untuk tautan rujukan, lihat artikel atribusi undangan pengguna .

 Contoh

Feed Me, layanan pengiriman bahan makanan, ingin mengirim tautan yang dipersonalisasi melalui SMS ke pelanggan yang sudah ada untuk mendorong mereka mengunduh aplikasi Feed Me dan membeli pisang. Berdasarkan negara pelanggan, Feed Me menggunakan OneLink REST API untuk membuat URL OneLink kustom yang berisi detail spesifik untuk negara, identitas pengguna, dan penawaran istimewa untuk pisang yang sedang dijual.

Prosedur

Untuk menyiapkan OneLink API:

  1. Buat templat OneLink.
  2. Catat ID OneLink. 

  3. Catat kode OneLink API. Admin akun perlu mengambil kode API. Anggota tim tidak memiliki akses ke Kode API. 
    • Di dashboard AppsFlyer, buka Integration (Integrasi) > API Access (Akses API) , dan gulir ke bawah ke bagian OneLink API.
    • Jika kode OneLink API tidak ada untuk admin, ini berarti Anda tidak memiliki paket yang diperlukan, dan Anda perlu menghubungi CSM Anda.  

      OL_API_key.png

  4. Berikan OneLink ID dan kode OneLink API kepada pengembang.
  5. Beri tahu pengembang untuk mengikuti petunjuk di pusat pengembang.

Batasan

Batasan

Catatan

Penilaian API

  • Batas permintaan untuk membuat tautan atribusi OneLink melalui API adalah 7,5 juta per bulan (zona waktu UTC), per akun.
  • Semua permintaan yang diajukan setelah melampaui 7,5 juta tidak dilayani, dan tautan tidak dapat dibuat; Panggilan API menerima kode status kesalahan/error 429 yang berisi pesan "batas permintaan terlampaui".
  • Informasi mengenai berapa banyak batas tarif yang digunakan/tersisa saat ini tidak tersedia. 

Visibilitas tautan khusus

  • Tautan yang dibuat melalui API tidak muncul di daftar tautan khusus OneLink di dashboard AppsFlyer.
  • Tidak ada API yang mencantumkan semua tautan kustom OneLink yang dibuat dengan API.
  • Praktik terbaik: Simpan tautan yang dibuat API ke tabel lokal, sehingga Anda dapat mengakses tautan untuk tujuan apa pun di masa mendatang. 

TTL 

  • Setiap tautan atribusi OneLink yang dibuat oleh API memiliki Time to Live (TTL) default selama 31 hari. Setelah 31 hari, catatan tautan atribusi ini dihapus dari sistem kami. Mengklik tautan seperti ini setelah TTL kedaluwarsa masih default ke perilaku yang ditentukan dalam konfigurasi dasar OneLink, tetapi atribusi tidak akan berfungsi.
  • TTL maksimum adalah 31 hari. Nilai TTL apa pun yang lebih besar dari 31 diganti dengan TTL default 31.
  • Nilai TTL dapat ditentukan dalam hari (default), menit, atau jam (misalnya, 10m, 20h, 14d).
  • Anda dapat mengirimpermintaan pembaruanuntuk menentukan TTL. Setiap permintaan pembaruan mengatur ulang TTL (untuk tautan yang ada) ke yang ditentukan dalam konten permintaan.
    • Ini berarti TTL diganti. Misalnya, jika Anda melakukan panggilan pembaruan dengan TTL 2d untuk tautan yang saat ini memiliki TTL 29d, itu akan berubah menjadi TTL=2d (bukan 31d).
    • Panggilan pembaruan berpotensi memperpanjang masa pakai tautan atribusi. Misalnya, jika Anda melakukan panggilan pembaruan dengan TTL 31d untuk tautan yang saat ini memiliki TTL 20d tetapi 5 hari telah berlalu, TTL akan menjadi 31d sejak waktu pembaruan.

Karakter khusus

Karakter berikut harus dikodekan jika digunakan untuk tautan yang dibuat API: ;, , !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, /
Jika Anda tidak menyandikan karakter ini, karakter tersebut akan diganti dengan spasi kosong.

 

Apakah artikel ini membantu?