REST Resource: firstPartyAndPartnerAudiences

Kaynak: FirstPartyAndPartnerAudience

Hedefleme için kullanılan bir birinci taraf veya iş ortağı kitle listesini açıklar. Birinci taraf kitleler, müşteri verileri kullanılarak 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
}
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. 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ştirilemez. Kitlenin türü.
audienceSource

enum (AudienceSource)

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

string (int64 format)

İsteğe bağlıdır. Uygunluk etkinliğinden sonra bir girişin kitlede kalacağı gün sayısı. Ayarlanan değer 0'dan büyük ve 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 alanlarından 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ğı için tahmini kitle boyutu.

Boyut 1.000'den küçükse gizlilik nedeniyle sayı gizlenir ve 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 1.000'den küçükse gizlilik nedeniyle sayı gizlenir ve 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 gizlilik nedeniyle sayı gizlenir ve 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 gizlilik nedeniyle sayı gizlenir ve 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 gizlilik nedeniyle sayı gizlenir ve 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 gizlilik nedeniyle sayı gizlenir ve 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 gizlilik nedeniyle sayı gizlenir ve 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

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 verileri kullanılarak 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üşteriler bilinen iletişim bilgileriyle eşleştirilerek oluşturuldu.
CUSTOMER_MATCH_DEVICE_ID Kitle, müşteriler bilinen mobil cihaz kimlikleriyle eşleştirilerek oluşturuldu.
CUSTOMER_MATCH_USER_ID Kitle, müşteriler bilinen User-ID'lerle eşleştirilerek oluşturuldu.
ACTIVITY_BASED

Desteği sonlandırıldı: Kitle, kampanya etkinliğine göre oluşturuldu.
FREQUENCY_CAP

Desteği sonlandırıldı: Kitle, kullanıcılara yayınlanan gösterim sayısının hariç tutulması temel alınarak oluşturuldu.
TAG_BASED Kitle, piksele eklenen özelleştirilebilen 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ü 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çeriği için kitle.
AGENCY Bir 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 kaynaklıdır.
CAMPAIGN_MANAGER Campaign Manager 360'tan kaynaklanır.
AD_MANAGER Google Ad Manager'dan kaynaklanır.
SEARCH_ADS_360 Search Ads 360'tan kaynaklanmıştır.
YOUTUBE YouTube'dan alınmıştır.
ADS_DATA_HUB Ads Data Hub'dan alınmıştır.

Yöntemler

get

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

list

 Birinci taraf ve iş ortağı kitlelerini listeler.