Dönüşüm API'leri
Hedeflerinizi tarayıcı yerine sunucumuzdan Meta, LinkedIn, TikTok ve Google Ads'e bildirin; eşleştirme yalnızca ağın kendisinin belirlediği tıklama tanımlayıcısıyla yapılır.
1. Neden sunucu tarafı?
Tarayıcı pikselinin dönüşüm bildirmeden önce üç şeyi aşması gerekir: reklam engelleyici, takip önleme ayarı ve piksel çalışmadan ziyaretçinin sekmeyi kapatması. Sunucu tarafı çağrı üçünü de aşar; çünkü tarayıcıda hiç gerçekleşmez.
MousePlayer hedefinizin ne zaman gerçekleştiğini zaten bilir; hedeflerin amacı budur. Dönüşüm API'leri yalnızca bu bilgiyi sunucumuzdan reklam ağına iletir.
Pikselinizin yerine geçmez. Onu tutun. Her ağ iki kaynaktaki yinelenenleri ayıklar; bunun için gereken tanımlayıcıları göndeririz.
2. Neler göndeririz, neleri asla göndermeyiz?
Bu çağrılarda ziyaretçiyi tanımlayan tek şey, ağın kendisinin belirlediği çerez veya tıklama tanımlayıcısıdır. Kişi hakkında başka hiçbir şey sunucumuzdan çıkmaz.
| Ağ | Kullanılan tanımlayıcı | Kaynak |
|---|---|---|
| Meta | _fbp, _fbc | Meta pikselinin ayarladığı birinci taraf çerezler |
li_fat_id | LinkedIn Insight Tag'in ayarladığı birinci taraf çerez | |
| TikTok | _ttp, ttclid | _ttp bir çerezdir, ttclid reklam tıklama URL'sinden gelir |
| Google Ads | gclid, wbraid, gbraid | Reklam tıklama URL'sinden veya sonrasında _gcl_aw çerezinden |
| Microsoft Advertising | msclkid | Reklam tıklama URL'sinden veya UET etiketinin yazdığı _uetmsclkid çerezinden |
Asla gönderilmez: E-posta, telefon numarası, ad veya IP adresi; özetlenmiş halleri bile gönderilmez. Ziyaretçinin tıklama tanımlayıcısı yoksa hiçbir şey gönderilmez. Hedefi belirsiz dönüşüm, sizin için doğru sayımdan daha az değerlidir.
Yalnızca onayla
Bu çağrıların her biri kaydın kendisiyle aynı onay kapısının arkasındadır. Onaysız oturum, proje ayarındaki düğmeden bağımsız olarak dönüşüm raporu üretmez.
3. Google Ads'in bir değil, üç tanımlayıcısı var
Şaşırtıcı olduğu için açıkça söylemek gerekir. Google, tek reklam tıklaması için gclid kullanır. Apple'ın takip önlemesi tek tıklamanın ilişkilendirilmesini engellerse Google bunun yerine wbraid veya gbraid gönderir; bunlar bir tıklama grubunu temsil eder.
Üçü birbirini dışlar; Google iki tanımlayıcılı dönüşümü reddeder. Tam bir tane göndeririz; birden fazlası varsa gclid en kesin olduğu için önceliklidir.
URL'de yalnızca bir kez bulunurlar
Tanımlayıcı adreste reklam tıklamasından sonraki yalnızca ilk sayfada görünür. Google etiketi sonra onu şu çerezde saklar: _gcl_aw . Çerezi yedek olarak okuruz; onsuz ziyaretin üçüncü sayfasındaki dönüşüm hiçbir tanımlayıcı bulamazdı.
4. Kurulum
Meta, LinkedIn ve TikTok
Her biri iki alan: piksel veya dönüşüm kuralı kimliği ve ağın kendi arayüzünde oluşturduğunuz erişim belirteci. İkisi de AES-256-GCM ile şifrelenerek saklanır, kayıttan sonra tekrar gösterilmez.
Google Ads için altı alan gerekir
Google istisnadır; başlamadan nedenini bilmek gerekir: diğer üçünün aksine basit erişim belirteci vermez. Erişim yenileme belirteçli OAuth ile çalışır; Ads API ayrıca geliştirici belirteci ister.
| Alan | Nerede bulunur? |
|---|---|
| Müşteri Kimliği | Google Ads'in sağ üstünde. Tire olmadan yalnızca rakamlar. |
| Dönüşüm işlemi kimliği | Hedefler ve dönüşümler, ardından kaydın işleneceği işlem. |
| Geliştirici belirteci | Google Ads yönetici hesabınız, API Merkezi. |
| OAuth istemci kimliği ve gizli anahtarı | Google Cloud Console, Kimlik Bilgileri, “masaüstü uygulaması” türünde OAuth istemcisi. |
| Yenileme belirteci | Şu kapsam için bir kez kendiniz üretirsiniz: adwords. |
LinkedIn'de iki yol var; kısa olanı seçin
Kampanya Yöneticisi içinde: Veri, Sinyal Yöneticisi, Doğrudan API, Erişim belirteci oluştur. Kendi verilerini gönderen reklamverenlerin yoludur; geliştirici uygulaması veya inceleme yoktur. Belirtecin süresi dolmaz, Kampanya Yöneticisi ikinci kez göstermez; hemen kopyalayın.
LinkedIn Developer Portal üzerinden istenen geliştirici uygulaması olan diğer yol, birçok reklamveren adına gönderim yapan platformlar içindir. Şirket sayfası doğrulaması ve onaylı kullanım senaryosu gerekir; burada bunların hiçbirine ihtiyacınız yok.
Microsoft Advertising kolay olanıdır
Google Ads'ten sonra aynı yükü beklersiniz: OAuth, geliştirici belirteci, onay adımı. Tam tersidir: iki alan. Tarayıcıda zaten kullandığınız UET etiket kimliği ve Microsoft Advertising'de UET etiketi altındaki “Conversions API Kullan”, “Belirteci Kopyala” bölümünden kopyaladığınız belirteç. Başvurulacak bir şey yok.
Tarayıcı etiketinizle aynı etiket kimliğini kullanın. Microsoft böylece sunucu olayıyla tarayıcı olayını iki değil, tek dönüşüm olarak tanır.
Geliştirici belirteci Google onayı gerektirir (“Temel erişim”); birkaç gün sürer. Bir dakikada tamamlayamayacağınız tek adım olduğundan önce başlatın. Google parolanızı asla görmeyiz; yalnızca yenileme belirtecini görürüz ve istediğiniz zaman iptal edebilirsiniz.
5. Dönüşüm ne zaman bildirilir?
Hedef ve oturum başına tam bir kez. MousePlayer çağrı çıkmadan yineleneni önler; gönderilen veri ayrıca kimlik taşır, ağ da kendi tarafında ikinci kez ayıklayabilir. Sepete beş ürün ekleyen ziyaretçi beş değil, tek dönüşüm üretir.
Reklam hesabınızda göreceğiniz şey
Dönüşüm, hedefinizin adını, ayarladıysanız değerini ve para birimini, gerçekleşme zamanını taşır. Normal işleyişte bir dakika içinde gelir.
Hiçbir şey gelmiyorsa
- Tıklama tanımlayıcısı yok. Ziyaretçi o ağın reklamından gelmedi veya piksel çerezini ayarlamadan geldi. Hiçbir şey gönderilmez; hata değil, beklenen durumdur.
- Onay yok. Önce onay kapısı gelir.
- Ağ çağrıyı kabul etti ama dönüşümü reddetti. Google, TikTok ve bazı diğerleri HTTP 200 ile yanıt gövdesinde hata döndürür. Yalnızca durumu değil gövdeyi okuruz; neden gönderim günlüğünde görünür.
Burada adı geçen tüm ticari markalar ilgili sahiplerine aittir. MousePlayer'ın bu sağlayıcılarla ticari ilişkisi yoktur.