LinkedIn Conversions API Kurulumu
Hardal server-side altyapısını kullanarak Google Tag Manager üzerinden LinkedIn Conversions API’nin entegrasyonu
Genel Bakış
Bu rehber, Hardal’ın server-side altyapısını kullanarak Google Tag Manager (GTM) ve server-side GTM aracılığıyla LinkedIn Conversions API (CAPI) entegrasyonunu anlatmaktadır. Bu uygulama, verileri doğrudan sunucunuzdan LinkedIn’e göndererek daha güvenilir dönüşüm takibi sağlar.
Hazırlık
Bu entegrasyona başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:
- Hardal hesabı
- Server-side GTM container
- Websitenizde kurulu web GTM container
- Yönetici erişimine sahip LinkedIn Campaign Manager hesabı
- Websitenizde Google Analytics 4 (GA4) kurulumu
Kurulum Adımları
GTM'de Server Container Kurun
İlk olarak bir server-side GTM container oluşturmanız gerekiyor.
- Hazırlanmak için Server-side Google Tag Manager rehberini takip edin.
Eğer Hardal’da server-side GTM kurulumunu zaten yaptıysanız, bu adımı atlayabilir ve mevcut kurulumunuzu kullanabilirsiniz.
Server Container'da GA4 Client Yapılandırın
Server-side GTM container’ınızda:
- “Clients” bölümüne gidin ve yerleşik “GA4” client’ının yapılandırıldığından emin olun
- Aşağıdaki parametreleri ayarlayın:
- Priority: 0 (varsayılan)
- Default GA4 paths: Etkin
- Default gtag.js paths: GA4 Measurement ID’lerinizle etkin
- Automatically serve dependent scripts: Etkin
- Compress HTTP response: Etkin
- Enable region-specific settings: Visitor Region değişkeniyle etkin
- Cookies and Client Identification: Server Managed
GA4 client, websitenizden gelen GA4 isteklerini işleyerek verileri LinkedIn CAPI tag’iniz için kullanılabilir hale getireceği için önemlidir.
Server Container'a LinkedIn CAPI Tag'i Ekleyin
- Server-side GTM container’ınızda “Tags” bölümüne gidin ve “New” butonuna tıklayın
- “Discover more tag types in the Community Template Gallery” seçeneğine tıklayın
- linkedin-developers’dan “LinkedIn | CAPI Tag Template” için arama yapın
- “Add to Workspace” butonuna tıklayın
- Tag’in gerektirdiği tüm bilgileri ekleyin
- LinkedIn API Access Token LinkedIn API Token’ınıza erişin
- LinkedIn Conversion Rule ID LinkedIn Conversion Rule ID’nize erişin
- EventID
- Conversion Value
LinkedIn CAPI Tag'i için Trigger Oluşturun
- Tag yapılandırmasındayken “Triggering” bölümüne tıklayın
- Yeni bir trigger oluşturun:
- Trigger Type: Custom Event
- Event Name: istediğiniz dönüşüm event’lerinden herhangi biri (örn. “purchase”, “lead”, “sign_up”)
- This trigger fires on: Some Custom Events
- Bir koşul ekleyin: “Event Name equals [dönüşüm event’iniz]”
- Trigger’ınızı kaydedin
Birden fazla dönüşüm türünü takip etmek için şunları yapabilirsiniz:
- Her dönüşüm türü için farklı trigger’larla ayrı LinkedIn CAPI tag’leri oluşturun
- Birden fazla trigger’a sahip tek bir tag kullanın
- Daha genel bir trigger’a sahip tek bir tag kullanın ve tag kodunda event eşleştirmesini yapın
LinkedIn Campaign Manager'ı Yapılandırın
- LinkedIn Campaign Manager’da Account Assets > Conversions bölümüne gidin
- “Create a conversion” butonuna tıklayın
- Kaynak olarak “Conversions API”yi seçin
- Dönüşümünüzü adlandırın ve uygun kategoriyi seçin
- Entegrasyon adımında “Google Tag Manager”ı seçin
- İstenirse GTM hesabınızı bağlayın
- Entegrasyon detaylarınızı doldurun:
- GA4 measurement ID
- Tagging server URL (Hardal sGTM endpoint’iniz)
- Web GA4 event trigger adı
- Dönüşümünüzü kampanyalarla ilişkilendirerek kurulumu tamamlayın
Entegrasyonu Test Edin
- Hem web hem de server GTM container’larınızda Preview modunu etkinleştirin
- Websitenizi ziyaret edin ve bir dönüşüm hareketi tetikleyin
- Web container önizlemesinde şunları doğrulayın:
- GA4 event tag’inin doğru şekilde çalıştığını
- Verilerin server container’a gönderildiğini
- Server container önizlemesinde şunları doğrulayın:
- Event verilerinin GA4 client tarafından alındığını
- LinkedIn CAPI tag’inin çalıştığını
- LinkedIn API’sine yapılan isteğin başarılı olduğunu
- LinkedIn Campaign Manager’da Test Events aracını kullanarak dönüşüm alımını doğrulayın
Event Veri Eşleştirmesi
Hardal’ın server-side GTM’i aracılığıyla GA4’ten LinkedIn CAPI’ye event gönderirken, aşağıdaki event adı eşleştirmesini kullanın:
GA4 Event Adı | LinkedIn Conversion Türü |
---|---|
purchase | Purchase |
generate_lead | Lead |
sign_up | Sign Up |
submit_application | Apply |
request_demo | Request Demo |
download | Download |
add_to_cart | Add to Cart |
LinkedIn takibi için GA4 event’lerinizin bu parametreleri içerdiğinden emin olun:
- Gerekli: event_name (dönüşüm türü)
- Kullanıcı eşleştirmesi için gerekli: e-posta adresi (hash’lenmiş)
- Önerilen: value, currency (satın alma event’leri için)
- İsteğe bağlı: ürün detayları, kullanıcı verileri, vb.
Gelişmiş Yapılandırma
Çoklu Tanımlayıcılarla Enhanced Match Uygulaması
Eşleşme oranlarını iyileştirmek için LinkedIn CAPI tag’inizi çoklu kullanıcı tanımlayıcılarıyla geliştirin:
- LinkedIn Cookie: LinkedIn’in first-party cookie’sini yakalamak ve göndermek için kod ekleyin
- LinkedIn Click ID: Reklam URL’lerinden LinkedIn tıklama kimliklerini yakalayın ve iletin
- External ID: Daha iyi çapraz kanal takibi için CRM veya kullanıcı kimliklerinizi dahil edin
Gelişmiş Dönüşüm Verileri Ekleme
Özellikle satın alma event’leri için daha zengin dönüşüm bilgileri için şunları ekleyin:
- İşlem ID: Her dönüşüm için benzersiz bir tanımlayıcı ekleyin
- Ürün Detayları: Ürün kimlikleri, kategorileri ve miktarlarını ekleyin
- Müşteri Değeri: Müşteri yaşam boyu değeri hakkında bilgi ekleyin
Sorun Giderme
Event'ler LinkedIn'e Ulaşmıyor
Event'ler LinkedIn'e Ulaşmıyor
Dönüşüm event’leriniz LinkedIn’de görünmüyorsa:
- Server-Side GTM Yapılandırmasını Kontrol Edin:
- GA4 client’ının server container’ınızda düzgün yapılandırıldığını doğrulayın
- Server container’ınızın Hardal’da düzgün bir şekilde konuşlandırıldığından emin olun
- LinkedIn CAPI tag’inin istediğiniz event’lerde çalıştığını kontrol edin
- API Kimlik Doğrulamasını Doğrulayın:
- LinkedIn erişim token’ınızın geçerli ve doğru biçimlendirildiğinden emin olun
- Server container preview modunda API hatalarını kontrol edin
- LinkedIn API endpoint URL’sinin doğru olduğunu doğrulayın
- Veri Formatı Sorunları:
- Kullanıcı tanımlayıcılarının (özellikle e-posta) düzgün şekilde hash’lendiğinden emin olun
- Dönüşüm event adlarının LinkedIn’in beklediği formatla eşleştiğini doğrulayın
- Eksik olabilecek gerekli alanları kontrol edin
Web Container Sunucuya Veri Göndermiyor
Web Container Sunucuya Veri Göndermiyor
Veriler web container’ınızdan server container’a akmıyorsa:
- GA4 Yapılandırmasını Kontrol Edin:
- server_container_url parametresinin doğru ayarlandığını doğrulayın
- URL’nin Hardal sGTM endpoint’inizi işaret ettiğinden emin olun
- Kullanıcı verileri gönderiyorsanız first_party_collection’ın etkinleştirildiğini kontrol edin
- Ağ Sorunları:
- Tarayıcı konsolunda CORS hataları olup olmadığını kontrol edin
- Sunucu endpoint’inin websitenizden erişilebilir olduğunu doğrulayın
- SSL/TLS sertifika sorunları olup olmadığını kontrol edin
Veri Gizliliği Endişeleri
Veri Gizliliği Endişeleri
Uygun veri gizliliği uyumluluğunu sağlamak için:
- Göndermeden önce her zaman PII bilgilerini hash’leyin:
- E-posta adresleri SHA-256 ile hash’lenmelidir
- Kullanılıyorsa telefon numaraları hash’lenmelidir
- PII içeriyorlarsa External ID’ler hash’lenmelidir
- İzin Yönetimini Düşünün:
- Yalnızca izlemeye izin veren kullanıcılar için veri gönderin
- GA4 event trigger’larınızda bir izin kontrolü uygulayın
- Uyumluluk için veri işleme süreçlerinizi belgelendirin