Universal Analytics Etiketleri

Google Analytics uygulamanızda, uygulama ikili programınızı yeniden oluşturup pazar yerlerine yeniden göndermenizi gerektirmeyen çalışma zamanı değişikliklerini etkinleştirmek için, uygulamanızda Google Etiket Yöneticisi (GTM) ile Universal Analytics'i (UA) uygulayın.

Bu kılavuzda, Universal Analytics etiketlerini ve Android için Google Etiket Yöneticisi SDK'sını kullanarak:

Ekran görüntülenme sayısı gönder

Uygulamanızda yeni bir ekran açıldığında Google Analytics'e bir ekran görünümü göndermek için:

  1. Ekran adı değişkeni oluşturma
  2. Açık ekran etkinlik tetikleyicisi oluşturma
  3. Universal Analytics ekran görüntüleme etiketi oluşturma
  4. Açık ekran etkinliğini ve ekran adını veri katmanına aktarma

1. Ekran adı değişkeni oluşturma

GTM'de ekran adı değişkeni oluşturmak için:

  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. Başlıksız Değişken'i tıklayarak değişken adı ekran adını girin.
  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 ve bilinmiyor ekran varsayılan değerini ayarlayın.
  8. Değişken Oluştur'u tıklayın.

2. Açık ekran etkinlik tetikleyicisi oluşturma

Google Etiket Yöneticisi'nde Universal Analytics ekran görüntüleme etiketini tetikleyecek bir tetikleyici oluşturmak için:

  1. Google Etiket Yöneticisi hesabınızda oturum açın.
  2. Bir mobil kapsayıcı seçin.
  3. Sol gezinme çubuğunda Tetikleyiciler'i tıklayın.
  4. Yeni'yi tıklayın.
  5. OpenScreenEvent'in tetikleyici adını girmek için Adsız Tetikleyici'yi tıklayın.
  6. Özel etkinlik'i seçin.
  7. Etkinleştirme'nin altında, aşağıdaki koşulu girin:

    Etkinlik, OpenScreen'e eşit olduğunda etkinleşecek bir tetikleyici

  8. Tetikleyici Oluştur'u tıklayın.

3. Universal Analytics ekran görüntüleme etiketi oluşturma

Açılış ekran etkinliği tarafından tetiklenen bir Universal Analytics ekran görüntüleme etiketi oluşturmak için:

  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. Ekranı Aç etiket adını girmek için Başlıksız Etiket'i tıklayın.
  6. Google Analytics ürününü seçin.
  7. İzleme kimliğini girin.
  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. Aşağıdaki alanları eklemek için arka arkaya + Alan Ekle'yi tıklayın:

    şu alanları ekleyin: uygulama adı, uygulama sürümü ve ekran adı

  12. Devam'ı tıklayın.
  13. Etkinleştirme'nin altında Özel'i tıklayın.
  14. OpenScreenEvent özel tetikleyicisini seçin.
  15. Kaydet'i tıklayın.
  16. Etiket Oluştur'u tıklayın.

4. Açık ekran etkinliğini ve ekran adını veri katmanına aktarmak için

Veri katmanına bir openScreen etkinliği ve bir screenName değeri aktarmak için uygulamanıza bir kod ekleyin. Örneğin:

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

import android.app.Activity;
import android.os.Bundle;

public class MainActivity extends Activity {

  private static final String SCREEN_NAME = "Home Screen";
  private DataLayer mDataLayer;

  @Override
  public void onCreate(Bundle savedInstanceState) {
    super.onCreate();
  }

  @Override
  public void onStart() {
    super.onStart();
    mDataLayer = TagManager.getInstance(this).getDataLayer();

    // Push an openScreen event and a screenName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    mDataLayer.push(DataLayer.mapOf("event", "openScreen", "screenName", SCREEN_NAME));
  }
}

Etkinlikleri gönder

Bir kullanıcı, uygulamanızdaki kullanıcı arayüzü kontrolleri veya içeriğiyle etkileşimde bulunduğunda Google Analytics'e etkinlik göndermek için:

  1. (İsteğe bağlı) Etkinlik değişkenleri oluşturma
  2. Etkinlik tetikleyicisi oluşturma
  3. Universal Analytics etkinlik etiketi oluşturma
  4. Etkinlik ve etkinlik değişkeni değerini veri katmanına aktarma

Aşağıdaki adımlarda, kullanıcı video oynatma başlattığında bir etkinliğin Google Analytics'e nasıl gönderileceği gösterilmektedir.

1. (İsteğe bağlı) Etkinlik değişkenleri oluşturma

Etkinlik; kategorisini, eylemi, etiketini veya değer alanlarını temsil etmek için veri katmanı değişkenlerini kullanıyorsa önce bu değişkenleri oluşturmanız gerekir. Bu örnekte video oynatma etkinlik etiketi, videonun adını almak için bir veri katmanı değişkeni kullanır.

GTM'de video adı değişkeni oluşturmak için:

  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. Video adı değişken adı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 videoName girin ve varsayılan değerini unknown video olarak ayarlayın.
  8. Değişken Oluştur'u tıklayın.

2. Etkinlik tetikleyici oluşturma

GTM'de Universal Analytics etkinlik etiketini tetikleyecek bir etkinlik tetikleyici oluşturmak için:

  1. Google Etiket Yöneticisi hesabınızda oturum açın.
  2. Bir mobil kapsayıcı seçin.
  3. Sol gezinme çubuğunda Tetikleyiciler'i tıklayın.
  4. Yeni'yi tıklayın.
  5. VideoPlayEvent tetikleyicisinin adını girmek için Adsız Tetikleyici'yi tıklayın.
  6. Özel etkinlik'i seçin.
  7. Etkinleştirme'nin altında, aşağıdaki koşulu girin:

    Etkinlik videoPlay'e eşit olduğunda etkinleşecek bir tetikleyici.

  8. Tetikleyici Oluştur'u tıklayın.

3. Universal Analytics etkinlik etiketi oluşturma

Video oynatma etkinliği tarafından tetiklenen bir Universal Analytics etkinlik etiketi oluşturmak için:

  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. Video Oynatma Etkinliği etiket adını girmek için Başlıksız Etiket'i tıklayın.
  6. Google Analytics ürününü seçin.
  7. İzleme kimliğini girin.
  8. İzleme Türü olarak Etkinlik'i seçin.
  9. Aşağıdaki etkinlik izleme parametrelerini girin:

    Şu izleme parametrelerini girin: Kategori için Video, Play for Action ve etiket için video adı

  10. Diğer ayarlar'ı tıklayın.
  11. Ayarlanacak Alanlar'ı tıklayın.
  12. Aşağıdaki alanları eklemek için arka arkaya + Alan Ekle'yi tıklayın:

    şu alanları ekleyin: uygulama adı, uygulama sürümü ve ekran adı

  13. Devam'ı tıklayın.
  14. Etkinleştirme'nin altında Özel'i tıklayın.
  15. VideoPlayEvent özel tetikleyicisini seçin.
  16. Kaydet'i tıklayın.
  17. Etiket Oluştur'u tıklayın.

4. Etkinlik ve etkinlik değişkeni değerini veri katmanına aktararak

Veri katmanına bir videoPlay etkinliği ve bir videoName değeri aktarmak için kod yazın. Örneğin:

import com.google.tagmanager.DataLayer;
import com.google.tagmanager.TagManager;

public class VideoPlayer {

  // Called when a user starts a video playback.
  public void onPlay(Video v) {
    DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

    // Push a videoPlay event and a videoName value to the data layer.
    // This call assumes the container has already been opened, otherwise events
    // pushed to the data layer will not fire tags in that container.
    dataLayer.push(DataLayer.mapOf("event", "videoPlay", "videoName", v.getName());
    play(v);
  }

  // Rest of the implementation.
  // ...
}

E-ticaret işlemlerini gönder

Kullanıcı uygulama içi bir satın alma işlemini tamamladığında, işlemi ve ilişkili öğeleri Google Analytics'e göndermek için:

  1. İşlem tetikleyicisi oluşturma
  2. Universal Analytics işlem etiketi oluşturma
  3. İşlem etkinliğini, işlemi ve öğeleri veri katmanına aktarma

Desteklenen işlem ve öğe değişkeni adlarının listesi için Desteklenen e-ticaret veri katmanı değişkenleri bölümüne bakın.

1. İşlem tetikleyicisi oluşturma

Google Etiket Yöneticisi'nde Universal Analytics işlem etiketini tetikleyecek işlem tetikleyicisi oluşturmak için:

  1. Google Etiket Yöneticisi hesabınızda oturum açın.
  2. Bir mobil kapsayıcı seçin.
  3. Sol gezinme çubuğunda Tetikleyiciler'i tıklayın.
  4. Yeni'yi tıklayın.
  5. İşlem Tamamlandı tetikleyicisinin adını girmek için Adsız Tetikleyici'yi tıklayın.
  6. Özel etkinlik'i seçin.
  7. Etkinleştirme'nin altında, aşağıdaki koşulu girin:

    Etkinlik, işleme eşit olduğunda etkinleşecek bir tetikleyici.

  8. Tetikleyici Oluştur'u tıklayın.

2. Universal Analytics işlem etiketi oluşturma

İşlem etkinliği tarafından tetiklenen bir Universal Analytics işlem etiketi oluşturmak için:

  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. İşlem Tamamlandı etiket adını girmek için Başlıksız Etiket'i tıklayın.
  6. Google Analytics ürününü seçin.
  7. İzleme kimliğini girin.
  8. İzleme Türü olarak İşlem'i seçin.
  9. Diğer ayarlar'ı tıklayın.
  10. Ayarlanacak Alanlar'ı tıklayın.
  11. Aşağıdaki alanları eklemek için arka arkaya + Alan Ekle'yi tıklayın:

    şu alanları ekleyin: uygulama adı, uygulama sürümü ve ekran adı

  12. Devam'ı tıklayın.
  13. Etkinleştirme'nin altında Özel'i tıklayın.
  14. TransactionCompleted özel tetikleyicisini seçin.
  15. Kaydet'i tıklayın.
  16. Etiket Oluştur'u tıklayın.

3. İşlem etkinliğini, işlemi ve öğeleri veri katmanına aktararak

İşlem etkinliğini, işlemi ve ilişkili öğeleri veri katmanına aktarmak için kod yazın. İşlem ve öğe verilerini veri katmanına aktarmak için desteklenen işlem ve öğe değişken adlarını kullanmanız gerekir. Örneğin:

// Called when a user completes a transaction.
public void onPurchaseCompleted(Purchase p) {

  DataLayer dataLayer = TagManager.getInstance(this).getDataLayer();

  // Put maps of item data into an array to be pushed to the data layer.
  ArrayList<Map<String, String>> purchasedItems = new ArrayList<Map<String, String>>();
  for (Item i : p.items) {
    HashMap<String, String> currentItem = new HashMap<String, String>();

    currentItem.put("name", i.getProductName());
    currentItem.put("sku", i.getProductSku());
    currentItem.put("category", i.getProductCategory());
    currentItem.put("price", i.getProductPrice());
    currentItem.put("currency", "USD");
    currentItem.put("quantity", i.getProductQty());

    purchasedItems.add(currentItem);
  }

  // This call assumes the container has already been opened, otherwise events
  // pushed to the [DataLayer] data layer will not fire tags in that container.
  dataLayer.push(DataLayer.mapOf("event", "transaction",
                                 "transactionId", p.getTransId(),
                                 "transactionTotal", p.getTotal(),
                                 "transactionAffiliation", "In-app Store",
                                 "transactionTax", p.getTax(),
                                 "transactionShipping", p.getShippingCost(),
                                 "transactionCurrency", "USD",
                                 "transactionProducts", purchasedItems));

  // Because the data layer is persistent, you should reset fields to null
  // after you are done pushing the transaction.
  dataLayer.push(DataLayer.mapOf("transactionId", null,
                                 "transactionTotal", null,
                                 "transactionAffiliation", null,
                                 "transactionTax", null,
                                 "transactionShipping", null,
                                 "transactionCurrency", null,
                                 "transactionProducts", null));
}

Universal Analytics Geliştirilmiş E-ticaret özelliklerini uygulamak üzere Android için Google Etiket Yöneticisi SDK'sını kullanma hakkında daha fazla bilgi için Geliştirilmiş E-ticaret bölümüne bakın.

Desteklenen e-ticaret veri katmanı değişkenleri

Evrensel işlem etiketleri, aşağıdaki işlem ve öğe değişkeni adlarını destekler.

İşlem değişkenleri

Değişken Adı Açıklama Tür Gerekli
transactionId Benzersiz işlem tanımlayıcı dize Evet
transactionAffiliation İş ortağı veya mağaza dize Hayır
transactionTotal İşlem toplamı dize Hayır
transactionTax İşlemin vergi tutarı dize Hayır
transactionShipping İşlemin gönderim maliyeti dize Hayır
transactionCurrency İşlemin para birimi dize Hayır
transactionProducts İşlem sırasında satın alınan öğelerin listesi içeren öğe değişkenleri dizisidir. Hayır

Öğe değişkenleri

Değişken Adı Açıklama Tür Gerekli
name Ürün adı dize Evet
sku Ürün SKU'su dize Hayır
category Ürün kategorisi dize Hayır
price Ürün fiyatı dize Hayır
currency price para birimi türü dize Hayır
quantity Öğe miktarı dize Hayır

Yönlendiren ilişkilendirmesini yükle

Aşağıdaki hizmeti ve alıcıyı AndroidManifest.xml dosyanıza kaydederseniz mevcut yükleme yönlendiren verileri, tüm Google Analytics isabetlerine veya AdWords Yeniden pazarlama pikseli isteklerine otomatik olarak dahil edilir:

<service android:name="com.google.tagmanager.InstallReferrerService" />
<receiver android:name="com.google.tagmanager.InstallReferrerReceiver" android:exported="true">
  <intent-filter>
    <action android:name="com.android.vending.INSTALL_REFERRER" />
  </intent-filter>
</receiver>