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

Google Analytics'teki kitleler , kullanıcılarınızı işletmeniz açısından önem taşıyan ölçütlere göre segmentlere ayırmanızı sağlar. Entegre sitenizin veya uygulamanızın kullanıcılarını, paylaşılan kitlelere göre gruplandırabilirsiniz. özellikleri hakkında daha fazla bilgi edinin.

Kullanıcıların anlık görüntüleri de dahil olmak üzere kitlelerinizi dışa aktarmak için Data API.

Kitle dışa aktarma veri beklentileri başlıklı makaleyi inceleyin. kılavuzundan yararlanabilirsiniz.

Genel Bakış

Kitle dışa aktarma oluşturmak ve sorgulamak için aşağıdaki Data API isteklerini yapın:

1. audienceExports.create numaralı telefonu arayın yöntemini kullanabilirsiniz.
2. audienceExports.query numaralı telefonu arayın yöntemi, kitledeki kullanıcıları almak için kullanılır.

Daha fazla bilgi için şu numarayı arayabilirsiniz: audienceExports.get - Belirli bir kitle dışa aktarma işlemiyle ilgili yapılandırma meta verilerini alma ve audienceExports.list - Belirli bir mülke ait tüm kitle dışa aktarmalarınızı listeleyin.

Rapor eden varlık seçin

Tüm Data API yöntemleri için Google Analytics mülkü gerekir tanımlayıcı properties/GA_PROPERTY_ID biçiminde dışa aktarabilirsiniz. Aşağıda bununla ilgili bir örnek verilmiştir:

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

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

Data API istemci kitaplıklarından birini kullanıyorsanız istek URL'sinin yolunu değiştirmesi gerekmez. Çoğu API istemcisi bir property sağlar parametresinde properties/GA_PROPERTY_ID biçiminde bir dize bekliyor. Görüntüleyin Hızlı başlangıç kılavuzunda bulabilirsiniz. kullanabilirsiniz.

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

Kitle dışa aktarma işlemi oluşturmak için şu bağlantıyı kullanarak audienceExports.create yöntemini çağırın: AudienceExport nesnesine ekleyin. Aşağıdaki parametreler gereklidir:

• audience alanında geçerli bir kitle adı alanı properties/{propertyId}/audiences/{audienceId} olarak biçimlendirilmiştir. Şunları yapabilirsiniz: her bir arama terimi 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.
• dimensions'ndaki geçerli bir boyut listesi. girin. Bu yöntemin desteklediği boyutların listesi Kitle dışa aktarma şeması belgeleri. Yalnızca Bu alanda belirtilen boyutlara ait veriler bir kitleye dahil ediliyor dışa aktar.

Aşağıda, kitle dışa aktarma oluşturmak için örnek bir istek 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 bir yanıtı, kitle dışa aktarma işleminin ismini name alanına girin (örneğin, properties/1234567/audienceExports/123). 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 işlemindeki kullanıcıları sorgulamak için name kullanılabilir.

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

Sonrasında kitle dışa aktarımının oluşturulması birkaç dakikayı bulabilir. audienceExports.create çağrısına bir tıklama URL'si eklemeniz gerekir.

Bir kitle dışa aktarma işleminin hazırlık durumunu kontrol etmek için audienceExports.get yöntemini kullanabilirsiniz.

audienceExports.create yanıtındaki kitle dışa aktarma adını kullanarak kitle dışa aktarımını belirtin.

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

HTTP İsteği

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

Bir kitle dışa aktarma işleminin hazırlık durumu state alanında döndürülür. biraz zaman alabilir. Kitle dışa aktarma işlemi tamamlandığında durumu CREATING olan değişiklikler ACTIVE olarak değiştirildi.

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

Tüm kitle dışa aktarma işlemlerinin durumunu, audienceExports.list yöntemidir.

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

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

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ı, kitle.

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
}