Kitle dışa aktarma işlemi oluşturma

Google Analytics'teki kitleler, kullanıcılarınızı işletmeniz için önemli olan şekillerde segmentlere ayırmanıza olanak tanır. Kitleler sayesinde, sitenizin veya uygulamanızın kullanıcılarını ortak özelliklere göre gruplandırabilirsiniz.

Kullanıcıların anlık görüntüsü de dahil olmak üzere kitlelerinizi Data API'yi kullanarak dışa aktarabilirsiniz.

Kitle dışa aktarma işlemlerinde gördüğünüz verilerle ilgili önemli bilgiler için Kitle dışa aktarma verileriyle ilgili beklentiler kılavuzuna bakın.

Genel Bakış

Kitle dışa aktarma işlemi oluşturmak ve sorgulamak için aşağıdaki Data API isteklerini gönderin:

1. Kitle dışa aktarma işlemi oluşturmak için audienceExports.create yöntemini çağırın.
2. Kitledeki kullanıcıları almak için audienceExports.query yöntemi çağrılır.

Daha fazla bilgi için audienceExports.get numaralı telefonu arayarak belirli bir kitle dışa aktarma işlemiyle ilgili yapılandırma meta verilerini alabilir ve audienceExports.list numaralı telefonu arayarak belirli bir mülkle ilgili tüm kitle dışa aktarma işlemlerinizi listeleyebilirsiniz.

Raporlama birimi seçin

Tüm Data API yöntemlerinin, bir URL isteği yolunda properties/GA_PROPERTY_ID biçiminde Google Analytics mülk tanımlayıcısının belirtilmesi gerekir. Aşağıda bununla ilgili bir örnek verilmiştir:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

Rapor, belirtilen Google Analytics mülkünde toplanan Google Analytics etkinlik verilerine göre oluşturulur.

Data API istemci kitaplıklarından birini kullanıyorsanız istek URL'si yolunu değiştirmeniz gerekmez. Çoğu API istemcisi, property biçiminde bir dize bekleyen bir parametre sağlar.properties/GA_PROPERTY_ID İstemci kitaplıklarını kullanma örnekleri için Hızlı başlangıç kılavuzu'na bakın.

Kitle dışa aktarma işlemi oluşturma

Kitle dışa aktarma işlemi oluşturmak için isteğinizdeki AudienceExport nesnesini kullanarak audienceExports.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. Yalnızca bu alanda belirtilen boyutlara ait veriler bir kitle dışa aktarma işlemine dahil edilir.

Aşağıda, kitle dışa aktarma işlemi oluşturmaya yönelik örnek bir istek verilmiştir:

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

audienceExports.create yönteminin yanıtı, name alanında kitle dışa aktarma işleminin adını içerir. Örneğin, properties/1234567/audienceExports/123. Aşağıda örnek bir yanıt verilmiştir:

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

Kitle dışa aktarma işleminden kullanıcıları sorgulamak için name kullanabilirsiniz.

Kitle dışa aktarma işleminin hazırlık durumunu sorgulama

audienceExports.create çağrısından sonra kitle dışa aktarma işleminin oluşturulması birkaç dakika sürebilir.

audienceExports.get yöntemini çağırarak bir kitle dışa aktarma işleminin hazır olma durumunu kontrol edebilirsiniz.

İsteğinizde kitle dışa aktarma işlemini belirtmek için audienceExports.create yanıtındaki kitle dışa aktarma adını kullanın.

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

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

Bir kitle dışa aktarma işlemine hazırlık durumu, yanıttaki state alanında döndürülür. Kitle dışa aktarma oluşturma işlemi tamamlandıktan sonra durumu CREATING'dan ACTIVE'ye değişir.

Aşağıda örnek bir yanıt verilmiştir:

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

audienceExports.list yöntemini çağırarak tüm kitle dışa aktarma işlemlerinin durumunu elde edebilirsiniz.

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

Kitle dışa aktarma işlemi oluşturulduktan sonra audienceExports.query yöntemini çağırın ve istekte kitle dışa aktarma işleminin name değerini belirtin.

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

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

Kitle dışa aktarma işlemi hazırsa bu çağrı, kitledeki kullanıcıların listesini döndürür.

Aşağıda örnek bir yanıt verilmiştir:

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