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