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.

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

Kitle dışa aktarmalarında gördüğünüz verilerle ilgili önemli bilgiler için Kitle dışa aktarma verileriyle ilgili beklentiler kılavuzunu inceleyin.

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 dosyası oluşturmak için audienceExports.create metodunu çağırın.
  2. Kitledeki kullanıcıları almak için audienceExports.query yöntemi çağrılır.

Daha fazla bilgi için belirli bir kitle dışa aktarma işlemiyle ilgili yapılandırma meta verilerini almak üzere audienceExports.get çağrısı yapabilir ve belirli bir mülk için tüm kitle dışa aktarma işlemlerinizi listelemek üzere audienceExports.list çağrısı yapabilirsiniz.

Raporlama birimi seçme

Tüm Data API yöntemleri, Google Analytics mülk tanımlayıcının bir URL istek yolunda properties/GA_PROPERTY_ID biçiminde belirtilmesini gerektirir. 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, properties/GA_PROPERTY_ID biçiminde bir dize beklenen bir propertyparametresi sağlar. İstemci kitaplıklarını kullanma örnekleri için Hızlı başlangıç kılavuzuna bakın.

Kitle dışa aktarma dosyası oluşturma

Kitle dışa aktarma dosyası oluşturmak için isteğinizde 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ında kitle adı bulunur.
  • dimensions alanındaki geçerli bir boyut listesi. Bu yöntemin desteklediği boyutların listesini Kitle dışa aktarma şeması dokümanında bulabilirsiniz. Yalnızca bu alanda belirtilen boyutlara ait veriler, kitle dışa aktarma işlemine dahil edilir.

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

HTTP İsteği

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ı (ör. properties/1234567/audienceExports/123) içerir. Aşağıda örnek bir yanıt verilmiştir:

HTTP Yanıtı

{
  "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 dosyasından kullanıcıları sorgulamak için name değerini kullanabilirsiniz.

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

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ırlık 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:

HTTP İsteği

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

Bir kitlenin dışa aktarılmaya hazır olma durumu, yanıtın state alanında döndürülür. Kitle dışa aktarma işlemi tamamlandıktan sonra durumu CREATING yerine ACTIVE olur.

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

HTTP Yanıtı

{
  "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 öğrenebilirsiniz.

Bir kitle dışa aktarma dosyasından 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:

HTTP İsteği

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:

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
}