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:createiznine 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 vebiz_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 birwhop.track çağrısı tetiklenebiliyorsa bunun yerine onu kullanın.
Bir sunucu olayı gönderin
Ziyaretçi kimliğini tarayıcıda okuyun
Piksel, her ziyaretçinin kimliğini alan adınızda Her alt alan adı kendi
_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
_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.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.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.
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:Doğru kişiye ulaştığını doğrulayın
Olayları Listele bir ziyaretçi kimliğini Sunucu olayınız, pikselin sayfa görüntülemelerinin yanında aynı
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
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ızcaaccount_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 birlead, 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
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çbiruser.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.
