iOS için Google Etiket Yöneticisi

Geliştirici olarak, uygulama ikililerini yeniden derleyip uygulama pazar yerlerine 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. Şunları yapan geliştiriciler: Firebase için Google Analytics SDK'sı ile çalışırken Etiket Yöneticisi'ni Bu uygulama, API'yi kullanmaya başladıktan sonra bile gönderildi.

Geliştiriciler önemli etkinlikleri günlüğe kaydedebilir ve daha sonra hangi etiketlerin veya piksellerin tetiklenebilir.

Ön koşullar

Aşağıdaki bölümlerde, Google'ı yapılandırma ve kullanmaya ilişkin adımlarda Etiket Yöneticisi'ni seçin.

1. Etiket Yöneticisi'ni projenize ekleme

  1. Etiket Yöneticisi paketini ekleyin:

    CocoaPods

    CocoaPods üzerinden Etiket Yöneticisi'ni eklemek için:

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

      $ sudo gem install cocoapods
      
    2. Proje dizininize geçin.

    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'ni indirip yüklemek için aşağıdaki komutu çalıştırın en iyi uygulamaları paylaştık:

      $ pod install
      

    Swift Paket Yöneticisi

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

    1. CocoaPods tabanlı bir projeden veri taşıyorsanız pod deintegrate komutunu çalıştırarak Xcode projenizden CocoaPods'u kaldırın. CocoaPods tarafından oluşturulan .xcworkspace dosya, daha sonra güvenli bir şekilde silinebilir. Örneğin Firebase'i bir projeye ilk kez eklerseniz bu adım yoksayılabilir.
    2. Xcode 12'de şu konuma giderek Etiket Yöneticisi kitaplığını yükleyin: Dosya > Etiket Yöneticisi Paketleri > Paket Bağımlısı Ekle...
    3. Görüntülenen komut istemine Etiket Yöneticisi GitHub'ı girin depo:

      https://github.com/googleanalytics/google-tag-manager-ios-sdk.git
      
    4. Kullanmak istediğiniz Etiket Yöneticisi sürümünü seçin. Yeni Etiket Yöneticisi'nin en son sürümünü kullanmanızı öneririz.

    5. -ObjC öğesini, şu öğenin Derleme Ayarları'nda Diğer Bağlayıcı İşaretleri'ne ekleyin: akılda kalıcı bir yolunu sunar.

  2. Etiket Yöneticisi hesabınızda yoksa bir iOS kapsayıcısı 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 sütununda "+" işaretini tıklayın. 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ının sürümünü seçin.
    5. İndir'i tıklayın.

  4. İndirilen container'ı projenize ekleyin:

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

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

Etiket Yöneticisi, Firebase için Analytics SDK'sının, yapılandırdığınız etiketleri tetiklemesi ve derlemesi amacıyla Google Etiket Yöneticisi.

Nasıl yapacağınıza ilişkin talimatlar için Firebase geliştirici belgelerini okuyun etkinlikleri günlüğe kaydedin ve kullanıcı özelliklerini ayarlayın.

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

Google'da kullanılacak 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ıza aşağıdaki özel etkinliği kaydedebilirsiniz:

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

Ardından, Etiket Yöneticisi'nde yeni Etkinlik Parametresi değişkenlerini image_name ve full_text parameter değerlerini yakalamak için aşağıdaki kodu uygulayın:

  • 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, Google etiketi için yeni bir Firebase Kullanıcı Mülkü değişkeni yapılandırabilirsiniz. favorite_food değerini yakalayacak yönetici:

  • Değişken Adı: Favori Yemek
  • 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, etkinlikleri Firebase için Google Analytics SDK'sı. Etkinliklerde değişiklik yapmak, yeni kullanıcı etkinlikleri uygulama güncellemeleri olmadan etkinlik parametrelerinin değerlerini değiştirin veya etkinlik adlarını ayarlayın. Engellenmeyen etkinlikler Firebase için Google Analytics tarafından günlüğe kaydedilir SDK'dır.

Firebase için Google Analytics SDK'sı ayrıca bazı etkinlikleri ve kullanıcı özellikleri. Otomatik olarak toplanan etkinlik ve mülkleri şurada kullanabilirsiniz: gerek kalmadan Etiket Yöneticisi'ni kullanabilirsiniz. Ancak bu kullanıcıları engelleyemezsiniz.

3. Etkinlik gönder

Firebase etkinlik adı değişkenleri, Firebase etkinlik parametresi değişkenleri ve diğer değişkenleri tetikleyicileri ayarlamak için kullanılır. Tetikleyici koşulları değerlendirilir her Firebase etkinliği kaydedin. Varsayılan olarak, Firebase için Google Analytics otomatik olarak tetiklenir. Firebase için Google Analytics etiketini kullanarak Google Analytics'e gönderilmesini engelleyebilirsiniz.

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, içeriği tam sürüm olarak düzgün çalıştığından emin olmalısınız. Etiket Yöneticisi, reklam öğelerinizin sürümlerini, Etiket Yöneticisi web arayüzünde bağlantılar ve QR kodları oluşturarak ve kullanarak diğer verilerinizi de izleyebilirsiniz.

Önizleme kapsayıcısı

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

  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. İşlemler > Önizlemek istediğiniz kapsayıcı sürümünde önizleme yapın.
  5. Uygulamanızın paket adını girin.
  6. Önizleme bağlantısı oluştur'u tıklayın.

    Önizleme URL'leri, Etiketin önizleme penceresinde mevcuttur
            Yönetici web arayüzü

    Şekil 1: Etiket Yöneticisi web arayüzü

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

Kapsayıcı önizlemelerini etkinleştirmek için Etiket Yöneticisi önizleme URL'si şemasını tanımlamanız gerekir. kullanabilirsiniz. Uygulamanızın URL türleri altında özellik listesi dosyasını yüklemek için 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_
Etiket yöneticisi önizleme URL'si şemasını uygulamanızın
            özellik listesi dosyasından ekleyebilirsiniz.
Şekil 2: Etiket Yöneticisi önizleme URL'si şemasını ekleme uygulamanızın özellik listesi dosyasına ekleyin.
ziyaret edin.

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

Hata ayıklama kapsayıcısı

Uygulamanızı bir simülasyon aracında veya önizleme modunda çalıştırdığınızda Etiket Yöneticisi, günlük kaydını otomatik olarak ayrıntılı hâle getirir.

Kapsayıcıyı yayınlama

Kapsayıcınızın önizlemesini yapıp ç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ının kullanımına sunulacaktır.

Gelişmiş yapılandırma bölümünü okuyun.