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. Yeni proje oluşturma
  2. Yeni Xcode projesi oluştur'u tıklayın.
  3. Tek Görünüm Uygulaması'nı seçin. Tek görüntülemeli uygulamayı 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.
    Ürün adını ve diğer seçenekleri girin
  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:
    6. # 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.
    Köprü üstbilgi dosyası oluşturma
  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.
    Derleme Ayarları&#39;nı tıklayın.
  3. Tümü ve Birleşik'i seçin ve köprü için arama yapın.
    Arama köprüleme
  4. Objective-C Köprü Başlığı'nı içeren satırın sağ sütununa BridgingHeader.h yazın.
    BridgingHeader.h&#39;yi Objective-C Köprü Başlığı olarak ekleyin

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.
    5. İ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.
  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.
GTM etiketi - Ekran Görünümü

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.
GTM etiketi - Düğmeye Basıldı

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. Resimli taslak ve yardımcı alan
  4. Hizmet alanının en altında,
    Nesne kitaplığını açan mavi düğme

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

    Nesne kitaplığı pop-up penceresi
  5. Arama kutusuna button yazın.
    düğmesi
  6. Düğme'yi hikaye tahtasına sürükleyip sol üst köşeye bırakın.
    Düğmeyi taslağa sürükleyip bırakın
  7. Xcode araç çubuğundaki yardımcı düzenleyici düğmesini tıklayın Asistan düzenleyici düğmesi.
  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.
    Düğmeyi ViewController sınıf tanımına sürükleyip 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.
    Düğmeye basma etkinliğini işleyen kod oluşturma

    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:

Başlatılan uygulamanın ekran görüntüsü