Swift için Başlangıç Kılavuzu

Bu kılavuzda, Google Etiket Yöneticisi (GTM) ile ekran açma ve düğmeye basılan etkinlikleri izlemek için Swift'te nasıl iOS uygulaması oluşturulacağı ve uygulanacağı açıklanmaktadır.

1. Yeni proje oluştur

1. Xcode'u açın.
2. Yeni Xcode projesi oluştur'u tıklayın.
3. Tek Görünüm Uygulaması'nı seçin.
4. İleri'yi tıklayın.
5. Projenizi adlandırın ve projeyle ilgili ek seçenekleri belirleyin. Proje adınız ve uygulama adınız, ürün adıyla aynı olacaktır.
   
6. İleri'yi tıklayın.
7. Bir proje konumu (dizin) seçin.
8. Oluştur'u tıklayın.

2. Google Etiket Yöneticisi bağımlılarını yükleme

1. Xcode'dan çıkın.
2. Cocoapods'u yüklemek için terminalde aşağıdaki komutu çalıştırın:

   $ sudo gem install cocoapods
   

3. Proje dizininize geçin.
4. Podfile adlı bir dosya oluşturmak için aşağıdaki komutu çalıştırın:

   $ pod init
   

5. Podfile ürününde, use_frameworks! açıklamasını kaldırın ve pod 'GoogleTagManager' öğesini hedefe ekleyin:

# Uncomment this line if you're using Swift
use_frameworks!

target 'GtmSwiftTutorial' do
  pod 'GoogleTagManager'
end

6. Google Etiket Yöneticisi (GTM) bağımlılıkları projenize indirip yüklemek için aşağıdaki komutu çalıştırın:

   $ pod install
   

   Bu komut, GtmSwiftTutorial.xcworkspace çalışma alanını da oluşturur. Bundan sonra GtmSwiftTutorial uygulamasını geliştirmek için bu çalışma alanını kullanın.

3. Objective-C kitaplıkları için köprüleme üstbilgisi ekleme

Bağlantı başlığı dosyası oluşturmak için:

1. Xcode'u açın.
2. Dosya > Yeni > Dosya'yı tıklayın.
3. iOS > Kaynak bölümünde Başlık Dosyası'nı seçin.
4. İleri'yi tıklayın.
5. Başlık dosyası adını BridgingHeader.h girin.
   
6. Oluştur'u tıklayın.
7. Üstbilgi dosyasına şu import ifadelerini ekleyin:

   #ifndef BridgingHeader_h
   #define BridgingHeader_h
   
   #import <GoogleTagManager/TAGManager.h>
   #import <GoogleTagManager/TAGContainer.h>
   #import <GoogleTagManager/TAGContainerOpener.h>
   #import <GoogleTagManager/TAGDataLayer.h>
   #import <GoogleTagManager/TAGLogger.h>
   
   #endif /* BridgingHeader_h */
   

Derleme ayarlarına Objective-C köprüleme üstbilgisi eklemek için:

1. Xcode'da projenizi tıklayın.
2. Düzenleyici alanında Derleme Ayarları'nı tıklayın.
   
3. Tümü ve Birleşik'i seçin ve köprü için arama yapın.
   
4. Objective-C Köprü Başlığı'nı içeren satırın sağ sütununa BridgingHeader.h yazın.
   

4. Projenize varsayılan kapsayıcı ekleme

Projenize varsayılan bir kapsayıcı eklemeden önce mobil kapsayıcı ikilisini indirin:

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Menü çubuğunda Sürümler'i tıklayın.
4. Seçilen kapsayıcı sürümünde İşlemler > İndir'i tıklayın.
İndirilen dosyanın adı kapsayıcı kimliğidir (örneğin, GTM-PT3L9Z).

Projenize varsayılan bir kapsayıcı ikili dosyası eklemek için:

1. Xcode'u açın.
2. Dock'taki Finder simgesini tıklayın.
3. Downoloads klasörünü tıklayın.
4. Kapsayıcı ikili dosyası sürükleyip Downloads klasörüne ve ardından Xcode projenizin kök klasörüne bırakın.

5. Google Etiket Yöneticisi'ni uygulamanıza bağlama

1. Xcode'da AppDelegate.swift dosyasını açın.
2. AppDelegate sınıfının TAGContainerOpenerNotifier sınıfını genişletmesini sağlayın:

   import UIKit
   
   @UIApplicationMain
   class AppDelegate: UIResponder, UIApplicationDelegate, TAGContainerOpenerNotifier {
     // ...
   }
   

   Sınıfı uzattıktan sonra Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier' hatası alırsınız. Aşağıdaki adım bu hatayı düzeltir.

3. AppDelegate sınıf tanımının alt kısmına aşağıdaki işlevi ekleyin:

   func containerAvailable(container: TAGContainer!) {
     container.refresh()
   }
   

4. application işlevinde return true ifadesinden önce aşağıdaki kodu ekleyin:

   let GTM = TAGManager.instance()
   GTM.logger.setLogLevel(kTAGLoggerLogLevelVerbose)
   
   TAGContainerOpener.openContainerWithId("GTM-PT3L9Z",  // change the container ID "GTM-PT3L9Z" to yours
       tagManager: GTM, openType: kTAGOpenTypePreferFresh,
       timeout: nil,
       notifier: self)
   

6. Ekran açma etkinliğini izleme

Bir ekran açma etkinliğini izlemek için:

1. İzleme kimliğini depolayacak bir değişken oluşturun.
2. screenName adlı bir veri katmanı değişkeni oluşturun.
3. Ekran Görüntüleme başlıklı bir GTM etiketi oluşturun.
4. Ekran izleme kodu ekleyin.

a. Takip kimliğini depolayacak bir değişken oluşturun

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Sol gezinme çubuğunda Değişkenler'i tıklayın.
4. Kullanıcı Tanımlı Değişkenler altında Yeni'yi tıklayın.
5. Değişken adını girmek için Başlıksız Değişken'i tıklayın İzleme Kimliği'ni girin.
6. Değişken türü olarak Sabit değer'i seçin.
7. Değişkenin değeri olarak takip kimliğini (X bir rakam olduğunda UA-XXXXXXXX-X biçiminde) girin.
   UA-47605289-5 (silinecek) kullanın.
8. Değişken Oluştur'u tıklayın.

b. ScreenName adlı bir veri katmanı değişkeni oluşturun

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Sol gezinme çubuğunda Değişkenler'i tıklayın.
4. Kullanıcı Tanımlı Değişkenler altında Yeni'yi tıklayın.
5. Ekran Adı başlığını girmek için Adsız Değişken'i tıklayın.
6. Değişken türü olarak Veri Katmanı Değişkeni'ni seçin.
7. Veri Katmanı Değişken Adı olarak screenName değerini girin.
8. Varsayılan Değeri Ayarla'yı tıklayın.
9. unknown screen (bilinmeyen ekran) varsayılan değerini girin.
10. Değişken Oluştur'u tıklayın.

c. Ekran Görüntüleme başlıklı bir GTM etiketi oluşturma

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Soldaki gezinme çubuğunda Etiketler'i tıklayın.
4. Yeni'yi tıklayın.
5. Etiket adını girmek için Başlıksız Etiket'i tıklayın Ekran Görünümü'nü seçin.
6. Google Analytics ürününü seçin.
7. Listeden İzleme Kimliği'ni seçin.
8. İzleme Türü olarak Uygulama Görünümü'nü seçin.
9. Diğer ayarlar'ı tıklayın.
10. Ayarlanacak Alanlar'ı tıklayın.
11. + Alan Ekle'yi tıklayın.
12. screenName alan adını ve Screen Name değerini seçin.
13. Devam'ı tıklayın.
14. Etkinleştirme bölümünde Herhangi bir etkinlik'i seçin.
15. Etiket Oluştur'u tıklayın.

Ekran Görünümü GTM etiketinin oluşturulmasını gösteren ekran görüntüsüne bakın.

d. Ekran izleme kodu ekleme

1. ViewController.swift dosyasını Xcode'da açın.
2. ViewController sınıfında dataLayer adlı bir değişken tanımlayın:

   var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer
   

3. viewDidLoad() işlevinde, OpenScreen etkinliğini veri katmanına aktarın:

   dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])
   

ViewController sınıfının tanımı aşağıdaki gibidir:

import UIKit

class ViewController: UIViewController {
  var dataLayer: TAGDataLayer = TAGManager.instance().dataLayer

  override func viewDidLoad() {
    super.viewDidLoad()
    dataLayer.push(["event": "OpenScreen", "screenName": "Home Screen"])
  }

  override func didReceiveMemoryWarning() {
    super.didReceiveMemoryWarning()
    // Dispose of any resources that cant be recreated
  }
}

7. Düğmeye basıldı etkinliğini izleme

Düğmeye basılan bir etkinliği izlemek için:

1. eventAction adlı bir veri katmanı değişkeni oluşturun.
2. Event adlı bir özel etkinlik değişkeni oluşturun.
3. Düğmeye Basıldı başlıklı bir GTM etiketi oluşturun.
4. Bir düğme oluşturun ve bu düğmeye basıldığını izlemek için kod ekleyin.

a. eventAction adlı bir veri katmanı değişkeni oluşturma

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Sol gezinme çubuğunda Değişkenler'i tıklayın.
4. Kullanıcı Tanımlı Değişkenler altında Yeni'yi tıklayın.
5. Etkinlik İşlemi başlığını girmek için Başlıksız Değişken'i tıklayın.
6. Değişken türü olarak Veri Katmanı Değişkeni'ni seçin.
7. Veri Katmanı Değişken Adı olarak eventAction girin.
8. Varsayılan Değeri Ayarla'yı tıklayın.
9. Bilinmeyen etkinlik varsayılan değerini girin.
10. Değişken Oluştur'u tıklayın.

b. Etkinlik adlı bir özel etkinlik değişkeni oluşturma

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Sol gezinme çubuğunda Değişkenler'i tıklayın.
4. Kullanıcı Tanımlı Değişkenler altında Yeni'yi tıklayın.
5. Adsız Değişken'i tıklayarak Etkinlik değişken adını girin.
6. Değişken türü olarak Özel Etkinlik'i seçin.
7. Değişken Oluştur'u tıklayın.

c. Düğmeye Basıldı başlıklı bir GTM etiketi oluşturma

1. Google Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Soldaki gezinme çubuğunda Etiketler'i tıklayın.
4. Yeni'yi tıklayın.
5. Etiket adını girmek için Başlıksız Etiket'i tıklayın Düğmeye Basıldı'yı seçin.
6. Google Analytics ürününü seçin.
7. Listeden İzleme Kimliği'ni seçin.
8. İzleme Türü olarak Etkinlik'i seçin.
9. Etkinlik kategorisini seçin.
10. Etkinlik İşlemi'ni seçin.
11. Devam'ı tıklayın.
12. Etkinleştirme bölümünde Herhangi bir etkinlik'i seçin.
13. Etiket Oluştur'u tıklayın.

Düğmeye Basıldı GTM etiketini oluşturmayla ilgili ekran görüntüsüne bakın.

d. Bir düğme oluşturun ve düğmeye basıldığını izlemek için kod ekleyin

1. Xcode projenizi açın.
2. Main.storyboard adlı kişiyi aç.
3. Yardımcı program alanını (sağ kenar çubuğu) açmak için Xcode araç çubuğundaki en sağdaki düğmeyi tıklayın.
4. Hizmet alanının en altında,
   

   Öğe kitaplığını göster düğmesini (mavi düğme) tıklayın:

   
5. Arama kutusuna button yazın.
   
6. Düğme'yi hikaye tahtasına sürükleyip sol üst köşeye bırakın.
   
7. Xcode araç çubuğundaki yardımcı düzenleyici düğmesini tıklayın .
8. Ctrl tuşunu basılı tutarken düğmeyi sürükleyip ViewController sınıf tanımının alt kısmına bırakın.
   
9. İletişim kutusunda İşlem bağlantısını seçin, buttonPressed işlev adını girin ve Bağlan'ı tıklayın.
   

   Bu işlem, ViewController sınıf tanımının sonuna aşağıdaki işlevi ekler:

   @IBAction func buttonPressed(sender: AnyObject) {
   }
   

   İşlev, düğmeye her basıldığında yürütülür.

10. buttonPressed işlevine, ButtonPressed etkinliğini gün katmanına göndermek için aşağıdaki kodu ekleyin:

    @IBAction func buttonPressed(sender: AnyObject) {
      dataLayer.push(["event": "ButtonPressed", "eventAction": "Test Event"])
    }
    

8. Uygulamanızı derleyip çalıştırma

Xcode'da Ürün > Çalıştır'ı tıklayın. Xcode, uygulamayı oluşturur ve çalıştırır: