REST Resource: firstAndThirdPartyAudiences

Kaynak: FirstAndÜçüncüPartyKitle

Hedefleme için kullanılan birinci veya üçüncü taraf kitle listesini açıklar. Birinci taraf kitleler, müşteri verileri kullanılarak oluşturulur. Üçüncü taraf kitleler, Üçüncü Taraf veri sağlayıcıları tarafından sağlanır ve yalnızca müşterilere lisanslanabilir.

JSON gösterimi 
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
Alanlar
name

string

Yalnızca çıkış. Birinci ve üçüncü taraf kitlenin kaynak adı.
firstAndThirdPartyAudienceId

string (int64 format)

Yalnızca çıkış. Birinci ve üçüncü taraf kitlenin benzersiz kimliği. Sistem tarafından atanır.
displayName

string

Birinci ve üçüncü taraf kitlenin görünen adı.
description

string

Kitle için kullanıcı tarafından sağlanan açıklama.

Yalnızca birinci taraf kitleler için geçerlidir.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

Kitlenin birinci veya üçüncü taraf bir kitle olup olmadığı.
audienceType

enum (AudienceType)

Kitlenin türü.
audienceSource

enum (AudienceSource)

Yalnızca çıkış. Kitlenin kaynağı.
membershipDurationDays

string (int64 format)

Bir girişin uygun etkinlikten sonra kitlede kaldığı gün cinsinden süre. Kitlenin son kullanma tarihi yoksa bu alanın değerini 10.000 olarak ayarlayın. Aksi takdirde, ayarlanan değer 0'dan büyük ve en fazla 540 olmalıdır.

Yalnızca birinci taraf kitleler için geçerlidir.

Aşağıdaki audienceType öğelerinden biri kullanılırsa bu alan gereklidir:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

Yalnızca çıkış. Görüntülü Reklam Ağı için tahmini kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca GET isteğinde döndürülür.
activeDisplayAudienceSize

string (int64 format)

Yalnızca çıkış. Görüntülü Reklam Ağı için geçen ayki tahmini kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca GET isteğinde döndürülür.
youtubeAudienceSize

string (int64 format)

Yalnızca çıkış. YouTube ağı için tahmini kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca birinci taraf kitleler için geçerlidir.

Yalnızca GET isteğinde döndürülür.
gmailAudienceSize

string (int64 format)

Yalnızca çıkış. Gmail ağı için tahmini kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca birinci taraf kitleler için geçerlidir.

Yalnızca GET isteğinde döndürülür.
displayMobileAppAudienceSize

string (int64 format)

Yalnızca çıkış. Görüntülü Reklam Ağı'ndaki tahmini mobil uygulama kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca birinci taraf kitleler için geçerlidir.

Yalnızca GET isteğinde döndürülür.
displayMobileWebAudienceSize

string (int64 format)

Yalnızca çıkış. Görüntülü Reklam Ağı'ndaki tahmini mobil web kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca birinci taraf kitleler için geçerlidir.

Yalnızca GET isteğinde döndürülür.
displayDesktopAudienceSize

string (int64 format)

Yalnızca çıkış. Görüntülü Reklam Ağı'ndaki tahmini masaüstü kitle boyutu.

Boyut 1000'den küçükse sayı gizlenir ve gizlilik nedeniyle 0 döndürülür. Aksi takdirde, sayı iki anlamlı basamağa yuvarlanır.

Yalnızca birinci taraf kitleler için geçerlidir.

Yalnızca GET isteğinde döndürülür.
appId

string

appId, yüklenen mobileDeviceId'lerin türüyle eşleşiyor.

Yalnızca audienceType CUSTOMER_MATCH_DEVICE_ID için geçerlidir
members alanı. Müşteri Eşleştirme kitlesinin ilk üyeleri. members şunlardan yalnızca biri olabilir:
contactInfoList

object (ContactInfoList)

Yalnızca giriş. İlk hedef kitle üyelerini tanımlamak için kullanılan iletişim bilgileri listesi.

Yalnızca audienceType CUSTOMER_MATCH_CONTACT_INFO için geçerlidir
mobileDeviceIdList

object (MobileDeviceIdList)

Yalnızca giriş. İlk kitle üyelerini tanımlamak için kullanılan mobil cihaz kimliklerinin listesi.

Yalnızca audienceType CUSTOMER_MATCH_DEVICE_ID için geçerlidir

FirstAndThirdPartyAudienceType

Olası birinci ve üçüncü taraf kitle kaynağı türleri.

Sıralamalar
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED Tür belirtilmezse veya bilinmiyorsa varsayılan değer.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY Müşteri verileri kullanılarak oluşturulan kitle.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY Üçüncü taraf veri sağlayıcılar tarafından sağlanan kitle.

AudienceType

Olası kitle türleri.

Sıralamalar
AUDIENCE_TYPE_UNSPECIFIED Tür belirtilmezse veya bilinmiyorsa varsayılan değer.
CUSTOMER_MATCH_CONTACT_INFO Kitle, müşterileri bilinen iletişim bilgileriyle eşleştirilerek oluşturulmuştur.
CUSTOMER_MATCH_DEVICE_ID Kitle, müşterileri bilinen mobil cihaz kimlikleriyle eşleştirilerek oluşturulmuştur.
CUSTOMER_MATCH_USER_ID Kitle, müşterileri bilinen User-ID'lerle eşleştirerek oluşturulmuştur.
ACTIVITY_BASED

Kitle, kampanya etkinliğine göre oluşturuldu.
FREQUENCY_CAP

Kitle, kendilerine yayınlanan gösterimlerin sayısı hariç tutularak oluşturulmuştur.
TAG_BASED Kitle, pixel'e eklenmiş özel değişkenlere göre oluşturuldu.
YOUTUBE_USERS Kitle; videolar, YouTube reklamları veya YouTube kanalıyla geçmişteki etkileşimlere göre oluşturulmuştur.
LICENSED Üçüncü taraf kitle türünün alt türü.

AudienceSource

Olası kitle kaynakları.

Sıralamalar
AUDIENCE_SOURCE_UNSPECIFIED Kitle kaynağı belirtilmediğinde veya bilinmiyorsa varsayılan değer.
DISPLAY_VIDEO_360 Display & Video 360'ta mevcuttur.
CAMPAIGN_MANAGER Campaign Manager 360'tan alınmıştır.
AD_MANAGER Google Ad Manager'dan alınmıştır.
SEARCH_ADS_360 Kaynak: Search Ads 360.
YOUTUBE Kaynağı YouTube'dur.
ADS_DATA_HUB Kaynak: Ads Data Hub.

ContactInfoList

Müşteri Eşleştirme kitlesi üyelerini tanımlayan iletişim bilgileri listesi için sarmalayıcı iletisi.

JSON gösterimi 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
Alanlar
contactInfos[]

object (ContactInfo)

Müşteri Eşleştirme kitlesi üyelerini tanımlayan ContactInfo nesnelerinin listesi. contactInfos öğesine bölünen üyelerin boyutu 500.000'den fazla olmamalıdır.
consent

object (Consent)

Yalnızca giriş. contactInfos kuruluşundaki kullanıcılar için izin ayarı.

Bu alanın ayarlanmadan bırakılması, izinin belirtilmediği anlamına gelir.

adUserData veya adPersonalization alanları CONSENT_STATUS_DENIED olarak ayarlanırsa istek hata döndürür.

ContactInfo

Müşteri Eşleştirme kitlesi üyesini tanımlayan iletişim bilgileri

JSON gösterimi 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
Alanlar
hashedEmails[]

string

Üyenin SHA256 karma oluşturma işlemi uygulanmış e-posta listesi. Karma oluşturma işleminden önce tüm boşlukları kaldırın ve dizenin tamamının küçük harfle yazıldığından emin olun.
hashedPhoneNumbers[]

string

Üyenin SHA256 karma oluşturma işlemi uygulanmış telefon numaralarının listesi. Karma oluşturma işleminden önce, tüm telefon numaraları E.164 biçimi kullanılarak biçimlendirilmeli ve ülke arama kodu eklenmelidir.
zipCodes[]

string

Üyenin posta kodlarının listesi.

Aşağıdaki alanlarla da ayarlanmalıdır:
hashedFirstName

string

SHA256 karma oluşturma işlemi uygulanmış üye adı. Karma oluşturma işleminden önce tüm boşlukları kaldırın ve dizenin tamamının küçük harfle yazıldığından emin olun.

Aşağıdaki alanlarla da ayarlanmalıdır:
hashedLastName

string

SHA256 karma oluşturma işlemi uygulanmış üye soyadı. Karma oluşturma işleminden önce tüm boşlukları kaldırın ve dizenin tamamının küçük harfle yazıldığından emin olun.

Aşağıdaki alanlarla da ayarlanmalıdır:
countryCode

string

Üyenin ülke kodu.

Aşağıdaki alanlarla da ayarlanmalıdır:

ConsentStatus

İzin durumu.

Sıralamalar
CONSENT_STATUS_UNSPECIFIED Tür değeri belirtilmedi veya bu sürümde bilinmiyor.
CONSENT_STATUS_GRANTED İzin verildi.
CONSENT_STATUS_DENIED İzin reddedildi.

MobileDeviceIdList

Müşteri Eşleştirme kitle üyelerini tanımlayan mobil cihaz kimlikleri listesi için sarmalayıcı mesajı.

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

string

Müşteri Eşleştirme kitle üyelerini tanımlayan mobil cihaz kimliklerinin listesi. mobileDeviceId'lerin boyutu 500.000'den büyük olmamalıdır.
consent

object (Consent)

Yalnızca giriş. mobileDeviceIds kuruluşundaki kullanıcılar için izin ayarı.

Bu alanın ayarlanmadan bırakılması, izinin belirtilmediği anlamına gelir.

adUserData veya adPersonalization alanları CONSENT_STATUS_DENIED olarak ayarlanırsa istek hata döndürür.

Yöntemler

create

 FirstAndÜçüncüPartyKitle oluşturur.

editCustomerMatchMembers

 Müşteri Eşleştirme kitlesinin üye listesini günceller.

get

 Birinci ve üçüncü taraf kitle edinir.

list

 Birinci ve üçüncü taraf kitleleri listeler.

patch

 Mevcut bir FirstAndÜçüncüPartyAudience'ı günceller.