Langsung ke konten utama

Instal Referrer plugin Capacitor

Baca data Google Play install referrer dan atribusi Apple AdServices dari Capacitor

Instal

bun add @capgo/capacitor-install-referrer bunx cap sync
npm, pnpm atau yarn
  • npm install @capgo/capacitor-install-referrer
  • pnpm add @capgo/capacitor-install-referrer
  • yarn add @capgo/capacitor-install-referrer

Panduan

Cara menggunakan Install Referrer di Capacitor

Tes di perangkat

Download aplikasi Capgo, lalu scan QR code.

Preview QR plugin Install Referrer code

Menggunakan @capgo/capacitor-install-referrer

@capgo/capacitor-install-referrer membaca sinyal atribusi instalasi di aplikasi Capacitor.

Gunakan ini saat Anda butuh data Google Play Install Referrer di Android dan token atribusi Apple AdServices di iOS melalui satu API.

Instal

bun add @capgo/capacitor-install-referrer
bunx cap sync

Apa yang Diekspos Plugin Ini

  • getReferrer mengembalikan detail atribusi instalasi untuk Android atau iOS.
  • GetReferrer adalah alias kompatibilitas yang sudah deprecated untuk migrasi dari cap-play-install-referrer.
  • Android mengembalikan string Play referrer, timestamp klik, timestamp instalasi, dan flag instant app.
  • iOS mengembalikan token atribusi AdServices dan dapat mengambil payload atribusi Apple secara opsional.

Contoh Penggunaan

import { InstallReferrer } from '@capgo/capacitor-install-referrer';

const result = await InstallReferrer.getReferrer();

if (result.platform === 'android') {
  console.log(result.referrer);
}

if (result.platform === 'ios') {
  console.log(result.attributionToken);
}

Payload Atribusi Apple

const result = await InstallReferrer.getReferrer({
  fetchAppleAttribution: true,
  appleAttributionRetryCount: 3,
  appleAttributionRetryDelayMs: 5000,
});

console.log(result.appleAttribution);

Catatan Platform

Android menggunakan layanan Google Play Install Referrer dan butuh instalasi Play Store untuk data referrer asli. iOS menggunakan Apple AdServices karena Apple tidak menyediakan padanan referrer instalasi App Store umum.

Referensi Lengkap

Lanjutkan dari Menggunakan @capgo/capacitor-install-referrer

Jika Anda menggunakan Menggunakan @capgo/capacitor-install-referrer untuk merencanakan pekerjaan plugin native, hubungkan dengan @capgo/capacitor-install-referrer untuk detail implementasi di @capgo/capacitor-install-referrer, Panduan Memulai untuk detail implementasi di Getting Started, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi di Plugin Capacitor oleh Capgo, dan Menambahkan atau Memperbarui Plugin untuk detail implementasi di bagian Menambahkan atau Memperbarui Plugin.

FAQ

FAQ plugin Install Referrer

Bagaimana cara install plugin Install Referrer di aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-install-referrer" (atau "npm install @capgo/capacitor-install-referrer"), lalu jalankan "bunx cap sync" agar proyek iOS dan Android mengenali code native. Import dari "@capgo/capacitor-install-referrer" di dalam code aplikasi Anda.

Apakah @capgo/capacitor-install-referrer bisa digunakan dengan React, Vue, dan Angular?

Ya. Install Referrer adalah package Capacitor, jadi bisa dipakai dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung @capgo/capacitor-install-referrer?

Plugin Capgo mengikuti versi mayor Capacitor: gunakan versi mayor plugin yang sesuai dengan versi mayor Capacitor Anda (contoh: plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub mencantumkan versi yang masih di-maintain.

Apakah @capgo/capacitor-install-referrer gratis dan open source?

Ya. Source code tersedia publik di GitHub pada https://github.com/Cap-go/capacitor-install-referrer/ dan package-nya gratis di-install dari npm. Bug report dan pull request selalu diterima.

Bisakah saya update code yang memakai Install Referrer tanpa review App Store?

Instalasi atau upgrade plugin akan mengubah native code, jadi butuh build store baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin bisa langsung dikirim lewat live updates Capgo.

Rilis perubahan Install Referrer tanpa menunggu review aplikasi

Setelah plugin ada di build store Anda, live updates Capgo akan mengirim perubahan JavaScript, HTML, dan CSS ke pengguna dalam hitungan menit.

Mulai dengan Capgo