Dokümantasyon

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öntemNe gerekir«Tracker» moduSayfa kaynağında bizim kodumuzZorluk
JS etiketi<head> erişimihayırgörünürkolay
PHP dosyasıPHP’li hostingevetgörünmez: karar sunucudaorta
Keitaro / Binomkendi tracker’ınızhayırgörünmez: karar sunucudaorta
Site oluşturucular, Cloudflareservis hesabıhayırgö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

  1. Akışı bulun

    Akışlar bölümü → gereken akışın satırında ⋯ → Bağla.

    Listede akış satırı: «⋯» düğmesi ve «Bağla», «Çoğalt», «Sil» öğelerinin bulunduğu açık menü
    Akış satırı: 1 — akış işlemleri menüsü, 2 — bağlantı penceresi.
  2. 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.

    «Bağla» penceresi: yöntem listesi — JS betiği, PHP dosyası («Kurulu» işaretli), Keitaro, Binom, WordPress, Cloudflare, Tilda
    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

  1. Kodu kopyalayın

    Landing sayfanıza script ekleyin bölümünü açın ve kodun sağındaki kopyalama düğmesine basın 1.

    «Landing sayfanıza script ekleyin» bloğu: kod alanı ve kopyalama düğmesi, head’e ekleme şeması, etiket yöneticileri uyarısı
    Demo hesapta kod gizlidir; panelinizde 1 alanında akışınızın kodu olur.  2 satırı — nereye ekleneceği: <head>’den hemen sonra.
  2. 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, async veya defer da eklemeyin: bunlarla betik daha geç çalışır ve sayfa, karar henüz yokken herkese gösterilir.

  3. 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.

    «Sayfamı kontrol et» düğmeli «Bağlantıyı kontrol edin» adımı
    Kontrol düğmesi — JS etiketinde ve PHP dosyasında son adım.
    Kontrolden sonra «Bağlantıyı kontrol edin» adımı: «Sayfamı kontrol et» düğmesi ve «Sayfanızda bulundu» satırı
     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.

  1. Dosyayı indirin

    Dosyayı sunucunuza yükleyin bölümünü açın ve Dosyayı indir’e basın 1.

    «Dosyayı sunucunuza yükleyin» bloğu: «Dosyayı indir» düğmesi, index.php ve offer.php içeren klasör şeması, yeni landing adresi adımı
    PHP dosyası bloğu: 1 indirme düğmesi ve landing klasörünün şeması 2.
  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)
  3. Yeni landing adresini akışın offer’ına yazın

    Örneğin, https://siteniz.com/offer.php.

  4. Yanına .htaccess dosyasını koyun

    Bu satırlar tüm akışlar için aynıdır; klasörde zaten .htaccess varsa onları mevcut RewriteEngine On satırının altına ekleyin.

    .htaccess
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteRule ^ index.php [L,QSA]
  5. Bağlantıyı kontrol edin

    Sayfamı kontrol et düğmesi — panel dosyanın yanıt verdiğini kontrol eder.

.htaccess kuralı neden gerekli

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.

nginx
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

  1. Dosya yöneticisini açın

    Hosting panelinde — «Dosyalar» veya «Dosya Yöneticisi» bölümü 1.

  2. Landing klasörüne gidin

    Genellikle public_html (bazen www veya htdocs), ardından reklamın yönlendirdiği klasör 2.

  3. «Yükle»ye basın

     3 düğmesi yükleme penceresini açar.

    Hosting paneli örneği: dosya yöneticisi, /public_html/promo/ yolu ve «Yükle» düğmesi
    Arayüz örneği — hostinginizde düğmelerin adı farklı olabilir. 1 dosya yöneticisi, 2 landing klasörü, 3 yükleme.
  4. Dosyaları seçin

    index.php ve .htaccess dosyalarını pencereye sürükleyin 4 ve «yüklendi» işaretini bekleyin 5. Ad tam olarak index.php olmalıdır: tarayıcı dosyayı tekrar indirirken bazen ada «(1)» ekler.

    Yükleme penceresi örneği: dosya alanı ve yüklenmiş iki dosya, index.php ve .htaccess
    Arayüz örneği. 4 yükleme alanı, 5 yüklenen dosyalar.
  5. İzinleri kontrol edin ve siteyi açın

    Dosya izinleri — 644, klasörler — 755. .htaccess dosyası 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

  1. 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.

  2. Sunucuda landing klasörünü açın

    Sağda — sunucu: public_html/klasor yoluna gidin 3.

  3. Dosyaları aktarın

    Solda — bilgisayarınız: index.php ve .htaccess dosyalarını seçin 4 ve sağa sürükleyin 5.

    FTP istemcisi örneği: bağlantı alanları, solda bilgisayardaki dosyalar, sağda sunucudaki /public_html/promo/ klasörü
    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.
HataNasıl anlaşılırNe yapmalı
Dosya başka klasördeKontrol: «Sayfanız açıldı, ancak bu kurulum sayfada yanıt vermedi»Dosyayı reklamdaki adresle açılan klasöre koyun
Eski PHPSayfada «PHP 7.2 or higher is required.» yazıyorHosting 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’siGü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ğiSayfayı herkes görüyor veya karar gecikmeli değişiyorLanding’i önbellekten hariç tutun

Keitaro filtresi

Bağlantı penceresinde «Keitaro filtresi» bloğu: üç adım ve «Filtreyi indir» düğmesi
 1 filtreyi indir, 2 dosyanın Keitaro sunucusunda nereye konacağı, 3 filtrenin Keitaro akışına nasıl ekleneceği.

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.

  1. Bu akışın filtre dosyasını indirin

  2. Onu Keitaro sunucusuna koyun

    /var/www/keitaro/var/filters klasörüne (eski sürümlerde — application/filters) ve Keitaro sayfasını yenileyin.

  3. 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

Bağlantı penceresinde «Binom geçidi» bloğu: üç adım, dosyayı dahil etme satırı ve «Geçidi indir» düğmesi
 1 geçidi indir, 2 landing’in ilk satırı için satır, 3 kontrol: insan landing’de, bot White Page’de.

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.

  1. Bu akışın geçit dosyasını indirin

    Ve sunucunuzda Binom landing dosyasının yanına koyun.

  2. Dosyayı landing’in ilk satırında dahil edin

    Herhangi bir çıktıdan önce:

    Binom landing’i
    <?php require __DIR__ . '/ac_binom_NNN.php'; ?>
  3. 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 filtresinde «Ön açılış sayfasında tarayıcı kontrolü» bloğu: ön açılış sayfası adresi için parametre, etiket ve üç yeşil kontrol satırı
 1 ön açılış sayfası adresi için parametre, 2 onun <head> bölümü için etiket, 3 üç kontrol satırı — her şey bağlı.

Keitaro

  1. Ö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:

    Parametre
    NAME={subid}
  2. Etiketimizi bu ön açılış sayfasının <head> bölümünün en başına yapıştırın

  3. 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

  1. 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:

    Parametre
    NAME={clickid}
  2. Etiketimizi aynı landing’in <head> bölümünün en başına yapıştırın

  3. 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

Bağlantı penceresinde WordPress bloğu: eklenti kurulum adımları ve «Eklentiyi indir» düğmesi
 1 eklentiyi indir, 2 WordPress’e kur, 3 API token’ını yapıştır, 4 akışı seç.

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.

Tilda bloğu: yapıştırılacak kod ve üç adım
Tilda. 1 «Yapıştırılacak kod», 2 kurulum adımları.
Webflow bloğu: yapıştırılacak kod ve üç adım
Webflow. 1 «Yapıştırılacak kod», 2 kurulum adımları.
Unbounce bloğu: yapıştırılacak kod ve dört adım
Unbounce. 1 «Yapıştırılacak kod», 2 kurulum adımları.
Shopify bloğu: yapıştırılacak kod ve dört adım
Shopify. 1 «Yapıştırılacak kod», 2 kurulum 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.
    Yanıt kodu parantez içinde yazar — onu desteğe iletebilirsiniz.
  • 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.
Kod ilk yüklenmeli

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.