Yinelenen kitle listeleri

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Bu dokümanda, Google Analytics Data API v1'in gelişmiş bir özelliği olan yinelenen kitle listeleri açıklanmaktadır. Kitle listesi dışa aktarma özelliğiyle ilgili giriş için kitle dışa aktarma ile ilgili temel bilgiler kılavuzuna bakın.

Yinelenen kitle listeleri, kitle üyelikleri değiştikçe en güncel verilerle çalıştığınızdan emin olmak için her gün kitle listeleri oluşturur.

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

Her gün yeni bir kitle listesi oluşturma

Bir günlük kitle verilerinin işlenmesi ve üyeliğin güncellenmesi değişken bir süre alır. Kitle listesi verilerinin 24 saat içinde güncelleneceğinden emin olamazsınız.

Örneğin, her gün aynı saatte kitle listesi isteseniz bile bazı günlerde kitle listesi önceki günküyle aynı olur. Diğer günlerde ise kitle listesi farklı olur ve üyelik değişikliklerinin bir gününü daha içerir.

Kitle listeleri, en son üyelik değişikliklerinden bir gün önceki etkinlik verilerini temel alır. Günlük üyelik güncellemeleri yapılmadan önce bir kitle listesi oluşturursanız bu liste, iki gün önceki verileri kullanır. Günlük üyelik güncellemeleri yapıldıktan sonra bir kitle listesi oluşturursanız bu listede dünkü veriler kullanılır.

Yinelenen bir kitle listesini düzenli olarak yoklama

Yinelenen kitle listeleri yalnızca ek bir günlük veri mevcut olduğunda kitle listeleri oluşturur. Bu sayede, yeni kitle listelerini ne zaman oluşturacağınıza karar verirken tahmin yürütmeniz gerekmez. Bunun yerine, ek veri olup olmadığını görmek için gün boyunca yinelenen kitle listesini düşük maliyetle anketleyebilirsiniz.

Yinelenen kitle listesi oluşturma

Yinelenen bir kitle listesi oluşturmak için bir istekteki 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ında kitle adı bulunur.
• dimensions alanındaki geçerli bir boyut listesi. Bu yöntem tarafından desteklenen boyutların listesini Kitle Dışa Aktarma Şeması belgelerinde bulabilirsiniz. Kitle listelerine yalnızca bu alanda belirtilen boyutlara ait veriler dahil edilir.

Aşağıda, yinelenen kitle listesi oluşturma isteği örneği verilmiştir:

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ı içerir (properties/1234567/recurringAudienceLists/123 gibi). Bu ad, sonraki sorgularda bu yinelenen kitle listesinin yapılandırma meta verilerini almak için kullanılabilir. Ayrıca yapılandırma meta verileri, bu yinelenen kitle listesi için oluşturulan kitle listesi örneklerine ait kaynak adlarını içerir.

{
  "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 listesi ile 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 örnekleri için kaynak adlarını içerir.

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

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

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

{
  "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 için tüm yinelenen kitle listelerini listelemek üzere recurringAudienceLists.list değerini kullanabilirsiniz.

Yeni kitle listeleriyle ilgili asenkron bildirimler almak için Webhook'ları kullanma

recurringAudienceLists.get yöntemini kullanarak belirli bir yinelenen kitle listesi hakkındaki yapılandırma meta verilerini düzenli olarak yoklamak yerine, bir kitle listesi kullanıma sunulduğunda asynkron olarak Webhook bildirimleri 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şleminde kullanıcıları alma

Bir Kitle Dışa Aktarma'daki 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.

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

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

{
  "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
}