Geliştirici olarak, uygulama ikili değerlerini yeniden oluşturup uygulama pazarlarına yeniden göndermek zorunda kalmadan 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, uygulama gönderildikten sonra bile uygulamayı yönetmeye ve değişiklik yapmaya yardımcı olması için Etiket Yöneticisi'ni kolayca ekleyebilir.
Geliştiriciler önemli etkinlikleri günlüğe kaydedebilir ve hangi etiketlerin veya piksellerin tetiklenmesi gerektiğine daha sonra karar verebilir.
Ön koşullar
- Firebase konsolunda uygulamanızı Firebase projenize ekleyin.
- Uygulamanız için Google Analytics'i ayarlayın. Buna, Firebase projenizde Google Analytics'i etkinleştirmek ve Firebase için Google Analytics SDK'sını eklemek de dahildir.
- Bir Etiket Yöneticisi hesabı oluşturun.
- Bir Etiket Yöneticisi kapsayıcısı yapılandırın.
Aşağıdaki bölümlerde, Google Etiket Yöneticisi'ni iOS uygulamanızda yapılandırmak ve kullanmak için uygulamanız gereken adımlar açıklanmaktadır.
1. Projenize Etiket Yöneticisi'ni ekleyin
Etiket Yöneticisi paketini ekleyin:
CocoaPods
Etiket Yöneticisi'ni CocoaPods üzerinden eklemek için:
Bir terminalde aşağıdaki komutu çalıştırın:
$ sudo gem install cocoapods
Proje dizininize geçin.
Podfile
adlı bir dosya oluşturmak için aşağıdaki komutu çalıştırın:$ pod init
Podfile
alanına aşağıdakileri ekleyin:pod 'GoogleTagManager', '~> 6.0'
Etiket Yöneticisi bağımlılıklarını indirip projenize yüklemek için aşağıdaki komutu çalıştırın:
$ pod install
Swift Paket Yöneticisi
Etiket Yöneticisi'ni Swift Paket Yöneticisi üzerinden eklemek için:
- CocoaPods tabanlı bir projeden veri taşıyorsanız Xcode projenizden CocoaPods'u kaldırmak için
pod deintegrate
komutunu çalıştı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 yok sayılabilir. - Xcode 12'de Dosya > Etiket Yöneticisi Paketleri > Paket Bağımlılığı Ekle... konumuna giderek Etiket Yöneticisi kitaplığını yükleyin.
Görüntülenen istemde, Etiket Yöneticisi GitHub deposuna girin:
https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
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.
Projenizin Derleme Ayarları bölümünde Diğer Bağlayıcı İşaretleri'ne
-ObjC
ekleyin.
Etiket Yöneticisi hesabınızda yoksa bir iOS kapsayıcısı oluşturun:
- Etiket Yöneticisi hesabınızda oturum açın.
- Üst gezinme çubuğunda YÖNETİCİ'yi tıklayın.
- CONTAINER sütununda açılır menüyü tıklayın ve CONTAINER'u seçin.
- Bir kapsayıcı adı girin.
- iOS kapsayıcısını seçin.
- Firebase (iOS) SDK'sını seçin.
- OLUŞTUR'u tıklayın.
Kapsayıcınızı indirin:
- Etiket Yöneticisi hesabınızda oturum açın.
- iOS kapsayıcınızı seçin.
- Üst gezinme çubuğunda Sürümler'i tıklayın.
Seçilen kapsayıcı sürümünde İşlemler > İndir'i tıklayın.
İndirilen kapsayıcıyı projenize ekleyin:
- İndirilen dosyayı XCode proje kökündeki (genellikle
PROJECT_ROOT/container/GTM-XXXXXX.json
)container
adlı bir klasöre kopyalayın. - Xcode'u açın.
- Dosya menüsünden Dosyaları ekle... seçeneğini belirleyin.
container
klasörünü seçin.- Seçenekler'i tıklayın ve Klasör referansları oluştur'un seçili olduğundan emin olun.
- Son'u tıklayın.
- İndirilen dosyayı XCode proje kökündeki (genellikle
2. Etkinlikleri ve değişkenleri günlüğe kaydet
Etiket Yöneticisi, Google Etiket Yöneticisi'nde yapılandırdığınız etiketleri tetiklemek ve oluşturmak amacıyla Firebase için Google Analytics SDK'sı tarafından günlüğe 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 okuyun.
Etiket Yöneticisi'nde değişkenleri yapılandırma
Google Etiket Yöneticisi'nde kullanmak ü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, aşağıdaki özel etkinliği uygulamanızda 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ı: Favori Yiyecek
- Değişken Türü: Firebase Kullanıcı Mülkü
- Etkinlik Parametresi Anahtar Adı:
favorite_food
Etkinlikleri değiştirme ve engelleme
Etiket Yöneticisi, Firebase için Google Analytics SDK'sı tarafından günlüğe kaydedilmeden önce etkinlikleri değiştirmenize ve engellemenize olanak tanır. Etkinlikleri değiştirmek, etkinlik parametrelerinin değerlerini eklemenize, kaldırmanıza veya değiştirmenize ya da uygulama güncellemeleri olmadan etkinlik adlarını düzenlemenize 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. Otomatik olarak toplanan etkinlikleri ve özellikleri Etiket Yöneticisi'nde herhangi bir kod eklemenize gerek kalmadan kullanabilirsiniz. Ancak bu kişileri engelleyemezsiniz.
3. Etkinlikleri gönder
Tetikleyici ayarlamak için Firebase etkinlik adı değişkenleri, Firebase etkinlik parametresi değişkenleri ve diğer değişkenler kullanılır. Bir Firebase etkinliğini kaydettiğinizde tetikleyici koşulları değerlendirilir. Firebase için Google Analytics etkinlikleri varsayılan olarak otomatik olarak tetiklenir. Etkinliklerin Google Analytics'e gönderilmesini engellemek amacıyla 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, istenen şekilde çalıştığından emin olmak için önizlemek istersiniz. Etiket Yöneticisi, Etiket Yöneticisi web arayüzünde bağlantılar ve QR kodları oluşturup bunları uygulamanızı açmak için kullanarak kapsayıcınızın sürümlerini önizlemenizi sağlar.
Kapsayıcı önizleme
Bir kapsayıcıyı önizlemek için Etiket Yöneticisi web arayüzünde bir önizleme URL'si oluşturun:
- Etiket Yöneticisi hesabınızda oturum açın.
- Bir mobil kapsayıcı seçin.
- Üst gezinme çubuğunda Sürümler'i tıklayın.
- Önizlemek istediğiniz kapsayıcı sürümünde İşlemler > Önizleme'yi tıklayın.
- Uygulamanızın paket adını girin.
Önizlemeyi başlatma bağlantısı oluştur'u tıklayın.
Sonraki adımlar için bu önizleme URL'sini kaydedin.
Kapsayıcı önizlemelerini etkinleştirmek için projenizin mülk listesinde Etiket Yöneticisi önizleme URL'si şemasını tanımlamanız gerekir. Uygulamanızın özellik listesi dosyasının URL türleri altında, 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_
Uygulamanızı durdurun ve taslak kapsayıcıyı uygulamanızda önizlemek için bir emülatörde veya fiziksel cihazda önizleme URL'sini açın.
Kapsayıcıda hata ayıklama
Uygulamanızı bir simülatörde veya önizleme modunda çalıştırdığınızda, Etiket Yöneticisi günlük kaydını otomatik olarak ayrıntılı moda geçirir.
Kapsayıcıyı yayınlama
Kapsayıcınızı önizledikten ve ç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.
İlgili kaynaklar
Gelişmiş yapılandırma başlıklı makaleyi inceleyin.