- Kaynak: Kitle
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter (NumericFilter)
- İşlem
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- Yöntemler
Kaynak: Kitle
GA4 kitlesini temsil eden bir kaynak mesajı.
JSON gösterimi |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
Alanlar | |
---|---|
name |
Yalnızca çıkış. Bu Kitle kaynağının kaynak adı. Biçim: mülkleri/{propertyId}/audiences/{audienceId} |
displayName |
Zorunlu. Kitlenin görünen adı. |
description |
Zorunlu. Kitlenin açıklaması. |
membershipDurationDays |
Zorunlu. Sabit. Bir kullanıcının bir Kitlede kalması gereken süre. 540 günden uzun bir süreye ayarlanamaz. |
adsPersonalizationEnabled |
Yalnızca çıkış. Bu bir NPA Kitlesiyse ve reklam kişiselleştirmeden hariç tutulduysa GA tarafından otomatik olarak false değerine ayarlanır. |
eventTrigger |
İsteğe bağlı. Bir kullanıcı Kitleye katıldığında günlüğe kaydedilecek etkinliği belirtir. Politika ayarlanmazsa kullanıcılar Kitleye katıldığında hiçbir etkinlik günlüğe kaydedilmez. |
exclusionDurationMode |
Sabit. Hariç tutma filtresini karşılayan kullanıcılar için hariç tutma işleminin ne kadar süreceğini belirtir. Bu filtre, tüm HARİÇ TUT filtre koşullarına uygulanır ve Kitlede HARİÇ TUT filtre koşulu yoksa yoksayılır. |
filterClauses[] |
Zorunlu. Sabit. Sırasız liste. Kitleyi tanımlayan filtre ifadeleri. Tüm yan tümceler "AND" olacaktır. |
AudienceEventTrigger
Bir kullanıcı Kitleye katıldığında günlüğe kaydedilecek etkinliği belirtir.
JSON gösterimi |
---|
{
"eventName": string,
"logCondition": enum ( |
Alanlar | |
---|---|
eventName |
Zorunlu. Günlüğe kaydedilecek etkinlik adı. |
logCondition |
Zorunlu. Etkinliğin günlüğe kaydedileceği zaman. |
LogCondition
Etkinliğin ne zaman günlüğe kaydedileceğini belirler.
Sıralamalar | |
---|---|
LOG_CONDITION_UNSPECIFIED |
Günlük koşulu belirtilmedi. |
AUDIENCE_JOINED |
Etkinlik yalnızca bir kullanıcı katıldığında günlüğe kaydedilmelidir. |
AUDIENCE_MEMBERSHIP_RENEWED |
Kullanıcı Kitlenin bir üyesi olsa bile, Kitle koşulu her karşılandığında etkinlik günlüğe kaydedilmelidir. |
AudienceExclusionDurationMode
Hariç tutma filtresini karşılayan kullanıcılar için hariç tutma işleminin ne kadar süreceğini belirtir.
Sıralamalar | |
---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
Belirtilmedi. |
EXCLUDE_TEMPORARILY |
Filtre koşulunu karşıladıkları dönemlerde kullanıcıları Kitleden hariç tutun. |
EXCLUDE_PERMANENTLY |
Filtre koşulunu daha önce karşılamış olan kullanıcıları Kitleden hariç tutun. |
AudienceFilterClause
Basit veya sıra filtresini tanımlamak için kullanılan ifade. Bir filtre kapsayıcı olabilir (Örneğin, filtre koşulunu karşılayan kullanıcılar Kitleye dahil edilir) veya dışlayıcı (Örneğin, filtre koşulunu karşılayan kullanıcılar Kitleden hariç tutulur) olabilir.
JSON gösterimi |
---|
{ "clauseType": enum ( |
Alanlar | |
---|---|
clauseType |
Zorunlu. Bunun bir dahil etme veya hariç tutma filtresi ifadesi olup olmadığını belirtir. |
Birleştirme alanı
|
|
simpleFilter |
Bir kullanıcının Kitlenin üyesi olmak için karşılaması gereken basit bir filtre. |
sequenceFilter |
Kullanıcının Kitlenin üyesi olması için belirli bir sırada gerçekleşmesi gereken filtreler. |
AudienceSimpleFilter
Bir kullanıcının Kitlenin üyesi olmak için karşılaması gereken basit bir filtre tanımlar.
JSON gösterimi |
---|
{ "scope": enum ( |
Alanlar | |
---|---|
scope |
Zorunlu. Sabit. Bu filtrenin kapsamını belirtir. |
filterExpression |
Zorunlu. Sabit. Kitle boyutu, metriği veya etkinlik filtrelerinin mantıksal ifadesi. |
AudienceFilterScope
Kullanıcıların bir Kitleye katılmak için nasıl değerlendirileceğini belirtir.
Sıralamalar | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
Kapsam belirtilmemiş. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
Filtre koşulu bir etkinlikte karşılanırsa kullanıcı Kitleye katılır. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
Filtre koşulu bir oturumda karşılanırsa kullanıcı Kitleye katılır. |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
Filtre koşulu herhangi bir oturumda herhangi bir etkinlik tarafından karşılanırsa kullanıcı Kitleye katılır. |
AudienceFilterExpression
Kitle boyutu, metriği veya etkinlik filtrelerinin mantıksal ifadesi.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı expr . Bir filtreye uygulanan ifade. expr şunlardan yalnızca biri olabilir: |
|
andGroup |
AND'a dahil edilecek ifadelerin listesi. Yalnızca orGroup ile AudienceFilterExpressions içerebilir. Bu, üst düzey AudienceFilterExpression için ayarlanmalıdır. |
orGroup |
OR ile birleştirilen ifadelerin listesi. andGroup veya orGroup ile AudienceFilterExpressions içeremez. |
notExpression |
YAPILMAYACAK filtre ifadesi (Örneğin, ters çevrilmiş, tamamlanmış). Yalnızca bir boyutOrMetricFilter içerebilir. Bu, üst düzey AudienceFilterExpression üzerinde ayarlanamaz. |
dimensionOrMetricFilter |
Tek bir boyut veya metrik üzerindeki bir filtre. Bu, üst düzey AudienceFilterExpression üzerinde ayarlanamaz. |
eventFilter |
Belirli bir etkinlikle eşleşen bir filtre oluşturur. Bu, üst düzey AudienceFilterExpression üzerinde ayarlanamaz. |
AudienceFilterExpressionList
Kitle filtre ifadelerinin listesi.
JSON gösterimi |
---|
{
"filterExpressions": [
{
object ( |
Alanlar | |
---|---|
filterExpressions[] |
Kitle filtre ifadelerinin listesi. |
AudienceDimensionOrMetricFilter
Tek bir boyut veya metrik için belirli bir filtredir.
JSON gösterimi |
---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
Alanlar | |
---|---|
fieldName |
Zorunlu. Sabit. Filtrelenecek boyut adı veya metrik adı. Alan adı özel bir boyuta veya metriğe işaret ediyorsa özel boyutların veya metrik adının önüne bir kapsam öneki eklenir. Kapsam önekleri veya özel boyutlar/metrikler hakkında daha fazla bilgi için Google Analytics Data API belgelerini inceleyin. |
atAnyPointInTime |
İsteğe bağlı. Bu filtrenin dinamik değerlendirmeye ihtiyaç duyup duymadığını belirtir. Doğru değerine ayarlanırsa kullanıcılar koşulu karşıladıkları takdirde Kitle'ye katılır (statik değerlendirme). Ayarlanmazsa veya yanlış değerine ayarlanırsa bir kitle için kullanıcı değerlendirmesi dinamik olur. Kullanıcılar koşulları karşıladığında kitleye eklenir, karşılamayı bıraktıklarında kaldırılır. Bu yalnızca Kitle kapsamı ACROSS_ALL_SESSIONS olduğunda ayarlanabilir. |
inAnyNDayPeriod |
İsteğe bağlı. Ayarlanırsa verilerin gün sayısına göre değerlendirileceği zaman aralığını belirtir. Politika ayarlanmazsa kitle verileri, yaşam boyu verilerle (ör. sonsuz zaman aralığı) değerlendirilir. Örneğin, 1 gün olarak ayarlanırsa yalnızca geçerli günün verileri değerlendirilir. Referans noktası, atAnyPointInTime'ın ayarlanmadığı veya yanlış değerine ayarlandığı geçerli gündür. Yalnızca Kitle kapsamı ACROSS_ALL_SESSIONS olduğunda ve 60 günden fazla olamazsa ayarlanabilir. |
Birleştirme alanı one_filter . Yukarıdaki filtrelerden biri. one_filter şunlardan yalnızca biri olabilir: |
|
stringFilter |
Belirli bir kalıpla eşleşen dize türü boyut için bir filtre. |
inListFilter |
Belirli bir seçenek listesiyle eşleşen dize boyutu için bir filtre. |
numericFilter |
Boyut veya metrikteki sayısal değerler ya da tarih değerleri için bir filtre. |
betweenFilter |
Bir boyut veya metrikteki belirli değerler arasındaki sayısal değerler ya da tarih değerleri için filtre. |
StringFilter
Belirli bir kalıpla eşleşen dize türü boyut için bir filtre.
JSON gösterimi |
---|
{
"matchType": enum ( |
Alanlar | |
---|---|
matchType |
Zorunlu. Dize filtresinin eşleme türü. |
value |
Zorunlu. Eşleştirilecek dize değeri. |
caseSensitive |
İsteğe bağlı. Değer true ise eşleşme büyük/küçük harfe duyarlıdır. Yanlış değerine ayarlanırsa eşleşme büyük/küçük harfe duyarlı değildir. |
MatchType
Dize filtresinin eşleme türü.
Sıralamalar | |
---|---|
MATCH_TYPE_UNSPECIFIED |
Belirtilmedi |
EXACT |
Dize değerinin tam eşleşmesi. |
BEGINS_WITH |
Dize değeriyle başlar. |
ENDS_WITH |
Dize değeriyle biter. |
CONTAINS |
Dize değerini içerir. |
FULL_REGEXP |
Tam normal ifade, dize değeriyle eşleşiyor. |
InListFilter
Belirli bir seçenek listesiyle eşleşen dize boyutu için bir filtre.
JSON gösterimi |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Alanlar | |
---|---|
values[] |
Zorunlu. Eşleştirilecek olası dize değerlerinin listesi. Boş olmamalıdır. |
caseSensitive |
İsteğe bağlı. Değer true ise eşleşme büyük/küçük harfe duyarlıdır. Yanlış değerine ayarlanırsa eşleşme büyük/küçük harfe duyarlı değildir. |
NumericFilter
Boyut veya metrikteki sayısal değerler ya da tarih değerleri için bir filtre.
JSON gösterimi |
---|
{ "operation": enum ( |
Alanlar | |
---|---|
operation |
Zorunlu. Sayısal filtreye uygulanan işlem. |
value |
Zorunlu. Eşleştirilecek sayısal değer veya tarih değeri. |
İşlem
Sayısal filtreye uygulanan işlem.
Sıralamalar | |
---|---|
OPERATION_UNSPECIFIED |
Belirtilmedi. |
EQUAL |
Eşittir. |
LESS_THAN |
Küçüktür. |
GREATER_THAN |
Büyüktür. |
NumericValue
Bir sayıyı temsil eder.
JSON gösterimi |
---|
{ // Union field |
Alanlar | |
---|---|
Birleştirme alanı one_value . Sayısal değerlerden biri. one_value şunlardan yalnızca biri olabilir: |
|
int64Value |
Tam sayı değeri. |
doubleValue |
Çift değer. |
BetweenFilter
Bir boyut veya metrikteki belirli değerler arasındaki sayısal değerler ya da tarih değerleri için filtre.
JSON gösterimi |
---|
{ "fromValue": { object ( |
Alanlar | |
---|---|
fromValue |
Zorunlu. Bu sayıyla başlar (bu sayı dahil). |
toValue |
Zorunlu. Bu sayıyla biter (bu sayı da dahil). |
AudienceEventFilter
Tek bir etkinlik adındaki etkinliklerle eşleşen bir filtre. Bir etkinlik parametresi belirtilirse yalnızca hem tek etkinlik adı hem de parametre filtre ifadeleriyle eşleşen etkinliklerin alt kümesi bu etkinlik filtresiyle eşleşir.
JSON gösterimi |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
Alanlar | |
---|---|
eventName |
Zorunlu. Sabit. Eşleştirilecek etkinliğin adı. |
eventParameterFilterExpression |
İsteğe bağlı. Belirtilirse bu filtre, hem tek etkinlik adı hem de parametre filtre ifadeleriyle eşleşen etkinlikleri eşleştirir. Parametre filtre ifadesinin içindeki AudienceEventFilter ayarlanamaz (Örneğin, iç içe yerleştirilmiş etkinlik filtreleri desteklenmez). Bu, tek bir boyutOrMetricFilter veya notExpression grubu olmalıdır; VEYA'ların VE'leri desteklenmez. Ayrıca, "eventCount" için bir filtre içeriyorsa yalnızca bu filtreler dikkate alınır, diğer tüm filtreler yoksayılır. |
AudienceSequenceFilter
Kullanıcının Kitlenin üyesi olması için belirli bir sırada gerçekleşmesi gereken filtreleri tanımlar.
JSON gösterimi |
---|
{ "scope": enum ( |
Alanlar | |
---|---|
scope |
Zorunlu. Sabit. Bu filtrenin kapsamını belirtir. |
sequenceMaximumDuration |
İsteğe bağlı. Tüm adım sırasının gerçekleşmesi gereken dönemi tanımlar. " |
sequenceSteps[] |
Zorunlu. Sıralı adım sayısı. Kullanıcının sıra filtresine katılabilmesi için her adımı tamamlaması gerekir. |
AudienceSequenceStep
Bu kullanıcının adım sırası ile eşleşmesi için belirtilen adım sırasında gerçekleşmesi gereken koşul.
JSON gösterimi |
---|
{ "scope": enum ( |
Alanlar | |
---|---|
scope |
Zorunlu. Sabit. Bu adımın kapsamını belirtir. |
immediatelyFollows |
İsteğe bağlı. Doğruysa, bu adımı karşılayan etkinlik, son adımı karşılayan etkinlikten sonra gelen bir sonraki etkinlik olmalıdır. Ayarlanmadan bırakılır veya Yanlış değerine ayarlanırsa bu adım dolaylı olarak önceki adımı izler; örneğin, önceki adım ile bu adım arasında etkinlikler olabilir. İlk adım için yoksayılır. |
constraintDuration |
İsteğe bağlı. Ayarlandığında bu adım, önceki adımın ISRCDuration (Örneğin, t[i] - t[i-1] <= restrictedDuration) dahilinde olmalıdır. Ayarlanmazsa süre gereksinimi yoktur (süre fiilen sınırsızdır). İlk adım için yoksayılır. " |
filterExpression |
Zorunlu. Sabit. Her bir adımdaki kitle boyutu, metriği veya etkinlik filtrelerinin mantıksal ifadesi. |
AudienceClauseType
Bunun bir dahil etme veya hariç tutma filtresi ifadesi olup olmadığını belirtir.
Sıralamalar | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
Belirtilmemiş ifade türü. |
INCLUDE |
Filtre koşulu karşılanırsa kullanıcılar Kitleye dahil edilir. |
EXCLUDE |
Filtre koşulu karşılanırsa kullanıcılar Kitleden hariç tutulur. |
Yöntemler |
|
---|---|
|
Bir mülkteki Kitleyi arşivler. |
|
Kitle oluşturur. |
|
Tek bir Kitleyi arayın. |
|
Bir mülkteki Kitleleri listeler. |
|
Bir mülkteki Kitleyi günceller. |