Keitaro Entegrasyon Rehberi

Blockchain-Ads ağı için Keitaro kullanarak sunucudan sunucuya (S2S) dönüşüm takibini kurmak için, Blockchain-Ads'ı bir postback URL'si oluşturacak şekilde yapılandıracak (Keitaro'nun dönüşüm verilerini göndereceği yer) ve ardından bunu Keitaro'da özel bir trafik kaynağı olarak entegre edeceksiniz. Bu, Keitaro'nun gelen trafikten {clickid}’yi yakalamasını ve eşleşen tıklama kimlikleri, gelir ve diğer ayrıntılarla birlikte Blockchain-Ads'a postback göndermesini sağlar.

Adım 1: Blockchain-Ads'da S2S Dönüşüm Olayını Oluşturun

1. Blockchain-Ads HUB kontrol panelinize giriş yapın.
2. Advertising > Tracking > Create Conversion > Server to Server'a gidin.
3. Olayı kurmak için ekrandaki talimatları takip edin:
   
   • Dönüşüm olayını adlandırın (örneğin, "Lead" veya "Sale").
   • Olay türünü (örneğin, lead, purchase) ve uygunsa gelir alanlarını belirtin.
   • Bu, olayınız için benzersiz bir izleyici kimliği ve aşağıdaki formatta bir postback URL'si oluşturacaktır:

 GET https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={transaction_value}

• {clickid}: Benzersiz tıklama kimliği için yer tutucu (Blockchain-Ads bunu orijinal tıklama ile eşleştirecektir).
• trackerid: Sabit olay kimliğiniz (değiştirmeyin).
• {transaction_value}: Gelir/ödeme tutarı için isteğe bağlı yer tutucu (gelir takip etmiyorsanız atlayabilirsiniz).

Bu tam postback URL'sini kopyalayın—Keitaro'da ihtiyaç duyacaksınız.

4. Olayı kaydedin. Not: Blockchain-Ads'da kampanyalar oluştururken, hedef URL'nizi Keitaro kampanya URL'nize ayarlayın (örneğin, https://your-keitaro-domain.com/campaign123?clickid={clickid}). Blockchain-Ads gerçek tıklama kimliği değerini otomatik olarak ekleyecektir.

Adım 2: Keitaro'da Blockchain-Ads'ı Özel Trafik Kaynağı Olarak Ekleyin

1. Keitaro kontrol panelinize giriş yapın.
2. Traffic Sources > Create'e gidin.
3. "From template" alanında "Blockchain-Ads" arayın—şablon yoksa Custom seçin veya manuel olarak oluşturmak için boş bırakın.
4. Temel bilgileri doldurun:
   
   • Name: "Blockchain-Ads".
   • Click ID parametresi: Bunu clickid olarak ayarlayın (bu, Keitaro'ya Blockchain-Ads trafiğinden gelen ?clickid=xxx değerini yakalamısını ve postback'ler için harici kimlik olarak dahili olarak saklanmasını söyler).
5. Parametre şablonu bölümünde (istenirse):
   
   • Tıklama kimliği için bir satır ekleyin:
     
     • Sütun 1 (Alias): Boş bırakın veya raporlama için "External ID" olarak ayarlayın.
     • Sütun 2 (Parameter name): clickid.
     • Sütun 3 (Macro): Boş bırakın (Blockchain-Ads gerçek değeri doğrudan eklediği için).
   • Gerekirse diğer parametreleri ekleyin (örneğin, Blockchain-Ads makrolarından kampanya kimliği veya subID'ler için).
6. S2S Postback alanında:
   
   • Adım 1'deki postback URL'sini yapıştırın.
   • Blockchain-Ads yer tutucularını Keitaro eşdeğerleriyle değiştirin:
     
     • {clickid} → {external_id} (yakalanan tıklama kimliğini geri iletir).
   • Dönüştürülmüş URL örneği:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

Yalnızca belirli dönüşüm durumlarını göndermek istiyorsanız (örneğin, onaylı müşteri adayları), bunları seçmek için "Send only statuses" açılır menüsünü kullanın (örneğin, "Lead", "Sale").

7. Trafik kaynağını kaydetmek için Create'e tıklayın.
8. (Opsiyonel) Birden fazla kampanyanız varsa, bunu mevcut kampanyalara uygulamak için Update in campaigns'i işaretleyin.

Adım 3: Keitaro'da Bir Kampanya Kurun ve Test Edin

1. Campaigns > Create'e gidin (veya mevcut bir kampanyayı düzenleyin).
2. Traffic Source olarak Blockchain-Ads'ı seçin.
3. Akışınızı oluşturun: Stream'ler, landing page'ler ve teklifler ekleyin. Dönüşümler için:
   
   • Affiliate teklifler kullanıyorsanız, affiliate ağından Keitaro'ya postback'ler kurun (Affiliate Networks altında).
   • Dönüşüm kurallarını tanımlayın (örneğin, tekliften S2S postback, pixel tetikleme veya özel etkinlikler).
4. Keitaro kampanya URL'nizi oluşturun ve kopyalayın (https://your-domain.com/abc?clickid={external_id} gibi görünecektir—bunu Blockchain-Ads kampanyanızdaki hedef olarak yapıştırın).
5. Test:
   
   • Keitaro URL'sine işaret eden Blockchain-Ads'da bir test kampanyası başlatın.
   • Bir tıklama ve dönüşümü simüle edin (örneğin, bir test teklifi aracılığıyla).
   • Yakalanan tıklamalar/dönüşümler için Keitaro raporlarını (Reports > Conversions) kontrol edin.
   • Blockchain-Ads takibinde postback'lerin ulaştığını doğrulayın (eşleşen tıklama kimlikleri ve gelir).
   • Gerekirse, manuel olarak bir test postback tetiklemek için Postman gibi araçlar kullanın.

İpuçları ve Sorun Giderme

• Keitaro'daki yer tutucular: clickid için {external_id}, tutarlar için {revenue} ve olay türleri için {status} kullanın (örneğin, "lead"’i bir duruma eşleyin). Kodlanmamış değerler için _ öneki kullanın (örneğin, {_external_id}).
• Gelir/Para Birimi: Dönüşümlerin farklı para birimleri varsa, dönüştürmek için {revenue:USD} kullanın.
• Hatalar: Postback'ler için HTTPS kullandığınızdan emin olun. Veri akmadığında, URL kodlamasını, güvenlik duvarı engellerini veya eşleşmeyen izleyici kimliğini kontrol edin. Keitaro, postback girişimlerini Logs > Postbacks'te kaydeder.
• Gelişmiş: Birden fazla etkinlik için, Blockchain-Ads'da ayrı dönüşüm etkinlikleri oluşturun ve Keitaro'ya birden fazla postback URL'si ekleyin (durum başına bir tane).

Bu kurulum, çerezler olmadan doğru atribusyon sağlar. Keitaro hakkında daha fazla ayrıntı için docs.keitaro.io adresindeki belgelerine bakın