REST Resource: firstPartyAndPartnerAudiences

Kaynak: FirstPartyAndPartnerAudience

Hedefleme için kullanılan birinci taraf veya iş ortağı kitle listesini açıklar. Birinci taraf kitleleri, müşteri verilerinin kullanımıyla oluşturulur. İş ortağı kitleleri, üçüncü taraf veri sağlayıcılar tarafından sağlanır ve yalnızca müşterilere lisanslanabilir.

JSON gösterimi 
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "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 taraf ve iş ortağı kitlesinin kaynak adı.
firstPartyAndPartnerAudienceId

string (int64 format)

Tanımlayıcı. Birinci taraf ve iş ortağı kitlesinin benzersiz kimliği. Sistem tarafından atanır.
displayName

string

İsteğe bağlı. Birinci taraf ve iş ortağı kitlesinin görünen adı.
description

string

İsteğe bağlı. Kitlenin kullanıcı tarafından sağlanan açıklaması.

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

enum (FirstPartyAndPartnerAudienceType)

Yalnızca çıkış. Kitlenin birinci taraf ve iş ortağı kitlesi olup olmadığı.
audienceType

enum (AudienceType)

Değişmez. Kitlenin türü.
audienceSource

enum (AudienceSource)

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

string (int64 format)

İsteğe bağlı. Girişin, uygunluk koşullarını karşılayan etkinlikten sonra kitlede kalacağı gün sayısı. Ayarlanan değer 0'dan büyük, 540'tan küçük veya 540'a eşit olmalıdır.

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

Aşağıdaki audienceType öğelerden biri kullanılıyorsa bu alan gereklidir:

  • 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

İsteğe bağlı. appId, yüklenen mobileDeviceIds türüyle eşleşiyor.

Yalnızca audienceType CUSTOMER_MATCH_DEVICE_ID için geçerlidir.
members birleşik alanı. Müşteri Eşleştirme kitlesinin ilk üyeleri. members aşağıdakilerden yalnızca 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.

FirstPartyAndPartnerAudienceType

Birinci taraf ve iş ortağı kitle kaynağının olası türleri.

Sıralamalar
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED Tür belirtilmediğinde veya bilinmediğinde varsayılan değer.
TYPE_FIRST_PARTY Müşteri verilerinin kullanımıyla oluşturulan kitle.
TYPE_PARTNER Üçü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

Kullanımdan kaldırıldı: Kitle, kampanya etkinliğine göre oluşturulmuş.
FREQUENCY_CAP

Kullanımdan kaldırıldı: 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.
THIRD_PARTY Kitle, üçüncü taraftan kullanım için lisanslanmıştır.
COMMERCE Ticari iş ortakları tarafından ücret karşılığında sağlanan kitle.
LINEAR Geleneksel TV içeriğinin kitlesi.
AGENCY Ajans tarafından sağlanan kitle.

AudienceSource

Olası kitle kaynakları.

Sıralamalar
AUDIENCE_SOURCE_UNSPECIFIED Kitle kaynağı belirtilmediğinde veya bilinmediğinde kullanılan varsayılan değer.
DISPLAY_VIDEO_360 Display & Video 360'tan kaynaklanmış olmalıdır.
CAMPAIGN_MANAGER Campaign Manager 360'tan kaynaklanmıştı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)

İsteğe bağlı. 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 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

İsteğe bağlı. Ü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

İsteğe bağlı. Ü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 alan kodu içermelidir.
zipCodes[]

string

İsteğe bağlı. Üyenin posta kodlarının listesi.

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

string

İsteğe bağlı. Ü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

İsteğe bağlı. Üyenin SHA256 karma oluşturma işlemi uygulanmış 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

İsteğe bağlı. Ü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

İsteğe bağlı. Müşteri Eşleştirme kitle üyelerini tanımlayan mobil cihaz kimliklerinin listesi. mobileDeviceIds 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

 FirstPartyAndPartnerAudience oluşturur.

editCustomerMatchMembers

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

get

 Birinci taraf veya iş ortağı kitlesi elde eder.

list

 Birinci taraf ve iş ortağı kitlelerini listeler.

patch

 Mevcut bir FirstPartyAndPartnerAudience öğesini günceller.