AudienceMember

Üzerinde işlem yapılacak kitle üyesi.

JSON gösterimi
{
  "destinationReferences": [
    string
  ],
  "consent": {
    object (Consent)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userData": {
    object (UserData)
  },
  "pairData": {
    object (PairData)
  },
  "mobileData": {
    object (MobileData)
  },
  "userIdData": {
    object (UserIdData)
  },
  "ppidData": {
    object (PpidData)
  },
  "compositeData": {
    object (CompositeData)
  },
  "googleUserIdData": {
    object (GoogleUserIdData)
  },
  "partnerProvidedIdData": {
    object (PartnerProvidedIdData)
  }
  // End of mutually exclusive fields.
}
Alanlar
destinationReferences[]

string

İsteğe bağlı. Kitle üyesinin hangi Destination'ye gönderileceğini tanımlar.

consent

object (Consent)

İsteğe bağlı. Kullanıcının izin ayarı.

Üzerinde işlem yapılacak tanımlayıcı verilerin türü. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt içinde en fazla bir alan ayarlanır:
userData

object (UserData)

Kullanıcıyı tanımlayan, kullanıcı tarafından sağlanan veriler.

pairData

object (PairData)

Yayıncı-Reklamveren Kimlik Eşleşmesi (PAIR) kimlikleri.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

mobileData

object (MobileData)

Kullanıcının mobil cihazlarını tanımlayan veriler.

userIdData

object (UserIdData)

Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcılarla ilgili veriler.

ppidData

object (PpidData)

Yayıncı tarafından sağlanan tanımlayıcılarla ilgili veriler.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

compositeData

object (CompositeData)

Birden fazla tanımlayıcı türünün grubu.

googleUserIdData

object (GoogleUserIdData)

Şifrelenmiş Google kullanıcı kimlikleri.

partnerProvidedIdData

object (PartnerProvidedIdData)

İş ortağı tarafından sağlanan tanımlayıcılar.

Karşılıklı olarak hariç tutulan alanların sonu.

PairData

Kitle için PAIR kimlikleri. En az bir PAIR ID gereklidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

JSON gösterimi
{
  "pairIds": [
    string
  ]
}
Alanlar
pairIds[]

string

Zorunlu. PAIR kullanıcı listesi için yayıncı anahtarı kullanılarak SHA256 ile karma oluşturulmuş ve EC değişmeli şifre ile şifrelenmiş, temiz oda tarafından sağlanan kimliği tanımlayabilecek bilgiler verileri. Tek bir AudienceMember içinde en fazla 10 pairIds sağlanabilir.

MobileData

Kitle için mobil kimlikler. En az bir mobil kimlik gereklidir.

JSON gösterimi
{
  "mobileIds": [
    string
  ]
}
Alanlar
mobileIds[]

string

Zorunlu. Mobil cihaz kimliklerinin listesi (Müşteri Eşleştirme kullanıcı listeleri için Android reklam kimliği, iOS IDFA ve temel kullanıcı listeleri için Android reklam kimliği, iOS IDFA, Xbox veya Microsoft kimliği, Amazon Fire TV kimliği, Roku kimliği, genel cihaz kimliği). Tek bir AudienceMember içinde en fazla 10 mobileIds sağlanabilir.

UserIdData

User-ID'yi içeren User-ID verileri.

JSON gösterimi
{
  "userId": string
}
Alanlar
userId

string

Zorunlu. Reklamveren tarafından tanımlanan, kullanıcıya ait benzersiz tanımlayıcı.

PpidData

PPID'leri içeren yayıncı tarafından sağlanan tanımlayıcılar verileri. En az bir ppid gereklidir.

Bu özellik yalnızca veri iş ortakları tarafından kullanılabilir.

JSON gösterimi
{
  "ppids": [
    string
  ]
}
Alanlar
ppids[]

string

Zorunlu. Bir kullanıcı için yayıncı tarafından sağlanan tanımlayıcıların listesi.

CompositeData

Bir kullanıcıya ait tanımlayıcıları ve ilişkili verileri içeren bileşik veriler. En az bir userData veya ipData zorunludur.

JSON gösterimi
{
  "userData": {
    object (UserData)
  },
  "ipData": [
    {
      object (IpData)
    }
  ]
}
Alanlar
userData

object (UserData)

İsteğe bağlı. Kullanıcıyı tanımlayan, kullanıcı tarafından sağlanan veriler.

ipData[]

object (IpData)

İsteğe bağlı. Kitle oluşturmak için kullanılan müşteri etkileşimini temsil eden IP adresi verileri.

IpData

Kullanıcının IP adresi bilgileri. Müşteri Eşleştirme eşleşme oranlarını artırmak için observeStartTime ve observeEndTime parametrelerini eklemenizi öneririz.

JSON gösterimi
{
  "ipAddress": string,
  "observeStartTime": string,
  "observeEndTime": string
}
Alanlar
ipAddress

string

Zorunlu. Müşteri etkileşimi sırasında yakalanan IP adresi. Hem IPv4 hem de IPv6 için standart dize biçimlerini kabul eder.

observeStartTime

string (Timestamp format)

İsteğe bağlı. Bir oturumda bu IP adresinden gelen, kaydedilmiş ilk etkileşimin zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

observeEndTime

string (Timestamp format)

İsteğe bağlı. Bir oturumda bu IP adresinden gelen, kaydedilmiş son etkileşim zamanı.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

GoogleUserIdData

Şifrelenmiş Google kullanıcı kimliklerini içeren Google kullanıcı kimliği verileri. En az bir Google kullanıcı kimliği gereklidir.

JSON gösterimi
{
  "googleUserIds": [
    string
  ]
}
Alanlar
googleUserIds[]

string

Zorunlu. Şifrelenmiş Google kullanıcı kimliklerinin listesi.

PartnerProvidedIdData

İş ortağı tarafından sağlanan tanımlayıcıları içeren, iş ortağı tarafından sağlanan veriler. En az bir iş ortağı tarafından sağlanan tanımlayıcı gereklidir.

JSON gösterimi
{
  "partnerProvidedIds": [
    string
  ]
}
Alanlar
partnerProvidedIds[]

string

Zorunlu. İş ortağı tarafından sağlanan tanımlayıcıların listesi.