Google Floodlight etiketleri

Bu makale, Floodlight etiketlerini bir Etiket Yöneticisi web kapsayıcısından bir sunucu kapsayıcısına taşımak isteyen geliştiricilere yöneliktir.

Sunucu tarafı Etiket Yöneticisi, Google Floodlight satış ve sayaç etiketlerinizi web sayfasından sunucuya taşımanıza olanak tanır. Bu etiketleri sunucuya taşımak, sayfada çalıştırmanız gereken kod miktarını azaltır ve sayfa yükleme sürelerinin iyileştirilmesine yardımcı olur.

Başlamadan önce

Etiketleri sunucunuza taşımadan önce aşağıdakileri yaptığınızdan emin olun:

• Google Etiket Yöneticisi ve Floodlight'a yönetici erişimi
• Google Etiket Yöneticisi'ni kurma ve yükleme
• Sunucu kapsayıcısı oluşturma
• Google Analytics: GA4 istemcisini ayarlama

1. Adım: Dönüşüm Bağlayıcı etiketini ayarlama

Floodlight hesabınızın Google Etiket Yöneticisi'ne dönüşüm verilerini gönderebilmesi için Dönüşüm Bağlayıcı etiketini ayarlamanız gerekir.

Sunucu kapsayıcınızda yapılandırılmış bir Dönüşüm Bağlayıcı etiketi zaten varsa bu adımı atlayabilirsiniz.

Dönüşüm Bağlayıcı etiketini ayarlamak için:

1. Sunucu kapsayıcı çalışma alanınızda, sayfanın sol tarafındaki Etiketler menüsünü açın.
2. Yeni etiket eklemek için Yeni'yi tıklayın.
3. Dönüşüm Bağlayıcı etiket türünü seçin.
4. Dönüşüm Bağlayıcı sunucu tarafı etiketinin etkinleşmesini sağlayacak tetikleyiciyi oluşturun.
   Çoğu durumda Tüm sayfalar tetikleyicisi en iyi seçenektir.
5. Etiketi adlandırın ve Kaydet'i tıklayın.

2. Adım: Floodlight etiketlerini ayarlayın

Google Etiket Yöneticisi, sunucu kapsayıcısındaki Floodlight Sayacı etiketlerini ve Floodlight Satış etiketlerini destekler.

Floodlight Sayacı

Bir Floodlight Sayacı etiketi ayarlamak için:

1. Sunucu kapsayıcı çalışma alanınızda, sayfanın sol tarafındaki Etiketler menüsünü seçin.
2. Yeni etiket eklemek için Yeni'yi tıklayın.

3. Floodlight Sayacı etiket türünü seçin.

   

4. Etiket yapılandırması için gereken değerleri toplamak üzere başka bir tarayıcı penceresi açın ve Campaign Manager 360'ta oturum açın. Reklamverenler'i ve ardından reklamverenin adını tıklayın. Bu değerleri yeni Etiket Yöneticisi Floodlight Sayacı etiketinize girin:

   • Reklamveren Kimliği: Reklamveren Kimliği, reklamveren ayrıntıları sayfasında reklamverenin adının hemen altında gösterilir. Bu değer, oluşturulmuş bir Floodlight etiket snippet'inde src= değeri olarak da bulunur.
   • Grup Etiketi Dizesi: Etkinlik tablosunda, çalışmak istediğiniz etkinliği belirleyin ve sağdaki sütunda listelenen grup etiketi dizesini bulun. Bu değer, oluşturulmuş bir Floodlight etiket snippet'inde type= değeri olarak da bulunur.
   • Etkinlik Etiketi Dizesi: Etkinlik tablosunda, çalışmak istediğiniz etkinliği belirleyin ve sağdaki sütunda listelenen etkinlik etiketi dizesini bulun. Bu değer, oluşturulmuş bir Floodlight etiket snippet'inde cat= değeri olarak da bulunur.

5. İstediğiniz Sayma Yöntemini ayarlayın:

   • Standart: Her dönüşümü sayar.
   • Benzersiz: Doğu Saati (ABD) ile gece yarısından gece yarısına 24 saatlik her bir gün boyunca her bir benzersiz kullanıcının ilk dönüşümünü sayar.
   • Oturum başına: Oturum başına bir kullanıcı için bir dönüşüm sayar. Oturum uzunluğu, Floodlight etiketinin dağıtıldığı site tarafından belirlenir.

6. Select a trigger (Tetikleyici seçin) penceresini açın.

7. Tetikleyici yapılandırması menüsünde bir tetikleyici seçin. Çoğu durumda Tüm Sayfalar en iyi seçenektir.

   

8. Bir etiket adı girin ve Kaydet'i tıklayın.

   

Floodlight Satış

Floodlight Satış etiketi ayarlamak için:

1. Sunucu kapsayıcı çalışma alanınızda, sayfanın sol tarafındaki Etiketler menüsünü seçin.
2. Yeni etiket eklemek için Yeni'yi tıklayın.

3. Floodlight Satış etiket türünü seçin. Not: Floodlight Satış etiketi, aşağıdaki değerleri karşılık gelen e-ticaret alanından otomatik olarak toplar:

   *   Order ID (Transaction ID)
   *   Revenue (Value)
   

4. Etiket yapılandırması için gereken değerleri toplamak üzere başka bir tarayıcı penceresi açın ve Campaign Manager 360'ta oturum açın. Reklamverenler'i ve ardından reklamverenin adını tıklayın. Bu değerleri yeni Etiket Yöneticisi Floodlight Sayacı etiketinize girin:

   • Reklamveren Kimliği: Reklamveren Kimliği, reklamveren ayrıntıları sayfasında reklamverenin adının hemen altında gösterilir. Bu değer, oluşturulmuş bir Floodlight etiket snippet'inde src= değeri olarak da bulunur.
   • Grup Etiketi Dizesi: Etkinlik tablosunda, çalışmak istediğiniz etkinliği belirleyin ve sağdaki sütunda listelenen grup etiketi dizesini bulun. Bu değer, oluşturulmuş bir Floodlight etiket snippet'inde type= değeri olarak da bulunur.
   • Etkinlik Etiketi Dizesi: Etkinlik tablosunda, çalışmak istediğiniz etkinliği belirleyin ve sağdaki sütunda listelenen etkinlik etiketi dizesini bulun. Bu değer, oluşturulmuş bir Floodlight etiket snippet'inde cat= değeri olarak da bulunur.

5. İstediğiniz Sayma Yöntemini ayarlayın:

   • Standart: Her dönüşümü sayar.
   • Benzersiz: Doğu Saati (ABD) ile gece yarısından gece yarısına 24 saatlik her bir gün boyunca her bir benzersiz kullanıcının ilk dönüşümünü sayar.
   • Oturum başına: Oturum başına bir kullanıcı için bir dönüşüm sayar. Oturum uzunluğu, Floodlight etiketinin dağıtıldığı site tarafından belirlenir.

6. Select a trigger (Tetikleyici seçin) penceresini açın.

7. Tetikleyici yapılandırması menüsünde bir tetikleyici seçin. Çoğu durumda Tüm Sayfalar en iyi seçenektir.

8. Bir etiket adı girin ve Kaydet'i tıklayın.

İsteğe bağlı: Gelişmiş dönüşümleri ayarlama

Gelişmiş dönüşümleri kullanmıyorsanız Ayarlarınızı doğrulama bölümüne atlayın.

Geliştirilmiş Dönüşümler'i yapılandırmak için aşağıdaki adımları uygulayın.

Kullanıcı tarafından sağlanan bir veri değişkeni oluşturma

Etiket Yöneticisi'nde gelişmiş dönüşümleri uygulamanın 3 yolu vardır. Kullanıcı tarafından sağlanan verileri toplamak için seçeneklerden yalnızca birini tercih etmeniz gerekir.

	Otomatik toplama	Manuel yapılandırma	Kod yapılandırması
Toplama yöntemi	Web sitenizin koduna göre kullanıcı tarafından sağlanan verileri otomatik olarak toplar. Girişlerin nereden toplanacağını kontrol etmeniz gerekiyorsa manuel kurulum veya kod kurulumunu tercih edin.	Kullanıcı tarafından sağlanan verileri toplamak için belirli CSS mülklerini veya JavaScript değişkenlerini belirtin. Veri biçimlendirme ve karma oluşturma işlemlerini kontrol etmeniz gerekiyorsa kod yapılandırmasını tercih edin.	Web sitenize, eşleştirme için karma oluşturma işlemi uygulanmış müşteri verilerini gönderen bir kod snippet'i ekleyin. Bu yöntem, dönüşüm etiketiniz her tetiklendiğinde tutarlı şekilde biçimlendirilmiş veriler göndermenizi sağlayarak gelişmiş dönüşümlerin doğruluğunu en üst düzeye çıkarmak için en iyi seçenektir.
Karmaşıklık	Basit	Aracı	Karışık
Beceriler	Özel bir beceri gerektirmez	HTML ve CSS	Web geliştirme

Otomatik toplama

1. Web kapsayıcınızda Değişkenler menüsünü açın.
2. Kullanıcı Tarafından Sağlanan Veriler türünde yeni bir Kullanıcı Tanımlı Değişken oluşturun.
3. Tür'ü Otomatik toplama olarak ayarlayın.
4. Değişkene My user-defined data gibi bir ad verin.
5. Kaydet'i tıklayın.

Manuel yapılandırma

1. Web kapsayıcınızda Değişkenler menüsünü açın.
2. Kullanıcı Tarafından Sağlanan Veriler türünde yeni bir Kullanıcı Tanımlı Değişken oluşturun.
3. Tür'ü Manuel yapılandırma olarak ayarlayın.

4. Gelişmiş dönüşümler aracılığıyla sağlamak istediğiniz alakalı kullanıcı verileri alanı için yeni veya mevcut bir değişken ekleyin.

   Not: Veri katmanınızda zaten değişkenler varsa (CSS seçicileri veya diğer değişken türlerini kullanıyorsanız) yeni değişkenler oluşturmak yerine bunları seçebilirsiniz. Emin değilseniz talimatları uygulamaya devam edin. Değişkenlere karma oluşturma işlemi uygulanabilir.

5. DOM'daki bir öğeyi belirtmek için Yeni değişken > Değişken yapılandırması > DOM öğesi oluşturun.

6. Seçim Yöntemi'nin altında CSS Seçici veya Kimlik kullanabilirsiniz. İpucu: CSS değişkenleriniz sık sık değişiyorsa sitenize HTML kimliği ekleyin ve kimlik değişkenini kullanın.

7. CSS seçiciyi veya kimlik adını girin. Özellik adı alanını boş bırakabilirsiniz.

8. DOM Öğesi değişkenini adlandırın ve kaydedin. Ekranınız Kullanıcı Tarafından Sağlanan Veriler ayarlarına döner.

9. Kullanıcı Tarafından Sağlanan Veriler değişkenini (ör. My user-defined data) adlandırın.

10. Kaydet'i tıklayın.

Kod ile yapılandırma

1. adım: Gelişmiş dönüşüm değişkenlerinizi belirleyip tanımlayın

Karma oluşturma işlemi uygulanmamış veriler veya önceden karma oluşturma işlemi uygulanmış veriler gönderebilirsiniz. Bu veriler sunuculara ulaşmadan önce Google tarafından karma haline getirilir. Önceden karma oluşturma işlemi uygulanmış veriler göndermeye karar verirseniz lütfen verileri onaltılık kodlanmış SHA256 kullanarak kodlayın. Her iki durumda da en az şu alanlardan birini sağlayın: email veya phone_number.
Karma oluşturma işlemi uygulanmamış verileri veri katmanına aktarmak için:

1. Web sitenizde, kullanıcılar tarafından sağlanan verileri bir JavaScript değişkeninde anahtar/değer çiftleri olarak depolayın. Örneğin:

   var leadsUserData = {
     'email': '[e-mail]',
     'phone_number': '[phone]',
     'address': {
       first_name: 'John',
       last_name: 'Doe',
       street: '123 Lemon',
       city: 'Some city',
       region: 'CA',
       country: 'US',
       postal_code: '12345',
     },
   };
   

2. dataLayer.push() kullanarak kullanıcı verilerini bir etkinlikle birlikte gönderin. Örneğin:

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'email': '[e-mail]',
         'phone_number': '[phone]',
         'address': {
            first_name: 'John',
            last_name: 'Doe',
            street: '123 Lemon',
            city: 'Some city',
            region: 'CA',
            country: 'US',
           postal_code: '12345',
          },
        },
     });
   <script>
   

leadsUserData değişkeni artık Google Etiket Yöneticisi'nde kullanılabilir.

Karma oluşturma işlemi uygulanmış verileri veri katmanına aktarmak için:

1. Web sitenizde, on altılık olarak kodlanmış SHA256 kullanarak kullanıcı tarafından sağlanan verilere karma oluşturma işlemi uygulayın. Kodlanmış verilerin anahtarının sha256_ ile başlaması gerekir. Örneğin:

   {'sha256_email_address':await hashEmail(email.trim()),
   }
   

2. dataLayer.push() kullanarak kullanıcı verilerini bir etkinlikle birlikte gönderin. Aşağıdaki örnekte, eşzamansız olarak çalıştırdığınız bir karma işlevi yazdığınızı varsayan bir veri katmanı uygulaması gösterilmektedir.

   <script>
     dataLayer.push({
       'event': 'formSubmitted',
       'leadsUserData': {
         'sha256_email_address': await hashEmail(email.trim()),
         'sha256_phone_number': await hashPhoneNumber(phoneNumber),
         'address': {
           sha265_first_name: await hashString(firstname),
           sha256_last_name: await hashString(lastname),
           sha256_street: await hashString(streetAddress),
           postal_code: '12345',
          },
        },
     });
   <script>
   

leadsUserData değişkeni artık Google Etiket Yöneticisi'nde kullanılabilir.

2. Adım: Kullanıcı tarafından sağlanan veri değişkenini oluşturun

1. Web kapsayıcınızda Değişkenler menüsünü açın.
2. Kullanıcı Tarafından Sağlanan Veriler türünde yeni bir Kullanıcı Tanımlı Değişken oluşturun.
3. Type (Tür) alanını Code olarak ayarlayın.
4. Sağlamak istediğiniz alakalı kullanıcı verileri alanı için açılır menüyü tıklayın ve Yeni Değişken'i seçin.
5. Değişken Türü Seçin'in altında, Veri Katmanı Değişkeni'ni seçin.
6. Veri Katmanı Değişkeni'nde depolanan kullanıcı verilerinize bakın. Örneğin, leadsUserData.
7. Veri Katmanı değişkenini adlandırın ve kaydedin. Ekranınız Kullanıcı Tarafından Sağlanan Veriler ayarlarına döner.
8. Kullanıcı Tarafından Sağlanan Veriler değişkenini (ör. My user-defined data) adlandırın.
9. Kaydet'i tıklayın.

Değişkeni Google etiketine atayın

1. Web kapsayıcınızda Etiketler menüsünü açın.
2. Etiketleme sunucusuna veri göndermek için kullandığınız Google etiketini düzenleyin.
3. Yapılandırma ayarları altında, user_data adlı yeni bir Yapılandırma parametresi ekleyin. Değer'i Kullanıcı tarafından sağlanan Veriler değişkenine ayarlayın (örneğin, {{My user-provided data}}).

4. Yaptığınız değişiklikleri kaydedin. Etiketiniz şu şekilde görünmelidir:

   

Sunucu tarafı Floodlight etiketini yapılandırma

Sunucu kapsayıcınızdaki Floodlight Satış veya Floodlight Sayacı etiketinde Gelişmiş Dönüşümleri etkinleştirin.

1. Kullanıcı tarafından sağlanan verileri dahil et onay kutusunu işaretleyin.
   
2. Yaptığınız değişiklikleri kaydetmek için Kaydet'e basın.

İsteğe bağlı: Gelir Değeri

Floodlight Satış etiketi, geliri hesaplamak için varsayılan tutar olarak etkinliğin value parametresini kullanır. Gelir değerini hesaplamak için farklı bir temel belirtmek üzere veritabanınızdan verileri alacak bir değişken ayarlamanız ve bunu, Floodlight Satış etiketinize atamanız gerekir.

Not: Sunucu kapsayıcısı, sunucu tarayıcıya geri veri iletirken dönüşüm verilerinin açığa çıkmasını önlemek için gelir değerini şifreler.

Yeni bir değişken oluşturmak için:

1. Sunucu kapsayıcınızda Değişkenler menüsünü açın.
2. Veri girişi için yeni bir kullanıcı tanımlı değişken oluşturun. Örneğin, bir Firestore veritabanındaki değeri kullanmak istiyorsanız {{Firestore Lookup}} değişkeni oluşturun.
3. Değişkene ilişkin veri kaynaklarını belirtin.
4. Değişkeni "Kâr arama" gibi bir adla adlandırın ve Kaydet'i tıklayın.

Değişkeni Floodlight Satış etiketinde kullanmak için:

1. Sunucu kapsayıcınızda Etiketler menüsünü açın.
2. Floodlight Satış etiketini düzenleyin.

3. Benzersiz Parametreler bölümünde:

   • Veri Kaynağı için Özel yapılandırma'yı seçin.
   • Gelir için daha önce oluşturduğunuz değişkeni seçin.
   • Sipariş Kimliği alanına, sipariş kimliğini dinamik olarak doldurmak için bir kimlik girin veya değişken kullanın.

   

4. Etiketi kaydedin.

İsteğe bağlı: Özel parametreler

Web sayfanızdan Google Marketing Platform'a match_id gibi özel alanlar aktarabilirsiniz.

Google Etiket Yöneticisi

Floodlight için özel alanları yapılandırmak için x-dc- parametresini bir parametre adının başına ekleyin:

1. Web kapsayıcınızda Etiketler menüsünü açın.
2. GA4 etkinlik etiketini düzenleyin veya yeni etiket oluşturun.

3. Etkinlik Parametreleri bölümüne parametre adını ekleyin. Floodlight'a gittiğini bildirmek için başa x-dc- ifadesini ekleyin. Örneğin, normalde match_id gönderecekseniz bunu x-dc-match_id olarak değiştirin.

   

4. Etiketi kaydedin.

gtag.js

Floodlight için özel alanları yapılandırmak için etkinlik parametresi adının başına x-dc- dizesini ekleyin:

  gtag('event', 'purchase', {
      'x-dc-match_id': [MATCH_ID],
      ...
  })

3. Adım: Ayarlarınızı doğrulayın

Sunucu kapsayıcısıyla veri göndermeye başladıktan sonra, aşağıdaki adımları uygulayarak düzgün çalışıp çalışmadığını kontrol edebilirsiniz:

1. Web sitenizi açın.
2. Google Etiket Yöneticisi sunucu kapsayıcınızda Önizleme'yi seçin. Tag Assistant başlatılır ve sunucu kapsayıcınızı yükler.
3. Etiketler sekmesi, tetiklenen tüm etiketleri gösterir. Yapılandırdığınız etiketin tetiklenip tetiklenmediğini kontrol edin.
4. Konsol sekmesi, sunucu kapsayıcısına veri iletimi sırasında oluşan hataları gösterir. Hataları kontrol edip düzeltin.

Etiket Yöneticisi kapsayıcılarında hata ayıklamayla ilgili daha fazla yardım için önizleme ve hata ayıklama yardımına bakın.

Sonraki adımlar

Floodlight etiketiniz beklendiği gibi çalıştıktan sonra, verilerin yinelenmesini önlemek için bir web kapsayıcısındaki eşdeğer Floodlight etiketlerini kaldırabilirsiniz.