Skip to main content
Events API, Whop Pixel’in sunucu tarafındaki karşılığıdır. POST /events, pikselin tarayıcıdan gönderdiği olayların aynısını kabul eder; böylece hiçbir pikselin çalışmadığı yerlerde gerçekleşen dönüşümleri raporlayabilirsiniz. Bu, CRM’inizde kapanan bir satışı, kendi arka ucunuzdaki bir ödemeyi, bir form veya rezervasyon aracından gelen bir webhook’u ya da bir temsilcinin rezerve edildi olarak işaretlediği bir görüşmeyi kapsar.
Başlamadan önce üç şeye ihtiyacınız vardır:
  • Hunizinizin her sayfasına yüklenmiş Whop Pixel. Bu kılavuzun ilettiği ziyaretçi kimliğini o oluşturur.
  • event:create iznine sahip bir API anahtarı. Account API Keys altında bir tane oluşturun ve sunucunuzda saklayın. Asla tarayıcı koduna koymayın.
  • Hesap kimliğiniz; panel URL’nizde dashboard/ sonrasında gelen ve biz_ ile başlayan kısım.

Events API ne zaman kullanılır

Çoğu entegrasyonun buna ihtiyacı yoktur. Piksel, tarayıcıda gerçekleşen her şeyi zaten raporlar ve ziyaretçi kimliğini, IP adresini ve kullanıcı aracısını kendisi doldurur. Events API’yi yalnızca bir dönüşümün gerçekleştiğini bilen tek yer sunucunuz olduğunda kullanın. Eylemin gerçekleştiği yerde bir whop.track çağrısı tetiklenebiliyorsa bunun yerine onu kullanın.

Bir sunucu olayı gönderin

1

Ziyaretçi kimliğini tarayıcıda okuyun

Piksel, her ziyaretçinin kimliğini alan adınızda _wuid adlı birinci taraf bir çerezde saklar ve aynı anahtar altında localStorage içine yansıtır. Değer wuid_k3j9x2m1p8q4r7s0t5u6 gibi görünür. Bunu sayfa yüklendiğinde değil, ziyaretçinin daha sonra raporlayacağınız eylemi gerçekleştirdiği anda okuyun. Çerez yalnızca piksel kod parçacığı sayfada çalıştıktan sonra mevcut olur.
Read the visitor ID
Her alt alan adı kendi _wuid değerini alır. Piksel bunları tek bir kişiye bağlar, bu nedenle aktarımın gerçekleştiği sayfada hangi çerez varsa onu okuyun.
2

Eylemle birlikte sunucunuza gönderin

Ziyaretçi kimliğini, eylemi arka ucunuza zaten taşıyan isteğe ekleyin: bir form gönderimi, bir ödeme çağrısı, bir kayıt isteği. Aynı anda sayfa URL’sini de yakalayın. Bu URL, sunucunuzun başka türlü göremeyeceği UTM’leri ve tıklama kimliklerini taşır.
Arka ucunuz sayfayla aynı ana makinede yanıt veriyorsa, _wuid çerezi istekle birlikte kendiliğinden gelir. Tarayıcıdan göndermek yerine orada okuyun. Çerez yalnızca o ana makine için ayarlanır, bu nedenle example.com adresinden api.example.com adresine yapılan bir istek onu taşımaz.Sunucunuz o istekte ziyaretçinin IP adresini ve kullanıcı aracısını zaten görür. İkisini de saklayın.
3

Müşteri kaydında saklayın

Ziyaretçi kimliğini, sayfa URL’sini, IP adresini ve kullanıcı aracısını potansiyel müşteri, müşteri veya sipariş kaydına kaydedin. Raporladığınız dönüşüm, ziyaretten günler sonra gerçekleşebilir. Satış ekibinizin gelecek hafta kapattığı bir anlaşmanın atfedilebilmesi için yine de orijinal ziyaretteki ziyaretçi kimliğine ihtiyacı vardır. Whop 28 güne kadar eski olayları kabul eder.
4

Olayı gönderin

Olayı API anahtarınızla sunucunuzdan gönderin. Örnek, bir reklamdan gelen, bir teklif formu dolduran ve ardından bir CRM’de nitelikli hale getirilen bir ziyaretçiden gelen potansiyel müşteriyi raporlar.
Örnekteki url, bir ziyaretçinin Meta’daki bir Whop reklamına dokunduktan sonra ulaştığı adrestir. utm_meta_ad_id, utm_meta_adset_id ve utm_meta_campaign_id ağın kimlikleridir. wacid, wasid ve waid Whop kampanya, reklam grubu ve reklam kimlikleridir. utm_source yüzeyi (fb, ig, msg veya an), utm_placement yerleşimi, utm_content ve utm_adset reklam ve reklam grubu adlarını belirtir; fbclid ise ağın kendisinin eklediği etikettir. Whop, ziyareti hangi reklamın sağladığını bunlardan çözümler, bu nedenle URL’den parametre seçmek yerine URL’yi bütün olarak saklayın.Yanıt, saklanan olay kimliğini döndürür. Whop, farklı hesaplardan gelen kimliklerin asla çakışmaması için event_id değerinizin önüne hesabı ekler:
5

Doğru kişiye ulaştığını doğrulayın

Olayları Listele bir ziyaretçi kimliğini identifier olarak kabul eder, böylece olayın katıldığı yolculuğun tamamını okuyabilirsiniz. İstek, company:basic:read gibi bir okuma iznine sahip bir anahtar gerektirir.
cURL
Sunucu olayınız, pikselin sayfa görüntülemelerinin yanında aynı person_id ile görünür. Sayfa görüntülemeleri oradaysa ancak olayınız yoksa, ziyaretçi kimliği eşleşmemiştir. Bkz. Sorun giderme. Olay ayrıca panelinizdeki Events sayfasında da görünür.

Atfı belirleyen parametreler

Yalnızca account_id ve event_name zorunludur. Yükün geri kalanı olayı atfedilebilir kılan şeydir, bu nedenle bunları da zorunlu olarak değerlendirin. Tam istek şeması Olay Oluştur referans sayfasındadır.

Olayı adlandırın

Pikselle aynı adları kullanın. Sunucunuzdan raporladığınız bir lead, pikselin raporladığı bir lead ile aynı olay olarak kaydedilir; böylece potansiyel müşterilere göre değerlendirilen bir kampanyanın sonuçlarına sayılır. Diğer herhangi bir event_name, o ad altında özel bir olay olur. Adları kısa ve sabit tutun ve küçük bir kümeyi yeniden kullanın.
Custom event
Whop’un işlediği bir satış için asla purchase göndermeyin. Whop, kendi ödeme sayfasındaki her ödemeyi, satın almayı, aboneliği ve denemeyi otomatik olarak kaydeder ve reklam ağına raporlar. Yalnızca Whop’un göremediği olayları gönderin.

Yinelenen olaylardan kaçının

Aynı dönüşüm Whop’a hem tarayıcıdan hem de sunucunuzdan ulaşabiliyorsa, her ikisinden de aynı event_name ve aynı event_id ile gönderin. Whop tek bir kopya tutar. Bu, bir formun gönderimde whop.track("lead", { event_id }) tetiklediği ve arka ucunuzun aynı potansiyel müşteriyi doğruladıktan sonra yeniden raporladığı durumlarda en güvenli kurulumdur. event_id, eylemin türünü değil, tek bir eylemi tanımlar. Her potansiyel müşterinin kendine ait bir kimliği olmalıdır. Gönderim anında uydurulan bir değer her seferinde yenidir, bu nedenle hiçbir şeyi engellemez. Sisteminizin o tek eylem için zaten sahip olduğu bir kimliği kullanın.

Sorun giderme

Olay saklanıyor ancak bir reklama atfedilmiyor. Olay hiçbir user.anonymous_id taşımıyordu veya pikselin hiç kullanmadığı bir değer taşıyordu. Olağan nedenler, çerezi piksel kod parçacığı çalışmadan önce okumak, pikselin olmadığı bir alan adında okumak veya ziyaretçi kimliğini yanlış kayda kaydetmektir. Düzeltmeyi, o ziyaretçi kimliği için olayları listeleyerek doğrulayın. Pikselin sayfa görüntülemeleri, olayınızla aynı identifier altında görünmelidir. event_time hakkında bir mesajla 400. Zaman damgası 28 günden daha eskidir. Olayı gerçekleştiği zamana daha yakın gönderin veya bırakın. Bir purchase olayında 400. value eksik veya sıfırdan büyük değil. Reklam ağları tutarı olmayan bir satışa yönelik optimizasyon yapamaz, bu nedenle Whop bunu reddeder. 401 veya 403. Anahtar eksik, event:create iznine sahip değil veya account_id değerinden farklı bir hesaba ait. Üretim anahtarları https://api.whop.com/api/v1 kullanır.