Tagds belgeleri

Üç rol, üç panel

Reklamveren

Oyuncu, kullanıcı ya da kanal üyesi isteyen. Bakiye yükler, kampanya ya da tanıtım ilanı açar. Panel: advertiser.tagds.net

Yayıncı

Mini App'i, botu, Telegram kanalı ya da grubu olan. Reklam gösterir ya da paylaşır; gösterim ve tıklamadan kazanır. Panel: publisher.tagds.net

Tanıtımcı

X hesabı, Telegram kanalı ya da grubu olan (ya da hiçbiri: bağlantıyı istediği yerde paylaşır). Tanıtım ilanlarını paylaşır; getirdiği oyuncunun attığı adımlardan kazanır. Panel: promoter.tagds.net

Üç rol aynı hesapla açılır: bir rolle kayıt olup hesap menüsündeki Panellerim'den öbürünü ekleyebilirsin. Telegram'da @tagdsbot'a /start yazarsan Reklam ver · Uygulamamla kazan · Paylaşarak kazan düğmeleri aynı panelleri Telegram'ın içinde açar. Panel dili Türkçe, İngilizce ya da Rusça. Kimlik belgesi (KYC) istenmez.

Para nasıl akar?

• Yükleme. Reklamveren TON ağında USDT ya da GRAM gönderir ve yorum alanına kendine özel kodu yazar. En az $1. GRAM geldiği andaki kurla dolara çevrilir; bakiye hep dolar olarak tutulur.
• Harcama. Gösterim (CPM), tıklama (CPC), katılım (CPA) ya da tanıtımda oyuncunun attığı adım. Harcama bakiyeden hemen düşer ve gün sonunda kesinleşir.
• Yayıncı kazancı. Reklamverenin o uygulamada ya da kanalda harcadığının standart %70'i (uygulamaya göre değişebilir). 7 gün bekler; çekilebilir bakiye en az $10 olunca ödeme talebi kendiliğinden sıraya girer ve TON cüzdanına USDT olarak gönderilir. Şu an bu ödemeleri Tagds ekibi sırayla gönderiyor; otomatik gönderim açılınca kendiliğinden gidecek.
• Tanıtımcı kazancı. İlanda yazan adım tutarının tamamı; Tagds komisyonu reklamverene ayrıca yansır. 7 gün bekler; ödeme şimdilik elle, Tron (TRC-20) ya da TON adresine.
• İade. Bekleme süresinde sahte bulunan trafiğin parası reklamverene iade edilir.

Kayıt ve onay

İki yoldan biriyle kayıt olursun:

• Web: promoter.tagds.net → Hesap oluştur. E-posta ve şifre yeter (şifre 10–200 karakter; çok yaygın şifreler ve e-postanı içeren şifreler kabul edilmez).
• Telegram: @tagdsbot'a /start yaz → Paylaşarak kazan. Telegram'ın içinde açılan panel de e-posta ve şifre ister; Telegram hesabın bu hesaba bağlanır ve sonraki açılışlarda doğrudan girersin.

Kayıttan sonra hesabın Onay bekliyor durumundadır: ilanlara bakabilir, hesaplarını ekleyebilirsin ama paylaşım açamazsın. Tagds ekibi hesabını onaylayınca paylaşım açılır. Onay için belge istenmez.

İlk giriş: paylaşım şeklini seç

İlk girişte panel İlanları nasıl paylaşacaksın? diye sorar. Bir kez seçersin; sonradan hesap menüsündeki Paylaşım şekli'nden ya da İlanlar ekranının üst şeridindeki Değiştir'den değiştirebilirsin.

İlanlar ekranı

Panelin ana ekranı İlanlar. En üstte ince bir kazanç şeridi var: Çekilebilir, Bekleyen (ve sıradaki açılış günü), Avans ya da Borç, paylaşım şeklin ve Ödemeler. Altında Getirdiğin oyuncular grafiği: son 7, 14 ya da 30 günde gün gün oyunu başlatan, en az 2 gün oynayan, 7 gün kalan ve yatırım yapan oyuncuların (Mini App ilanında ayrıca açan); ilana ve hesaba göre süzülür. Sonra ilan kartları.

Kendin paylaş: paylaşım paketi

1. 1

   İlanı seç

   Kartta Telegram'da paylaş ya da X'te paylaş'a bas.

2. 2

   Hesabı ve dili seç

   O platformda bağlı hesabın varsa hangisinde paylaşacağını seç ya da Hesap belirtmeden de; hiç hesabın yoksa paket doğrudan açılır. Gönderi dilini seç (TR, EN, RU) ve Paylaşım paketini al.

3. 3

   Paketi al

   Senin bağlantın (kopyala), metin (Metni kopyala; X için 280 karakteri aşmayacak biçimde hazır) ve görsel (Görseli indir: Telegram için 1280×720, X için 1200×675). Telegram'ın içindeysen görsele basılı tutup kaydet.
4. 4

   Paylaş

   X'te yaz ya da Telegram'da paylaş metni hazır açar; istersen kopyaladığını kendin yapıştır. Bağlantıyı aynen kullan.
5. 5

   İsteğe bağlı: doğrula

   X'te tweet bağlantısını, Telegram'da gönderi bağlantısını pakete yapıştır (aşağıda).

Hesap belirtmeden açtığın paket gün içinde kartta Bugünkü paketlerin altında durur; aynı ilan ve platform için yeniden açmak hak harcamaz. Eski tagds.net/r/… bağlantıları çalışmaya devam eder, yeni paketler doğrudan t.me bağlantısı verir.

Günlük paylaşım hakkı

Her hesap günde en çok 3 paylaşım açabilir (Tagds bu sayıyı 1 ile 3 arasında tutar). Açtığın her paket o hesabın hakkından düşer; hak Türkiye saatiyle gece yarısı yenilenir.

• Bağlı hesapla açılan paket: o hesabın hakkından düşer. Her hesabın hakkı ayrıdır.
• Hesap belirtmeden açılan paket: platform başına ayrı hak (Telegram için 3, X için 3).
• Bot paylaşımları da aynı haktan düşer (kanal başına).
• Hak dolunca Bugünkü hak doldu, yarın yenilenir yazar.

Hak yalnız paket açmayı sınırlar. Bir paylaşımdan gelebilecek oyuncu sayısının sınırı yok; ilanın günlük ya da toplam tavanı dolunca adımlar kaydedilir ama ödenmez.

X ve Telegram'da doğrulama

Doğrulama, paylaşımın nerede yapıldığını kayda geçirir; reklamveren bunu sonuç tablosunda görür. Kazanç bağlantından gelen oyuncuya bağlıdır: bağlantından gelen oyuncular doğrulama yapmasan da sayılır.

X

Tweet'i attıktan sonra bağlantısını (https://x.com/<kullanıcı>/status/<numara>) paketteki Tweet bağlantısı alanına yapıştır ve Doğrula'ya bas. Tagds tweet'in yazarına ve metinde senin bağlantının bulunduğuna bakar. X hesabını panele eklediysen tweet o hesabın olmalı; ilk geçerli tweet X hesabını da doğrular. Bir tweet yalnız bir paylaşımı doğrular.

Telegram

Gönderinin bağlantısını (https://t.me/<kanal>/<numara>) Gönderi bağlantısı (isteğe bağlı) alanına yapıştır. Bağlı bir kanalla paylaştıysan bağlantıdaki kanal o kanal olmalı. Gönderinin içeriği okunmaz.

Bot paylaşsın: iki adımda kur

Bot paylaşsın'ı seçince panel Bot paylaşımını kur ekranını açar. İki adım bitmeden ilanlar açılmaz ve bot hiçbir yerde paylaşmaz. Botsuz devam etmek istersen aynı ekrandaki Kendim paylaşacağım'a bas.

1. 1

   Telegram hesabını bağla

   Bağlantıyı al → Telegram'da aç → botta Başlat. Kanalın ya da grubun kurucusu olan Telegram hesabıyla aç. Bağlantı 15 dakika geçerli ve yalnız senin için; ekran kendiliğinden ikinci adıma geçer. Telegram'ın içinden kayıt olduysan bu adım zaten tamamdır.
2. 2

   Kanalını ya da grubunu seç

   Tür (Kanal ya da Grup) → Bağlantıyı al. Bağlantı 30 dakika geçerli.

3. 3

   Botu yönetici yap

   Telegram'da kanalına ekle düğmesi Telegram'ı açar. Kanalını ya da grubunu seç, botu yönetici yap. Bot, ekleyenin sohbetin kurucusu olduğunu doğrular ve üye sayısını okur; yalnız yönetici olan hesaplar kabul edilmez.
4. 4

   Hazır

   Ekran kendiliğinden güncellenir, kanal Doğrulandı olur ve İlanlar açılır. Hesabın onaylıysa bot paylaşmaya başlar. Başka kanal eklemek için Hesaplarım → Hesap ekle.

Bot nasıl paylaşır?

• Her gün 10:00–22:00 (Türkiye saati) arasında, kanal başına en çok 3 gönderi; gönderiler güne yayılır (3 hakta en erken 10:00, 14:00 ve 18:00).
• Aynı kanalda iki gönderi arasında en az 60 dakika; aynı ilan aynı kanala 24 saatte en çok bir kez.
• İlanlar sırayla döner: o kanalda en uzun süredir paylaşılmayan ilan önce gelir.
• Gönderi: ilanın görseli, reklamverenin metni ve sana özel bağlantı. Metnin dili panelinin dili.
• Yalnız Telegram'a açık ve reklamverenin bakiyesi olan ilanlar paylaşılır. Yalnız X için olan ilanı bot paylaşamaz; onu kendin paylaşırsın.
• İstemediğin ilanı kartındaki Botla paylaş anahtarıyla kapatırsın.

Nasıl kazanılır?

Her ilanda reklamveren, oyuncunun atacağı adımları ve her adımın tutarını kendisi belirler. Bağlantından gelen bir oyuncu bir adımı attığında o adımın tutarı kazancına yazılır. Tutarlar ilandan ilana değişir; kartta görürsün.

Örnek hesap

Bu bir örnek: bağlantından 100 kişi oyunu başlattı, 30'u 7 gün kaldı, 5'i para yatırdı. Gerçek tutarlar ilanda yazar. Her oyuncu her adım için bir kez ödenir.

Hangi oyuncu sayılır?

Sayılır

• Bağlantından gelen ve adımı reklamverenin botunun bildirdiği gerçek Telegram hesabı.
• Bir ilanda her Telegram hesabı bir kez: her adımı da bir kez ödenir.
• İlk dokunuş kazanır: kişi o ilana ilk kez kimin bağlantısıyla geldiyse sonraki bütün adımları onun sayılır.
• Oyuncunun ilk gelişinden sonraki 30 gün içinde atılan adımlar.

Sayılmaz

• Aynı ilana daha önce başka bir tanıtımcının bağlantısıyla gelmiş kişi.
• Aynı adımı ikinci kez atan kişi.
• İlk gelişinden 30 günden sonra atılan adım.
• Mini App'i açıp oyunu başlatmayan kişi (panelde "açtı ama başlatmadı" diye ayrılır).

Bekleme, avans ve ödeme

• Bekleme. Kazanç gün sonunda kesinleşir ve 7 gün sonra çekilebilir olur. Ödemeler ekranındaki Açılış takvimi hangi gün ne kadarının açılacağını gösterir.
• Ödeme adresi. Ödemeler → Ödeme adresi. Tron (TRC-20): T ile başlayan 34 karakter; USDT (TRC-20) ya da TRX gönderilir. TON: UQ… ya da EQ… ile başlayan 48 karakter; borsa adresiyse (ör. Binance TON) memo yaz, zorunlu olabilir.
• Ödeme. Şimdilik elle: Tagds ekibi çekilebilir tutarı adresine gönderir ve işlem kimliğini (tx) panele işler; Ödeme ve avans geçmişi'nde görürsün. Yayıncılardaki $10 ödeme eşiği tanıtımcılar için geçerli değil.
• Avans. Tagds'in verdiği güven ödemesi. İlk kazançlarından düşülür; kazanç avansı karşılayana kadar şeritte Borç görünür ve çekilebilir tutar oluşmaz.

İade ve sahte trafik

Reklamveren gerçek oyuncu için öder. Şunlar sahte trafik sayılır:

• Kendi Telegram hesaplarınla, ikinci hesaplarla ya da bot hesaplarla oyun başlatmak.
• Aynı kişiyi birden çok hesapla getirmek.
• Reklamverenin botunu kandırarak adım ürettirmek.

Sahte trafik bulunursa hesabın askıya alınır: yeni paylaşım açamazsın, eski bağlantıların çalışır ama dönüşümleri ödenmez. Bekleme süresindeki ilgili kazanç geri alınır ve parası reklamverene iade edilir. Bekleme süresi dolmuş kazanç geri alınmaz.

Sık sorulan sorular

Kayıt ve bakiye yükleme

1. 1

   Kayıt ol

   advertiser.tagds.net → Hesap oluştur (e-posta ve şifre) ya da Telegram'da @tagdsbot → Reklam ver.
2. 2

   Bakiye ekranını aç

   Bakiye: USDT ya da GRAM seç. Ekranda Tagds'in TON adresi, sana özel yorum kodu (TG-XXXXXXXX), QR ve Cüzdanda aç düğmesi var.
3. 3

   Gönder

   Cüzdanından TON ağında gönder ve yorum alanına kodu aynen yaz. En az $1.

4. 4

   Bakiyende gör

   İşlem kesinleşince bakiyene dolar olarak yazılır (genelde bir dakika içinde); ekran kendiliğinden tazelenir.

Reklam biçimleri

Güncel en düşük teklifler landing'deki Biçimler ve fiyatlar tablosunda. Hedefleme: ülke ve kullanıcının Telegram dili; kanal gönderisinde en az üye sayısı. Günlük bütçe dolunca ya da bakiye bitince reklam kendiliğinden durur.

Tanıtım ilanı oluşturma

Kampanyalar → Yeni kampanya → biçim Tanıtım. Sihirbaz sağda canlı ilan kartını ve paylaşım metninin önizlemesini gösterir; kaydetmek tek adım.

İlan başlığı, açıklama

Tanıtımcının kartında görünen başlık ve kısa açıklama.

Paylaşım metni (TR · EN · RU)

Tanıtımcının kopyalayacağı metin: en az bir dil, en çok 1000 karakter. {link} yazdığın yere tanıtımcının kişisel bağlantısı gelir; yazmazsan metnin sonuna eklenir. X'te 280 karakteri aşan metin kısaltılır, bağlantı sonda kalır. Yazmadığın dil ilk yazdığın dile düşer. Hashtag ya da kısa kod gerekmez.

Görsel

PNG, JPEG ya da WebP; en çok 1 MB, en az 300×150 px. Pakette Telegram için 1280×720'ye, X için 1200×675'e yerleştirilir.

Platformlar

Telegram, X ya da ikisi. Tanıtımcı yalnız seçtiğin platformlarda paylaşabilir; bot yalnız Telegram'lı ilanı paylaşır.

Hedef

Bot: oyuncu t.me/<bot>?start=<kod> ile botunu açar. Mini App: t.me/<bot>/<kısa ad>?startapp=<kod> ile Mini App'in açılır; sahiplik doğrulaması zorunlu (aşağıda).

Bot

Botunun kullanıcı adı (t.me/<bot>; "bot" ile biter).

Adımlar ve tutarlar

Hazır adımlar: baslatti (oyunu başlattı), aktif_2 (en az 2 gün oynadı), aktif_7 (7 gün aktif), yatirdi (para yatırdı); ya da kendi adın (küçük harf, rakam, _). En çok 10 adım. Tutar tanıtımcıya gidendir; 0 yazarsan adım yalnız ölçülür. En az bir adım ücretli olmalı.

Günlük ve toplam tavan

Günlük tavan zorunlu, toplam isteğe bağlı: senden düşecek en çok tutar (komisyon dahil). Tavan dolunca adımlar kaydedilir ama ödenmez.

Bildirim adresi

İsteğe bağlı https adres; entegrasyonda.

Komisyon nasıl yansır?

Tanıtımcı yazdığın tutarın tamamını alır. Tagds komisyonu (%30) üstüne eklenir: senden düşen = tutar × 100 / (100 − 30), yukarı yuvarlanır. Sihirbaz her adımın yanında senden düşeni gösterir.

Gizli anahtar ve yayın

Kaydedince gizli anahtar bir kez gösterilir; sakla (dönüşüm bildirimini imzalar). Anahtarı olmayan ilan tanıtımcılara görünmez. Sonra İncelemeye gönder.

İnceleme

Her kampanya ve ilan yayına girmeden önce Tagds tarafından incelenir: Taslak → İncelemeye gönder → İncelemede → Yayında ya da Reddedildi (neden panelde yazar; düzeltip yeniden gönderirsin).

• Bakiyen yoksa ilan onaylanamaz; önce bakiye yükle.
• Yayındaki ilanda paylaşım metnini, platformları, botu ya da hedefi (Mini App kısa adı, bot kimliği) değiştirirsen ilan yeniden incelemeye düşer. Adım tutarları, tavanlar ve bildirim adresi düşürmez.
• Öbür biçimlerde başlık, metin, düğme, bağlantı ya da görsel değişince kampanya yeniden incelenir.
• Mini App hedefli ilan, sahiplik doğrulanmadan incelemeye gönderilemez ve yayına alınamaz.
• Yasak kategoriler (kumar, yetişkin) kabul edilmez.

Yayındaki ilanı Durdur / Devam et ile yönetirsin; duran ilan tanıtımcı listesinden kalkar.

Mini App kurulumu ve sahiplik doğrulaması

1. 1

   Hedefi gir

   İlanda Hedef: Mini App. Botunun kullanıcı adını, Mini App'in kısa adını (t.me/<bot>/<kısa ad>; boş bırakırsan botun ana Mini App'i) ve botun sayısal kimliğini yaz. Sayısal kimlik, bot token'ının ":" işaretinden önceki sayıdır; token'ın kendisini hiçbir yere yazma.

2. 2

   Ölçüm kodunu ekle

   Kaydedince ilanda Kurulum ve doğrulama bölümü açılır. Ölçüm kodunu Mini App sayfanın <head> bölümüne, telegram-web-app.js'ten sonra tek satır olarak ekle:

   <!-- Mini App'inin HTML'i: Telegram betiğinden sonra tek satır -->
   <script src="https://telegram.org/js/telegram-web-app.js"></script>
   <script src="https://tagds.net/sdk/v1/tagds.js" data-olcum async></script>

3. 3

   Doğrulama bağlantısını aç

   Paneldeki doğrulama bağlantısını (t.me/<bot>/<kısa ad>?startapp=<doğrulama kodu>) Telegram'da aç. Mini App açılınca ölçüm kodu, Telegram'ın imzaladığı açılış bilgisini Tagds'e yollar. Bu bağlantı tanıtımcı paylaşımı değildir: sayılmaz, ödenmez.

4. 4

   Doğrulandı

   Tagds imzanın senin botuna ait olduğunu denetler; birkaç saniye içinde bölümde Doğrulandı görünür (bölüm kendiliğinden yenilenir). Artık İncelemeye gönder.

Doğrulanmıyorsa

• Botun sayısal kimliği yanlışsa imza tutmaz; panelde imza hatası sayısı artar.
• Mini App'inin Content-Security-Policy'si varsa script-src ve connect-src'ye https://tagds.net ekle; yoksa istek gitmez.
• Bağlantıyı tarayıcıda değil Telegram'da aç. Açılış bilgisi 24 saatten eski olmamalı.
• Hedef, bot ya da kısa ad sonradan değişirse doğrulama sıfırlanır ve ilan yeniden incelemeye düşer; bağlantıyı yeniden aç.

Ölçüm kodu doğrulamadan sonra da sayfada kalmalı: tanıtımcı bağlantısıyla gelen her açılışı (Açan) ölçer ve "açtı ama başlatmadı" ayıklamasını yapar.

Sonuçları izleme

Kampanya detayındaki Tanıtımcılar bölümünde: ilanı aç/kapa, adımlar, tavanlar, bildirim adresi, gizli anahtar (oluştur / yenile), Node.js ve curl örneği ve dönemli sonuç tablosu. Tabloda her tanıtımcı × hesap bir satırdır (hesap belirtmeden paylaşımlar platform başına bir satır); günlük grafik de oradadır.

Bakiyen ücreti karşılamadığı için ödenmeyen adımlar ayrıca sayılır. Harcama bakiyeden hemen düşer ve gün sonunda kesinleşir; Hareketler'de görünür.

Akış

start / startapp parametresini okuma

Bot

Telegram, t.me/<bot>?start=<kod> bağlantısında botuna /start <kod> mesajı gönderir. Kodu oyuncunun Telegram kimliğiyle sakla; oyuncu daha önce başka bir kodla geldiyse ilkini koru (Tagds de ilk dokunuşu sayar).

// Botunun /start işleyicisinde: "/start AbC…" mesajından kodu al
// (Telegram, t.me/<bot>?start=<kod> bağlantısında bu mesajı gönderir)
const m = /^\/start(?:@\w+)?\s+([A-Za-z0-9_-]{16,64})$/.exec(message.text || "");
if (m) {
  const code = m[1]; // tanıtımcı bağlantısındaki kod (22 karakter)
  await db.saveFirstCode(message.from.id, code); // oyuncunun ilk kodunu sakla; sonra gelen kod ilkini ezmesin
}

Mini App

t.me/<bot>/<kısa ad>?startapp=<kod> bağlantısında kod, initData'nın start_param alanındadır (istemcide Telegram.WebApp.initDataUnsafe.start_param). Telegram bu alanı yalnız bağlantıyla açılışta verir: ilk açılışta sakla. Sunucuda initData'yı kendi bot token'ınla doğruladıktan sonra oku:

// Sunucunda: initData'yı önce kendi bot token'ınla doğrula (Telegram'ın kuralı),
// sonra start_param'ı ve oyuncunun kimliğini oku
const params = new URLSearchParams(initData); // Telegram.WebApp.initData (ham dize)
const code = params.get("start_param");       // tanıtımcı kodu; yoksa null
const user = JSON.parse(params.get("user"));  // user.id = telegramId

Ölçüm kodu (Mini App)

Mini App hedefli ilanda zorunlu. Bağımlılığı yok; hata olursa oyunu bozmaz (sessiz, 5 saniye zaman aşımı).

<!-- Mini App'inin HTML'i: Telegram betiğinden sonra tek satır -->
<script src="https://telegram.org/js/telegram-web-app.js"></script>
<script src="https://tagds.net/sdk/v1/tagds.js" data-olcum async></script>

• Açılışta start_param bir Tagds kodu ise Telegram'ın imzaladığı initData'yı POST /api/olcum/acilis'e yollar. Tagds imzayı ilanın bot kimliğiyle doğrular: açılış (Açan) sayılır, oyuncu bağlantıya eşlenir (ilk dokunuş).
• Doğrulama koduyla açılışta yalnız sahiplik doğrulanır; kayıt ya da atıf yapılmaz.
• Kodsuz açılışta hiçbir istek gitmez.

Tagds.basladi()

// Oyuncu oyunu gerçekten başlattığında (ör. ilk seviyeye girince)
if (window.Tagds) Tagds.basladi(); // baslatti adımı; gizli anahtar gerekmez

Oyuncu oyunu gerçekten başlattığında çağır: baslatti adımını bildirir, gizli anahtar gerekmez. Sunucundan imzalı baslatti bildirimi de gönderirsen ikisinden ilki sayılır; ikincisi tekrar sayılmaz. Adım ilanda tanımlı değilse sayılmaz.

Dönüşüm bildirimi: POST /api/donusum

POST /api/donusum HTTP/1.1
Host: tagds.net
Content-Type: application/json
X-Tagds-Imza: <hex(HMAC-SHA256(secret, raw body))>

{"clickId":"AbCdEfGhIjKlMnOpQrStUv","telegramId":123456789,"adim":"baslatti","ts":1760000000}

clickId · string

Bağlantıdaki kod (start ya da start_param değeri): 16–64 karakter; harf, rakam, _ ve -.

telegramId · sayı

Oyuncunun Telegram kullanıcı kimliği (rakam dizisi de olur).

adim · string

İlanda tanımlı adım: baslatti, aktif_2, aktif_7, yatirdi ya da kendi adın (en çok 32 karakter).

ts · tam sayı

Unix zamanı (saniye); Tagds saatinden en çok ±5 dakika farklı.

İmza

X-Tagds-Imza = hex(HMAC-SHA256(gizli anahtar, ham gövde)). İmza gönderdiğin baytların aynısı üzerinden hesaplanır: gövdeyi imzaladıktan sonra yeniden serileştirme, boşluk ekleme. sha256= öneki de kabul edilir. Gövde JSON, en çok 4 KB.

Yanıtlar

{"ok":true,"sayildi":true,"durum":"sayildi","donusum_id":4182}

{"ok":true,"sayildi":false,"neden":"tekrar"}

{"ok":false,"neden":"imza","error":"İmza geçersiz"}

Eşleşme sorgusu: GET /api/donusum/tik/:kod

Bir kodun hangi ilana ve tanıtımcıya ait olduğunu sorar. İmza: hex(HMAC-SHA256(gizli anahtar, <kod>.<ts>)), aynı X-Tagds-Imza başlığında; ts sorguda.

// Bir kodun hangi ilana ve tanıtımcıya ait olduğunu sor
export async function lookup(code) {
  const ts = Math.floor(Date.now() / 1000);
  const signature = crypto.createHmac("sha256", SECRET).update(code + "." + ts).digest("hex");
  const res = await fetch(TAGDS + "/api/donusum/tik/" + code + "?ts=" + ts, { headers: { "X-Tagds-Imza": signature } });
  return res.json(); // { ok, kampanya_id, tanitimci, hesap, platform, … }
}

{"ok":true,"clickId":"AbCdEfGhIjKlMnOpQrStUv","baslangic":true,"kampanya_id":12,"paylasim_id":345,"tanitimci_id":67,"tanitimci":"@promoter","hesap":"@kanal","platform":"telegram","at":"2026-10-21T09:12:44.000Z","oyuncu":null,"adimlar":[]}

Paylaşım kodunda (baslangic: true) oyuncu ve adimlar boş döner: kod çok oyunculudur. Eski /r/ kodunda oyuncu ve adımları da gelir. Hata kodları dönüşüm bildirimiyle aynı.

Bildirim adresi (isteğe bağlı)

İlanda bir https adres tanımlarsan Tagds, bağlantıyla gelen her yeni oyuncunun ilk baslatti adımında bu adresi GET ile çağırır; tanıtımcı bilgisini kendi tarafında yakalarsın.

https://api.example.com/tagds?click=[clickId]&campaign=[campaignId]&promoter=[promoterId]&account=[account]&platform=[platform]&ts=[ts]

• Değerler URL kodlu yerleştirilir.
• Yalnız https, 443 portu ve alan adı (IP adresi, localhost yok).
• 5 saniye zaman aşımı, 3 deneme (1 ve 2 saniye arayla); 2xx başarı sayılır. Yönlendirme izlenmez, yanıt gövdesi okunmaz.
• Eski /r/ bağlantılarında her tıklamada çağrılır.

Gizli anahtar

• Kampanya detayı → Tanıtımcılar → Anahtar oluştur. tgs_ ile başlar (47 karakter) ve yalnız o anda bir kez gösterilir.
• Yenile: yeni anahtar hemen geçerli olur, eskisi anında geçersizleşir. Önce sunucundaki anahtarı değiştirmeye hazır ol.
• Anahtarı yalnız sunucuda tut (ortam değişkeni). Mini App'e, istemci koduna ya da depoya koyma.
• Anahtarı olmayan ilan tanıtımcılara görünmez.

Kod örnekleri

// Node.js 18+ — bağımlılık yok
import crypto from "node:crypto";

const TAGDS = "https://tagds.net";
const SECRET = process.env.TAGDS_SECRET; // tgs_… panelde bir kez gösterilen gizli anahtar

// Oyuncu bir adım atınca çağır.
// code: start / start_param değeri; telegramId: oyuncunun Telegram kimliği
export async function reportStep(code, telegramId, step) {
  const body = JSON.stringify({ clickId: code, telegramId, adim: step, ts: Math.floor(Date.now() / 1000) });
  const signature = crypto.createHmac("sha256", SECRET).update(body).digest("hex");
  const res = await fetch(TAGDS + "/api/donusum", {
    method: "POST",
    headers: { "content-type": "application/json", "X-Tagds-Imza": signature },
    body, // imzaladığın baytların aynısını gönder
  });
  return { status: res.status, ...(await res.json()) };
}

// Deneme: komut satırından çalıştır
// TAGDS_SECRET=tgs_… node report.mjs <code> <telegramId>
const [code, telegramId] = process.argv.slice(2);
console.log(await reportStep(code, Number(telegramId), "baslatti"));

# Python 3.8+ — bağımlılık yok
import hashlib, hmac, json, os, time, urllib.error, urllib.request

TAGDS = "https://tagds.net"
SECRET = os.environ["TAGDS_SECRET"].encode()  # tgs_… panelde bir kez gösterilen gizli anahtar

def report_step(code, telegram_id, step):
    """Oyuncu bir adım atınca çağır; (HTTP kodu, yanıt) döner."""
    # code: start / start_param değeri; telegramId: oyuncunun Telegram kimliği
    body = json.dumps({"clickId": code, "telegramId": telegram_id, "adim": step, "ts": int(time.time())},
                      separators=(",", ":")).encode()
    signature = hmac.new(SECRET, body, hashlib.sha256).hexdigest()
    req = urllib.request.Request(TAGDS + "/api/donusum", data=body, method="POST",  # imzaladığın baytların aynısını gönder
                                 headers={"content-type": "application/json", "X-Tagds-Imza": signature})
    try:
        with urllib.request.urlopen(req, timeout=10) as r:
            return r.status, json.load(r)
    except urllib.error.HTTPError as e:  # 4xx/5xx yanıtların gövdesi de JSON
        return e.code, json.load(e)

if __name__ == "__main__":  # Deneme: komut satırından çalıştır: TAGDS_SECRET=tgs_… python report.py <code> <telegramId>
    import sys
    print(report_step(sys.argv[1], int(sys.argv[2]), "baslatti"))

# Bash + openssl: TAGDS_SECRET ve CODE ortam değişkeni
BODY='{"clickId":"'"$CODE"'","telegramId":123456789,"adim":"yatirdi","ts":'"$(date +%s)"'}'
SIG=$(printf '%s' "$BODY" | openssl dgst -sha256 -hmac "$TAGDS_SECRET" | sed 's/^.* //')
curl -sS -X POST https://tagds.net/api/donusum \
  -H 'content-type: application/json' -H "X-Tagds-Imza: $SIG" -d "$BODY"

Test önerileri

İmzanı önce bu test vektörüyle karşılaştır (ağ gerekmez); gövde bayt bayt aynı olmalı:

secret    tgs_test_ornek
body      {"clickId":"AbCdEfGhIjKlMnOpQrStUv","telegramId":123456789,"adim":"baslatti","ts":1760000000}
signature 2c2a9365e74cf323166299bc1a23c8068ff2f59e6321305eddf97903ba55168c

secret    tgs_test_ornek
text      AbCdEfGhIjKlMnOpQrStUv.1760000000
signature 533d7df9f5ee87262b060eabc61544165c6d4a5b445d4020b52772b4904e39de

• Uçtan uca deneme gerçek ödeme doğurmasın: ilana tutarı 0 olan bir ölçüm adımı ekle (ör. test); sayılır ama bakiyeden düşmez.
• Aynı bildirimi ikinci kez gönder: 200 ve neden: tekrar.
• ts'yi 10 dakika geri al: 401 zaman. Anahtarın bir harfini değiştir: 401 imza. Uydurma kod: 404 tik_yok.
• Mini App: doğrulama bağlantısını Telegram'da aç; panelde Doğrulandı görmelisin.

Yayıncı SDK'sı (kısa)

Mini App'inde reklam göstermek için (yayıncı tarafı; tanıtım ölçümünden ayrı):

<script src="https://tagds.net/sdk/v1/tagds.js"></script>
<script type="module">
  // Ödüllü ya da tam ekran reklam
  const ad = Tagds.init({ blockId: "blk_…" });
  const r = await ad.show(); // r = { done, state, error, description }
  if (r.done) giveReward();

  // Banner: verdiğin öğenin içine çizilir
  await Tagds.banner({ blockId: "blk_…", el: "#banner" });
</script>

• show() her zaman çözülür: done ödüllüde ödül kazanıldıysa, görevde doğrulandıysa, tam ekranda gösterilip kapandıysa true. state: load (reklam yok ya da istek hatası), playing (erken kapandı), destroy (bitti), render (banner çizildi).
• Olaylar: ad.addEventListener("onStart" | "onReward" | "onSkip" | "onError", f).
• Kimlik Telegram.WebApp.initData'dan; bot token'ın bize gelmez. CSP'n varsa connect-src ve img-src'ye https://tagds.net ekle.
• Blok kodunu (blk_…) ve hazır kodu panelde uygulamanın sayfası verir; bağlantı çalışınca panel gösterir.

Mini App ya da bot ekleme

1. 1

   Uygulamanı ekle

   publisher.tagds.net → Uygulamalar → Uygulama ekle: Mini App bağlantısı (https://t.me/<bot>/<uygulama>), botun kullanıcı adı ve sayısal kimliği (token değil). Ödüllü ve görev reklamı için ödül adresi (https, [userId] yer tutuculu).
2. 2

   İncelemeyi bekle

   Uygulaman incelenir; onaylanınca reklam almaya hazırdır.

3. 3

   Blok ekle, kodu koy

   Biçimi seç (banner, ödüllü, tam ekran, görev), panelin verdiği kodu uygulamana yapıştır; bağlantı çalışınca panel gösterir.

• İstemediğin reklam kategorilerini kapatırsın; bir kişiye saatte en çok kaç ödüllü/tam ekran reklam gösterileceğini seçersin.
• Her reklamda "Reklam" etiketi ve kapatma düğmesi hep görünür.
• Reklamlar yalnız Telegram'ın doğruladığı gerçek kullanıcılara gösterilir; sayım sunucumuzda yapılır.

Kanal ve grup

1. 1

   Telegram'ı bağla

   Hesap menüsü → Telegram'ı bağla.

2. 2

   Kanalını ekle

   Kanallar → Kanal ya da grup ekle. Bağlantı 30 dakika geçerli; botu kanalına yönetici olarak ekle (gönderi paylaşma ve silme yetkisi). Ekleyen kişi orada yönetici olmalı.
3. 3

   Sahipliği doğrula

   Bot sana özelden bir doğrulama bağlantısı yollar; aç. Sonra kanal incelenir.

• Günde 1, 2 ya da 3 reklam; hangi saatlerde paylaşılacağını ve gönderinin kaç saat sonra silineceğini (ya da kalacağını) sen seçersin. İki reklam arasında en az 4 saat olur.
• Düğmeye tıklayan her gerçek kişi için kazanırsın (CPC). Kendi tıklamaların ve aynı kişinin tekrar tıklaması ödenmez.
• Bir gönderide ödenen tıklama sayısı kanalın üye sayısıyla sınırlıdır; sınırı aşan kanal incelemeye alınır.
• Botu kanaldan çıkarırsan paylaşım durur.

Kazanç ve ödemeler

• Reklamverenin senin uygulamanda ya da kanalında harcadığının standart %70'i sana yazılır (uygulamaya göre değişebilir; kendi oranını panelde görürsün).
• Kazanç gün sonunda kesinleşir ve 7 gün bekler; sonra çekilebilir olur.
• Çekilebilir bakiyen en az $10 olunca ödeme talebin kendiliğinden sıraya girer (talep açman gerekmez) ve USDT olarak TON cüzdanına gönderilir. Şu an ödemeler Tagds ekibi tarafından sırayla gönderiliyor; otomatik gönderim açılınca kendiliğinden gidecek. Durumu Ödemeler'de görürsün; büyük tutarlar Tagds onayından geçebilir.
• Ödemeler → TON cüzdan adresi (UQ… ya da EQ… ile başlayan 48 karakter). Kayıtlı adresi değiştirirsen 48 saat yeni ödeme açılmaz; ilk adres beklemez.

İçerik ve inceleme

• Her kampanya ve ilan yayından önce incelenir; görünen içerik değişince yeniden incelenir.
• Yasak kategoriler: kumar ve yetişkin içerik. Yayıncı ayrıca kendi uygulamasında istemediği kategorileri kapatır.
• Her reklamda "Reklam" etiketi var; tam ekran reklamda kapatma düğmesi hep görünür.
• Kanal gönderisi ve görev reklamının bağlantısı yalnız t.me adresine gider.
• Tanıtım ilanının hedefi reklamverenin kendi botu ya da Mini App'idir; Mini App'te sahiplik doğrulaması zorunlu.

Sahte trafik

• Gösterim, tıklama ve dönüşüm sunucumuzda sayılır; Mini App gösterimleri Telegram'ın imzaladığı kullanıcı bilgisiyle gelir.
• Kanal reklamında kanal sahibinin kendi tıklamaları ve aynı kişinin tekrar tıklaması ödenmez.
• Tanıtımda aynı Telegram hesabı ilan başına bir kez sayılır; ilk dokunuş kazanır; adımı reklamverenin botu imzalı bildirir.
• Bot hesaplar, ikinci hesaplar, kendi kendine tıklama ya da başlatma sahte trafiktir.

İade ve askıya alma

• Bekleme süresi (7 gün) içinde sahte bulunan trafiğin parası reklamverene iade edilir.
• Sahte bulunan yayıncının uygulaması ya da kanalı kapatılır; açık ödemesi iptal edilir.
• Sahte trafik getiren tanıtımcı askıya alınır: yeni paylaşım açamaz, dönüşümleri ödenmez; bekleme süresindeki kazancı iade edilir.
• Bekleme süresi dolmuş, çekilebilir olmuş kazanç geri alınmaz.

Hesap ve güvenlik

• Giriş e-posta ve şifreyle; Telegram hesabı isteğe bağlı bağlanır. Bir Telegram hesabı yalnız bir Tagds hesabına bağlanır.
• Bir kanal ya da grup yalnız bir Tagds hesabında olabilir.
• Tagds bot token'ını hiçbir zaman istemez; yalnız botun sayısal kimliğini ister.
• Gizli anahtarlar (tgs_…) yalnız sunucunda durur; paylaşma.

Gizlilik ve sahtecilik önleme

• Sahteciliği (çoklu hesap, sahte oyuncu, ödeme suistimali) önlemek için kayıt, giriş, Telegram bağlama, ödeme adresi değişikliği, paylaşım ve ödeme isteklerinde IP adresi, tarayıcı bilgisi (kullanıcı ajanı), cihaz bilgisi ve bir cihaz parmak izi kaydedilir.
• Parmak izi tarayıcıda ekran, saat dilimi, dil, donanım ve çizim özelliklerinden hesaplanan bir özettir; ham bilgiler cihazdan çıkmaz. Ayrıca tarayıcıda rastgele bir cihaz kimliği saklanır.
• Ölçüm kodu olan Mini App'lerde açılışla birlikte oyuncunun Telegram kimliği, IP adresi ve aynı cihaz bilgileri kaydedilir.
• Bu kayıtlar 180 gün saklanır, sonra silinir; yalnız sahtecilik incelemesi için Tagds yöneticileri görür, satılmaz ve reklam hedeflemesinde kullanılmaz.