Yinelenen kitle listeleri

Bu belgede, Google Analytics Data API v1'in ileri seviye bir özelliği olan yinelenen kitle listeleri açıklanmaktadır. Kitle listesini dışa aktarma özelliğine giriş için Kitle dışa aktarma ile ilgili temel bilgiler kılavuzunu inceleyin.

Yinelenen kitle listeleri, kitle üyelikleri değiştikçe her gün kitle listeleri oluşturur. Böylece en güncel verilerle çalışırsınız.

Normal (yinelenmeyen) kitle listeleri, liste oluşturulduğu sırada kitlede bulunan kullanıcıların statik listeleridir.

Her gün yeni bir kitle listesi oluşturma

Bir günlük kitle verilerinin işlenmesi ve üyeliklerin güncellenmesi için gereken süre değişiklik gösterir. Kitle listesi verilerinin 24 saat içinde güncelleneceğinden emin olmanın bir yolu yoktur.

Örneğin, kitle listesini her gün aynı saatte isteseniz bile bazı günlerde kitle listesi önceki günle aynı olur, diğer günlerde ise kitle listesi farklı olur ve ek bir günlük üyelik değişikliklerini içerir.

Kitle listeleri, en son üyelik değişikliklerinden bir gün önceki etkinlik verilerine dayanır. Günlük üyelik güncellemeleri gerçekleşmeden önce bir kitle listesi oluşturursanız iki gün öncesine ait veriler kullanılır. Günlük üyelik güncellemeleri yapıldıktan sonra bir kitle listesi oluşturursanız dünkü veriler kullanılır.

Yinelenen bir kitle listesini düzenli olarak sorgulama

Yinelenen kitle listeleri, yalnızca ek bir günün verileri mevcut olduğunda kitle listeleri oluşturur. Bu sayede, yeni kitle listelerinin ne zaman oluşturulacağına karar vermek için tahmin yürütmenize gerek kalmaz. Bunun yerine, gün boyunca yinelenen kitle listesini düşük maliyetle sorgulayarak ek verilerin mevcut olup olmadığını kontrol edebilirsiniz.

Yinelenen kitle listesi oluşturma

Yinelenen bir kitle listesi oluşturmak için istekte RecurringAudienceList nesnesini kullanarak recurringAudienceLists.create yöntemini çağırın. Aşağıdaki parametreler gereklidir:

• audience alanında, properties/{propertyId}/audiences/{audienceId} olarak biçimlendirilmiş geçerli bir kitle adı. Bu değeri elde etmek için Google Analytics Admin API v1'in audiences.list yöntemini kullanabilirsiniz. audiences.list yanıtının Audience.name alanı, kitle adını içerir.
• dimensions alanında geçerli bir boyut listesi. Bu yöntem tarafından desteklenen boyutların listesini Kitle Dışa Aktarma Şeması belgelerinde bulabilirsiniz. Kitle listesine yalnızca bu alanda belirtilen boyutların verileri dahil edilir.

Yinelenen kitle listesi oluşturma isteği örneğini aşağıda bulabilirsiniz:

HTTP İsteği

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

recurringAudienceLists.create yönteminin yanıtı, name alanında adı (ör. properties/1234567/recurringAudienceLists/123) içerir. Bu ad, bu yinelenen kitle listesinin yapılandırma meta verilerini almak için sonraki sorgularda kullanılabilir. Ayrıca yapılandırma meta verileri, bu yinelenen kitle listesi için oluşturulan kitle listesi örneklerinin kaynak adlarını içerir.

HTTP Yanıtı

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Anket yapılandırması meta verileri

Belirli bir yinelenen kitle listesiyle ilgili yapılandırma meta verilerini almak için recurringAudienceLists.get yöntemini kullanın. Yapılandırma meta verileri, bu yinelenen kitle listesi için oluşturulan kitle listesi örneklerinin kaynak adlarını içerir.

Aşağıda bununla ilgili bir örnek verilmiştir:

HTTP İsteği

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

Yanıt olarak bir RecurringAudienceList örneği döndürülür. Bu yinelenen kitle listesi için oluşturulan kitle listesi örneklerinin kaynak adlarını içeren yapılandırma meta verilerini içerir.

HTTP Yanıtı

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Bir mülkün tüm yinelenen kitle listelerini listelemek için recurringAudienceLists.list yöntemini kullanabilirsiniz.

Yeni kitle listeleriyle ilgili eşzamansız bildirimler almak için webhook'ları kullanma

recurringAudienceLists.get yöntemini kullanarak belirli bir yinelenen kitle listesiyle ilgili yapılandırma meta verilerini düzenli olarak sorgulamak yerine, kitle listesi kullanılabilir olduğunda webhook bildirimlerini eşzamansız olarak alabilirsiniz.

Webhook bildirimlerini yapılandırmak için yeni bir yinelenen kitle listesi oluştururken webhookNotification alanını belirtin.

Google Analytics Data API v1'de webhook'ları kullanma hakkında daha fazla bilgi için Async audience lists with webhooks kılavuzunu inceleyin.

Kitle dışa aktarma işlemindeki kullanıcıları alma

Kitle dışa aktarma işlemindeki kullanıcıları almak için audienceExports.query yöntemini çağırın ve recurringAudienceLists.get veya recurringAudienceLists.list tarafından sağlanan yapılandırma meta verilerinden alınan kitle dışa aktarma adını belirtin.

HTTP İsteği

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Kitle dışa aktarma işlemi hazırsa kitledeki kullanıcıların listesini içeren bir yanıt döndürülür:

HTTP Yanıtı

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}