iOS için Google Etiket Yöneticisi

Geliştirici olarak, uygulama ikililerini yeniden oluşturup uygulama pazarlarına göndermeniz gerekmeden mobil uygulamalarınızda ölçüm etiketlerini ve piksellerini uygulamak ve yönetmek için Google Etiket Yöneticisi'ni kullanabilirsiniz. Firebase için Google Analytics SDK'sı ile çalışan geliştiriciler, uygulamayı gönderdikten sonra bile uygulamaya Etiket Yöneticisi'ni kolayca ekleyerek uygulamayı yönetebilir ve uygulamada değişiklik yapabilir.

Geliştiriciler önemli etkinlikleri kaydedebilir ve daha sonra hangi etiketlerin veya piksellerin tetiklenmesi gerektiğine karar verebilir.

Ön koşullar

• Firebase konsolunda uygulamanızı Firebase projenize ekleyin.
• Firebase projenizde Google Analytics'i etkinleştirme ve Firebase için Google Analytics SDK'sını uygulamanıza ekleme dahil olmak üzere uygulamanız için Google Analytics'i ayarlayın.
• Etiket Yöneticisi hesabı oluşturun.
• Bir Etiket Yöneticisi kapsayıcısı yapılandırın.

Aşağıdaki bölümlerde, iOS uygulamanızda Google Etiket Yöneticisi'ni yapılandırma ve kullanma adımları açıklanmaktadır.

1. Projenize Etiket Yöneticisi'ni ekleme

1. Etiket Yöneticisi paketini ekleyin:

   CocoaPods

   Etiket Yöneticisi'ni CocoaPods aracılığıyla eklemek için:

   1. Terminalde aşağıdaki komutu çalıştırın:

      $ sudo gem install cocoapods
      

   2. Proje dizininize gidin.

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

      $ pod init
      

   4. Podfile alanına aşağıdakileri ekleyin:

      pod 'GoogleTagManager', '~> 6.0'
      

   5. Etiket Yöneticisi bağımlılıklarını projenize indirmek ve yüklemek için aşağıdaki komutu çalıştırın:

      $ pod install
      

   Swift Package Manager

   Swift Package Manager aracılığıyla Etiket Yöneticisi'ni eklemek için:

   1. CocoaPods tabanlı bir projeden geçiş yapıyorsanız pod deintegrate komutunu çalıştırarak CocoaPods'u Xcode projenizden kaldırın. CocoaPods tarafından oluşturulan .xcworkspace dosyası daha sonra güvenli bir şekilde silinebilir. Firebase'i bir projeye ilk kez ekliyorsanız bu adımı yoksayabilirsiniz.
   2. Xcode 12'de, File > Tag Manager Packages > Add Package Dependency… (Dosya > Etiket Yöneticisi Paketleri > Paket Bağımlısı Ekle…) seçeneğine giderek Etiket Yöneticisi kitaplığını yükleyin.

   3. Görüntülenen istemde Etiket Yöneticisi GitHub deposunu girin:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      

   4. Kullanmak istediğiniz Etiket Yöneticisi sürümünü seçin. Yeni projeler için Etiket Yöneticisi'nin en son sürümünü kullanmanızı öneririz.

   5. Projenizin Derleme Ayarları bölümündeki Diğer Bağlayıcı İşaretleri'ne -ObjC ekleyin.

2. Etiket Yöneticisi hesabınızda iOS kapsayıcısı yoksa oluşturun:

   1. Etiket Yöneticisi hesabınızda oturum açın.
   2. Hesaplar sekmesinde iOS kapsayıcınızı seçin.
   3. Üst gezinme çubuğunda Yönetici'yi tıklayın.
   4. CONTAINER (KAPSAYICI) sütununda, kapsayıcı oluşturmak için "+" simgesini tıklayın.
   5. Bir kapsayıcı adı girin.
   6. iOS kapsayıcısını seçin.
   7. Oluştur'u tıklayın.

3. Kapsayıcınızı indirin:

   1. Etiket Yöneticisi hesabınızda oturum açın.
   2. Hesaplar sekmesinde iOS kapsayıcınızı seçin.
   3. Üst gezinme çubuğunda Sürümler'i tıklayın.
   4. İndirmek istediğiniz kapsayıcı sürümünü seçin.

   5. İndir'i tıklayın.

      Not: İndirilen dosyanın adı, .json uzantılı kapsayıcı kimliğidir.

4. İndirilen kapsayıcıyı projenize ekleyin:

   1. İndirilen dosyayı, XCode proje kökünde (genellikle PROJECT_ROOT/container/GTM-XXXXXX.json) container adlı bir klasöre kopyalayın.
   2. Xcode'u açın.
   3. Dosya menüsünden Dosya ekle... seçeneğini belirleyin.
   4. container klasörünü seçin.
   5. Seçenekler'i tıklayın ve Klasör referansları oluştur'un seçili olduğundan emin olun.
   6. Son'u tıklayın.

2. Etkinlikleri ve değişkenleri günlüğe kaydetme

Etiket Yöneticisi, Google Etiket Yöneticisi'nde yapılandırdığınız etiketleri tetiklemek ve oluşturmak için Firebase için Google Analytics SDK'sı tarafından kaydedilen etkinlikleri, parametreleri ve kullanıcı özelliklerini kullanır.

Etkinlikleri günlüğe kaydetme ve kullanıcı özelliklerini ayarlama ile ilgili talimatlar için Firebase geliştirici belgelerini inceleyin.

Etiket Yöneticisi'nde değişkenleri yapılandırma

Google Etiket Yöneticisi'nde kullanılmak üzere etkinlik parametrelerinin ve kullanıcı özelliklerinin değerini yakalamak için Etiket Yöneticisi arayüzünde değişkenleri yapılandırabilirsiniz.

Örneğin, uygulamanızda aşağıdaki özel etkinliği günlüğe kaydedebilirsiniz:

Analytics.logEvent("share_image", parameters: [
  "image_name": name,
  "full_text": text
])

Ardından, image_name ve full_text parameter değerlerini yakalamak için Etiket Yöneticisi'nde yeni etkinlik parametresi değişkenlerini aşağıdaki gibi yapılandırabilirsiniz:

• Değişken Adı: Resim Adı
• Değişken Türü: Etkinlik Parametresi
• Etkinlik Parametresi Anahtar Adı: image_name

ve:

• Değişken Adı: Tam Metin
• Değişken Türü: Etkinlik Parametresi
• Etkinlik Parametresi Anahtar Adı: full_text

Benzer şekilde, uygulamanızda aşağıdaki kullanıcı özelliğini ayarlayabilirsiniz:

Analytics.setUserProperty(food, forName: "favorite_food")

Ardından, favorite_food değerini yakalamak için Google Etiket Yöneticisi'nde yeni bir Firebase kullanıcı özelliği değişkeni yapılandırabilirsiniz:

• Değişken Adı: En Sevilen Yemek
• Değişken Türü: Firebase Kullanıcı Özelliği
• Etkinlik Parametresi Anahtar Adı: favorite_food

Etkinlikleri değiştirme ve engelleme

Etiket Yöneticisi, etkinliklerin Firebase için Google Analytics SDK'sı tarafından kaydedilmeden önce değiştirilmesine ve engellenmesine olanak tanır. Etkinlikleri değiştirme, etkinlik parametrelerinin değerlerini eklemenize, kaldırmanıza veya değiştirmenize ya da uygulama güncellemeleri olmadan etkinlik adlarını ayarlamanıza yardımcı olabilir. Engellenmeyen etkinlikler, Firebase için Google Analytics SDK'sı tarafından günlüğe kaydedilir.

Firebase için Google Analytics SDK'sı, bazı etkinlikleri ve kullanıcı özelliklerini de otomatik olarak günlüğe kaydeder. Herhangi bir kod eklemenize gerek kalmadan Etiket Yöneticisi'nde otomatik olarak toplanan etkinlikleri ve özellikleri kullanabilirsiniz. Ancak bunları engelleyemezsiniz.

3. Etkinlik gönderme

Tetikleyicileri ayarlamak için Firebase etkinlik adı değişkenleri, Firebase etkinlik parametresi değişkenleri ve diğer değişkenler kullanılır. Firebase etkinliği kaydettiğinizde tetikleme koşulları değerlendirilir. Firebase için Google Analytics etkinlikleri varsayılan olarak otomatik olarak tetiklenir. Etkinliklerin Google Analytics'e gönderilmesini engellemek için Etiket Yöneticisi'ne bir Firebase için Google Analytics etiketi ekleyebilirsiniz.

4. Kapsayıcınızı önizleme, hata ayıklama ve yayınlama

Kapsayıcınızın bir sürümünü yayınlamadan önce, amaçlandığı gibi çalıştığından emin olmak için önizlemeniz gerekir. Etiket Yöneticisi, Etiket Yöneticisi web arayüzünde bağlantılar ve QR kodları oluşturarak ve bunları uygulamanızı açmak için kullanarak kapsayıcınızın sürümlerini önizlemenize olanak tanır.

Kapsayıcıyı önizleme

Bir kapsayıcıyı önizlemek için Etiket Yöneticisi web arayüzünde bir önizleme URL'si oluşturun:

1. Etiket Yöneticisi hesabınızda oturum açın.
2. Bir mobil kapsayıcı seçin.
3. Üst gezinme çubuğunda Sürümler'i tıklayın.
4. Önizlemek istediğiniz kapsayıcı sürümünde İşlemler > Önizleme'yi tıklayın.
5. Uygulamanızın paket adını girin.

6. Önizlemeyi başlatma bağlantısı oluştur'u tıklayın.

   

   Şekil 1: Etiket Yöneticisi web arayüzünden önizleme URL'si alma.

   Bu önizleme URL'sini sonraki adımlar için kaydedin.

Kapsayıcı önizlemelerini etkinleştirmek için projenizin özellik listesinde Etiket Yöneticisi önizleme URL şemasını tanımlamanız gerekir. Uygulamanızın özellik listesi dosyasındaki URL türleri bölümünde aşağıdaki URL tanımlayıcısını ve URL şemasını kaydedin:

URL identifier: _your.package.name_
URL scheme: tagmanager.c._your.package.name_

Şekil 2: Etiket Yöneticisi önizleme URL şemasını uygulamanızın özellik listesi dosyasına ekleyin.

Not: your.package.name, önizleme URL'sini oluşturmak için kullanılan uygulamanın adıyla eşleşmelidir (Şekil 1'e bakın).

Uygulamanızı durdurun ve uygulamanızdaki taslak kapsayıcıyı önizlemek için önizleme URL'sini bir emülatörde veya fiziksel cihazda açın.

Kapsayıcıda hata ayıklama

Uygulamanızı simülatörde veya önizleme modunda çalıştırdığınızda Etiket Yöneticisi, günlüğü otomatik olarak ayrıntılı hale getirir.

Kapsayıcıyı yayınlama

Kapsayıcınızı önizleyip çalıştığını doğruladıktan sonra yayınlayabilirsiniz. Kapsayıcınızı yayınladıktan sonra etiket yapılandırmalarınız mobil uygulama kullanıcıları tarafından kullanılabilir.

Not: Mobil kapsayıcılarda, kapsayıcı ilk kez indirilene kadar ilk etiket yapılandırmalarını ayarlamak için varsayılan bir kapsayıcı kullanılır. Uygulama internete bağlandıktan ve bir kapsayıcı indirdikten sonra bir daha asla varsayılan kapsayıcıyı kullanmaz. Uygulamalar, kapsayıcı güncellemelerini düzenli olarak kontrol eder. Bu kontrol genellikle 12 saatte bir yapılır.

İlgili kaynaklar

Gelişmiş yapılandırma başlıklı makaleyi okuyun.