session_attributes hakkında

Çevrimdışı Dönüşümlerin İçe Aktarılması (OCI), GCLID'yi kullanarak içe aktarmalardan gelen çevrimdışı dönüşümleri izler. GCLID'nin kullanılamadığı durumlarda OCI kullanıcıları; kullanıcı tarafından sağlanan karma oluşturma işlemi uygulanmış veriler, wbraid/gbraid veya session_attributes gibi diğer tanımlayıcılardan yararlanabilir.

Bu sayfada

• session_attributes hakkında
• session_attributes'u yakalama
• Verileri Google Ads'e gönderme

---

session_attributes hakkında

session_attributes, kullanıcının web sitenizle etkileşimi hakkında daha fazla bağlam ve sinyal elde etmeye yarayan bir alandır. Bu alan, dönüşüm ölçümünü, raporlamayı (aynı cihaz/cihazlar arası dökümü dahil) ve teklif verme doğruluğunu daha iyi hale getirebilir. session_attributes'un base64 kodlu dizesini oluşturmak, bu dizeyi veritabanınıza/CRM'nize iletmek ve API içe aktarma işlemleriniz sırasında Google'a göndermek amacıyla aşağıdaki kullanıcı arabirimi komut dosyamızı kullanabilirsiniz. Kullanıcı arabirimi komut dosyasını kullanamıyorsanız her anahtar/değer çiftini ayrı ayrı göndermek için session_attributes_key_value_pairs alanını kullanın.

6 alt alandan yalnızca 4'ü zorunlu olsa da session_attributes alanının aşağıdaki tüm alt alanlarını göndermenizi öneririz:

• gad_source (zorunlu): Reklamlardan kaynaklanan trafiğin kaynağını belirlemek için URL'de sunulan toplu bir parametredir. gad_* URL parametreleri hakkında daha fazla bilgi edinin.
  • Örnek değer: "1"
    Yönerge: Bunlar, reklam tıklaması URL'sine eklenen toplu parametrelerdir (örneğin: &gad_source=1). Açılış sayfası URL'sinde bulunan değeri yakalamanız gerekir.
• gad_campaignid (zorunlu): Reklam tıklamasını getiren reklam kampanyasının kimliği. gad_* URL parametreleri hakkında daha fazla bilgi edinin.
  • Örnek değer: "1234567890"
    Yönerge: Bu, aynı zamanda bir URL parametresidir (örneğin: &gad_campaignid=1234567890) ve açılış sayfası URL'sinden alınmalıdır.
• session_start_time_usec (zorunlu): Kullanıcının oturumunun web sitenizde başladığı zamana ait zaman damgası. Bunun sayesinde kullanıcı ziyaretlerinin süresini takip edebilirsiniz. UNIX zaman damgası sıfır zaman mikrosaniye şeklinde tutarlı bir zaman biçimi kullanmak önemlidir.
  • Örnek değer: "1678886400000000" (Belirli bir zamanı mikrosaniye cinsinden gösterir)
    Yönerge: Tutarlı bir zaman biçimi (UNIX zaman damgası sıfır zaman mikrosaniye) kullanın. Bunun sayesinde kullanıcı ziyaretlerinin süresini takip edebilirsiniz.
• landing_page_user_agent (zorunlu): Kullanıcının tarayıcısını ve işletim sistemini tanımlayan bir dize. Bu bilgiler, kullanıcılarınızın teknik ortamını anlamak için yararlı olabilir.
  • Örnek değer: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, Gecko gibi) Chrome/117.0.0.0 Safari/537.36"
    Yönerge: Bu, gelen açılış sayfası HTTP isteğinin kullanıcı aracısı üstbilgisinden alınmalıdır. Genel veya gömülü kodlanmış değerlerden kaçının.
• landing_page_url: Web sitenizdeki açılış sayfasının tam URL'si. Bu, kullanıcının ilk ulaştığı sayfayı gösterir.
  • Örnek değer: "https://www.example.com/product/deluxe-widget?gad_source=1&gad_campaignid=1234567890"
    Yönerge: Doğru ve tam URL'yi sağlayın. Yer tutucu dizeler, dahili uygulama yolları (ör. "/productdetailscreen") veya eksik URL'ler kullanmayın. Tam ve doğru URL mevcut değilse bu alanı atlamak daha yerinde olacaktır.
• landing_page_referrer: Kullanıcıyı web sitenize bağlayan web sayfasının URL'si. Bu, sitenize yönlendiren trafik kaynaklarını anlamanıza yardımcı olur. Yönlendirenlerle ilgili daha fazla bilgi için bu makaleyi inceleyin. Makale Analytics'e odaklanmış olsa da yönlendiren kavramı web genelinde geçerli olan evrensel bir kavramdır.

  • Örnek değer: "https://www.google.com/" veya"https://www.socialmedia.com/referral"
    Yönerge: Bu, kullanıcının sitenize gelmeden önce bulunduğu son sayfayı yansıtır.

Veri kalitesiyle ilgili en iyi uygulamalar

• Kötü landing_page_url verilerinden kaçının: Yanlış veya kısmi landing_page_url değerleri modelleme açısından zararlıdır. Tam ve doğru URL'yi sağlayamıyorsanız bu değeri hariç tutmanız daha yerinde olacaktır.
• Yinelenen yüklemeleri önleyin: Aynı dönüşüm etkinliğini birden fazla kez göndermeyin. Tekilleştirme için sipariş kimliği gibi benzersiz bir tanımlayıcı kullanın.

session_attributes alanı için önerilen depolama boyutu 5 KB'tır. Bu boyut, çoğu kullanım alanında aşılmaz. session_attributes 5 KB'ı aşarsa alan boyutunu değiştirmek için CRM sağlayıcınızla birlikte çalışmanızı öneririz. Ayrıca landing_page_url ve landing_page_referrer parametrelerini JavaScript yardımcı işlevinden kaldırabilirsiniz.

---

session_attributes'u yakalama

session_attributes'u yakalayıp depolamak için açılış sayfanızda aşağıdaki JavaScript yardımcı işlevini ve HTML formunu kullanabilirsiniz.

Bu örnek kod, verileri localStorage üzerinde tutar. Web sitenizde uygulamadan önce web sitenize özgü gerekli izin ve veri saklama koşullarının gerektiği gibi karşılandığından emin olun.

HTML Formu

1. session_attributes için gizli bir alan eklemek amacıyla her bir form gönderme sayfasını düzenlemeniz gerekir. Bu işlem sayesinde session_attributes arka uç sisteminize iletilir. İletilme şeklini gösteren örnek bir kod aşağıda verilmiştir.
   <form action="" name="myForm">
Name: <input type="text" name="name">
<input type="hidden" id="session_attributes_field" name="session_attributes_field" value="">
<input type="submit" value="Submit Form" name="btnSubmit">
</form>
2. session_attributes_encoded parametresini yakalayıp form alanında ayarlamak için örnek komut dosyası. Bu örnek kod, verileri localStorage üzerinde tutar.

   <script>
function getSessionAttributes() {
const searchParams = new URLSearchParams(window.location.search);
if (Array.from(searchParams.keys()).some(key => key.startsWith('gad_')) ||
searchParams.has('gclid') || searchParams.has('gbraid')) {
const params = {};
searchParams.forEach((value, key) => {
if (key.startsWith('gad_')) params[key] = value;
});
params['session_start_time_usec'] =
(new Date().getTime() * 1000).toString();
params['landing_page_url'] = window.location.href;
params['landing_page_referrer'] = document.referrer;
params['landing_page_user_agent'] = navigator.userAgent;
const sessionAttributesEncoded = btoa(JSON.stringify(params))
.replace(/\+/g, '-')
.replace(/\//g, '_')
.replace(/=+$/, '');
localStorage.setItem('google_session_attributes', sessionAttributesEncoded);
return sessionAttributesEncoded;
}
return localStorage.getItem('google_session_attributes') || '';
}

   
   function addSessionAttributes() {
const sessionAttributesEncoded = getSessionAttributes();
var sessionAttributesFormField =
document.getElementById('session_attributes_field');
if (sessionAttributesFormField && sessionAttributesEncoded != '') {
sessionAttributesFormField.value = sessionAttributesEncoded;
}
}
window.addEventListener('load', addSessionAttributes);
</script>

---

Verileri Google Ads'e gönderme

1. Google Ads API'deki session_attributes_encoded alanı

Google Ads API, 2 Şubat 2026'dan itibaren dönüşüm içe aktarma işlemlerinin bir parçası olarak oturum özellikleri veya IP adresi verilerini kullanmaya başlamak isteyen yeni kullanıcıları kabul etmeyecek. Karmaşık verilerin yönetilip işlenmesi konusunda daha sağlam ve ölçeklenebilir bir deneyim için Google Ads API geliştiricilerinin, birincil dönüşüm ve kullanıcı verilerini içe aktarma API'si olarak Data Manager API'ye geçmelerini öneririz. Bu API'de oturum özellikleri ve IP adresi kabul edilir. Google Ads API'de IP adresi ve oturum özelliği desteğinde yapılan değişiklikler hakkında daha fazla bilgi edinin.

JavaScript kullanan mevcut Çevrimdışı Dönüşümlerin İçe Aktarılması (OCI) kullanıcıları; bu verileri, mevcut yükleme şemaları içinde session_attributes adlı yeni bir alana JavaScript'ten yakalanan kodlanmış session_attributes'u yerleştirerek göndermelidir. Mevcut OCI sürecinizi kullanmaya devam edin ancak içe aktarma yaparken bu yeni alanı ayarlayın. Diğer tanımlayıcılarınız mevcut olmadığında Google Ads, session_attributes'u kullanır.

Yeni kullanıcıların tümü Data Manager API'yi kullanmalıdır. Bir hesap, IP adreslerini veya oturum özelliklerini Google Ads API üzerinden iletmek için izin verilenler listesinde yer almıyorsa bu dönüşümlerle ilgili bir hata mesajı alırsınız.

Not: Google Ads API'deki yeni alana erişmek için v19 veya sonraki bir sürüme yükseltmeniz gerekir.

Gelişmiş

JavaScript kullanamıyorsanız tek tek anahtar/değer çiftlerini yakalayıp bunları Çevrimdışı Dönüşümlerin İçe Aktarılması sürecinizle gönderebilirsiniz.

JavaScript kullanmayan mevcut Çevrimdışı Dönüşümlerin İçe Aktarılması (OCI) kullanıcıları; mevcut yükleme şemaları içinde ClickConversion.session_attributes_key_value_pairs adlı anahtar/değer çifti alanını da kullanabilir. API'yi çağırırken bu alanlarla birlikte anahtar/değer çiftleri göndermenizi öneririz. ClickConversion'a tek tek anahtar/değer çiftlerinin nasıl ekleneceğini açıklayan geliştirici belgelerini inceleyin.

Geçerli verilerin gönderildiğinden emin olmak için aşağıdaki önerileri inceleyebilir ve uygulamanızı güncelleyebilirsiniz:

• gad_campaignid (Kampanya kimliği): Reklam tıklamasıyla ilişkili geçerli Google Ads kampanyası kimliğini tutarlı bir şekilde gönderdiğinizden emin olun. Bu, reklam tıklaması URL'sinde "gad_campaignid=1234" olarak doldurulan kampanya kimliğidir. Temel bir özelliktir ve doğru ilişkilendirme için çok önemlidir.
• session_start_time_usec: Özelliğin (kullanıcı oturumunun başladığı zaman damgası) tutarlı bir şekilde gönderildiğinden emin olun.
• landing_page_url (URL): Açılış sayfasının doğru ve tam URL'sini gönderdiğinizden emin olun. Yer tutucu dizeler, dahili uygulama yolları veya eksik URL'ler göndermeyin.
  • Not: Doğru ve tam URL mevcut değilse yanlış veriler modellemeyi olumsuz etkileyebileceğinden alanın tamamının kaldırılması önerilir.
• landing_page_user_agent (Kullanıcı aracısı): Dizenin, kullanıcının tarayıcısını ve işletim sistemini doğru şekilde yansıttığından emin olun ve genel veya gömülü kod biçiminde değerler göndermeyin.

2. session_attributes alanını Veri Yöneticisi'ni kullanarak gönderme

session_attributes alanını Veri Yöneticisi'ni kullanarak da gönderebilirsiniz.

• Veri Yöneticisi kullanıcı arayüzü: session_attributes alanını oluşturmak için sağlanan JavaScript'i kullanın ve bu alanı Veri Yöneticisi kullanıcı arayüzü üzerinden yükleyin.
• Veri Yöneticisi API'si: Verilerinizi programatik olarak yüklemek için Data Manager API'yi entegre edebilirsiniz. Belirli talimatlar ve şema ayrıntıları için Veri Yöneticisi belgelerine bakın.

Doğru verileri göndererek Google Ads'in dönüşümleri doğru kampanyalarla ilişkilendirmek ve size daha kapsamlı dönüşüm raporları sunmak için bu bilgileri kullanmasına olanak tanırsınız.