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

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

1. Yeni proje oluştur

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

1. Xcode'dan çıkın.
2. Yükleme işlemi için bir terminalde aşağıdaki komutu çalıştırın Cocoapod'lar:

   $ 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 grubundaki yorumu kaldır use_frameworks! 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'ni (GTM) indirip yüklemek için aşağıdaki komutu çalıştırın üç önemli var:

   $ pod install

   Bu komut aynı zamanda 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ü üstbilgisi ekleyin

Köprü başlığı dosyası oluşturmak için:

1. Xcode'u açın.
2. Dosya > Yeni > Dosya.
3. iOS > Kaynak bölümünde Üstbilgi Dosyası'nı seçin.
4. İleri'yi tıklayın.
5. Başlık dosya adını BridgingHeader.h girin.
   
6. Oluştur'u tıklayın.
7. Bu 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ü üstbilgisi eklemek için:

1. Xcode'da projenizi tıklayın.
2. Düzenleyici alanında Build Settings (Derleme Ayarları) seçeneğini tıklayın.
   
3. Tümü ve Birleşik'i seçip köprü araması yapın.
   
4. Objective-C Köprü Başlığı'nı içeren satırın sağ sütununda, BridgingHeader.h girin.
   

4. Projenize varsayılan bir container ekleyin

Projenize varsayılan bir container eklemeden önce şunu indirin: mobil container ikili programı:

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

Projenize varsayılan bir container ikili programı 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 dosyayı Downloads klasörüne sürükleyip bırakın Xcode projenizin kök klasörüne kopyalayı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:

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

   Dersin süresini uzattıktan sonra şu avantajları elde edeceksiniz: Type 'AppDelegate' does not conform to protocol 'TAGContainerOpenerNotifier'. hatası. Aşağıdaki adım bu hatayı düzeltecektir.

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şlevine aşağıdaki kodu ekleyin return true ifadesinden önce:

   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. İzleme ekranı açma etkinliği

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

1. İzleme kimliğini depolayacak 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 depolayacak bir değişken oluşturun

1. Google Etiket Yöneticinizde oturum açın. hesap.
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 Adsız Değişken'i tıklayın İzleme Kimliği.
6. Değişken türü olarak Sabit değer'i seçin.
7. İzleme kimliğini girin (UA-XXXXXXXX-X biçiminde, burada X rakamdır) değişkenin değeri olarak ayarlanır.
   Silinecek olan UA-47605289-5 hesabını 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öneticinizde oturum açın. hesap.
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. Başlığı girmek için Adsız Değişken'i tıklayın Ekran Adı.
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 GTM etiketi oluşturma

1. Google Etiket Yöneticinizde oturum açın. hesap.
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üntüleme.
6. Google Analytics ürü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.

Ekran Görüntüleme GTM etiketini oluşturmayla ilgili ekran görüntüsüne bakın.

d. Ekran izleme kodu ekle

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

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

3. viewDidLoad() işlevinde, Veri katmanına OpenScreen etkinliği:

   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. Takip düğmesine basılan etkinlik

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. 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öneticinizde oturum açın. hesap.
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. Başlığı girmek için Adsız Değişken'i tıklayın Etkinlik İşlemi.
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öneticinizde oturum açın. hesap.
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öneticinizde oturum açın. hesap.
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ı.
6. Google Analytics ürü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şturup bu düğmeye basıldığını izlemek için kod ekleyin

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

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

   
5. Arama kutusuna button yazın.
   
6. Düğme'yi resimli taslağına sürükleyip en üste bırakın tıklayın.
   
7. Asistan düzenleyici düğmesini tıklayın . tıklayın.
8. Ctrl tuşunu basılı tutarken düğmeyi sürükleyip bırakın ifadesini ViewController sınıf tanımının altında bulabilirsiniz.
   
9. İletişim kutusunda İşlem bağlantısını seçin ve işlev adını girin buttonPressed ve buttonPressed'ı tıklayın.
   

   Bu komut, ViewController sınıf tanımı:

   @IBAction func buttonPressed(sender: AnyObject) {
   }

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

10. buttonPressed işlevinde, aşağıdaki kodu ButtonPressed etkinliğini gün katmanına aktarın:

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

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

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