REST Resource: firstAndThirdPartyAudiences

Kaynak: FirstAndThirdPartyAudience

Hedefleme için kullanılan birinci veya üçüncü taraf kitle listesini açıklar. Birinci taraf kitleleri, müşteri verilerinin kullanımıyla oluşturulur. Üçüncü taraf kitleleri, üçü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

Kitlenin kullanıcı tarafından sağlanan açıklaması.

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

enum (FirstAndThirdPartyAudienceType)

Kitlenin birinci taraf mı yoksa üçüncü taraf kitle mi olduğu.
audienceType

enum (AudienceType)

Kitlenin türü.
audienceSource

enum (AudienceSource)

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

string (int64 format)

Bir girişin, uygunluk koşullarını karşılayan etkinlikten sonra kitlede kalacağı süre (gün cinsinden). Ayarlanan değer 0'dan büyük ve 540'a eşit veya daha küçük olmalıdır.

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

Aşağıdaki audienceType öğelerinden biri kullanılıyorsa bu alan zorunludur:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

Boyut 1.000'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ış. Geçen ay Görüntülü Reklam Ağı'ndaki tahmini kitle boyutu.

Boyut 1.000'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ğının tahmini kitle boyutu.

Boyut 1.000'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 1.000'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 1.000'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 1.000'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 1.000'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 mobileDeviceIds türüyle eşleşiyor.

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

object (ContactInfoList)

Yalnızca giriş. İlk kitle üyelerini tanımlamak için kullanılan iletişim bilgilerinin 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

Birinci ve üçüncü taraf kitle kaynağının olası türleri.

Sıralamalar
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_UNSPECIFIED Tür belirtilmediğinde veya bilinmediğinde varsayılan değer.
FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY Müşteri verilerinin kullanımıyla 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 belirtilmediğinde veya bilinmediğinde varsayılan değer.
CUSTOMER_MATCH_CONTACT_INFO Kitle, müşterilerin bilinen iletişim bilgileriyle eşleştirilmesiyle oluşturulmuştur.
CUSTOMER_MATCH_DEVICE_ID Kitle, müşterilerin bilinen mobil cihaz kimlikleriyle eşleştirilmesiyle oluşturuldu.
CUSTOMER_MATCH_USER_ID Kitle, müşteriler bilinen kullanıcı kimlikleriyle eşleştirilerek oluşturuldu.
ACTIVITY_BASED

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

Kitle, kullanıcılara yayınlanan gösterim sayısını hariç tutarak oluşturuldu.
TAG_BASED Kitle, piksele eklenen ö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şturuldu.
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 bilinmediğinde varsayılan değer.
DISPLAY_VIDEO_360 Display & Video 360'tan kaynaklanmıştır.
CAMPAIGN_MANAGER Campaign Manager 360'tan kaynaklanmış olmalıdır.
AD_MANAGER Google Ad Manager'dan kaynaklanmıştır.
SEARCH_ADS_360 Search Ads 360'tan kaynaklanıyor.
YOUTUBE Youtube'dan alınmıştır.
ADS_DATA_HUB Ads Data Hub'dan kaynaklanmış olmalıdır.

ContactInfoList

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

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

object (ContactInfo)

Müşteri Eşleştirme kitle üyelerini tanımlayan ContactInfo nesnelerinin listesi. contactInfos bölündükten sonraki üye sayısı 500.000'den fazla olmamalıdır.
consent

object (Consent)

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

Bu alanın ayarlanmamış bırakılması, iznin belirtilmediğini gösterir.

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

ContactInfo

Müşteri Eşleştirme kitle ü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 adreslerinin listesi. Karma oluşturmadan önce tüm boşlukları kaldırın ve dizenin tamamen küçük harflerden oluştuğundan 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çiminde biçimlendirilmeli ve ülke kodu içermelidir.
zipCodes[]

string

Üyenin posta kodlarının listesi.

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

string

Üyenin SHA256 karma oluşturma işlemi uygulanmış adı. Karma oluşturmadan önce tüm boşlukları kaldırın ve dizenin tamamen küçük harflerden oluştuğundan emin olun.

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

string

Üyenin SHA256 karma değeri oluşturulmuş soyadı. Karma oluşturmadan önce tüm boşlukları kaldırın ve dizenin tamamen küçük harflerden oluştuğundan emin olun.

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

string

Üyenin ülke kodu.

Ayrıca aşağıdaki alanlarla da ayarlanmalıdır:

ConsentStatus

İzin durumu.

Sıralamalar
CONSENT_STATUS_UNSPECIFIED Tür değeri belirtilmemiş veya bu sürümde bilinmiyor.
CONSENT_STATUS_GRANTED İzin verilir.
CONSENT_STATUS_DENIED İzin reddedilir.

MobileDeviceIdList

Müşteri Eşleştirme kitle üyelerini tanımlayan mobil cihaz kimliklerinin 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. mobileDeviceIds dizisinin boyutu 500.000'den büyük olmamalıdır.
consent

object (Consent)

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

Bu alanın ayarlanmamış bırakılması, iznin belirtilmediğini gösterir.

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

Yöntemler

create

 FirstAndThirdPartyAudience oluşturur.

editCustomerMatchMembers

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

get

 Birinci ve üçüncü taraf kitle elde eder.

list

 Birinci ve üçüncü taraf kitleleri listeler.

patch

 Mevcut bir FirstAndThirdPartyAudience öğesini günceller.