Uygulama
Özet
Dönüşüm izleme uygulaması üç aşamadan oluşur:
- Açılış sayfasından / uygulama giriş noktasından
rwg_token
vemerchant_id
toplanıyor. - Uygun ilişkilendirme dönemi için
rwg_token
vemerchant_id
koşullarının korunması. - Dönüşüm sırasında kalıcı
merchant_id
vemerchant_id
karşılaştırmasını yapın (rezervasyon tamamlandı). - Dönüşüm zamanında bir dönüşüm etkinliği gönderiliyor (rezervasyon tamamlandı).
Bu dönüşüm izleme uygulaması, Google Analytics'i veya başka bir üçüncü taraf JavaScript'i kullanmanızı gerektirmez.
Dönüşüm izleme uygulamanız üzerinde çalışmaya başlamadan önce, dönüşümleri cihaz düzeyinde mi yoksa kullanıcı düzeyinde mi izleyeceğinize karar vermeniz gerekir:
- Cihaz düzeyinde; tarayıcı çerezleri, yerel depolama alanı, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme süresi boyunca koruyabilen başka herhangi bir yöntem kullanılabilir. Jeton, kullanıcının cihazında yerel olarak depolanacağından, kullanıcı kullandığı cihazı değiştirir, yerel depolama alanını veya çerezlerini temizlerse ya da gizli göz atma veya gizli mod kullanıyorsa dönüşüm etkinliği düzgün bir şekilde ilişkilendirilmeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken, bunu desteklenen her yüzeyde (mobil cihazlar dahil) tekrar uygulamanız gerekir.
- Kullanıcı düzeyi, verinin uygulama veritabanınızda, sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla kalıcı olarak tutulmasını içerir. Jeton sunucu tarafında depolanacağından, kullanıcı kullandığı cihazı değiştirir, yerel depolama alanını veya çerezlerini temizlerse ya da gizli tarama veya gizli mod kullanıyorsa kullanıcı tekrar giriş yaptığında dönüşüm etkinliği ilişkilendirilmeye devam eder. Kullanıcı düzeyinde dönüşüm izlemeyi kullanırken, sisteminizin mimarisine bağlı olarak bunu sunucu tarafında bir kez uygulayıp desteklenen tüm yüzeylerde yeniden kullanabilirsiniz.
rwg_token
verileri toplanıyor
Google, Feed'ler aracılığıyla sağladığınız bir action_link öğesi görüntülediğinde, bu URL benzersiz bir sorgu parametresi içerecek şekilde değiştirilir: rwg_token
. rwg_token
değeri, kullanıcının tıkladığı bağlantıyla ilgili bazı meta verileri içeren kodlanmış bir dizedir. Bu jetonu depolamanız ve dönüşüm etkinliğinin bir parçası olarak geri vermeniz gerekir.
Her açılış sayfasında / uygulama giriş noktasında, rwg_token
sorgu parametresi için ayarlanan değeri ayrıştırmalı ve depolamalısınız. Bu parametreyi depolama koşulları, rwg_token
'ün Kalıcılığını Sağlama adımında açıklanmıştır.
Bu jetonun, tarayıcı üzerinden cihaz düzeyinde izleme için nasıl ayrıştırılabileceğine dair bir örnek aşağıda verilmiştir. Alternatif olarak, isteğe yanıt verirken sunucu tarafında bu jetonu toplayabilirsiniz:
var query = location.search.substring(1);
var params = query.split('&');
var rwgToken = undefined;
for (var i = 0; i < params.length; ++i) {
var pair = params[i].split('=');
if (pair[0] == 'rwg_token') {
rwgToken = decodeURIComponent(pair[1]);
break;
}
}
merchant_id
verileri toplanıyor
Dönüşüm izleme mantığını ön uçta uygularsanız açılış sayfasında, merchant_id
parametresini bulup yakalayacak özel bir komut dosyası uygulamanız gerekir. merchant_id
genellikle açılış sayfasında veya URL'de zaten mevcut olabilir. Böylece bu bilgiyi oradan yakalayabilirsiniz. Aksi takdirde, arka uç değişikliklerine işaret edebilecek şekilde yakalanabileceği bir yerde açığa çıkarmanın bir yolunu bulmanız gerekir.
Arka uca dönüşüm izleme mantığını uygularsanız ön uç sayfasını oluşturmak için dahili sisteminizi sorgulayan verilerin yanı sıra merchant_id
kodunu bulabilirsiniz.
Bu merchant_id
, feed'inizde Google ile paylaştığınız ile aynı olmalıdır.
rwg_token
ve merchant_id
koşullarının korunması
Sağladığınız tüm işlem bağlantılarına eklenecek olan rwg_token
URL parametresini toplam 30 gün boyunca sürdürmeniz gerekir.
rwg_token
değeri saklanmalı ve herhangi bir düzenleme yapılmadan döndürülmelidir.
rwg_token
ile birlikte, işlem bağlantısıyla ilişkili merchant_id
öğesini depolamanız gerekir.
Önceki bir ziyaretten kalan mevcut bir jeton varsa önceki rwg_token
ve merchant_id
değiştirilmeli ve depolama için 30 günlük zaman aralığı sıfırlanmalıdır.
Yukarıdaki eşleşmeyi sürdürürken değerleri cihaz düzeyinde veya kullanıcı düzeyinde depolayabilirsiniz:
- Cihaz düzeyinde; tarayıcı çerezleri, yerel depolama alanı, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme süresi boyunca koruyabilen başka herhangi bir yöntem kullanılabilir.
- Kullanıcı düzeyi, verinin uygulama veritabanınızda, sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla kalıcı olarak tutulmasını içerir.
Aşağıda, cihaz düzeyinde dönüşüm izleme örneği verilmiştir. Bu değerler, birinci taraf çerezi kullanılarak bir web tarayıcısında saklanır. Bu örnekte, yukarıdaki örnekte olduğu gibi jeton değerini bir değişkene ayrıştırıdığınız varsayılmaktadır. Bu örneği kullanmak için rootdomain.com
alanını alanınıza güncellemeniz gerekir.
if (typeof rwg_token !== 'undefined') {
document.cookie =
"_rwg_token=" + rwg_token + ";_merchant_id=" + merchantid + ";max-age=2592000;domain=rootdomain.com;path=/";
}
Kullanıcı düzeyinde dönüşüm izleme kullanılırken rwg_token
+ merchant_id
sunucuda depolanmalı ve kullanıcıyla ilişkilendirilmelidir.
Dönüşüm Verilerini Gönderme
Kullanıcı, Google Yer İşlemi bağlantısıyla ilişkilendirilebilir bir işlemi tamamladığında dönüşüm uç noktasına bir HTTP POST isteği göndermeniz gerekir. Biri üretim ortamı, diğeri ise korumalı alan ortamı için olmak üzere iki uç nokta bulunur.
- Üretim: https://www.google.com/maps/conversion/collect
- Korumalı alan: https://www.google.com/maps/conversion/debug/collect
Yayın gövdesi, şu biçimde JSON kodlamalı bir nesne olmalıdır:
{
"conversion_partner_id": <partnerId>,
"rwg_token": <rwg_token_val>,
"merchant_changed": 1|2
}
Örnek (20123456 iş ortağı için test jetonuna sahip değişmemiş satıcı):
{
"conversion_partner_id": 20123456,
"rwg_token": "AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ",
"merchant_changed": 2
}
merchant_changed değeri, satıcının ilk yönlendirmeli satıcıdan değiştirilip değiştirilmediğini belirlemek için kullanılır. İki değer iletilebilir.
Satıcı Değişim Değeri | Gereksinim |
---|---|
1 | Bu değer, bir kullanıcı orijinal satıcının web sitesinden ayrılıp platformunuz üzerinden farklı bir satıcıyla bir satın alma işlemini tamamladığında kullanılmalıdır. |
2 | Bu değer, müşteri bir işlemi orijinal Varlık (Satıcı) aracılığıyla tamamladığında kullanılmalıdır. |
Hem korumalı alanda hem de üretim ortamlarında, bir dönüşüm etkinliği gönderirken geçerli bir rwg_token
sağlamanız gerekir. Test amacıyla, lansmana kadar her iki ortamda aşağıdaki test jetonunu kullanın:
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
Bu yayın isteğinin nasıl yapılacağını gösteren JavaScript'te cihaz düzeyinde dönüşüm izlemenin (kullanıcının cihazında bir çerez kullanarak) tam örneği aşağıda verilmiştir:
const partnerId = XXXXXXXXXX;
const endpoint = `https://www.google.com/maps/conversion/collect`;
const rwgTokenCookie = document.cookie
.split('; ')
.find(row => row.startsWith('_rwg_token='));
if (typeof rwgTokenCookie !== 'undefined') {
const rwgTokenVal = rwgTokenCookie.split('=')[1];
fetch(endpoint, {
method: "POST",
body: JSON.stringify({
conversion_partner_id: partnerId,
rwg_token: rwgTokenVal,
merchant_changed: merchantChanged
})
});
}
Kullanıcı düzeyinde dönüşüm izlemeyi kullanırken, kullanıcıyla ilişkili jetonu (bulunduğu yüzeyden bağımsız olarak) sunucu tarafı depolama mekanizmanızdan almalı ve jetonu aynı üretim veya korumalı alan uç noktalarını kullanarak göndermeniz gerekir.
Dönüşümle İlişkilendirme Gereksinimleri
Google'ın dönüşüm ilişkilendirmesi için zorunlu standardı, herhangi bir mağazada bir yer bağlantısıyla olan tüm etkileşimler için 30 günlük bir ilişkilendirme aralığıdır.
Bu ilişkilendirme aralığı, Google'ın aşağıdaki senaryolardan herhangi birinde bir dönüşüm etkinliği gönderilmesini bekleyebileceği anlamına gelir:
- Bir kullanıcı, bir yer işlemi bağlantısını izler ve aynı oturumda aynı satıcıya sipariş verir. (Satıcı Değişim Değeri = 2 )
- Bir kullanıcı, bir yer işlemi bağlantısını izler ve ardından aynı satıcıya sipariş vermek için 30 gün içinde farklı bir kanaldan geri döner. (Satıcı Değişim Değeri = 2)
- Bir kullanıcı, bir yer işlemi bağlantısını izler ve ardından aynı oturumda veya 30 günlük süre içinde farklı bir oturumda farklı bir mağazadan sipariş verir. ( Satıcı Değişim Değeri = 1 )
Buna ek olarak Google, dönüşüm etkinliklerinin kullanıcıların bir yer işlemi bağlantısı üzerinden ulaşabilecekleri tüm platformlardan gönderilmesini bekler. Şunlar dahil:
- Masaüstü veya mobil web uygulamaları
- Uygulama derin bağlantısı veya alanınız için kayıtlı uygulama amacı aracılığıyla mobil uygulamalar
Jeton kullanıcı düzeyinde depolanıyorsa (jetonu kullanmaya devam etme konusuna bakın) cihazlar arası ilişkilendirme sağlamanız beklenir. Diğer bir deyişle, masaüstünden bir işlem bağlantısını takip eden ve ardından işlemi mobil cihazda tamamlayan (aynı kullanıcı hesabını kullanarak) bir kullanıcı bir dönüşüm etkinliği tetiklemelidir.
Jeton yalnızca cihaz düzeyinde depolanıyorsa (ör. tarayıcı çerezlerinde), cihazlar arası ilişkilendirme sağlamanız beklenmez. Bu durumda, kullanıcı söz konusu cihazdaki işlem bağlantısını izlemiş olsaydı her bir cihaz için ayrı bir jeton kullanılmaya devam eder ve her cihaz ilişkilendirme kurallarını ayrı ayrı izler.