Dönüşümler API’si, kısaca CAPI, işletmenin sunucu veya uygun entegrasyon altyapısından Meta’ya olay verisi iletmesini sağlar. Meta Pixel ise tarayıcı tarafındaki olay iletimini kullanır. İki bağlantı birlikte planlanabilir; fakat iki yöntem kullanmak olayların kendiliğinden doğru ölçüleceği anlamına gelmez. Aynı davranışın iki kez sayılmaması, olayların doğru zamanda gönderilmesi ve verinin gerçek iş kaydıyla uyumlu olması gerekir.
Tarayıcı ve sunucu bağlantısını ayırt edin
Pixel, ziyaretçinin tarayıcısında gerçekleşen akıştan olay gönderir. CAPI ile işletmenin altyapısı veya bağlı çözümü aynı davranış hakkında sunucu olayı iletebilir. Örneğin ödeme başarıyla tamamlandığında sipariş sistemindeki kayıt, gönderilecek olayın dayanağı olabilir. Kullanıcı tercihleri, bağlantı sorunları ve teknik koşullar tarayıcı iletimini etkileyebilir. Sunucu bağlantısı ek bir veri yolu sunar; bütün eksik veriyi geri getiren veya reklam sonucunu kesin biçimde artıran bir yöntem olarak değerlendirilmemelidir.
Önce olayın iş anlamını belirleyin
Kurulum yöntemini seçmeden önce gönderilecek olayların listesini hazırlayın. Bir form gönderimi ne zaman geçerli sayılır? Satın alma için ödeme tamamlanması mı, sipariş kaydı mı esas alınır? İade veya iptal verisi işletme kayıtlarında nasıl izlenir? Bu soruları ekip içinde netleştirin. Ardından olayın adı, zamanı, kaynak bilgisi ve ilgili değer parametrelerini tanımlayın. Teknik olarak kabul edilen bir istek, yanlış tanımlanmış iş olayını doğru hale getirmez.
Uygun entegrasyon yöntemini seçin
Web sitesi altyapınıza ve teknik kapasitenize göre ortak entegrasyonu veya doğrudan sunucudan sunucuya bağlantı gibi yöntemler değerlendirilebilir. Mevcut bağlantının CAPI gönderip göndermediğini önce araştırın. Aynı olayı farklı eklentilerden veya özel koddan paralel göndermek kontrolsüz tekrar oluşturabilir. Doğrudan entegrasyon için sunucu erişimi, bakım sorumlusu ve güncel teknik koşullar gerekir. İşletme ekibiyle teknik ekip, hangi sistemin hangi olaydan sorumlu olduğunu birlikte belgelemelidir.
Aynı olayın iki kez sayılmasını önleyin
Pixel ve CAPI aynı davranışı ilettiğinde olayın kimliğinin eşleşmesi gerekir. Meta’nın resmî sunucu olay modelinde event_id, event_name ile birlikte tarayıcı ve sunucu olaylarının aynı olayı temsil edip etmediğini belirlemek için kullanılır. Uygulamada bir gerçek davranış için bir kimlik oluşturup bu kimliği iki bağlantıda tutarlı kullanın. Her gönderimde yeni kimlik oluşturmak aynı satın almanın farklı olaylar gibi görünmesine yol açabilir.
| Alan | Tarayıcı örneği | Sunucu örneği |
|---|---|---|
| Olay adı | Purchase | Purchase |
| Olay kimliği | test-siparis-1042 | test-siparis-1042 |
| Değer ve para birimi | 850 ve TRY | 850 ve TRY |
Tablodaki kimlik ve tutar öğretim amaçlı örnektir. Farklı gerçek satın almalar aynı kimliği kullanmamalıdır. Kimlik üretimini, yenilenen sayfa veya tekrar gönderim sırasında değişmeyecek biçimde planlayın. Sonra olay tekilleştirmesinin hesabınızın test ve tanılama ekranlarında çalıştığını doğrulayın.
Veri kalitesi ile olay sayısını ayrı değerlendirin
Olay kapsamı, veri güncelliği, olay eşleştirme kalitesi ve tekilleştirme farklı kontrol konularıdır. Çok sayıda olay gelmesi tek başına iyi bir kurulum kanıtı değildir. Olay eşleştirmede kullanılan bilgilerin doğruluğunu ve uygun biçimini kontrol edin. Daha yüksek kalite göstergesi görmek için rastgele veri eklemeyin. Gereksiz veya hassas bilgileri paylaşmayın; kullanıcı tercihleri ve veri paylaşım koşullarıyla uyumlu bir kapsam belirleyin. Sunucu bağlantısı bu sorumluluğu ortadan kaldırmaz.
Bir gerçek akışı uçtan uca test edin
- Doğru veri kaynağını ve entegrasyonu seçin.
- Uygun test ortamında bir kullanıcı davranışı gerçekleştirin.
- Tarayıcı ve sunucu olaylarını ayrı ayrı kontrol edin.
- Olay adı, kimliği, zamanı, değeri ve para birimini karşılaştırın.
- Aynı davranış için tekilleştirmeyi ve gereksiz tekrarları inceleyin.
- Başarısız işlemde başarı olayı gönderilmediğini doğrulayın.
- Test kaydını gerçek form veya sipariş kaydıyla eşleştirin.
Örnek olarak form başvurusu testinde, formu yalnızca açmakla başarıyla göndermek farklı davranışlardır. Sunucu, doğrulanmış başvuru kaydını temel alıyorsa testte o kaydın gerçekten oluştuğunu kontrol edin. İstek yanıtının başarılı olmasıyla iş kaydının doğruluğunu aynı kontrol gibi değerlendirmeyin.
Sık hatalar ve bakım düzeni
Tarayıcı ve sunucuda farklı olay adları kullanmak, kimliği ayrı ayrı üretmek, yanlış değer göndermek ve test sonrası entegrasyonu hiç incelememek sık hatalardır. Teknik ekip gönderim hatalarını ve gecikmeleri takip etmelidir. Tema, ödeme sağlayıcısı veya form değişikliği sonrasında aynı akışı tekrar test edin. Reklam raporundaki dönüşümlerle işletme kayıtları farklıysa önce ölçüm doğruluğunu, ardından tarih ve ilişkilendirme koşullarını inceleyin. CAPI kurulumu tek başına kârlılık kanıtı değildir.
Son kontrol listesi
- Olayların iş tanımı ve tetikleme anı belgelenmiş.
- Entegrasyon yöntemi ve bakım sorumlusu belli.
- Doğru veri kaynağı kullanılıyor.
- Tarayıcı ve sunucuda olay adı ile kimliği tutarlı.
- Değer, para birimi ve gerçek iş kaydı eşleşiyor.
- Tekilleştirme, hata ve gecikme kontrolleri tamamlandı.
- Veri kapsamı kullanıcı tercihleriyle uyumlu.
- Site değişikliklerinden sonra yeniden test planı hazır.
Öğrendiklerinizi hesabınızda uygulayın.
Reklam metriklerinizi UNITE7’nin ücretsiz analiz aracıyla değerlendirin. Hesabınızı ve hedeflerinizi birlikte konuşmak için Instagram üzerinden bize ulaşın.