Bu sayfa, Cloud Translation API ile çevrilmiştir.

Kitle Dışa Aktarmayla İlgili Temel Bilgiler

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

Google Analytics Data API v1'i kullanarak kitledeki kullanıcıların anlık görüntüsünü içeren Kitle Dışa Aktarma işlemleri oluşturabilirsiniz.

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

Google Analytics Data API v1, Kitle Dışa Aktarma oluşturmak için eşzamansız bir yaklaşım kullanır. Öncelikle, kullanıcılardan kitle dışa aktarımı oluşturmak için audienceExports.create yöntemine istek gönderilmelidir. Ardından, kitledeki kullanıcıları almak için audienceExports.query yöntemi kullanılır.

Ayrıca, belirli bir Kitle Dışa Aktarma ile ilgili yapılandırma meta verilerini almak için audienceExports.get ve bir mülkle ilgili tüm Kitle Dışa Aktarma işlemlerini listelemek için audienceExports.list kullanabilirsiniz.

Rapor Eden Varlık Seçin

Data API v1'in tüm yöntemlerinde, Google Analytics 4 mülk tanımlayıcısının bir URL istek yolunda properties/GA4_PROPERTY_ID biçiminde belirtilmesi gerekir. Örneğin:

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

Rapor, belirtilen Google Analytics 4 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 manuel olarak değiştirmenize gerek yoktur. Çoğu API istemcisi, properties/GA4_PROPERTY_ID biçiminde bir dize bekleyen property parametresi sağlar. İstemci kitaplıklarının kullanımına ilişkin örnekler için Hızlı başlangıç kılavuzuna bakın.

Kitle Dışa Aktarma Oluşturma İsteğinde Bulunma

Kitle Dışa Aktarma oluşturmak için bir istekte 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ındaki boyutların geçerli bir listesi. Bu yöntemin desteklediği boyutların listesini Kitle Dışa Aktarma Şeması dokümanlarında bulabilirsiniz. Yalnızca bu alanda belirtilen boyutların verileri Kitle Dışa Aktarma işlemine dahil edilir.

Örnek kitle dışa aktarma oluşturma isteği:

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 Audience Export adını (ör. properties/1234567/audienceExports/123) içerir. Bu ad, kullanıcıları Kitle Dışa Aktarma özelliğinden almak için sonraki sorgularda kullanılabilir.

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 Aktarmaya 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 Kitle Dışa Aktarma işleminin hazır olma durumunu alabilirsiniz.

Kitle Dışa Aktarma özelliğini belirtmek için audienceExports.create yanıtından aldığınız Kitle Dışa Aktarma adını (ör. properties/1234567/audienceExports/123) kullanın.

Örnek:

HTTP İsteği

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

Kitle Dışa Aktarma işleminin hazırlık durumu, yanıtın state alanında döndürülür. Kitle Dışa Aktarma oluşturma işlemi tamamlandıktan sonra CREATING olan durum ACTIVE olarak değişir.

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 elde edebilirsiniz.

Kitle Dışa Aktarma İşlemindeki Kullanıcıları Alma

audienceExports.create yöntemi kullanılarak Kitle Dışa Aktarma oluşturulduktan sonra audienceExports.query yöntemini çağırın ve Kitle Dışa Aktarma adını (properties/1234567/audienceExports/123 gibi) belirtin.

HTTP İsteği

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

Kitle Dışa Aktarma hazırsa bir 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
}

Kitle Dışa Aktarma Veri Beklentileri

Aşağıdaki bölümde, Kitle Dışa Aktarma işlemlerindeki kullanıcı üyelikleriyle ilgili veri beklentileri belirlenmektedir.

Veri Güncelliği

Kitle Dışa Aktarma verilerinin güncelliği, Google Analytics'in etkinlikleri toplamasının, etkinlikleri işlemesinin ve ardından kitlelerdeki kullanıcı üyeliğini güncellemesinin ne kadar sürdüğünü gösterir. Tüm bu işlem 24 saat sürerse Kitle Dışa Aktarma verilerinin güncelliği 24 saat olur. Daha fazla bilgi için Veri Güncelliği bölümüne bakın.

Bir kullanıcının ilk satın alma işlemini tamamladığını ve 7 saat sonra "Alıcılar" kitlesi için bir Kitle Dışa Aktarma oluşturduğunuzu varsayalım. Bu kullanıcı büyük olasılıkla henüz "Alıcılar" Kitle Dışa Aktarma bölümünde yer almayacaktır. İlk satın alma işleminden sonraki 14 ila 38 saat içinde bu kullanıcı muhtemelen yeni Kitle Dışa Aktarma işlemlerine dahil edilir.

Kitle dışa aktarma işlemleri anlık görüntülerdir

Kitle Dışa Aktarma işlemleri, belirli bir zamandaki anlık görüntüdeki bir kitledeki kullanıcıların listeleridir. Google Analytics, Google Ads yeniden pazarlama için kitlelerdeki kullanıcıları otomatik ve sürekli olarak Google Ads'e aktarır. Buna karşın, Data API v1 kullanılarak oluşturulan Kitle Dışa Aktarma işlemleri ise söz konusu kitledeki en son kullanıcıları görmek için yeni bir Kitle Dışa Aktarma işlemi oluşturmanız gerekir.

Kitle Dışa Aktarma işlemleri, mevcut en yeni kullanıcı üyeliklerine göre oluşturulur. Ancak Kitle Dışa Aktarma işlemlerinin veri güncelliği 20 saat olabilir. Bu durumda, Kitle Dışa Aktarma işlemi o andan önceki 20 saatteki tüm etkinlikleri temel alır.

En son üyelik verileri, genellikle mülkün saat dilimine göre yaz saatlerinde günde bir kez güncellenir. Diğer bir deyişle, aynı kitle için saat 09:00 ve 11:00'de yapılan Kitle Dışa Aktarma işlemi büyük olasılıkla aynı verileri döndürür, ancak 15:00'teki Kitle Dışa Aktarma işlemi, bir güne ait daha verileri dahil etmeye bağlı olarak farklı olabilir.

Kitle Dışa Aktarımlarının Son Geçerlilik Tarihi

Kitle dışa aktarma işlemlerinin süresi 72 saat sonra dolar. Yeni kullanıcılar her gün bir kitleye girip çıkabilirler. En son kullanıcıların anlık görüntüsünü almak amacıyla her gün için yeni kitle dışa aktarma işlemleri oluşturmanız gerekir.

Kitle Dışa Aktarma Kullanıcı Sınırları

Bir kitlenin veya mülkün boyutu kullanıcı sınırını aştığında, Kitle Dışa Aktarma işlevi kitlenin temsili örneklerini döndürür. Bu sınırlar mülk türünüze (ör. standart veya 360 mülkü) bağlıdır ve her bir Kitle Dışa Aktarma işleminde ayrı ayrı uygulanır. Geri gelen kullanıcılar, istenen kitledeki kullanıcılardır. Değerlendirilen kullanıcılar kitlenin üyesi olan veya olmayan kullanıcılardır.

Sınır Türü	Standart Mülk Sınırları	Analytics 360 Mülk Sınırları
Maksimum geri gelen kullanıcı sayısı	2 milyon	200 milyon
Dikkate alınan maksimum kullanıcı sayısı	10 milyon	1 milyar

Raporlama Kimliği Tutarlılığı

Raporlama kimliği, kullanıcıların raporlarda nasıl tekilleştirileceğine karar verir. Kitle dışa aktarma işlemleri, raporlama kimliği ayarına bağlı olarak DEĞİŞMEZ. Kitle dışa aktarma işlemlerinde kullanıcılar her zaman kullanıcı kimliğine ve ardından cihaz kimliğine göre tanımlanır.

Diğer bir deyişle, bir kitleyle ilgili raporlar, Kitle Dışa Aktarma işleminin döndürdüğünden daha fazla kullanıcı gösterebilir. Örneğin, raporlama kimliği "Cihaz tabanlı" ise ve kullanıcı kimliği toplanmışsa raporlar kullanıcı kimliğine göre kullanıcıları tekilleştirmez ancak kitle dışa aktarma işlemleri kullanıcı kimliğine göre tekilleştirilir.

Bir kitleyle ilgili raporlarda, Kitle Dışa Aktarma işleminin döndürdüğünden daha az kullanıcı da gösterilebilir. Örneğin, raporlama kimliği "Harman" ise raporlar Google sinyallerine göre kullanıcıları tekilleştirir ancak kitle dışa aktarma işlemleri yapmaz.

Dolgu Tutarlılığı

Google Analytics'te Kitle oluşturup Google Ads yeniden pazarlamayı etkinleştirdiğinizde Google Analytics, Google Ads'de bu kitleyi en son eklenen üyelerle doldurur. Ancak Google Analytics raporları ve Kitle Dışa Aktarma işlemleri, doldurulmuş kitle üyeliklerini İÇERMEZ. Raporların ve Kitle Dışa Aktarma işlemlerinin kullanıcıyı ilgili kitlede göstermesi için kitle oluşturulduktan sonra söz konusu kullanıcının günlüğe bir etkinlik kaydetmesi gerekir.

Örneğin, bir kullanıcı 20 Haziran'da günlüğe bir satın alma etkinliği kaydederse ve 21 Haziran'da "Alıcılar" kitlesi oluşturursanız söz konusu kullanıcıyı yeni Kitle Dışa Aktarımlarında görmek için 22 Haziran'a kadar beklemeniz gerekebilir. Ancak bu kullanıcı 21 Haziran'da günlüğe bir etkinlik kaydettiyse yalnızca kitle dışa aktarma işlemine dahil edilir.