Dokümantasyon bölümleri
Trafik
Siteye bağlama
Akışın çalışmaya başlaması için onu sitenize bağlayın. Tek bir yöntem yeterlidir. Reklamda sitenizin adresi yer alır ve sayfalar sizde kalır.
Bu sayfada
Hangi yöntemi seçmeli
- Site Tilda, Webflow, Unbounce, Shopify veya WordPress üzerinde → site oluşturucu.
- Trafik zaten kendi Keitaro veya Binom’unuzdan geçiyor → Keitaro filtresi veya Binom geçidi.
- «Tracker» modu gerekiyor → yalnızca PHP dosyası.
- Sitenin kodu düzenlenemiyor ama alan adı Cloudflare’de → Cloudflare.
- Diğer durumlarda → JS etiketi, bağlantı penceresindeki ilk yöntem.
| Yöntem | Ne gerekir | «Tracker» modu | Sayfa kaynağında bizim kodumuz | Zorluk |
|---|---|---|---|---|
| JS etiketi | <head> erişimi | hayır | görünür | kolay |
| PHP dosyası | PHP’li hosting | evet | görünmez: karar sunucuda | orta |
| Keitaro / Binom | kendi tracker’ınız | hayır | görünmez: karar sunucuda | orta |
| Site oluşturucular, Cloudflare | servis hesabı | hayır | görünür (aynı etiket) | kolay |
Akışın sitesi bizde barındırılıyorsa (Site nerede barındırılsın → Bizim sunucumuzda) hiçbir şey bağlamanız gerekmez: akış dosyasını sunucuya biz koyar ve kendimiz güncelleriz. Ayrıntılar Siteler bölümünde.
Bağlantı penceresini açın
Akışı bulun
Akışlar bölümü → gereken akışın satırında ⋯ → Bağla.

Akış satırı: 1 — akış işlemleri menüsü, 2 — bağlantı penceresi. Bir yöntemi açın
Yöntemler daraltılmıştır, aynı anda yalnızca biri açılabilir. Çalışan yöntem yeşille ve «Kurulu» rozetiyle işaretlenir.

Akışın bağlantı penceresi: 1 JS etiketi, 2 PHP dosyası — burada sitede zaten kurulu.
«Tracker» modundaki akış yalnızca PHP dosyasıyla bağlanır — etiket, Keitaro, Binom ve site oluşturucular onun için gösterilmez.
JS etiketi
Kodu kopyalayın
Landing sayfanıza script ekleyin bölümünü açın ve kodun sağındaki kopyalama düğmesine basın 1.

Demo hesapta kod gizlidir; panelinizde 1 alanında akışınızın kodu olur. 2 satırı — nereye ekleneceği: <head>’den hemen sonra.Onu <head> içine ilk satır olarak ekleyin
Landing’in her sayfasında —
<head>’den hemen sonra, diğer tüm betiklerin üstüne 2. Kaydedin ve sayfayı yenileyin.index.html<head> <!-- bağlantı penceresindeki kod --> <meta charset="utf-8"> … </head>Kodu Google Tag Manager veya başka etiket yöneticileri üzerinden eklemeyin,
asyncveyadeferda eklemeyin: bunlarla betik daha geç çalışır ve sayfa, karar henüz yokken herkese gösterilir.Bağlantıyı kontrol edin
Sayfamı kontrol et’e basın: panel, akışın offer’ının bulunduğu klasörün ana sayfasını açar ve orada kodu arar. Offer adresi olmadan kontrol başlamaz.

Kontrol düğmesi — JS etiketinde ve PHP dosyasında son adım. 
1 kontrol düğmesi, 2 yanıt: kod sayfada bulundu. Blokta «Kurulu» işareti görünür.
Etiket karar gelene kadar sayfayı gizler. Karar 5 saniye içinde gelmezse etiket White Page’e yönlendirir. White Page’in kendi adresi yoksa («Durum kodu» modu veya bizim hazır sayfamız) ziyaretçi boş bir sayfa görür.
PHP dosyası
PHP destekli hostingdeki siteler için. «Tracker» modu için tek yöntemdir. Gölge modu PHP dosyasıyla, Keitaro filtresiyle ve Binom geçidiyle çalışır.
Dosyayı indirin
Dosyayı sunucunuza yükleyin bölümünü açın ve Dosyayı indir’e basın 1.

PHP dosyası bloğu: 1 indirme düğmesi ve landing klasörünün şeması 2. Onu landing’in kök klasörüne index.php adıyla koyun
Kendi landing’inizi ise yeniden adlandırın, örneğin
offer.php:Landing klasörü/ ├── index.php ← bizim dosyamız └── offer.php ← sizin landing’iniz (önceden index.php veya index.html)Yeni landing adresini akışın offer’ına yazın
Örneğin,
https://siteniz.com/offer.php.Yanına .htaccess dosyasını koyun
Bu satırlar tüm akışlar için aynıdır; klasörde zaten
.htaccessvarsa onları mevcutRewriteEngine Onsatırının altına ekleyin..htaccessRewriteEngine On RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule ^ index.php [L,QSA]Bağlantıyı kontrol edin
Sayfamı kontrol et düğmesi — panel dosyanın yanıt verdiğini kontrol eder.
Kural, sitede olmayan adreslere gelen tüm istekleri bizim dosyamıza yönlendirir. Bu iki şey için gereklidir.
Ön açılış sayfası. Ön açılış sayfasındaki düğmeden sonra offer, reklam bağlantısıyla aynı klasördeki start adresinde açılır: siteniz.com/offer.php offer’ı için siteniz.com/start?etiketler, siteniz.com/klasor/offer.php için siteniz.com/klasor/start?etiketler. Kural olmadan bu sayfa yenilenince 404 hatası olur. Kuralla {click_url} düğmesi bizim geçiş adresimize değil, sizin alan adınıza — siteniz.com/start?etiketler — götürür: tıklamayı dosya bize kendisi iletir ve ön açılış sayfasının kodunda bizim alan adımız yer almaz.
Başka alan adındaki White Page. Onun sayfalarını, görsellerini ve stillerini dosya sizin alan adınızın adresleriyle sunar: menüdeki white-site.com/kontakt.html bağlantısı siteniz.com/kontakt.html olur ve ziyaretçi White Page’in alan adına gitmez. Kural olmadan bağlantılar White Page’in alan adına gitmeye devam eder.
Apache’siz nginx’te aşağıdaki kuralı ekleyin (/folder/ yerine — kendi klasörünüz) ve yine de index.php’nin yanına aynı satırlarla bir .htaccess dosyası koyun: nginx onu okumaz, ama bizim dosyamız kuralın ayarlandığını ondan anlar. Yalnızca try_files bırakırsanız sayfa normal yenilenir, ama ön açılış sayfası düğmesi ve White Page bağlantıları bizim adreslerimize gider.
location /folder/ {
try_files $uri $uri/ /folder/index.php?$query_string;
}Sunucudaki dosya kendiliğinden güncellenmez. Yeni sürüm çıktıysa pencerede «Eski bir dosya çalıştırıyorsunuz» rozeti ve sürümünüzün yapamadıklarının listesi görünür. Dosyayı yeniden indirip değiştirin.
Dosya hostinge nasıl yüklenir
PHP dosyasını ve .htaccess’i sitenin, reklamın yönlendirdiği klasörüne koyun. Reklam my-landing.com/promo/ adresine gidiyorsa bu public_html/promo/ klasörüdür; kök my-landing.com/ adresine gidiyorsa public_html/’in kendisidir.
Klasörde zaten index.php veya index.html varsa — bu sizin landing’inizdir. Önce onu yeniden adlandırın, örneğin offer.php, ve yeni adresi akışın offer’ına yazın; ancak ondan sonra bizim index.php’mizi yükleyin. Aksi hâlde landing’in yerini alır. Hem index.html hem index.php varsa birçok hosting önce index.html’i açar — o zaman bizim dosyamız çalışmaz.
Hosting panelinin dosya yöneticisiyle
Dosya yöneticisini açın
Hosting panelinde — «Dosyalar» veya «Dosya Yöneticisi» bölümü 1.
Landing klasörüne gidin
Genellikle
public_html(bazenwwwveyahtdocs), ardından reklamın yönlendirdiği klasör 2.«Yükle»ye basın
3 düğmesi yükleme penceresini açar.

Arayüz örneği — hostinginizde düğmelerin adı farklı olabilir. 1 dosya yöneticisi, 2 landing klasörü, 3 yükleme. Dosyaları seçin
index.phpve.htaccessdosyalarını pencereye sürükleyin 4 ve «yüklendi» işaretini bekleyin 5. Ad tam olarakindex.phpolmalıdır: tarayıcı dosyayı tekrar indirirken bazen ada «(1)» ekler.
Arayüz örneği. 4 yükleme alanı, 5 yüklenen dosyalar. İzinleri kontrol edin ve siteyi açın
Dosya izinleri —
644, klasörler —755..htaccessdosyası bazı yöneticilerde gizlidir — «gizli dosyaları göster»i açın. Landing adresini tarayıcıda açın ve panelde Sayfamı kontrol et’e basın.
FTP veya SFTP istemcisiyle
Bağlanın
Sunucu, kullanıcı adı ve şifre hosting panelinin FTP/SSH bölümünde bulunur 1. Port: FTP için 21, SFTP için 22. «Bağlan»a basın 2.
Sunucuda landing klasörünü açın
Sağda — sunucu:
public_html/klasoryoluna gidin 3.Dosyaları aktarın
Solda — bilgisayarınız:
index.phpve.htaccessdosyalarını seçin 4 ve sağa sürükleyin 5.
Arayüz örneği — istemcinizde düğmelerin adı farklı olabilir. 1 bağlantı bilgileri, 2 bağlan, 3 sunucudaki klasör, 4 bilgisayardaki dosyalar, 5 aktar.
| Hata | Nasıl anlaşılır | Ne yapmalı |
|---|---|---|
| Dosya başka klasörde | Kontrol: «Sayfanız açıldı, ancak bu kurulum sayfada yanıt vermedi» | Dosyayı reklamdaki adresle açılan klasöre koyun |
| Eski PHP | Sayfada «PHP 7.2 or higher is required.» yazıyor | Hosting panelinde PHP 7.2 veya daha yenisini açın |
| .htaccess yok veya gizli | Ön açılış sayfasındaki düğmeden sonra start sayfası 404 veriyor | .htaccess dosyasını index.php’nin yanına yükleyin |
| Hosting proxy’si | Günlükte tüm ziyaretlerin IP’si aynı | Alan adını Cloudflare üzerinden geçirin (turuncu bulut) veya hostingden ziyaretçinin gerçek IP’sini iletmesini isteyin (bkz. Bir şey çalışmıyorsa) |
| Hosting veya CDN önbelleği | Sayfayı herkes görüyor veya karar gecikmeli değişiyor | Landing’i önbellekten hariç tutun |
Keitaro filtresi

Trafik zaten Keitaro’nuzdan geçiyorsa ArtisanClo, Keitaro akışında bir filtre olur: Keitaro ziyaretçiyi offer’a geçirip geçirmeyeceğini bize sorar, tam olarak nereye yönlendirileceğine ise Keitaro’daki akışlarınız karar verir.
Bu akışın filtre dosyasını indirin
Onu Keitaro sunucusuna koyun
/var/www/keitaro/var/filtersklasörüne (eski sürümlerde —application/filters) ve Keitaro sayfasını yenileyin.Filtreyi kampanyaya ekleyin
Keitaro kampanyasında offer’lı akışı açın ve dosyanın adıyla aynı adlı filtreyi «Evet» modunda ekleyin. Altına White Page’inizin olduğu akışı koyun — filtreyi geçemeyen herkes oraya düşer.
Keitaro filtreye ziyaretçiye yanıt vermeden önce başvurur, bu yüzden burada bekleme sayfası yoktur: JavaScript kontrolü, sayfada kalma süresi ve canlı etkileşim bu yöntemde çalışmaz, karar yalnızca ağa ve isteğin verilerine göre verilir. ArtisanClo akışındaki offer ve White Page adresleri kullanılmaz — bunları Keitaro akışları belirler. Servisimiz 3 saniye içinde yanıt vermezse ziyaret White Page’e gider. JavaScript, süre ve etkileşim kontrolü ayrıca açılabilir — bkz. Ön açılış sayfasında tarayıcı kontrolü.
Binom geçidi

Trafik Binom’unuzdan geçiyorsa ArtisanClo landing’e geçit olarak bağlanır: kontrolümüz landing’in ilk satırında durur ve landing açılmadan önce kime gösterileceğine karar verir. İnsan, offer’a giden olağan Binom bağlantısıyla landing’inizi görür; bot ve denetçi — White Page.
Bu akışın geçit dosyasını indirin
Ve sunucunuzda Binom landing dosyasının yanına koyun.
Dosyayı landing’in ilk satırında dahil edin
Herhangi bir çıktıdan önce:
Binom landing’i<?php require __DIR__ . '/ac_binom_NNN.php'; ?>Bağlantıyı kontrol edin
İnsan landing’e geçer, bot White Page alır.
Geçit, landing ziyaretçiye yanıt vermeden önce karar verir, bu yüzden onda bekleme sayfası yoktur: JavaScript kontrolü, sayfada kalma süresi ve canlı etkileşim çalışmaz, karar yalnızca ağa ve isteğin verilerine göre verilir. Servisimiz 3 saniye içinde yanıt vermezse ziyaretçi, adresi indirme sırasında dosyaya yazılan White Page’i görür. White Page’i değiştirdiyseniz dosyayı yeniden indirin. White Page’in kendi adresi yoksa («Durum kodu» modu veya bizim hazır sayfamız) geçit böyle bir durumda 503 hatasıyla yanıt verir. Binom’da Keitaro’daki gibi bir filtre klasörü yoktur, bu yüzden landing’in içindeki bir dosyayla bağlanırız. JavaScript, süre ve etkileşim kontrolü ayrıca açılabilir — bkz. Ön açılış sayfasında tarayıcı kontrolü.
Ön açılış sayfasında tarayıcı kontrolü
Tracker filtresi yalnızca IP adresini ve istek başlıklarını görür — tarayıcının kendisini kontrol etmez. Onu da kontrol etmek için etiketimizi, tracker’ın filtreyi geçenleri gönderdiği ön açılış sayfasına koyun. Etiket JavaScript’in çalışıp çalışmadığına, ziyaretçinin sayfada ne kadar kaldığına, fareyi oynatıp oynatmadığına veya sayfayı kaydırıp kaydırmadığına ve otomatik bir tarayıcı olup olmadığına bakar. Kontrolü geçemeyen White Page görür. Geçen ön açılış sayfasında kalır ve kampanyanızda ilerler. İstatistikte ziyaret iki kez değil, bir kez sayılır.
Akışın bağlantı penceresinde, Keitaro filtresi veya Binom geçidi bloğunda açılır. Orada ön açılış sayfası adresi için tam parametre (aşağıda NAME olarak gösterilmiştir) ve her şeyin doğru bağlandığını gösteren üç satır yer alır.

Keitaro
Ön açılış sayfasının adresine parametreyi ekleyin
Keitaro’da, offer’lı akışta ön açılış sayfasının (veya landing’in) adresine bu parametreyi ekleyin — adreste henüz parametre yoksa
?ile, varsa&ile. Filtrenin geçirdiği ziyaretçiyi ön açılış sayfasında bununla tanırız:ParametreNAME={subid}Etiketimizi bu ön açılış sayfasının <head> bölümünün en başına yapıştırın
Filtre dosyasını güncelleyin
Onu yeniden indirip eskisinin yerine koyun — yeni sürüm subid’yi bize iletir. Sonra kampanya bağlantısını kendiniz açın: ilk ziyaretten sonra üç kontrol satırı yeşile döner.
Binom
Landing adresine parametreyi ekleyin
Binom’da landing adresine bu parametreyi ekleyin —
?veya&ile. Geçidin geçirdiği ziyaretçiyi landing’de bununla tanırız:ParametreNAME={clickid}Etiketimizi aynı landing’in <head> bölümünün en başına yapıştırın
Geçit dosyasını güncelleyin
Onu yeniden indirip eskisinin yerine koyun — yeni sürüm clickid’yi okur. Sonra kampanya bağlantısını kendiniz açın: ilk ziyaretten sonra üç kontrol satırı yeşile döner.
Parametre olmadan da ziyareti IP adresine ve tarayıcıya göre eşleştiririz, ama daha az isabetle: mobil operatörlerde tek bir adresi çoğu zaman birçok kişi paylaşır. Tracker’ın geçirdiği ziyaret, etiket yanıt verir vermez günlükte görünür. Ziyaretçi ön açılış sayfasına hiç ulaşmadıysa ziyaret yaklaşık iki dakika sonra, tracker’daki filtrenin verdiği kararla kaydedilir. Ön açılış sayfasını tracker’ı atlayarak doğrudan açan kişi (örneğin reklam ağının moderatörü) etiketin tam kontrolünden geçer. Gölge modunda ve «Tracker» modunda bu kontrol çalışmaz.
Site oluşturucular

Starter’da JS etiketi, PHP dosyası, Keitaro filtresi ve Binom geçidi kullanılabilir. WordPress eklentisi, Cloudflare worker’ı ve site oluşturucular için adım adım talimatlar — Professional’dan itibaren ve deneme süresinde. Tilda, Webflow, Unbounce veya Shopify üzerindeki bir site Starter’da da bağlanabilir — sıradan JS etiketiyle, sadece talimat olmadan.
- WordPress Professional’dan itibaren — Eklentiyi indir → WordPress’te «Eklentiler» → «Yeni ekle» → «Eklenti yükle» → «Şimdi kur» → «Etkinleştir» → «Ayarlar» → Traffic Gate (eklentimizin adı budur) → «API entegrasyonu» bölümündeki (avatar menüsü) API token’ını yapıştırın ve akışı seçin. Sitede önbellek eklentisi varsa bağladıktan sonra önbelleği temizleyin.
- Tilda, Webflow Professional’dan itibaren — site oluşturucunun kendisinin ücretli tarifesi gerekir. Kodu head bölümüne yapıştırın ve siteyi yayınlayın.
- Unbounce Professional’dan itibaren — Script Manager, yerleşim — Head. unbouncepages.com alt alan adında çalışmaz: kendi alan adınız gerekir.
- Shopify Professional’dan itibaren — kodu tema şablonunda
<head>’den hemen sonra yapıştırın.
Her site oluşturucunun bağlantı penceresinde kendi bloğu vardır: 1 yapıştırılacak kod — sağdaki düğmeyle kopyalanır, 2 bu site oluşturucu için adımlar.




Cloudflare Professional’dan itibaren — etiketi Cloudflare tarafındaki worker ekler, sitenin dosyaları değişmez. Adım adım anlatım Cloudflare ile bağlama bölümünde.
Bağlantı kontrolü
- Kontrol yanıtları: «Kurulum sayfanızda bulundu», «Sayfanız açıldı, ancak bu kurulum sayfada yanıt vermedi» veya sayfanın açılamadığına dair bir yanıt — nedeniyle birlikte:
- sayfa kontrolümüzü içeri almadı — çoğunlukla hostingin veya CDN’in bot koruması (örneğin Cloudflare kontrolü). Bağlantı yine de doğru kurulmuş olabilir: bunu ilk gerçek ziyaret doğrular;
- offer adresinde sayfa yok;
- sayfanızın bulunduğu sunucu hatayla yanıt verdi;
- sayfa zamanında yanıt vermedi;
- sayfa yönlendirmelerle başka yere gidiyor.
- Sayfada başka bir akışınızın etiketi varsa kontrol bunu açıkça söyler: «Sayfada başka bir akışınızın etiketi var — «…». Onu yukarıdaki bağlantı penceresindeki bu akışın kod parçasıyla değiştirin» (kod parçası, etiketin kodudur).
- Kontrol 20 saniyede bir yapılabilir; daha erken basarsanız panel «Az önce kontrol edildi» yanıtını verir. Her kontrol, Keitaro ve Binom dahil tüm yöntemlerde «Kurulu» ve «Bağlı» işaretlerini kaldırır. «Kurulu», kontrol bağlantıyı bulduysa hemen, aksi hâlde ilk ziyaretle geri gelir. «Bağlı» her zaman ilk ziyaretle geri gelir.
- Yöntemin altında «Şu an çalışıyor» veya son çalışma tarihi görünür.
Etiket betiği yüklenmezse (örneğin ağ veya sunucudaki bir koruma engellerse) sayfa gizlenmez ve moderasyon onu görür. Kodu ilk satıra koyun ve sitede her düzenlemeden sonra bağlantıyı kontrol edin.
ArtisanClo · Panel dokümantasyonu. Sorularınız için: info@artisanclo.com veya Telegram’da @artisanclo_support.