Entegrasyonlar

Yapılandır > 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 bir analitik aracın sunucularından hiçbir şey okumaz, anahtar saklamaz, çerez okumaz. Sayfadaki olay adlarını duyar, başkasını duymaz.

Başlamadan önce

• Araç açmak, olay kabul etmek ve yardım masası bağlamak yalnızca yöneticilere açıktır. Ü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. Dört anahtar: PostHog, Mixpanel, Amplitude, Google Analytics 4. Kapalı bir araca hiç dokunulmaz; sayfada olup olmadığına bile bakılmaz. Bir etiket yöneticisinin, arcy.js yüklendikten sonraki on saniye içinde eklediği araç da bulunur. ARCY MCP ile ajanınıza devredin, ARCY MCP sayfasındaki Analitik aracınızı bağlayın maddesini açar: kodlama ajanınız aracınızın zaten gönderdiği olayları bulur ve her biri için bir eşleme önerir. Öneriler burada Ajanınızın önerisi olarak görünür. Kabul et aracı açar ve olayı eşler. ARCY'nin henüz duymadığı bir olay reddedilir. Bu durumda işlemi yazılım ürününüzde bir kez yapın, ardından yeniden kabul edin.

Görülen olaylar, kartından açılan aracın kendi sayfasında. arcy.js'in o araçtan çıkarken duyduğu her olay adı, 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. Satır menüsündeki Kaldır kaydı durdurur.

Yardım masası. Bir ziyaretçi bir kişiyle görüşmek istediğinde ARCY, burada bağladığınız yardım masasında bir kayıt açar. Yanıt kendi ekibinizden gider. Canlı aktarma yoktur. Zendesk, Intercom ve HubSpot bağlantısı giriş yapılarak kurulur. Freshdesk için Freshdesk adınız ile bir API anahtarı, Crisp için Site kimliği ile Eklenti tanımlayıcısı ve Eklenti anahtarı gerekir. Anahtar, yazdıktan sonra bir daha gösterilmez; Bağlantıyı kes onu siler. Her ortam tek bir yardım masası tutar: kayıtların başkasına düşmesi için önce bağlantıyı kesin. Ziyaretçi özeti okuyup onaylamadan ARCY'den hiçbir şey çıkmaz, kaydın neler taşıdığı ise Yapay zeka istek içeriği sayfasındadır.

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 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 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.
• Yardım masası İlgilenmeniz gerekiyor diyorsa sağlayıcı ARCY'nin elindeki anahtarı kabul etmemiştir ve o zamandan beri kayıt açılmamıştır. Yeniden bağla ile bağlanın.
• Bir sağlayıcının sayfasında girişin hazır olmadığı yazıyorsa ARCY o sağlayıcı tarafında girişini henüz tanımlamamıştır. Şimdilik anahtarla bağlanan bir yardım masası kullanın.

Ayrıca bakın

• Akışlar
• Referans
• Kendi Verini Getir