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 bir iOS uygulamasının nasıl oluşturulacağı ve uygulanacağı açıklanmaktadır.

1. Yeni proje oluşturma

  1. Xcode'u açın. yeni proje oluştur
  2. Create a new Xcode project'i (Yeni bir Xcode projesi oluştur) tıklayın.
  3. Single View Application'ı (Tek Görünüm Uygulaması) seçin. tek görünümlü uygulama seç
  4. İleri'yi tıklayın.
  5. Projenize bir ad verin ve proje için ek seçenekler belirleyin. Projenizin adı ve uygulama adı, ürün adıyla aynı olur.
    Ü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ılıklarını yükleme

  1. Xcode'dan çıkın.
  2. Bir terminalde aşağıdaki komutu çalıştırarak Cocoapods'u yükleyin: 
    $ sudo gem install cocoapods
  3. Proje dizininize geçin.
  4. Podfile adında bir dosya oluşturmak için aşağıdaki komutu çalıştırın: 
    $ pod init
  5. Podfile ürününde use_frameworks! nesnesinin yorumunu 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. Projenize Google Etiket Yöneticisi (GTM) bağımlılıklarını 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. Artık GtmSwiftTutorial uygulamasını geliştirmek için bu çalışma alanını kullanabilirsiniz.

3. Objective-C kitaplıkları için köprü başlığı ekleyin

Köprü üst bilgisi dosyası oluşturmak için:

  1. Xcode'u açın.
  2. Dosya > Yeni > Dosya'yı tıklayın.
  3. iOS > Kaynak altında 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ü başlık dosyası oluştur
  6. Oluştur'u tıklayın.
  7. Aşağıdaki import ifadelerini başlık dosyasına 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ü başlığı 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'ı seçin ve köprü araması yapın.
    Arama köprüleme
  4. Objective-C Köprüleme Başlığı içeren satırın sağ sütununa BridgingHeader.h girin.
    BridgingHeader.h&#39;yi Objective-C Bridging Header olarak ekleyin

4. Projenize varsayılan kapsayıcı ekleyin

Projenize varsayılan container eklemeden önce bir mobil kapsayıcı ikili dosyası 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 (ör. GTM-PT3L9Z).

Projenize varsayılan container ikili programı eklemek için:

  1. Xcode'u açın.
  2. Dock'ta (Yuva) Finder (Bulucu) simgesini tıklayın.
  3. Downoloads klasörünü tıklayın.
  4. Kapsayıcı ikili dosyayı Downloads klasörüne sürükleyip 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ın süresini uzattıktan sonra Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier' hatası alırsınız. Aşağıdaki adım bu hatayı düzeltecektir.

  3. Aşağıdaki işlevi AppDelegate sınıf tanımının en altına ekleyin: 
    func containerAvailable(container: TAGContainer!) {
  container.refresh()
}
  4. application işlevinde, return true ifadesinin önüne 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 izle

Ekran açma etkinliğini izlemek için:

  1. İzleme kimliğini depolamak için bir değişken oluşturun.
  2. screenName adında 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. İzleme kimliğini depolamak için değişken 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. İzleme Kimliği değişken adını girmek için Adsız Değişken'i tıklayın.
  6. Değişken türü olarak Sabit değer'i seçin.
  7. İzleme kimliğini (UA-XXXXXXXX-X biçiminde, burada X bir rakamdır) değişkenin değeri olarak girin.
    Silinmek için UA-47605289-5 kullanın.
  8. Değişken Oluştur'u tıklayın.

b. screenName adında 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. 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 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 Google Etiket Yöneticisi etiketi 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 Etiketler'i tıklayın.
  4. Yeni'yi tıklayın.
  5. Başlıksız Etiket'i tıklayarak etiket adını Ekran Görüntüleme'yi girin.
  6. Google Analytics ürününü seçin.
  7. Listeden İzleme Kimliği'ni seçin.
  8. İzleme Türü olarak Uygulama Görüntüleme'yi 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.

d. Ekran izleme kodu ekleyin

  1. ViewController.swift dosyasını Xcode'da aç.
  2. ViewController sınıfının içinde 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ı şu şekildedir:

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. Etkinliği izle düğmesine basıldı

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

  1. eventAction adlı bir veri katmanı değişkeni oluşturun.
  2. Etkinlik adlı bir özel etkinlik değişkeni oluşturun.
  3. Düğmeye Basıldı başlıklı bir GTM etiketi oluşturun.
  4. Düğmeye basıldığını izlemek için bir düğme oluşturun ve 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 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 eventAction değerini girin.
  8. Varsayılan Değeri Ayarla'yı tıklayın.
  9. unknown event (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. Etkinlik değişken adını girmek için Adsız Değişken'i tıklayın.
  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. Sol 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ı.
  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. Düğmeye basıldığını izlemek için bir düğme oluşturun ve 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ğunun en sağındaki düğmeyi tıklayın. Resimli taslak ve yardımcı alan
  4. Hizmet alanının en altında,
    nesne kitaplığını açmak için mavi düğme

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

    Nesne kitaplığı pop-up penceresi
  5. Arama kutusuna button yazın.
    nesne kitaplığındaki düğme
  6. Düğme'yi film şeridine sürükleyip sol üst köşeye bırakın.
    Düğmeyi film şeridine sürükleyip bırakın
  7. Xcode araç çubuğunda Assistant Editor düğmesini Asistan düzenleyicisi düğmesi tıklayın.
  8. Ctrl tuşunu basılı tutarken düğmeyi sürükleyip ViewController sınıf tanımının en altına bırakın.
    Düğmeyi ViewController sınıf tanımına sürükleyip bırakın
  9. İletişim kutusunda Action (İşlem) bağlantısını seçin, button Pressed (düğmeye basıldı) işlev adını girin ve Bağlan'ı tıklayın.
    Düğmeye basılan etkinliği işlemek için kod oluşturun

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

    @IBAction func buttonPressed(sender: AnyObject) {
}

    Düğmeye her basıldığında işlev yürütülür.

  10. buttonPressed işlevinde, ButtonPressed etkinliğini gün katmanına aktarmak 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 Product > Run'ı (Ürün > Çalıştır) tıklayın. Xcode, uygulamayı derler ve çalıştırır:

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