Yinelenen kitle listeleri

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

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

Normal (yinelenmeyen) kitle listeleri, liste oluşturulduğu sırada kitlenin kullanıcılarından oluşan statik listelerdir.

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üncellendiğinden emin olmanın bir yolu yoktur.

Örneğin, her gün aynı saatte bir kitle listesi isteğinde bulunsanız bile bazı günlerde kitle listesi önceki günle aynı olurken bazı günlerde 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 önceki etkinlik verilerine dayanır. Günlük üyelik güncellemeleri gerçekleşmeden önce bir kitle listesi oluşturursanız listede, 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 listede önceki günün verileri kullanılır.

Yinelenen bir kitle listesinde düzenli olarak anket yapma

Yinelenen kitle listeleri, yalnızca ek bir güne ait veriler mevcut olduğunda kitle listeleri oluşturur. Bu sayede, yeni kitle listeleri oluşturma zamanına karar verirken tahminde bulunmanıza gerek kalmaz. Bunun yerine, ek verilerin olup olmadığını görmek için gün boyunca yinelenen kitle listesini ucuz bir şekilde yoklayabilirsiniz.

Gün içinde yinelenen bir kitle listesini düzenli aralıklarla yoklama

Tekrarlanan 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. Bir kitle listesine yalnızca bu alanda belirtilen boyutlara ait veriler dahil edilir.

Aşağıda, yinelenen kitle listesi oluşturma isteğine dair bir örnek verilmiştir:

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 (ör. properties/1234567/recurringAudienceLists/123) 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ş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ırma 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 RecurringAudienceList örneği döndürülür. Bu, 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ülkle ilgili tüm yinelenen kitle listelerini listelemek için recurringAudienceLists.list kullanabilirsiniz.

Yeni kitle listeleri hakkında eşzamansız bildirimler almak için Web kancalarını kullanma

Belirli bir yinelenen kitle listesiyle ilgili yapılandırma meta verilerini recurringAudienceLists.get yöntemini kullanarak düzenli 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 Web kancalarını 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

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
}