Yinelenen kitle listeleri

Bu belgede, Google Analytics Data API v1'in gelişmiş bir özelliği olan yinelenen kitle listeleri açıklanmaktadır. Kitle listesini dışa aktarma özelliğiyle ilgili temel bilgileri görmek için kitle dışa aktarmayla ilgili temel bilgiler kılavuzunu inceleyin.

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

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

Her gün yeni bir kitle listesi oluşturma

Bir günün kitle verilerinin işlenmesi ve üyeliğin güncellenmesi değişken bir zaman alır. Kitle listesi verilerinin 24 saat içinde güncellendiğinden emin olmak mümkün değildir.

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

Her gün yeni bir Kitle Listesi oluşturma

Kitle listeleri, en son üyelik değişikliklerinden bir gün öncesine ait 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 öncesine ait verileri kullanır. Günlük üyelik güncellemeleri yaptıktan sonra bir kitle listesi oluşturursanız bu kitlede düne ait veriler kullanılır.

Yinelenen bir kitle listesine düzenli olarak anket yapma

Yinelenen Kitle Listeleri, yalnızca ek bir güne ait veriler mevcut olduğunda Kitle Listeleri oluşturur. Böylece yeni Kitle Listeleri'ni ne zaman oluşturacağınıza karar vermekten kurtulursunuz. Bunun yerine, ek veri olup olmadığını görmek için Gün boyunca Yinelenen Kitle Listesi'ni uygun bir şekilde sorgulayabilirsiniz.

Yinelenen bir Kitle Listesi'ne gün içinde düzenli olarak anket yapmak

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ı, kitle adını içerir.
  • dimensions alanındaki boyutların geçerli bir listesi. Bu yöntemin desteklediği boyutların listesini Kitle Dışa Aktarma Şeması belgelerinde bulabilirsiniz. Yalnızca bu alanda belirtilen boyutların verileri Kitle Listesi'ne dahil edilir.

Yinelenen kitle listesi oluşturma isteği için örnek:

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 properties/1234567/recurringAudienceLists/123 gibi bir ad 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şturulmuş 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 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. Dosya, 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 kullanabilirsiniz.

Yeni kitle listeleri hakkında eşzamansız bildirimler almak için Webhook'ları kullanın

recurringAudienceLists.get yöntemini kullanarak belirli bir yinelenen kitle listesiyle ilgili yapılandırma meta verilerini periyodik olarak yoklamak yerine, bir kitle listesi kullanıma sunulduğ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 WebhookNotification belgelerini 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 hazırsa bir 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
}