Entegrasyonlar

Ayarlar > Entegrasyonlar sayfasında ARCY, sayfalarınızda zaten çalışan analitik araçlarını tarayıcıda dinler. Ayar ortam başınadır: Staging için açtığınız bir araç Production'da dinlenmez. ARCY aracın sunucularından hiçbir şey okumaz, anahtar saklamaz, çerez okumaz. Sayfadaki olay adlarını duyar, başka bir şey duymaz.

Başlamadan önce

• Bir aracı yalnızca yöneticiler açabilir ve bir olayı yalnızca yöneticiler kabul edebilir. Üyeler aynı sayfayı salt okunur görür.
• Bir olay adının bildirilmesi için ziyaretçinin onay bildiriminizi kabul etmiş olması gerekir. Test ettiğiniz sayfada önce bildirimi kabul edin. Bkz. Onay.
• Araç sayfada global olarak bulunmalıdır: window.posthog, window.mixpanel, window.amplitude ya da Google Analytics 4 için dataLayer. npm ile kurulan bir aracın globali yoktur; örneğini arcy.init çağrısına listen seçeneğiyle devredin. Seçenek Referans sayfasındadır.

Kurulum

Analitik araçları. Dört anahtar: PostHog, Mixpanel, Amplitude, Google Analytics 4. Kapalı bir araca hiç dokunulmaz; sayfada olup olmadığına bile bakılmaz. arcy.js açık bir aracı yüklendikten sonra on saniye boyunca yarım saniyede bir arar; bu yüzden bir etiket yöneticisinin sonradan eklediği araç da bulunur. Açık bir aracın kartında Bir kodlama ajanına verin satırı görünür: ajan başına bir düğme, her biri o aracın kontrolünü deponuz için bir görev olarak kopyalar. Görev, kurulumunuzun listen seçeneğine ihtiyaç duyup duymadığını, kaçınılacak ikinci arcy.track() çağrısını ve ilk olayın gelişini nasıl göreceğinizi anlatır. Her üye kopyalayabilir.

Görülen olaylar. arcy.js'in açık bir araçtan çıkarken duyduğu her özel olay adı; aracı ve son duyulduğu zamanla birlikte. Aracın kendi adları burada hiç görünmez: PostHog ve Mixpanel'in $... olayları, Amplitude'un [Amplitude] ... olayları ve Google Analytics 4'ün page_view, scroll gibi otomatik olayları.

Her satırda bir ARCY adı bulunur. Aracın adından türetilmiş sade bir kısaltmayla önceden doldurulur: Checkout Completed, checkout_completed olur. Yalnızca küçük harf, rakam ve alt çizgi; en fazla 64 karakter; harfle başlar. İsterseniz düzenleyin, sonra Kabul et ile onaylayın. İki araç adı tek bir ARCY adını paylaşabilir. Kabul edilmiş bir satırda düzenlenen adı Güncelle kaydeder; Kaldır kaydı durdurur.

Neyi değiştirir

• Kabul et sonrasındaki ilk sayfa yüklemesinden itibaren araç bu olayı her gönderdiğinde ARCY aynı oturumda ARCY adıyla bir özel olay kaydeder. Yalnızca ad gider: aracın eklediği özellikler tarayıcıda atılır, hiç gönderilmez.
• Kaydedilen olay planınızdaki izlenen olay sayısına dahildir, her olay gibi onaya bağlıdır, oturumun Aktivite sayfasında görünür ve Akışlar sayfasında bir akışın tamamlanma olayı olarak seçilebilir. Kimsenin kabul etmediği adlar 90 gün sonra silinir.
• Liste her ortam için en fazla 1.000 ad tutar. Bu sınırdan sonra yeni bir ad, kabul edilmemiş adlar silinene kadar listeye girmez. Bir sayfa yüklemesi araç başına en fazla 200 ad bildirir.
• Açık bir araç bir olayı zaten gönderiyorsa aynı adla arcy.track() çağırmayın. Olay iki kez kaydedilir.
• Yalnızca tarayıcıda olanlar duyulur. Arka ucunuzun bir aracın sunucu SDK'sına gönderdiği olay, örneğin bir ödeme webhook'u, sayfadan geçmez. Bunlar için arcy.track() kullanmaya devam edin.

Sorun çıktığında

• Kabul et "Eşleme kaydedilemedi." yanıtını veriyor ve satır kayboluyorsa, sayfa açıkken ad listeden düşmüştür. Ad sayfanın bir sonraki yüklemesinde geri gelir; o zaman Kabul et çalışır.

Ayrıca bakın

• Akışlar
• Referans
• ARCY neleri toplar