Sistem rujukan teman

Sistem rujukan teman mendorong pemain yang sudah ada untuk membawa pemain baru ke game Anda, meningkatkan retensi pemain dan keterlibatan secara keseluruhan. Pemain dapat mengakses dan membagikan tautan rujukan dari prompt undangan pemain atau langsung dari menu undangan dalam game yang merupakan pengaturan standar.

Sebagai pengembang, Anda dapat membuat spanduk yang disesuaikan untuk mengiklankan sistem hadiah Anda dan menggunakan tautan rujukan yang dapat dibagikan untuk:

• Melacak pemain mana yang berhasil mengundang pemain lain ke game Anda.
• Melacak pemain mana yang bergabung ke game Anda menggunakan undangan tautan rujukan dari pemain lain.
• Membuat dan mendistribusikan hadiah kepada baik pengundang maupun yang diundang.

Untuk mengimplementasikan sistem rujukan, siapkan acara rujukan dan buat hadiah rujukan di Studio. Properti ReferredByPlayerId dari GetJoinData() secara otomatis terisi untuk semua jenis undangan dan memberi Anda akses ke ID pengguna dari pemain yang merujuk. Anda kemudian dapat mengakses data ini di acara Players.PlayerAdded untuk mengidentifikasi pengundang dan memberikan hadiah kepada baik pengundang maupun yang diundang.

function onPlayerAdded(player)

    local referredByPlayerId = player:GetJoinData().ReferredByPlayerId

    local referrerEvent: RemoteEvent = ReplicatedStorage:FindFirstChild("ReferralReceivedEvent")
    referrerEvent:FireClient(player, referredByPlayerId)
end

Players.PlayerAdded:Connect(onPlayerAdded)

Untuk memastikan bahwa pemain memahami sistem hadiah, implementasikan spanduk hadiah yang disesuaikan di bagian atas modal undangan teman Anda yang menunjukkan kepada mereka rincian tentang hadiah yang dapat mereka peroleh.

Siapkan acara rujukan

Untuk menyiapkan acara rujukan:

1. Siapkan RemoteEvent di ReplicatedStorage untuk membuat acara jarak jauh untuk berkomunikasi dengan klien saat rujukan diterima.
2. Ambil ID pengguna pengundang menggunakan ReferredByPlayerId untuk melacak gabungan pemain dan menangani logika rujukan di skrip sisi server Anda selama acara Players.PlayerAdded.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Buat atau ambil RemoteEvent untuk menangani rujukan
local referrerEvent: RemoteEvent = ReplicatedStorage:FindFirstChild("ReferralReceivedEvent")

-- Fungsi yang dipicu saat pemain bergabung
function onPlayerAdded(player)
    local joinData = player:GetJoinData()
    local referredByPlayerId = joinData.ReferredByPlayerId

    -- Periksa apakah pemain diundang melalui rujukan
    if referredByPlayerId and referredByPlayerId ~= 0 then
        -- Kirim acara rujukan ke klien, dengan ID pengundang
        referrerEvent:FireClient(player, referredByPlayerId)

        -- Logika tambahan untuk memberi hadiah kepada pengundang dan yang diundang dapat ditambahkan di sini
        -- e.g., rewardReferrer(referredByPlayerId)
        -- e.g., rewardInvitee(player)
    end
end

-- Sambungkan fungsi ke acara PlayerAdded
Players.PlayerAdded:Connect(onPlayerAdded)

Berikan hadiah rujukan

Untuk mendorong partisipasi, berikan hadiah kepada baik pengundang maupun yang diundang. Misalnya, Anda dapat memberikan pengundang lencana atau mata uang dalam game saat teman mereka bergabung ke game, dan memberikan yang diundang hadiah selamat datang karena bergabung ke game melalui tautan rujukan.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- Buat atau ambil RemoteEvent untuk menangani rujukan
local referrerEvent: RemoteEvent = ReplicatedStorage:FindFirstChild("ReferralReceivedEvent")

-- Fungsi yang dipicu saat pemain bergabung
function onPlayerAdded(player)
    local joinData = player:GetJoinData()
    local referredByPlayerId = joinData.ReferredByPlayerId

    -- Periksa apakah pemain diundang melalui rujukan
    if referredByPlayerId and referredByPlayerId ~= 0 then
        -- Kirim acara rujukan ke klien, dengan ID pengundang
        referrerEvent:FireClient(player, referredByPlayerId)

        -- Hadiahkan pengundang
        function rewardReferrer(referrerId)
          local referrerPlayer = Players:GetPlayerByUserId(referrerId)
          if referrerPlayer then
              -- Berikan hadiah kepada pengundang
              -- Contoh: referrerPlayer.leaderstats.Coins.Value += 100
          end
        end

        -- Hadiahkan yang diundang
        function rewardInvitee(player)
            -- Berikan hadiah kepada yang diundang
            -- Contoh: player.leaderstats.WelcomeBonus.Value += 50
        end
    end
end

-- Sambungkan fungsi ke acara PlayerAdded
Players.PlayerAdded:Connect(onPlayerAdded)

Buat spanduk hadiah

Spanduk hadiah mendorong pengguna untuk mengundang teman untuk bergabung ke game Anda dengan menunjukkan rincian tentang hadiah rujukan yang dapat mereka peroleh. Spanduk ini ditampilkan di bagian atas modal undangan teman Anda.

Untuk membuat spanduk hadiah yang disesuaikan:

1. Di Creator Hub, pergi ke Creations dan pilih game yang telah Anda siapkan acara rujukan.
2. Pergi ke Engagement ⟩ Referral Rewards.
3. Klik Add Reward Details.
4. Di halaman Referral Rewards:

   1. Ganti ikon default dengan gambar yang mewakili game Anda.
   2. Masukkan nama hadiah untuk ditampilkan di spanduk.
   3. Pilih tanggal mulai dan akhir untuk ketika Anda ingin menampilkan spanduk kepada pemain.
   4. (Opsional) Masukkan deskripsi dengan rincian tentang hadiah.
   5. (Opsional) Jika Anda ingin menambahkan batasan hadiah, masukkan batas hadiah. Misalnya, batas hingga 3 hadiah per pengundang.
5. Klik Save untuk menyimpan perubahan Anda.
6. Klik Publish untuk membuat spanduk terlihat bagi pemain.

Anda dapat membuat banyak spanduk yang berbeda, tetapi hanya satu spanduk yang bisa diterbitkan dan ditampilkan sekaligus. Pastikan bahwa spanduk yang diterbitkan secara akurat menggambarkan sistem rujukan yang telah Anda terapkan di Studio.

Cegah penyalahgunaan sistem rujukan

Anda dapat menerapkan langkah-langkah pengaman untuk mencegah pemain mengeksploitasi sistem rujukan teman.

• Tawarkan hadiah satu kali untuk melacak yang diundang dan memastikan mereka hanya dihargai satu kali.
• Perkenalkan periode cooldown sebelum pengundang dapat mengajukan rujukan lain.
• Pantau aktivitas yang tidak biasa dan terapkan langkah-langkah korektif seperti melarang pengguna atau membatalkan hadiah.

local DataStoreService = game:GetService("DataStoreService")
local Players = game:GetService("Players")

-- Buat atau ambil datastore untuk rujukan
local referralDataStore = DataStoreService:GetDataStore("ReferralDataStore")

-- Fungsi untuk memeriksa dan menandai rujukan
local function onPlayerAdded(player)
    local joinData = player:GetJoinData()
    local referredByPlayerId = joinData.ReferredByPlayerId

    -- Muat data rujukan pemain
    local success, alreadyReferred = pcall(function()
        return referralDataStore:GetAsync(tostring(player.UserId))
    end)

    if not success then
        warn("Gagal mendapatkan data rujukan untuk pemain:", player.UserId)
        return
    end

    if referredByPlayerId and referredByPlayerId ~= 0 and not alreadyReferred then
        -- Hadiahkan pengundang dan yang diundang
        rewardReferrer(referredByPlayerId)
        rewardInvitee(player)

        -- Tandai pemain sebagai yang diundang di DataStore
        local saveSuccess, err = pcall(function()
            referralDataStore:SetAsync(tostring(player.UserId), true)
        end)

        if not saveSuccess then
            warn("Gagal menyimpan status rujukan untuk pemain:", player.UserId, err)
        end
    end
end

-- Sambungkan fungsi ke pemain yang bergabung
Players.PlayerAdded:Connect(onPlayerAdded)

Pertanyaan yang sering diajukan

Game mana yang memenuhi syarat untuk menggunakan fitur ini?

Fitur ini terbuka untuk game apa pun yang telah aktif selama setidaknya satu hari dan yang tidak melanggar Standar Komunitas.

Pemain mana yang dapat memanfaatkan rujukan?

Semua pemain berhak mendapatkan hadiah melalui rujukan.

Apakah undangan dibatasi untuk teman pemain di Roblox?

Tidak, pemain dapat mengirim undangan kepada teman yang tidak terhubung di platform Roblox.

Apakah tautan rujukan kedaluwarsa?

Tautan tidak pernah kedaluwarsa.

Bagaimana cara mendapatkan manfaat maksimal dari fitur ini?

Anda dapat menambahkan tombol dalam game untuk mengiklankan sistem rujukan dan mendorong pemain untuk memanfaatkan rujukan. Anda kemudian dapat memberikan tombol judul deskriptif dan menghubungkan acara klik tombol ke modal undangan teman di mana pemain dapat melihat spanduk hadiah.