Yinelenen kitle listeleri

Bu belgede, düzenli kullanıcılarınızın Google Analytics Data API v1'in gelişmiş özelliği. Kitle listesini dışa aktarma özelliğine giriş için Kitle dışa aktarımıyla ilgili temel bilgiler kılavuzunu inceleyin.

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

Normal (yinelenmeyen) kitle listeleri, kitledeki kullanıcıların statik listeleridir güncellendiği gibi.

Her gün yeni bir kitle listesi oluştur

Bir güne ait kitle verilerinin işlenmesi ve güncellenmesi biraz zaman alabilir. üyeliği. Kitle listesi verilerinin her 24 saatte bir.

Örneğin, bir kitle listesi için her gün aynı saatte istekte bulunsanız bile bazı günlerde kitle listesi, diğer günlerde ise kitle listesi farklı olur ve üyelik değişikliklerinin yapıldığı ek bir günü içerir.

Her gün yeni bir Kitle Listesi oluşturma

Kitle listeleri, en güncel üyelik değişiklikleri hakkında bilgi edinebilirsiniz. Günlük üyelikten önce bir kitle listesi oluşturursanız iki gün öncesine ait verileri kullanır. Bir günlük üyelik güncellemeleri yapıldıktan sonra, kitle listesini dünkü.

Yinelenen kitle listesiyle düzenli olarak anket yapma

Yinelenen kitle listeleri, yalnızca ek bir günün sonunda kitle listeleri oluşturur. verilerini kullanabilirsiniz. Böylece, yeni bir yeni öğenin ne zaman oluşturulacağına karar vermek için tahmin yürütmeniz gerekmez Kitle Listeleri. Bunun yerine, Yinelenen Kitle Listesi'ni uygun fiyata sorgulayabilirsiniz. görmek için gün boyunca işleme devam eder.

Gün boyunca düzenli olarak yinelenen bir kitle listesini yoklama

Yinelenen Kitle Listesi Oluşturma

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

  • Şurada geçerli bir kitle adı: audience alanı properties/{propertyId}/audiences/{audienceId} olarak biçimlendirilmiştir. URL parametrelerinin Google tarafından nasıl ele alınmasını istediğinizi belirtmek için audiences.list değerini almak için Google Analytics Admin API v1. İlgili içeriği oluşturmak için kullanılan Audience.name audiences.list yanıtının alanında kitle adı bulunuyor.
  • Boyutların geçerli bir listesi dimensions girin. Bu yöntemin desteklediği boyutların listesi Kitle Dışa Aktarma Şeması belgeleri. Yalnızca bu alanda belirtilen boyutlara ilişkin veriler dahil edilir kitle listesidir.

Aşağıda, yinelenen bir kitle listesi oluşturma isteği örneği 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 bir yanıtı name alanına girilen ad (örneğin, properties/1234567/recurringAudienceLists/123) ile uyumludur ve yapılandırma meta verilerini almak için sonraki sorgular kitle listesi oluşturun. Ayrıca yapılandırma meta verileri kitle listesi örnekleri için kaynak adları bu yinelenen kitle listesi için oluşturuldu.

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

Şunu kullanın: recurringAudienceLists.get belirli bir yapılandırma meta verilerini alma yöntemi yinelenen kitle listesidir. Yapılandırma meta verileri kitle listesi örnekleri için kaynak adları bu yinelenen kitle listesi için oluşturuldu.

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

HTTP İsteği

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

RecurringAudienceList örneği yanıtı döndürülür. Şunları içeren yapılandırma meta verilerini içerir: kitle listesi örnekleri için kaynak adları bu yinelenen kitle listesi için oluşturuldu.

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

Tekliflerinizi otomatikleştirmek ve optimize etmek için recurringAudienceLists.list mülkteki tüm yinelenen kitle listelerini listelemek için kullanılır.

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

Belirli bir yapılandırmayla ilgili yapılandırma meta verilerini düzenli aralıklarla yoklamak yerine yinelenen kitle listesi oluşturmak için recurringAudienceLists.get yöntemini kullanıyorsanız, bir kitle aşağıdaki işlemler gerçekleştirdiğinde eşzamansız olarak Webhook bildirimleri kullanılabilir hale gelir.

Webhook bildirimlerini yapılandırmak için webhookNotification alanını kullanın.

Async audience lists with webhooks kılavuzundaki adımları uygulayın inceleyebilirsiniz.

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

Kitle Dışa Aktarma işleminde kullanıcıları almak için audienceExports.query yöntemini kullanın ve Kitle Dışa Aktarma adını belirtin tarafından sağlanan yapılandırma meta verilerinden alındı recurringAudienceLists.get veya recurringAudienceLists.list.

HTTP İsteği

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

Kitle Dışa Aktarma hazırsa şunları içeren bir yanıt: kitledeki kullanıcılar 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
}