# Oyunlaştırma yöntemleri

## Instagram ve Facebook'ta oyunlaştırma yöntemleri&#x20;

{% hint style="warning" %}
Fonksiyon işlemlerini yapılandırmak için, oyunlaştırma[ Instagram sohbetleri için şablonu referans olarak kullanmanızı öneririz](#gamification-methods-in-instagram-and-facebook).&#x20;
{% endhint %}

Aşağıda listelenen işlevleri kullanmak için, ortak değişkenleri tanımlamanız gerekir **Şuraya gidin**:

<table data-header-hidden><thead><tr><th width="270.3333333333333">Değişken adı</th><th width="323">Değişkenin amacı</th><th align="center">Değer, örnek</th></tr></thead><tbody><tr><td>comment_score</td><td>yorumlar için kaç puan verileceği</td><td align="center">10</td></tr><tr><td>comment_max_actions </td><td>günlük maksimum yorum sayısı</td><td align="center">5</td></tr><tr><td>min_comment_len</td><td>minimum yorum uzunluğu</td><td align="center">25</td></tr><tr><td>stories_score</td><td>story'lerdeki reaksiyonlar için kaç puan verileceği</td><td align="center">15</td></tr><tr><td>stories_max_actions</td><td>günlük maksimum işlem sayısı</td><td align="center">1</td></tr><tr><td>stories_mention_score</td><td>story'lerdeki bahsetmeler için kaç puan verileceği</td><td align="center">5</td></tr><tr><td>stories_mention_max_actions</td><td>günlük maksimum işlem sayısı</td><td align="center">2</td></tr><tr><td>post_mention_score</td><td>gönderideki bahsetmeler için kaç puan verileceği</td><td align="center">10</td></tr><tr><td>post_mention_max_actions</td><td>günlük maksimum işlem sayısı</td><td align="center">3</td></tr><tr><td>end_game_date</td><td>oyun bitiş tarihi</td><td align="center">30.12.2021</td></tr></tbody></table>

**game\_add\_comment**(text=None) - Instagram veya FB'deki bir yoruma puan ekler; ayrıca herhangi bir metin de geçebilirsiniz.

**game\_add\_stories**() - story'lerdeki reaksiyonlar için puan ekler

**game\_add\_message**() - Direkt mesajlar için puan ekler

**game\_add\_stories\_mention**() - story'lerdeki bahsetmeler için puan ekler

**game\_get\_user\_score**() - kullanıcının puanlarını döndürür

**game\_get\_user\_place**() - kullanıcının sıralamadaki konumunu gösterir

**game\_get\_leader\_score**() - sıralamadaki liderin puanlarını döndürür

**game\_get\_top(count=99999999, shift=0, humanize=False, delimiter=None, platform=None)** - fonksiyonun argüman olmadan çağrılması, kullanıcılar dizisi olarak sıralanmış bir tablo döndürür. Aşağıdaki 5 parametreyi kabul eder: **count** - kaç kullanıcının döndürüleceği; **shift** - seçim için başlangıç sıra konumu (0, listenin liderden başlaması ve puanlara göre aşağı doğru gitmesi anlamına gelir; örneğin 3, seçimin 4. sıradan ve altından başlaması anlamına gelir); **humanize** **0** - kullanıcı sözlüklerinden oluşan bir dizi döndürür, **1** kullanıcıya göstermek için biçimlendirilmiş bir liste döndürür; **delimiter** - kullanıcı adı ile puanı arasındaki ayırıcı (eğer kullanılırsa **humanize=1**); **platform 1** - Instagram girişini (örneğin, **@nik**) kullanıcı adı yerine çıktı olarak verir.

Örnek 1: game\_get\_top(10, 0, 1, ' - ') şunu döndürür: John - 40 Anna - 30 George - 10\
\
Örnek 2: game\_get\_top(3, 0, 1, ' - ', 1) şunu döndürür: @john - 40 @anna - 30 @privet - 10&#x20;

**game\_add\_score**(count=1, client\_id=None) - kullanıcıya puan ekler

**game\_set\_score**(score, client\_id=None) - kullanıcının toplam puanını ayarlar

**game\_ban\_player**() - kullanıcıyı engeller

**game\_unban\_player**() - kullanıcının engelini kaldırır

**game\_user\_banned**() - kullanıcının engel durumunu döndürür; engelliyse True, değilse False

\# liderlik tablosunda rastgele değerlerle çalışmaya izin verir.&#x20;

**game\_add\_value**(val\_name, count=1, client\_id=None) -&#x20;

**game\_set\_value**(val\_name, value, client\_id=None)

{% hint style="info" %}
Eğer **client\_id** sağlanmamışsa, fonksiyon mevcut istemciyle çalışır.
{% endhint %}

**game\_minus\_user\_score**(count =10) - kullanıcıdan puan düşer (**count** - kaç puan düşüleceği)

**game\_get\_today\_user\_comment\_action**() - kullanıcının bugün yaptığı yorum sayısı

**game\_get\_today\_user\_message\_actions**() - kullanıcının bugün gönderdiği mesaj sayısı

**game\_get\_today\_user\_stories\_actions**() - kullanıcının bugün paylaştığı story sayısı

**game\_get\_today\_user\_mention\_actions**() - bugün kullanıcının faaliyetlerinin (bahsetmelerin) sayısı

**game\_get\_today\_user\_post\_mention\_actions**() - kullanıcının bugün bahsetme içeren gönderi sayısı

**game\_get\_total\_comment\_action**() - tüm oyun boyunca toplam yorum sayısı

**game\_get\_total\_message\_actions**() - tüm oyun boyunca toplam mesaj sayısı

**game\_get\_total\_stories\_actions**() - tüm oyun boyunca toplam story sayısı

**game\_get\_total\_stories\_mention\_actions()** - tüm oyun boyunca story'lerdeki toplam bahsetme sayısı

**game\_get\_total\_post\_mention\_actions()** - tüm oyun boyunca gönderilerdeki toplam bahsetme sayısı

## Telegram'da sıralama alma &#x20;

{% hint style="warning" %}
Fonksiyon işlemlerini yapılandırmak için, oyunlaştırma[ Telegram sohbetleri için şablonu referans olarak](#getting-ranking-in-telegram).
{% endhint %}

Global değişkenlerde, istemci bilgilerini aşağıdaki biçimde saklamak için tg\_thanks\_score\_data adlı bir sözlük oluşturmalısınız:

`{"total_thanks":20,"326659632":{"name":"John","user_name":"john","score":5},"403051597":{"name":"Timm","user_name":"dbeing","score":15,"banned":false}}`

**tg\_get\_top(count=99999999, shift=0, humanize=False, delimiter=None)**&#x20;

Parametreler:&#x20;

**count** - kaç kullanıcının döndürüleceği\
**shift** - seçim için başlangıç sıra konumu (0, listenin liderden başlaması ve puanlara göre aşağı doğru gitmesi anlamına gelir; örneğin 3, seçimin 4. sıradan ve altından başlaması anlamına gelir)\
**humanize** - 0 kullanıcı sözlüklerinden oluşan bir dizi döndürür, 1 kullanıcıya gösterim için biçimlendirilmiş bir liste döndürür\
**delimiter** -  kullanıcı adı ile puanı arasındaki ayırıcı (humanize=1 ise kullanılır)

**tg\_get\_user\_info()**

{'score': user\_score, 'place': place, 'name': name}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/tr/chatbot/functions/hesap-makinesi/gamification.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
