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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of mutually exclusive fields.
}
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ıdır. Birinci taraf ve iş ortağı kitlesinin görünen adı.
description

string

İsteğe bağlıdır. Kullanıcı tarafından sağlanan kitle 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ştirilemez. Kitlenin türü.
audienceSource

enum (AudienceSource)

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

string (int64 format)

İsteğe bağlıdır. 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 en fazla 540 olmalıdır.

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

Aşağıdaki audienceType öğelerden 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çtiğimiz 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ğı 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.
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ıdır. appId, yüklenen mobileDeviceIds türüyle eşleşiyor.

Yalnızca audienceType CUSTOMER_MATCH_DEVICE_ID için geçerlidir.
Müşteri Eşleştirme kitlesinin ilk üyeleri. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
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.
Birbirini dışlayan alanların sonu.

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ıdır. 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ış olması, 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

İsteğe bağlıdır. Üyenin SHA256 karma oluşturma işlemi uygulanmış e-posta adreslerinin listesi. Karma oluşturmadan önce tüm beyaz boşlukları kaldırın ve dizenin tamamen küçük harflerden oluştuğundan emin olun.
hashedPhoneNumbers[]

string

İsteğe bağlıdır. Ü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ıdır. Üyenin posta kodlarının listesi.

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

string

İsteğe bağlıdır. Üyenin SHA256 karma değeri oluşturulmuş adı. Karma oluşturmadan önce tüm beyaz boşlukları kaldırın ve dizenin tamamen küçük harflerden oluştuğundan emin olun.

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

string

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

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

string

İsteğe bağlıdır. Üyenin ülke kodu.

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 kimlikleri listesi için sarmalayıcı mesaj.

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

string

İsteğe bağlıdır. 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ış olması, iznin belirtilmediğini gösterir.

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

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ştirilmesi yoluyla 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şte kurulan etkileşimlere göre oluşturulmuştur.
THIRD_PARTY Kitle, üçüncü bir 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çeriklerinin kitlesi.
AGENCY Bir ajans tarafından sağlanan kitle.

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ış olmalıdır.
CAMPAIGN_MANAGER Campaign Manager 360'tan kaynaklanmıştır.
AD_MANAGER Google Ad Manager'dan kaynaklanmış olmalıdı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.

Yöntemler

create

 FirstPartyAndPartnerAudience oluşturur.

editCustomerMatchMembers

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

get

 Birinci taraf veya iş ortağı kitlesi alır.

list

 Birinci taraf ve iş ortağı kitlelerini listeler.

patch

 Mevcut bir FirstPartyAndPartnerAudience öğesini günceller.