E-ticaret sözlüğüPazarlama ve reklam

Dönüşüm API'si nedir?

Conversions API · dönüşüm API'si

Dönüşüm API'si, satın alma veya başvuru gibi olayların işletmenin sunucusundan reklam platformuna iletilmesini sağlayan bağlantıdır. Aynı satın almanın farklı kanallardan gelen bildirimleri eşleştirilmeli, kişisel veri akışı ayrıca kontrol edilmelidir.

Son kontrol: 26 Ekim 20266 resmî kaynakGündem Masası

Tanım

Dönüşüm API'si, satın alma veya başvuru gibi olayların işletmenin sunucusundan reklam platformuna iletilmesini sağlayan bağlantıdır.

Bir bakışta

Bağlantıİşletme sunucusundan reklam platformuna olay iletimi

TekilleştirmeAynı gerçek olaya ait bildirimlerin eşleştirilmesi

KVKK6698 md. 4, 5 ve 10

Aktarım ve güvenlikYurt dışı aktarımda md. 9; güvenlikte md. 12

Dönüşüm API’si hangi bilgiyi taşır?

Dönüşüm API’si, reklamın ardından izlemek istediğiniz işletme olaylarını platforma aktarmanın bir yoludur. LinkedIn’in resmi açıklaması, reklamverenin sunucusuyla platform arasında doğrudan bağlantı kurulduğunu ve çevrim içi veya çevrim dışı sonuçların ölçülebildiğini belirtir. Amaç, gerçekleşen iş sonucunu kampanya ölçümüne taşımaktır. Örneğin başvuru alınmasıyla satışın tamamlanması farklı olaylardır. Kurulumdan önce hangi aşamanın hangi olay adıyla gönderileceğini belirleyin. Aynı satışın farklı sistemlerde ayrı sonuç gibi görünmesini önlemek için kayıtların bağlantısını kurun.

Meta’nın resmi Business SDK belgesi de web, uygulama ve çevrim dışı olayların doğrudan sunucudan gönderilebildiğini gösterir. Örneğinde Purchase olayı, gerçekleşme zamanı, kullanıcı bilgisi, tutar, para birimi, olayın kaynak adresi ve kaynak türü bulunur. Bu alanların işlevleri farklıdır: tutar olayın ekonomik değerini, kaynak türü nerede gerçekleştiğini anlatır. Meta reklamları için satın alma ölçerken henüz ödenmemiş bir sepeti tamamlanmış satışla aynı olay altında göndermeyin. Satış sisteminizde olayın gerçekten ne zaman gerçekleştiğini tanımlayın.

Takip pikselinden farkı nedir?

Takip pikseli tarayıcı tarafındaki bağlantıyı, dönüşüm API’si ise sunucu üzerinden olay iletimini ifade eder. İki kanal aynı işletme olayını aktarabilir. Bu durumda iki ayrı satış doğmuş olmaz; aynı satışın iki bildirimi vardır. Platformun bunları tek olaya indirmesi için kendi eşleştirme kuralları uygulanmalıdır. Sunucu kurulumu yapıldı diye tarayıcı kurulumunun kaldırılması veya bütün olayların iki kanaldan gelişigüzel gönderilmesi doğru bir başlangıç değildir. Hangi olayın hangi kaynaktan geleceğini kurulum planında gösterin.

Meta’nın resmi olay sınıfında event_name olayın adını, event_time gerçek olayın saniye cinsinden Unix zamanını, event_id olay kimliğini taşır. Gönderim anıyla olayın gerçekleşme anını birbirine karıştırmayın. Hata nedeniyle yeniden gönderilen aynı satın alma için olayın kimliği korunmalıdır; farklı gerçek satın almalara aynı kimlik verilmemelidir. Teknik ekibe yalnız “satışları gönderin” demek yerine olay tanımını, kimlik üretimini ve tekrar gönderimde izlenecek yolu açıklayın. API bağlantısının çalışması ile ölçülen iş olayının doğru seçilmesi ayrı kontroller gerektirir.

Aynı siparişin iki kez sayılması nasıl önlenir?

Snap’in resmi tekilleştirme belgesi, web kurulumunda aynı piksele giden tarayıcı ve sunucu bildirimlerinde olay adının ve ilgili kimlik değerinin eşleşmesini ister. Snap örneğinde tarayıcıdaki client_dedup_id ile sunucudaki event_id aynı değeri taşır. Bu alan adlarını bütün platformların ortak standardı gibi kullanmayın; kendi entegrasyonunuzun belgesine bakın. Tek bir ziyaretçi veya oturum kimliğini bütün ayrı olaylara vermek, farklı gerçek işlemlerin birleştirilmesine yol açabilir. İşlem başına kimlik ile kullanıcı kimliğinin görevini ayırın.

Kurguda 40 gerçek sipariş bulunduğunu, 30 tanesinin hem tarayıcıdan hem sunucudan, 10 tanesinin yalnız sunucudan bildirildiğini varsayalım. Ham bildirim sayısı 30 × 2 + 10 = 70 olur. Aynı olaya ait 30 tekrar doğru birleştirilirse 70 − 30 = 40 benzersiz satın alma kalır. Tekilleştirme yapılmadan 70 işlemi satış diye yorumlamak, 40 gerçek siparişe göre 30 fazla sayım üretir; fark 30 / 40 × 100 = %75’tir. Bu rakamlar örnektir; gerçek platform raporunda reklamla ilişkilendirme kuralları da uygulanır.

Türkiye’de kişisel veri kuralları değişir mi?

Verinin sunucudan gönderilmesi kişisel veri kurallarını kaldırmaz. 6698 sayılı Kişisel Verilerin Korunması Kanunu md. 4 gereğince veriler belirli, açık ve meşru amaçlarla, amaçla bağlantılı, sınırlı ve ölçülü işlenmelidir. Md. 5 kapsamındaki işleme şartını belirleyin; sipariş için edinilmiş bütün müşteri bilgilerinin reklam ölçümü amacıyla gönderilebileceğini varsaymayın. Md. 10 aydınlatmasında amaç, aktarım, yöntem ve hukuki sebep açıklanır. KVKK aydınlatma metni gerçek veri akışını yansıtmalıdır; yalnız sistemin adını eklemek yeterli hazırlık değildir.

Yurt dışına kişisel veri aktarımı varsa md. 9’daki güncel aktarım şartları kontrol edilmelidir. Md. 12 ise hukuka aykırı işleme ve erişimi önlemek, veriyi korumak için gerekli teknik ve idari tedbirleri düzenler. Hangi alanların hangi alıcıya gittiğini, erişim yetkilerini ve kayıtların saklanmasını gözden geçirin. Tarayıcıdaki bir tercihin sunucudaki gönderimlere nasıl yansıyacağını kurulumda belirleyin. KVKK ve e-ticaret rehberini veri akışıyla birlikte inceleyin; teknik bağlantının başarılı olması hukuki hazırlığın tamamlandığını göstermez.

Satıcı kurulumun sonucunu nasıl kontrol eder?

Önce test olayıyla iletimin, olay kimliğinin ve beklenen alanların doğru geldiğini kontrol edin. Snap belgeleri test olayları ve tanılama araçlarıyla alınma, eşleşme ve tekilleştirmenin doğrulanmasını önerir. Ardından sipariş sistemindeki gerçek kayıtlarla karşılaştırın: tek sipariş için kaç bildirim oluştu, tekrarlar nasıl birleşti, tutar ile para birimi doğru mu? Raporlanmış dönüşüm sayısını doğrudan sipariş defterinin yerine kullanmayın. Dönüşüm hunisi içindeki aşamalar ve reklamla ilişkilendirme kapsamı aynı değilse iki rapor farklı sorulara cevap verir.

06 · Örnek

Örnek: 40 siparişten 70 ham bildirim

Kurguda 40 gerçek siparişin 30 tanesi iki kanaldan, 10 tanesi yalnız sunucudan gönderilir. Toplam 70 ham bildirim oluşur.

30 × 2 + 10 = 70 ham bildirimi hesaplayın.
Aynı siparişe ilişkin 30 çift bildirimi eşleştirin.
70 − 30 = 40 benzersiz satın alma bulun.
Yanlış çift sayımdaki fazlalığı 70 − 40 = 30 olarak hesaplayın.
30 / 40 × 100 = %75 fazla sayımı gerçek sipariş tabanında gösterin.

Sonuç

Kurguda 70 bildirim 40 satın almayı temsil eder. Bu hesap gerçek reklam atfı sonucu veya performans artışı iddiası değildir.

07 · Fark

Dönüşüm API'si ile karıştırılan kavramlar

Dönüşüm API'si ≠ Takip pikseli

Tarayıcıdan olay iletir; dönüşüm API’si sunucu üzerinden iletim kurar ve aynı olay iki kanalda bulunabilir.

Dönüşüm API'si ≠ Tekilleştirme

Aynı gerçek olaya ait tekrar bildirimlerini birleştirir; farklı gerçek satın almaları tek olay yapmaz.

Dönüşüm API'si ≠ Reklamla ilişkilendirme

Dönüşümün hangi reklam etkileşimine yazılacağını belirler; olayın teknik olarak alınmasıyla aynı kontrol değildir.

08 · Satıcı için

Satıcı ne yapmalı?

Ölçülecek işletme olayını ve gerçekleşme anını tanımlayın.
Kullanılan platformun güncel olay ve kimlik alanlarını kontrol edin.
Aynı olayın tarayıcı ve sunucu kimliklerini eşleştirin.
Kişisel veri alanlarını, hukuki sebebi ve varsa yurt dışı aktarımı belirleyin.
Test olaylarıyla alım ve tekilleştirmeyi doğrulayın.
Gerçek siparişleri tutar, para birimi ve benzersiz olay bakımından karşılaştırın.

09 · Devamı

İlgili rehberler

10 · Sık sorulanlar

Dönüşüm API'si hakkında sık sorulanlar

Dönüşüm API’si yalnız Meta’ya mı aittir?

Hayır. Meta, Snap ve LinkedIn gibi platformların kendi dönüşüm API uygulamaları vardır. Alan adları, erişim koşulları ve tekilleştirme kuralları platforma göre kontrol edilir.

Piksel ve API aynı siparişi gönderirse iki satış mı olur?

Hayır. Aynı satın alma iki kez bildirilmiş olur. Platformun eşleştirme kurallarına uygun kimlikler gönderilmezse ölçümde çift sayım sorunu oluşabilir.

Sunucu üzerinden gönderimde KVKK uygulanır mı?

Evet. Kişisel veri işleniyorsa 6698 md. 4 ve 5 kapsamındaki ilke ve şartlar, md. 10 aydınlatması ve md. 12 güvenlik tedbirleri uygulanır; yurt dışı aktarım varsa md. 9 da kontrol edilir.

Her olayda aynı müşteri kimliği tekilleştirme için yeterli mi?

Aynı kişi farklı gerçek işlemler yapabilir. Snap’in resmi belgesi her ayrı dönüşüm olayının ayrı kimlik taşımasını ister; olay kimliğiyle kişi veya oturum kimliğini karıştırmayın.

API bağlantısının çalışması ölçümün doğru olduğunu kanıtlar mı?

Hayır. Olay tanımı, zaman, tutar, para birimi, kimlik eşleştirmesi ve tekrarlar kontrol edilmelidir. Ardından gerçek siparişlerle karşılaştırma yapılır; reklamla ilişkilendirme kapsamı da dikkate alınır.