Uygulama
Özet
Dönüşüm izleme üç bölümden oluşur:
- Açılış sayfasından / uygulama giriş noktasından
rwg_token
vemerchant_id
bilgileri toplanıyor. - Uygun ilişkilendirme dönemi için
rwg_token
vemerchant_id
koşullarının geçerli olması. - Dönüşüm zamanında kalıcı
merchant_id
ilemerchant_id
karşılaştırmasını karşılaştırma (rezervasyon tamamlandı). - Dönüşüm zamanında bir dönüşüm etkinliği gönderme (rezervasyon tamamlandı).
Bu dönüşüm izleme uygulaması, Google Analytics veya başka bir 3. taraf JavaScript 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 vermelisiniz:
- Cihaz düzeyinde tarayıcı çerezleri, yerel depolama alanı, uygulama yerel depolama alanı veya jetonu 30 günlük ilişkilendirme penceresi için saklayabilecek başka bir yöntem kullanılabilir. Jeton, kullanıcının cihazında yerel olarak depolanacağından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını veya çerezlerini temizlerse ya da gizli tarama veya gizli mod kullanıyorsa dönüşüm etkinliği düzgün bir şekilde ilişkilendirilemeyebilir. Cihaz düzeyinde dönüşüm izlemeyi kullanırken bunu, desteklenen her yüzeyde (mobil dahil) yeniden uygulamanız gerekir.
- Kullanıcı düzeyi, verilerin sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda tutulmasını içerir. Jeton sunucu tarafında depolanacağından, kullanıcı kullandığı cihazı değiştirirse, yerel depolama alanını veya çerezlerini temizlerse ya da özel bir 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 izleme özelliğini kullanırken, sisteminizin mimarisine bağlı olarak bunu sunucu tarafında bir kez uygulayabilir ve desteklenen tüm yüzeylerde yeniden kullanabilirsiniz.
rwg_token
toplanıyor
Google, Feed'ler aracılığıyla sağladığınız bir action_link öğesini her gösterdiğ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 ancak kullanıcı verilerini içermeyen kodlanmış bir dizedir. Bu jetonu depolamalı ve dönüşüm etkinliğinin bir parçası olarak geri iletmeniz gerekir.
Her açılış sayfası / uygulama giriş noktasında, rwg_token
sorgu parametresi için ayarlanan değeri ayrıştırıp depolamanız gerekir. Bu parametrenin depolanmasıyla ilgili şartlar, rwg_token
ürününün devamlılığı bölümünde açıklanmıştır.
Bu jetonun tarayıcı üzerinden cihaz düzeyinde izleme için nasıl ayrıştırılabileceğine dair bir örneği aşağıda bulabilirsiniz. Alternatif olarak, isteğe yanıt verirken bu jetonu sunucu tarafında 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
toplanıyor
Ön uçta dönüşüm izleme mantığını uygularsanız açılış sayfasında merchant_id
öğesini bulup yakalayacak özel bir komut dosyası uygulamanız gerekir. Genellikle merchant_id
, açılış sayfasında veya URL'de zaten mevcut olabilir. Böylece, bunu oradan yakalayabilirsiniz. Böyle bir durum söz konusu değilse arka uç değişikliklerine işaret edecek şekilde kullanılabilmesi için bir yerde görünür hale getirmenin bir yolunu bulmanız gerekir.
Arka uçta dönüşüm izleme mantığını uygularsanız ön uç sayfasını oluşturmak için dahili sisteminizi sorgulayan verilerin yanında merchant_id
görebilirsiniz.
Bu merchant_id
, feed'inizde Google ile paylaştığınızla aynı olmalıdır.
rwg_token
ve merchant_id
devam ediyor
Sağladığınız tüm işlem bağlantılarına toplam 30 gün boyunca eklenecek rwg_token
URL parametresini kullanmaya devam etmeniz gerekir.
rwg_token
değeri depolanmalı ve herhangi bir düzenleme yapılmadan döndürülmelidir.
rwg_token
ile birlikte, işlem bağlantısıyla ilişkilendirilmiş merchant_id
öğesini de depolamanız gerekir.
Önceki bir ziyaretten kalan mevcut bir jeton varsa önceki rwg_token
ve merchant_id
değiştirilmeli ve 30 günlük depolama aralığı sıfırlanmalıdır.
Yukarıdaki eşlemeyi 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 penceresi için saklayabilecek başka bir yöntem kullanılabilir.
- Kullanıcı düzeyi, verilerin sunucu tarafı analiz sistemi veya diğer sunucu tarafı sistemler aracılığıyla uygulama veritabanınızda tutulmasını içerir.
Aşağıda, birinci taraf çerezi kullanılarak bu değerlerin bir web tarayıcısında depolandığı cihaz düzeyinde dönüşüm izlemeye ilişkin bir örnek verilmiştir. Bu örnekte, jeton değerini yukarıdaki örnekte olduğu gibi bir değişkene ayrıştırdığınız varsayılır. Bu örneği kullanmak için rootdomain.com
alan adını 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şkilendirilir.
Dönüşüm Verileri Gönderiliyor
Bir kullanıcı, Google Place Action bağlantısıyla ilişkilendirilebilecek bir işlemi tamamladığında dönüşüm uç noktasına bir HTTP POST isteği göndermeniz gerekir. Biri üretim ortamı, diğeri korumalı alan ortamı için olmak üzere iki uç nokta vardır.
- Üretim: https://www.google.com/maps/conversion/collect
- Korumalı alan: https://www.google.com/maps/conversion/debug/collect
Gönderi gövdesi şu biçimde JSON kodlu bir nesne olmalıdır:
{
"conversion_partner_id": <partnerId>,
"rwg_token": <rwg_token_val>,
"merchant_changed": 1|2
}
Örnek (iş ortağı 20123456 için test jetonuna sahip değiştirilmemiş 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önlendirme satıcısından 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, kullanıcı asıl satıcının web sitesinden ayrılıp platformunuz üzerinden farklı bir satıcıyla satın alma işlemi tamamladığında kullanılmalıdır |
2 | Bu değer, müşteri orijinal Varlık (Satıcı) aracılığıyla bir işlemi tamamladığında kullanılmalıdır. |
Hem korumalı alan hem de üretim ortamlarında, dönüşüm etkinliği gönderirken geçerli bir rwg_token
sağlamanız gerekir. Test amacıyla, siz lansman yapana kadar her iki ortamda da aşağıdaki test jetonunu kullanın:
AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ==
Korumalı Alan'da test etmek için aşağıdaki URL parametresini Korumalı Alan bağlantılarınıza manuel olarak eklemeniz gerekir:
rwg_token=AJKvS9WeONmWKEwjG0--HdpzMq0yAVNL8KMxbb44QtbcxMhSx_NUud5b8PLUBFehAIxOBO-iYRIJOknEFkIJmdsofdVJ6uOweQ%3D%3D
Bu gönderme isteğinin nasıl yapılacağına dair JavaScript'te, cihaz düzeyinde dönüşüm izlemeye (kullanıcının cihazındaki bir çerez kullanılarak) ilişkin tam bir örnek 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şkilendirilen jetonu (bulundukları yüzeye bakılmaksızın) sunucu tarafı depolama mekanizmanızdan almanız ve jetonu aynı üretim veya korumalı alan uç noktalarını kullanarak göndermeniz gerekir.
Dönüşümle İlişkilendirme Koşulları
Google'ın dönüşüm ilişkilendirmesi için zorunlu standardı, herhangi bir mağazada yer bağlantısıyla her etkileşim için 30 günlük bir ilişkilendirme aralığıdır.
Bu ilişkilendirme dönemi, Google'ın aşağıdaki senaryolardan herhangi birinde bir dönüşüm etkinliği gönderilmesini beklediği anlamına gelir:
- Bir kullanıcı, yer işlemi bağlantısını takip eder ve aynı oturumda aynı satıcı için sipariş verir. (Satıcı Değişim Değeri = 2 )
- Kullanıcı, yer işlemi bağlantısını takip eder ve ardından aynı satıcıya sipariş vermek için 30 günlük zaman aralığı içinde farklı bir kanaldan geri döner. (Satıcı Değişiklik Değeri = 2 )
- Kullanıcı, bir yer işlemi bağlantısını takip ettikten sonra farklı bir mağazada aynı oturumda veya 30 günlük zaman aralığındaki farklı bir oturumda sipariş verir. ( Satıcı Değişim Değeri = 1 )
Ayrıca Google, dönüşüm etkinliklerinin bir kullanıcının bir yer işlemi bağlantısından gidebileceği tüm yüzeylerden gönderilmesini bekler. Şunlar dahil:
- Masaüstü veya mobil web uygulamaları
- Uygulama derin bağlantısı veya alanınız için kayıtlı bir uygulama amacı aracılığıyla mobil uygulamalar
Jeton kullanıcı düzeyinde depolanıyorsa (jetonun devam ettiğini görün) cihazlar arası ilişkilendirme sağlamanız beklenir. Yani masaüstündeki bir işlem bağlantısını takip eden ve daha sonra mobil cihazda işlemi tamamlayan (aynı kullanıcı hesabını kullanarak) bir kullanıcı, bir dönüşüm etkinliği tetiklemelidir.
Jeton yalnızca cihaz düzeyinde (ör. tarayıcı çerezlerinde) depolanıyorsa cihazlar arası ilişkilendirme sağlamanız beklenemez. Bu durumda, kullanıcının cihazdaki bir işlem bağlantısını izlemesi durumunda her cihazın ayrı bir jetonu olur ve her cihaz ilişkilendirme kurallarını ayrı ayrı izlerdi.