Kitle Dışa Aktarma ile ilgili temel bilgiler

Google Analytics 4'teki kitleler, kullanıcılarınızı işletmeniz için önemli olan şekillerde segmentlere ayırmanızı sağlar. Kitleler sayesinde, sitenizin 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ılar için Audience Export (Kitle Dışa Aktarma) oluşturmak için audienceExports.create yöntemine istek gönderilmesi gerekir. 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.

Raporlama varlığı seçin

Tüm Data API v1 yöntemleri, Google Analytics 4 mülk tanımlayıcısının bir URL istek yolunda properties/GA4_PROPERTY_ID biçiminde belirtilmesini gerektirir. Ö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 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ı kullanmaya ilişkin örnekler için Hızlı başlangıç kılavuzuna bakın.

Kitle Dışa Aktarma isteği oluşturma

Kitle Dışa Aktarma oluşturmak için bir istekteki 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ı belgelerinde 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ında, name alanında Audience Export adı (properties/1234567/audienceExports/123 gibi) bulunur. 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 Aktarma hazırlık durumu durumunu sorgulama

audienceExports.create görüşmesinden 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'yı 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ığında CREATING olan durumu 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"
}

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

Kitle dışa aktarma işleminde 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 belirlenir.

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 veri güncelliği 24 saat olur. Daha fazla bilgi edinmek için Veri Güncelliği bölümüne bakın.

Örneğin, bir kullanıcı ilk satın alma işlemini tamamlar ve 7 saat sonra "Alıcılar" kitlesi için bir Kitle Dışa Aktarma oluşturursanız kullanıcı büyük olasılıkla henüz "Alıcılar" Kitle Dışa Aktarma bölümünde olmayacaktır. İlk satın alma işleminden sonraki 14 ila 38 saat içinde, söz konusu kullanıcı muhtemelen yeni kitle dışa aktarma işlemine dahil olur.

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

Kitle Dışa Aktarma, bir kitledeki kullanıcıların anlık bir anlık görüntüsüdür. Google Analytics, Google Ads yeniden pazarlama için kitlelerdeki kullanıcıları otomatik ve sürekli olarak Google Ads'e aktarır. Buna karşılık, Data API v1 kullanılarak oluşturulan Kitle Dışa Aktarma işlemleri, 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, Kitle Dışa Aktarma işleminin geçerli andan 20 saat öncesine ait tüm etkinlikleri temel alacağı anlamına gelir.

En son üyelik verileri günde bir kez, genellikle mülkün saat dilimindeki yaz saatlerinde güncellenir. Bu, aynı kitle için 09:00 ve 11:00'da yapılan Kitle Dışa Aktarma işleminin büyük olasılıkla aynı verileri döndüreceği, ancak 15:00'teki Kitle Dışa Aktarma işleminin, bir günün daha verilerini eklemeye bağlı olarak farklı olabileceği anlamına gelir.

Kitle Dışa Aktarma işlemlerinin geçerlilik süresi

Kitle dışa aktarma işlemlerinin süresi 72 saat sonra dolar. Her gün bir kitleye yeni kullanıcılar girip çıkabilirler. Kullanıcıların en son ekran görüntüsünü elde etmek 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şlemleri kitlenin temsili örneklerini döndürür. Bu sınırlar mülk türünüze (standart veya 360 mülkü) bağlıdır ve her Kitle Dışa Aktarma işleminde ayrı ayrı uygulanır. Geri gelen kullanıcılar, istenen kitledeki kullanıcılardır. Bu kullanıcılar, kitlenin üyesi olabilecek veya olmayabilecek 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
Maksimum dikkate alınan 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 göre DEĞİŞMEZ. Kitle Dışa Aktarma işlemleri, kullanıcıları her zaman kullanıcı kimliği ve ardından cihaz kimliğine göre tanımlar.

Yani 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 User ID 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.

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 aktarımları, 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 bir "Alıcılar" kitlesi oluşturursanız söz konusu kullanıcıyı yeni Kitle Dışa Aktarma işlemlerinde görebilmek 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.