Gelişmiş Kullanım Alanları

Bu belgede, Analytics 360'ta Google Analytics'e ait Data API v1. API ile ilgili ayrıntılı referans için API Referansı'nı inceleyin.

Özel tanımları listeleme ve rapor oluşturma

Data API, kayıtlı Özel Boyutlar ve Özel Metrikler. Metadata API Yöntem, API'yi listelemek için kullanılabilir Mülkünüzün kayıtlı Özel Tanımlarının adları. Bu API adları runReport yöntemini örnek olarak verebiliriz.

Aşağıdaki bölümlerde, her bir Özel Tanım türüne ilişkin örnekler gösterilmektedir. İçinde Bu örneklerde GA_PROPERTY_ID yerine Mülk kimliğinizi yazın.

Etkinlik kapsamlı özel boyutlar

1. Adım: Metadata API Yöntemini sorgulayın Mülk Kimliğinizle girin.

GET https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/metadata

2. Adım: İlgilendiğiniz Etkinlik Kapsamlı Özel Boyutu bulun ve yanıttan raporlar oluşturmaktır. Boyut mevcut değilse boyutu kaydedin.

"dimensions": [
...
    {
      "apiName": "customEvent:achievement_id",
      "uiName": "Achievement ID",
      "description": "An event scoped custom dimension for your Analytics property."
    },
...
],

3. Adım: Özel boyutu bir rapor isteğine ekleyin. Aşağıdakiler runReport yöntemine örnek bir istektir.

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [{ "startDate": "2020-09-01", "endDate": "2020-09-15" }],
  "dimensions": [{ "name": "customEvent:achievement_id" }],
  "metrics": [{ "name": "eventCount" }]
}

Kullanıcı kapsamlı özel boyutlar

1. Adım: Metadata API Yöntemini sorgulayın Mülk Kimliğinizle girin.

GET https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/metadata

2. Adım: İlgilendiğiniz kullanıcı kapsamlı özel boyutu bulun ve yanıttan raporlar oluşturmaktır. Boyut mevcut değilse boyutu kaydedin.

"dimensions": [
...
    {
      "apiName": "customUser:last_level",
      "uiName": "Last level",
      "description": "A user property for your Analytics property."
    },
...
],

3. Adım: Özel boyutu bir rapor isteğine ekleyin. Aşağıdakiler runReport yöntemine örnek bir istektir.

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "entity": { "propertyId": "GA_PROPERTY_ID" },
  "dateRanges": [{ "startDate": "7daysAgo", "endDate": "yesterday" }],
  "dimensions": [{ "name": "customUser:last_level" }],
  "metrics": [{ "name": "activeUsers" }]
}

Etkinlik kapsamlı özel metrikler

1. Adım: Metadata API Yöntemini sorgulayın Mülk Kimliğinizle girin.

GET https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/metadata

2. Adım: İlgilendiğiniz Etkinlik Kapsamlı Özel Metriği bulun ve yanıttan raporlar oluşturmaktır. Metrik yoksa şunları yapmanız gerekir: metriği kaydedin.

"metrics": [
...
    {
      "apiName": "customEvent:credits_spent",
      "uiName": "Credits Spent",
      "description": "An event scoped custom metric for your Analytics property.",
      "type": "TYPE_STANDARD"
    },
...
],

3. Adım: Özel metriği bir rapor isteğine ekleyin. Aşağıdakiler runReport yöntemine örnek bir istektir.

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [{ "startDate": "30daysAgo", "endDate": "yesterday" }],
  "dimensions": [{ "name": "eventName" }],
  "metrics": [{ "name": "customEvent:credits_spent" }]
}

Tek bir önemli etkinliğin önemli etkinlik oranı metrikleri

1. Adım: Metadata API'yi sorgulayın yöntemi ekleyin.

GET https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/metadata

2. adım: İlgilendiğiniz bir önemli etkinliğin önemli etkinlik oranı metriğini bulun daha fazla bilgi edineceksiniz. Önemli etkinlik mevcut değilse gereken anahtarı bakın.

"metrics": [
...
    {
      "apiName": "sessionKeyEventRate:add_to_cart",
      "uiName": "Session key event rate for add_to_cart",
      "description": "The percentage of sessions in which a specific key event was triggered",
    },
...
],

3. Adım: Önemli etkinlik oranı metriğini bir rapor isteğine ekleyin. Aşağıdakiler runReport için örnek bir istektir yöntemidir.

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [{ "startDate": "30daysAgo", "endDate": "yesterday" }],
  "dimensions": [{ "name": "eventName" }],
  "metrics": [{ "name": "sessionKeyEventRate:add_to_cart" }]
}

Etkinlik kapsamlı özel metrik ortalamaları

1. Adım: Metadata API Yöntemini sorgulayın Mülk Kimliğinizle girin.

GET https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/metadata

2. Adım: İlgilendiğiniz Etkinlik Kapsamlı Özel Metrik Ortalamasını bulun ve yanıttan raporlar oluşturmaktır. Metrik yoksa şunları yapmanız gerekir: metriği kaydedin.

"metrics": [
...
    {
      "apiName": "averageCustomEvent:credits_spent",
      "uiName": "Average Credits Spent",
      "description": "The average of an event scoped custom metric for your Analytics property.",
      "type": "TYPE_STANDARD"
    },
...
],

3. Adım: Özel metrik ortalamasını bir rapor isteğine ekleyin. Aşağıdakiler runReport yöntemine örnek bir istektir.

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [{ "startDate": "2020-11-01", "endDate": "2020-11-10" }],
  "dimensions": [{ "name": "eventName" }],
  "metrics": [{ "name": "averageCustomEvent:credits_spent" }]
}

Kohort raporu örnekleri

Grup raporları, grup için bir zaman serisi kullanıcıları elde tutma işlemi oluşturur. Örneğin, daha ayrıntılı dokümanlarına göz atabilirsiniz. Daha fazla bilgi için REST referansını CohortSpec değeri.

Grup raporu oluşturma

Aşağıda, şu özelliklere sahip örnek bir grup raporu verilmiştir:

  • Grupta firstSessionDate 2020-12-01 değerine sahip kullanıcılar var; bu cohorts nesnesi tarafından yapılandırıldı. Rapordaki boyutlar ve metrikler yanıt yalnızca grubun kullanıcılarını temel alır.
  • Grup raporunda üç sütun gösterilir: bu yapılandırma, ve metrik nesnelerini kapsar.
    • cohort boyutu, grubun adıdır.
    • cohortNthDay boyutu, 2020-12-01 tarihinden bu yana geçen gün sayısıdır.
    • cohortActiveUsers metriği hâlâ etkin olan kullanıcıların sayısıdır.
  • cohortsRange nesnesi, raporun etkinlik verileri içermesi gerektiğini belirtir bu grup için 2020-12-01 ile başlayıp 2020-12-06 itibarıyla sona erecek.
    • DAILY ayrıntı düzeyi kullanıldığında, cohortNthDay boyutu önerilir.

Grup için rapor isteği:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dimensions": [{ "name": "cohort" }, { "name": "cohortNthDay" }],
  "metrics": [{ "name": "cohortActiveUsers" }],
  "cohortSpec": {
    "cohorts": [
      {
        "dimension": "firstSessionDate",
        "dateRange": { "startDate": "2020-12-01", "endDate": "2020-12-01" }
      }
    ],
    "cohortsRange": {
      "endOffset": 5,
      "granularity": "DAILY"
    }
  },
}

Bu istek için örnek bir rapor yanıtı:

{
  "dimensionHeaders": [
    { "name": "cohort" }, { "name": "cohortNthDay" }
  ],
  "metricHeaders": [
    { "name": "cohortActiveUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0000" }],
      "metricValues": [{ "value": "293" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0001" }],
      "metricValues": [{ "value": "143" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0002" }],
      "metricValues": [{ "value": "123" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0003" }],
      "metricValues": [{ "value": "92" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0005" }],
      "metricValues": [{ "value": "86" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0004" }],
      "metricValues": [{ "value": "83" }]
    }
  ],
  "metadata": {},
  "rowCount": 6
}

Bu rapor yanıtından bu Grup raporuna ait bir grafik aşağıdaki gibidir. Analiz Bu rapora göre bu grup için etkin kullanıcı sayısındaki en büyük düşüş ilk ve ikinci gün arasında değişir.

Kohort kullanıcılarının zaman içinde görselleştirilmesi

Birden çok kohort ve kullanıcıyı elde tutma oranı

Kullanıcı edinme ve elde tutma, Web Sitenizi veya Uygulamanızı büyütmenin yollarıdır. Kohort kullanıcı elde tutma oranına odaklanır. Bu örnekte, raporda bu mülk gösteriliyor , kullanıcıları 4 günlük elde tutma oranını iki hafta içinde% 10 artırdı.

Bu raporu oluşturmak için üç kohort belirtiyoruz: ilki firstSessionDate/2020-11-02, ikincisi firstSessionDate ile 2020-11-09 ve üçüncüsü firstSessionDate ile 2020-11-16. Çünkü bu üç gün için farklıysa mülkünüzdeki kullanıcı sayısı grubun kullanıcıyı elde tutma oranı metriğine göre Doğrudan bağlantıları kullanmak yerine cohortActiveUsers/cohortTotalUsers cohortActiveUsers metriği.

Bu gruplar için rapor isteği:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dimensions": [{ "name": "cohort" },{ "name": "cohortNthDay" }],
  "metrics": [
    {
      "name": "cohortRetentionFraction",
      "expression": "cohortActiveUsers/cohortTotalUsers"
    }
  ],
  "cohortSpec": {
    "cohorts": [
      {
        "dimension": "firstSessionDate",
        "dateRange": { "startDate": "2020-11-02", "endDate": "2020-11-02" }
      },
      {
        "dimension": "firstSessionDate",
        "dateRange": { "startDate": "2020-11-09", "endDate": "2020-11-09" }
      },
      {
        "dimension": "firstSessionDate",
        "dateRange": { "startDate": "2020-11-16", "endDate": "2020-11-16" }
      }
    ],
    "cohortsRange": {
      "endOffset": 4,
      "granularity": "DAILY"
    }
  },
}

Bu istek için örnek bir rapor yanıtı:

{
  "dimensionHeaders": [{ "name": "cohort" },{ "name": "cohortNthDay" }],
  "metricHeaders": [{
      "name": "cohortRetentionFraction",
      "type": "TYPE_FLOAT"
    }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0000" }],
      "metricValues": [{ "value": "1" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_1" },{ "value": "0000" }],
      "metricValues": [{ "value": "1" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_2" },{ "value": "0000" }],
      "metricValues": [{ "value": "1" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_2" },{ "value": "0001" }],
      "metricValues": [{ "value": "0.308" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_1" },{ "value": "0001" }],
      "metricValues": [{ "value": "0.272" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_2" },{ "value": "0002" }],
      "metricValues": [{ "value": "0.257" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0001" }],
      "metricValues": [{ "value": "0.248" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_2" },{ "value": "0003" }],
      "metricValues": [{ "value": "0.235" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_2" },{ "value": "0004" }],
      "metricValues": [{ "value": "0.211" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_1" },{ "value": "0002" }],
      "metricValues": [{ "value": "0.198" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0002" }],
      "metricValues": [{ "value": "0.172" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_1" },{ "value": "0003" }],
      "metricValues": [{ "value": "0.167" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_1" },{ "value": "0004" }],
      "metricValues": [{ "value": "0.155" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0003" }],
      "metricValues": [{ "value": "0.141" }]
    },
    {
      "dimensionValues": [{ "value": "cohort_0" },{ "value": "0004" }],
      "metricValues": [{ "value": "0.118" }]
    }
  ],
  "metadata": {},
  "rowCount": 15
}

Bu rapor yanıtından bu Grup raporuna ait bir grafik aşağıdaki gibidir. Analiz bu rapordan, 4 günlük kullanıcıları elde tutma oranının süreceğini söyleyebilirler. firstSessionDate/2020-11-16 olan sonraki grup firstSessionDate ile önceki grubun elde tutma oranını aşıyor / 2020-11-02.

Birden fazla grubu elde tutma grafiği

Haftalık kohortlar ve kohortları diğer API özellikleriyle kullanma

Kullanıcı davranışlarındaki günlük değişimleri kaldırmak için haftalık kohortları kullanın. Haftada bir kohort raporlarında, aynı hafta içinde firstSessionDate sahibi olan tüm kullanıcılar kohort. Hafta Pazar günü başlar ve Cumartesi günü sona erer. Ayrıca bu raporda Bu kohort, etkinliği olan kullanıcıları Rusya'da etkinliği olan ve üzerine konuşacağız. Bu dilimleme, country boyutunu ve bir dimensionFilter karar verin.

Bu gruplar için rapor isteği:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dimensions": [
    { "name": "cohort" },
    { "name": "cohortNthWeek" },
    { "name": "country" }
  ],
  "metrics": [{ "name": "cohortActiveUsers" }],
  "dimensionFilter": {
    "filter": {
      "fieldName": "country",
      "inListFilter": {
        "values": [ "Russia", "Mexico" ]
      }
    }
  },
  "cohortSpec": {
    "cohorts": [
      {
        "dimension": "firstSessionDate",
        "dateRange": {
          "startDate": "2020-10-04",
          "endDate": "2020-10-10"
        }
      }
    ],
    "cohortsRange": {
      "endOffset": 5,
      "granularity": "WEEKLY"
    }
  },
}

Bu istek için örnek bir rapor yanıtı:

{
  "dimensionHeaders": [
    { "name": "cohort" },
    { "name": "cohortNthWeek" },
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "cohortActiveUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0000" },{ "value": "Russia" }
      ],
      "metricValues": [{ "value": "105" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0000" },{ "value": "Mexico" }
      ],
      "metricValues": [{ "value": "98" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0001" },{ "value": "Mexico" }
      ],
      "metricValues": [{ "value": "35" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0002" },{ "value": "Mexico" }
      ],
      "metricValues": [{ "value": "24" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0001" },{ "value": "Russia" }
      ],
      "metricValues": [{ "value": "23" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0004" },{ "value": "Mexico" }
      ],
      "metricValues": [{ "value": "17" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0003" },{ "value": "Mexico" }
      ],
      "metricValues": [{ "value": "15" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0005" },{ "value": "Mexico" }
      ],
      "metricValues": [{ "value": "15" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0002" },{ "value": "Russia" }
      ],
      "metricValues": [{ "value": "3" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0003" },{ "value": "Russia" }
      ],
      "metricValues": [{ "value": "1" }]
    },
    {
      "dimensionValues": [
        { "value": "cohort_0" },{ "value": "0004" },{ "value": "Russia" }
      ],
      "metricValues": [{ "value": "1" }]
    }
  ],
  "metadata": {},
  "rowCount": 11
}

Bu rapor yanıtından sonra bu Grup raporunun bir grafiği aşağıdaki gibidir. Buna dayanarak Bu mülk, Meksika'da etkinliği olan kullanıcıları elde tutma konusunda daha başarılı Rusya'da etkinliği olan kullanıcılara göre %65 daha yüksek.

Ülke karşılaştırma kohort grafiği

Karşılaştırmalar

Karşılaştırmalar, verilerinizin alt gruplarını yan yana değerlendirmenize olanak tanır. Şunları yapabilirsiniz: karşılaştırmaları tanımlamak için comparisons alanını kullanabilirsiniz. Data API'nin Karşılaştırmalar özelliği de buna benzerdir. Google Analytics ön ucundaki karşılaştırmalara.

Her API alanıyla ilgili ayrıntılı belgeler için Karşılaştırma.

Karşılaştırma oluşturun

Karşılaştırmak istediğiniz her veri kümesi için ayrı bir karşılaştırma oluşturabilirsiniz. Örneğin, uygulama ve web verilerini karşılaştırmak için her bir uygulama için Android ve iOS verileri ile web verileri için başka bir karşılaştırma.

Aşağıda, iki karşılaştırmanın tanımlandığı ve etkin kullanıcı döndüren örnek bir rapor verilmiştir ülke bazında döküm halinde görebilirsiniz.

"Uygulama trafiği" adlı ilk karşılaştırma inListFilter kullanıyor. platform boyutunu "iOS" değerleriyle eşleştir ve "Android". İkinci "Web trafiği" adlı karşılaştırma platform ile eşleştirmek için stringFilter öğesini kullanır "web" boyutunu içeren bir boyut seçin.

  POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
  {
    "comparisons": [
      {
        "name": "App traffic",
        "dimensionFilter": {
          "filter": {
            "fieldName": "platform",
            "inListFilter": {
              "values": [
                "iOS",
                "Android"
              ]
            }
          }
        }
      },
      {
        "name": "Web traffic",
        "dimensionFilter": {
          "filter": {
            "fieldName": "platform",
            "stringFilter": {
              "matchType": "EXACT",
              "value": "web"
            }
          }
        }
      }
    ],
    "dateRanges": [
      {
        "startDate": "2024-05-01",
        "endDate": "2024-05-15"
      }
    ],
    "dimensions": [
      {
        "name": "country"
      }
    ],
    "metrics": [
      {
        "name": "activeUsers"
      }
    ]
  }

Karşılaştırma özelliğini kullanan tüm istekler için comparison alanı oluşturulan rapora otomatik olarak eklenir. Bu alanda ad yer alır karşılaştırmanın geri kalanına da değineceğiz.

Aşağıda, karşılaştırmalar içeren bir yanıtın örnek snippet'i verilmiştir:

{
  "dimensionHeaders": [
    {
      "name": "comparison"
    },
    {
      "name": "country"
    }
  ],
  "metricHeaders": [
    {
      "name": "activeUsers",
      "type": "TYPE_INTEGER"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Web traffic"
        },
        {
          "value": "United States"
        }
      ],
      "metricValues": [
        {
          "value": "638572"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "Web traffic"
        },
        {
          "value": "Japan"
        }
      ],
      "metricValues": [
        {
          "value": "376578"
        }
      ]
    },
  {
      "dimensionValues": [
        {
          "value": "App traffic"
        },
        {
          "value": "United States"
        }
      ],
      "metricValues": [
        {
          "value": "79527"
        }
      ]
    },

    ...

  ],

...

}