REST Resource: curators.curatedPackages

Kaynak: CuratedPackage

Seçici tarafından oluşturulan ve yönetilen, özel olarak seçilmiş bir envanter paketini temsil eder.

JSON gösterimi
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Alanlar
name

string

Tanımlayıcı. Seçilmiş paketin benzersiz kaynak adı. Biçim: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Zorunlu. Seçilmiş pakete seçici tarafından atanan görünen ad. curatedPackages.list yönteminin yanıtını filtrelemek için kullanılabilir.

description

string

İsteğe bağlıdır. Seçilmiş paketin seçen kişi tarafından sağlanan açıklaması.

createTime

string (Timestamp format)

Yalnızca çıkış. Seçilmiş paketin oluşturulduğu zaman damgası. curatedPackages.list yönteminin yanıtını filtrelemek için kullanılabilir.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Yalnızca çıkış. Seçilmiş paketin en son güncellendiği zaman damgası. curatedPackages.list yönteminin yanıtını filtrelemek için kullanılabilir.

Zaman damgasında RFC 3339 kullanılır. Yani oluşturulan çıkış her zaman Z ile normalleştirilir ve 0, 3, 6 veya 9 kesirli basamak kullanılır. "Z" dışındaki zaman farkları da kabul edilir. Örnekler: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

İsteğe bağlıdır. Alıcının bu özel paketteki envanter için açık artırmalara katılmak üzere teklif vermesi gereken minimum BGBM. curatedPackages.list yönteminin yanıtını filtrelemek için kullanılabilir.

state

enum (State)

Yalnızca çıkış. Seçilmiş paketin durumu. curatedPackages.list yönteminin yanıtını filtrelemek için kullanılabilir.

accessSettings

object (AccessControlSettings)

Zorunlu. Seçilmiş pakete erişimi kontrol etme ayarları.

Bu özel pakete yalnızca izin verilenler listesindeki medya planlayıcılar ve içerik üretici erişebilir. Alıcılar ve teklif verenler bu kaynak için izin verilenler listesine eklenemez veya kaynağa doğrudan erişemez.

targeting

object (PackageTargeting)

İsteğe bağlıdır. Seçki paketi için hedefleme ölçütleri.

curationFeeVisibility

enum (CurationFeeVisibility)

İsteğe bağlıdır. Değiştirilemez. Birleştirilmiş seçim paketi ücretinin ve veri segmenti ücretlerinin (toplam seçim ücreti) görünürlüğü.

Bu paket için seçiciye ödenen ücret. Aşağıda, birbirini dışlayan alanların listesi verilmiştir. Yanıtta en fazla bir alan ayarlanır:
feeCpm

object (Money)

İsteğe bağlıdır. Seçilmiş paketi kullanan alıcılardan seçici tarafından tahsil edilen BGBM ücreti. curatedPackages.list yönteminin yanıtını filtrelemek için kullanılabilir.

millipercentOfMediaFee

string (int64 format)

İsteğe bağlıdır. Ücret, gösterim maliyetinin yüzdesi olarak alınır ve milisaniye cinsinden gösterilir. Örneğin, %1, 1000 olarak gösterilir.

Birbirini hariç tutan alanların sonu.

Eyalet

Seçilmiş paketin durumu.

Sıralamalar
STATE_UNSPECIFIED Varsayılan değer.
ACTIVE Seçilmiş paket etkin.
INACTIVE Seçilmiş paket etkin değil.

AccessControlSettings

Seçilmiş bir pakete erişimi kontrol etme ayarları.

JSON gösterimi
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Alanlar
allowlistedMediaPlanners[]

string

Zorunlu. Değiştirilemez. Seçilmiş pakete açıkça erişim izni verilen medya planlayıcıların listesi. Uygun medya planlayıcılar mediaPlanners.list yönteminde bulunabilir. Şu anda yalnızca bir medya planlayıcı izin verilenler listesine eklenebilir.

Biçim: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Seçilmiş paketler ve açık artırma paketleri için hedefleme ölçütleri.

JSON gösterimi
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Alanlar
includedDeviceTypes[]

enum (DeviceType)

İsteğe bağlıdır. Hedeflenecek dahil edilen cihaz türlerinin listesi. Boş bırakılırsa tüm cihaz türleri hedeflenir.

includedEnvironment

enum (Environment)

İsteğe bağlıdır. Hedeflenecek ortam. Belirtilmezse tüm ortamlar hedeflenir.

includedCreativeFormat

enum (CreativeFormat)

İsteğe bağlıdır. Hedeflenecek reklam öğesi biçimi. Ayarlanmazsa tüm reklam öğesi işaretleme türleri hedeflenir.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

İsteğe bağlıdır. Hedeflenen Accelerated Mobile Pages türü. Ayarlanmazsa envanter, AMP durumundan bağımsız olarak hedeflenir.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

İsteğe bağlıdır. Hedeflenen yetkili satıcı durumlarının dahil edilen listesi. Boş bırakılırsa envanter, satıcı durumundan bağımsız olarak hedeflenir.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

İsteğe bağlıdır. Hedeflenen doğal envanter türleri. Boş bırakılırsa envanter, yerel envanter türünden bağımsız olarak hedeflenir.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

İsteğe bağlıdır. Hedeflenen Open Measurement türlerinin listesi. Boş bırakılırsa envanter, Open Measurement desteğinden bağımsız olarak hedeflenir.

includedRestrictedCategories[]

enum (RestrictedCategory)

İsteğe bağlıdır. Hedeflenen kısıtlanmış kategorilerin listesi. Boş bırakılırsa envanter, kısıtlanmış kategorilerden bağımsız olarak hedeflenir.

includedRewardedType

enum (RewardedType)

İsteğe bağlıdır. Hedeflenen ödüllü reklam türü. Politika ayarlanmazsa ödüllü türüne bakılmaksızın envanter hedeflenir.

videoTargeting

object (PackageVideoTargeting)

İsteğe bağlıdır. Videoya özgü hedefleme ölçütleri.

minimumPredictedViewabilityPercentage

string (int64 format)

İsteğe bağlıdır. Hedeflenen minimum tahmini görüntülenebilirlik yüzdesi.

Bu değer, 10 ile 90 (başlangıç ve bitiş değerleri dahil) arasında 10'un katı olmalıdır. Örneğin, 10 geçerlidir ancak 0, 15 ve 100 geçerli değildir. 10 değeri, yapılandırmanın yalnızca en az %10 görüntülenebilirlik tahmin ettiğimiz reklam alanlarıyla eşleşeceği anlamına gelir.

Ayarlanmamış bir değer, envanterin tahmini görüntülenebilirlikten bağımsız olarak hedefleneceğini gösterir.

languageTargeting

object (StringTargetingDimension)

İsteğe bağlıdır. Hedeflenecek diller. Ayarlanmazsa envanter, dilden bağımsız olarak hedeflenir. Desteklenen dil kodlarının listesi için https://developers.google.com/google-ads/api/data/codes-formats#languages adresini ziyaret edin.

includedAdSizes[]

object (AdSize)

İsteğe bağlıdır. Hedeflenecek reklam boyutlarının listesi. Politika ayarlanmazsa envanter, reklam boyutundan bağımsız olarak hedeflenir.

Seçilmiş paketler, PIXEL ve INTERSTITIAL reklam boyutlarını destekler.

publisherTargeting

object (StringTargetingDimension)

İsteğe bağlıdır. Hedeflenen yayıncılar. Ayarlanmazsa envanter, yayıncıdan bağımsız olarak hedeflenir. Yayıncılar, ads.txt/app-ads.txt dosyasındaki yayıncı kimlikleriyle tanımlanır. Daha fazla bilgi için https://iabtechlab.com/ads-txt/ ve https://iabtechlab.com/app-ads-txt/ adreslerini inceleyin.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

İsteğe bağlıdır. Hedeflenen minimum tahmini tıklama oranı.Değerler [10, 10000] (%0, 01 - %10) aralığındadır. 50 değeri, yapılandırmanın yalnızca en az %0,05 tıklama oranı tahmin ettiğimiz reklam alanlarıyla eşleşeceği anlamına gelir.

Ayarlanmamış bir değer, envanterin tahmini tıklama oranından bağımsız olarak hedefleneceğini gösterir.

verticalTargeting

object (CriteriaTargeting)

İsteğe bağlıdır. https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals adresinde tanımlandığı şekilde dahil edilen veya hariç tutulan sektörler. Politika ayarlanmazsa envanter, sektörden bağımsız olarak hedeflenir.

geoTargeting

object (CriteriaTargeting)

İsteğe bağlıdır. https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv adresinde tanımlandığı şekilde dahil edilecek veya hariç tutulacak coğrafi ölçüt kimlikleri. Ayarlanmazsa envanter, coğrafi konumdan bağımsız olarak hedeflenir.

includedDataSegments[]

string

İsteğe bağlıdır. Hedeflenecek etkin veri segmentleri. Politika ayarlanmazsa envanter, veri segmentlerinden bağımsız olarak hedeflenir. Biçim: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

İsteğe bağlıdır. Yerleşim hedefleme bilgileri (ör. URL, mobil uygulamalar).

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

İsteğe bağlıdır. Hedeflenecek yayıncı tarafından sağlanan sinyaller. Ayarlanmazsa envanter, yayıncı tarafından sağlanan sinyallerden bağımsız olarak hedeflenir.

DeviceType

Hedeflenecek cihazın genel türü.

Sıralamalar
DEVICE_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
DEVICE_TYPE_PERSONAL_COMPUTER Masaüstü veya dizüstü bilgisayarları hedefler.
DEVICE_TYPE_CONNECTED_TV Bağlı TV'leri hedefler: Akıllı TV'ler, oyun konsolları ve canlı oynatma kutuları/çubukları dahil olmak üzere TV içeriği yayını yapan cihazlar.
DEVICE_TYPE_PHONE İleri teknoloji mobil cihazları hedefler.
DEVICE_TYPE_TABLET Tablet cihazları hedefler.

Ortam

Hedeflenecek ortam.

Sıralamalar
ENVIRONMENT_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
ENVIRONMENT_SITE Reklam destekli bir web sitesinde oluşturulan envanteri hedefler.
ENVIRONMENT_APP Mobil uygulama içindeki envanteri hedefler.

CreativeFormat

Hedeflenebilecek reklam öğesi biçimi.

Sıralamalar
CREATIVE_FORMAT_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
CREATIVE_FORMAT_DISPLAY HTML görüntülü reklam öğeleri için tasarlanmış reklam alanlarını hedefler.
CREATIVE_FORMAT_VIDEO Video reklam öğeleri için tasarlanan reklam alanlarını hedefler.
CREATIVE_FORMAT_AUDIO İşitsel reklam öğeleri için tasarlanmış reklam alanlarını hedefler.

AcceleratedMobilePageType

Hedeflenecek Accelerated Mobile Pages (AMP) uygulamasının türü.

Sıralamalar
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP AMP çerçevesi kullanmayan standart web sayfalarındaki envanteri hedefler.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Temel AMP HTML çerçevesi kullanılarak oluşturulan sayfalardaki envanteri hedefler.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Görsel hikaye anlatımı için optimize edilmiş AMP Hikayesi (STAMP) biçimini kullanan sayfalardaki envanteri hedefler (ör. dokunulabilir tam ekran deneyimleri).

AuthorizedSellerStatus

Yayıncı ile satıcı arasındaki ilişkiyi ads.txt veya app-ads.txt dosyasında belirtildiği şekilde gösterir.

Sıralamalar
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
AUTHORIZED_SELLER_STATUS_DIRECT Satıcının "DIRECT" olarak beyan edildiği envanteri hedefler. Bu, yayıncının (içerik sahibi) satıcı hesabını doğrudan kontrol ettiğini ve bu hesap için reklamcılık sistemiyle doğrudan bir iş sözleşmesi olduğunu gösterir.
AUTHORIZED_SELLER_STATUS_RESELLER Satıcının "BAYİ" olarak beyan edildiği envanteri hedefler. Bu, yayıncının listelenen satıcı hesabını işletmesi ve reklam alanını yeniden satması için başka bir tüzel kişiye yetki verdiğini gösterir.

NativeInventoryType

Bir reklam alanının desteklediği reklam öğesi oluşturma türünü, özellikle de doğal reklamlarla ilgili olarak temsil eder.

Sıralamalar
NATIVE_INVENTORY_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Yalnızca doğal reklamları kabul eden ve yayınlayan reklam alanlarını hedefler.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Doğal veya banner reklamları kabul eden ve yayınlayan reklam alanlarını hedefler.

OpenMeasurementType

Hedeflenecek Open Measurement Interface Definition (OMID) türü.

Sıralamalar
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
OPEN_MEASUREMENT_TYPE_OMID_V1 v1 Open Measurement Interface Definition'ı (OMID) destekleyen envanteri hedefler.

RestrictedCategory

Politika uyarınca hedeflenmesi kısıtlanan belirli reklam kategorilerini temsil eder.

Sıralamalar
RESTRICTED_CATEGORY_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
RESTRICTED_CATEGORY_ALCOHOL Yayıncı tarafından alkol reklamlarına izin verilen envanteri hedefler.
RESTRICTED_CATEGORY_GAMBLING Yayıncı tarafından kumar reklamlarına izin verilen envanteri hedefler.

RewardedType

Reklam envanterinin, reklamı görüntüleyen kullanıcıya ödül sunup sunmadığına göre hedefleme ölçütlerini tanımlar.

Sıralamalar
REWARDED_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
REWARDED_TYPE_NON_REWARDED Kullanıcıya reklamı izlemesi veya reklamla etkileşim kurması karşılığında açık bir ödül SUNMAYAN envanteri hedefler.
REWARDED_TYPE_REWARDED Reklamı izleme veya reklamla etkileşim kurma karşılığında kullanıcıya ödül sunan envanteri hedefler.

PackageVideoTargeting

Videoya özgü hedefleme ölçütleri.

JSON gösterimi
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Alanlar
includedMimeTypes[]

enum (VideoMimeType)

İsteğe bağlıdır. IANA tarafından yayınlanan MIME türü dizelerini (https://www.iana.org/assignments/media-types/media-types.xhtml) kullanan hedeflenen video MIME türlerinin listesi. Boş bırakılırsa envanter, video MIME türünden bağımsız olarak hedeflenir.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

İsteğe bağlıdır. Hedeflenen maksimum video reklam süresi. Ayarlanmazsa envanter, maksimum video reklam süresinden bağımsız olarak hedeflenir.

includedPositionTypes[]

enum (PositionType)

İsteğe bağlıdır. Hedeflenen video reklam konumu türleri. Boş bırakılırsa envanter, video reklam konumu türünden bağımsız olarak hedeflenir.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

İsteğe bağlıdır. Hedeflenen video yayınlanma yöntemi. Ayarlanmazsa envanter, video yayınlama yönteminden bağımsız olarak hedeflenir.

plcmtTargeting

object (VideoPlcmtTargeting)

İsteğe bağlıdır. Hedeflenen video yerleşimi türleri. Politika ayarlanmazsa envanter, video plcmt türünden bağımsız olarak hedeflenir.

includedPlaybackMethods[]

enum (PlaybackMethod)

İsteğe bağlıdır. Hedeflenen video oynatma yöntemlerinin listesi. Boş bırakılırsa envanter, video oynatma yönteminden bağımsız olarak hedeflenir.

minimumPredictedCompletionRatePercentage

string (int64 format)

İsteğe bağlıdır. Hedeflenen tahmini minimum tamamlanma oranı yüzdesi.

Bu değer, 10 ile 90 (başlangıç ve bitiş değerleri dahil) arasında 10'un katı olmalıdır. Örneğin, 10 geçerlidir ancak 0, 15 ve 100 geçerli değildir. 10 değeri, yapılandırmanın yalnızca en az %10 tamamlanma oranı tahmin ettiğimiz reklam alanlarıyla eşleşeceği anlamına gelir.

Ayarlanmamış bir değer, tahmini tamamlanma oranından bağımsız olarak envanterin hedefleneceğini gösterir.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

İsteğe bağlıdır. Hedeflenen video oynatıcı boyutu. Politika ayarlanmazsa envanter, video oynatıcı boyutundan bağımsız olarak hedeflenir.

VideoMimeType

Hedeflenecek video MIME türleri.

Sıralamalar
VIDEO_MIME_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
VIDEO_MIME_TYPE_THREEGPP 3G telefonlarda kullanılan 3GPP kapsayıcı biçimi.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 Genellikle H.264 codec'li MPEG-4 kapsayıcısı.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (VPAID reklamları için kullanılır).
VIDEO_MIME_TYPE_WEBM VP9 codec'i varsayılan WebM kapsayıcısı.

MaximumVideoAdDuration

Hedeflenecek video reklam öğesi süresinin üst sınırı. Enum değerleri, grupları tanımlar ve bir değer seçildiğinde reklam öğesinin süresi, belirtilen süreye eşit veya bu süreden daha kısa olmalıdır.

Sıralamalar
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS Süresi 15 saniyeye kadar olan video reklamlar için geçerlidir (0 < süre <= 15 sn).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS Süresi 20 saniyeye kadar olan video reklamlar için geçerlidir (0 < süre <= 20 sn).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS Süresi 30 saniyeye kadar olan video reklamlar için geçerlidir (0 < süre <= 30 sn).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS Süresi 60 saniyeye kadar olan video reklamlar için geçerlidir (0 < süre <= 60 sn).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS Süresi 90 saniyeye kadar olan video reklamlar için geçerlidir (0 < süre <= 90 sn).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS Süresi 120 saniyeye kadar olan video reklamlar için geçerlidir (0 < süre <= 120 sn).

PositionType

Reklamın bir video içindeki hedeflenebilir konumu.

Sıralamalar
POSITION_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
POSITION_TYPE_MIDROLL Reklam, video içeriğinin ortasında oynatılır.
POSITION_TYPE_POSTROLL Reklam, video içeriğinden sonra oynatılır.
POSITION_TYPE_PREROLL Reklam, video içeriğinden önce oynatılır.

ContentDeliveryMethod

Video içeriğinin yayınlanma yöntemine dayalı hedefleme ölçütleri.

Sıralamalar
CONTENT_DELIVERY_METHOD_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
CONTENT_DELIVERY_METHOD_STREAMING Canlı yayınlanan video içeriğini hedefler.
CONTENT_DELIVERY_METHOD_PROGRESSIVE İstemcinin oynatma gereksinimlerine göre kademeli olarak aktarılan video içeriğini hedefler.

VideoPlcmtTargeting

Video yerleşimi türüne göre hedefleme ölçütlerini tanımlar. Genellikle IAB OpenRTB "plcmt" alanına karşılık gelir.

JSON gösterimi
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Alanlar
selectionType

enum (SelectionType)

Zorunlu. Video yerleşimleri listesi için seçim türü.

videoPlcmtTypes[]

enum (VideoPlcmtType)

Zorunlu. Hedeflenen video yerleşimi türlerinin listesi. Boş bırakılırsa envanter, video plcmt türünden bağımsız olarak hedeflenir.

SelectionType

Hedefleme boyutları tarafından kullanılan olası seçim türleri için enum.

Sıralamalar
SELECTION_TYPE_UNSPECIFIED Seçim türü belirtilmemiş. Kullanılmamalıdır.
SELECTION_TYPE_INCLUDE Hedefleme boyutundaki değerler dahil edilir.
SELECTION_TYPE_EXCLUDE Hedefleme boyutundaki değerler hariç tutulur.

VideoPlcmtType

OpenRTB standartlarına uygun olarak video yerleşimi türünü temsil eder.

Sıralamalar
VIDEO_PLCMT_TYPE_UNSPECIFIED Varsayılan değer. Hedefleme spesifikasyonlarında kullanılmamalıdır.
INSTREAM Tüketicinin istediği akışlı video içeriğinden önce, içerik sırasında veya içerikten sonra oynatılan videodan önce gösterilen reklamlar, ara reklamlar ve yayın sonrası video reklamlar. Yayın içi video, oynatıcı başlatıldığında varsayılan olarak "ses açık" olarak ayarlanmalı veya video içeriğini izlemek için açıkça net bir kullanıcı niyeti olmalıdır. Oynatıcının etrafında başka içerikler bulunabilir ancak video içeriği, kullanıcının ziyaretinin odak noktası olmalıdır. Sayfadaki birincil içerik ve oynatılırken ses çalabilen tek video oynatıcı olarak kalmalıdır. Oynatıcı kayan/sabit hale gelirse sonraki reklam çağrıları güncellenen oynatıcı boyutunu doğru şekilde iletmelidir.
ACCOMPANYING_CONTENT Video içeriği akışından önce, akış sırasında veya akıştan sonra oynatılan videodan önce gösterilen reklamlar, ara reklamlar ve yayın sonrası video reklamlar. Video oynatıcı, metin veya grafik içerik paragraflarından önce, paragrafların arasında ya da paragraflardan sonra yüklenip oynatılır ve yalnızca görüntü alanına girdiğinde oynatılmaya başlar. Eşlik eden içerik yalnızca görüntü alanına girildiğinde oynatılmaya başlamalıdır. Sayfadan kaydırıldığında kayan/sabit bir oynatıcıya dönüşebilir.
INTERSTITIAL Video içeriği olmadan oynatılan video reklamlar. Oynatma sırasında sayfanın ana odağı olmalı, görüntü alanının büyük kısmını kaplamalı ve kaydırılarak görünümden çıkarılamamalıdır. Bu, uygulama içi video veya slayt gösterileri gibi yerleşimlerde olabilir.
NO_CONTENT Akışlı video içeriği olmadan oynatılan video reklamlar. Bu, slayt gösterileri, yerel feed'ler, içerik içi veya yapışkan/kayan gibi yerleşimlerde olabilir.

PlaybackMethod

Hedeflenecek oynatma yöntemi.

Sıralamalar
PLAYBACK_METHOD_UNSPECIFIED Belirtilmemiş video oynatma yöntemi. Kullanılmamalıdır.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON Sayfa/içerik yüklendiğinde oynatma otomatik olarak başlar.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF Sayfa/içerik yüklendiğinde oynatma otomatik olarak başlar ancak ses kapalıdır.
PLAYBACK_METHOD_CLICK_TO_PLAY Oynatma, bir kullanıcı işlemiyle (ör. oynat düğmesini tıklama) başlatılır.

VideoPlayerSizeTargeting

Hedeflenebilecek video oynatıcının boyutunu temsil eder. Hem genişlik hem de yükseklik için sıfır dışında bir değer ayarlanmalıdır.

JSON gösterimi
{
  "minimumWidth": string,
  "minimumHeight": string
}
Alanlar
minimumWidth

string (int64 format)

Zorunlu. Video oynatıcının piksel cinsinden minimum genişliği.

minimumHeight

string (int64 format)

Zorunlu. Video oynatıcının piksel cinsinden minimum yüksekliği.

StringTargetingDimension

Dize değerleriyle genel hedefleme.

JSON gösterimi
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Alanlar
selectionType

enum (SelectionType)

Zorunlu. Bu listedeki öğelerin nasıl hedeflenmesi gerektiği.

values[]

string

Zorunlu. Belirtilen değerler.

AdSize

Tek bir reklam alanının veya reklam öğesinin boyutunu temsil eder.

JSON gösterimi
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Alanlar
width

string (int64 format)

Reklam alanının piksel cinsinden genişliği. Bu alan yalnızca boyut türü PIXEL olduğunda gösterilir.

height

string (int64 format)

Reklam alanının piksel cinsinden yüksekliği. Bu alan yalnızca boyut türü PIXEL olduğunda gösterilir.

type

enum (Type)

Reklam alanı boyutunun türü.

Tür

Farklı reklam alanı/reklam boyutu türlerini temsil eder.

Sıralamalar
TYPE_UNSPECIFIED Tanımlanmamış bir boyut türü için yer tutucu.
PIXEL Piksel cinsinden yükseklik ve genişlik ile belirtilen boyuta sahip reklam alanı.
INTERSTITIAL Geçiş reklamı alanını tanımlamak için özel boyut.
NATIVE Yayıncı tarafından oluşturulan doğal (mobil) reklamlar.
FLUID Akışkan boyut (duyarlı boyut), dış ortamın değişmesiyle otomatik olarak yeniden boyutlandırılabilir.

CriteriaTargeting

Dahil edilen ve hariç tutulan sayısal kimliklerin listesini içeren hedefleme boyutlarını hedeflemek için kullanılan genel hedefleme. Bu, liste filtresi söz dizimi kullanılarak filtrelenemez.

JSON gösterimi
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Alanlar
targetedCriteriaIds[]

string (int64 format)

Dahil edilecek sayısal kimliklerin listesi.

excludedCriteriaIds[]

string (int64 format)

Hariç tutulacak sayısal kimliklerin listesi.

PackagePlacementTargeting

Reklamların nerede görünebileceğiyle (ör. belirli siteler veya mobil uygulamalar) ilgili hedeflemeyi temsil eder. Farklı yerleşim hedefleme türleri mantıksal olarak VEYA ile birleştirilir.

JSON gösterimi
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Alanlar
uriTargeting

object (StringTargetingDimension)

İsteğe bağlıdır. Hedeflenen veya hariç tutulan URL'lerin listesi. Alan adlarında http/https kaldırılmış olmalıdır (ör. google.com) ve URL başına en fazla 5 yol bulunabilir.

mobileAppTargeting

object (StringTargetingDimension)

İsteğe bağlıdır. Yayıncıların sahip olduğu, hedeflenen veya hariç tutulan mobil uygulama kimliklerinin listesi. Şu anda yalnızca Android ve Apple uygulamaları desteklenmektedir.

Android uygulama kimliği (ör. com.google.android.apps.maps) Google Play Store URL'sinde bulunabilir. iOS uygulama kimliği (sayıdan oluşur) iTunes Store URL'sinin sonunda bulunabilir. Birinci taraf mobil uygulamaları dahil edilir veya hariç tutulur.

includedMobileAppCategoryTargeting[]

string (int64 format)

İsteğe bağlıdır. Hedeflenen mobil uygulama kategorilerinin listesi.

PackagePublisherProvidedSignalsTargeting

Yayıncı tarafından sağlanan sinyallerle ilgili hedeflemeyi temsil eder. Yayıncı tarafından sağlanan farklı sinyal türleri mantıksal olarak VEYA ile birleştirilir.

JSON gösterimi
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Alanlar
audienceTargeting

object (TaxonomyTargeting)

İsteğe bağlıdır. Hedeflenen veya hariç tutulan kitle kimliklerinin listesi. IAB Kitle Sınıflandırması 1.1 sürümünü (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv) temel alır.

contentTargeting

object (TaxonomyTargeting)

İsteğe bağlıdır. Hedeflenen veya hariç tutulan Content ID'lerinin listesi. IAB İçerik Sınıflandırması 2.2 sürümünü (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv) temel alır.

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

İsteğe bağlıdır. Hedeflenen ve hariç tutulan video ve işitsel sinyal kimliklerinin listesi. Bunlar, yayıncı tarafından sağlanan sinyallerle desteklenen ek sinyallerdir.

TaxonomyTargeting

IAB kitle ve içerik sınıflandırması kimlik alanını işlemek için hedefleme ölçütlerini tanımlar.

JSON gösterimi
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Alanlar
targetedTaxonomyIds[]

string

İsteğe bağlıdır. Hedeflenen içerik sınıflandırması kimliklerinin listesi.

excludedTaxonomyIds[]

string

İsteğe bağlıdır. Hariç tutulan içerik sınıflandırması kimliklerinin listesi.

CurationFeeVisibility

Birleştirilmiş seçim paketi ücreti ve veri segmenti ücretlerinin (toplam seçim ücreti) görünürlüğü. Ücretler, paketi oluşturan kullanıcı tarafından her zaman görülebilir.

Sıralamalar
CURATION_FEE_VISIBILITY_UNSPECIFIED Toplam seçim ücreti görünürlüğü belirtilmemiş.
DISCLOSED Toplam seçim ücreti tüm alıcılar tarafından görülebilir. Bu, ayarlanmadığı takdirde varsayılan değerdir.
NON_DISCLOSED Toplam seçim ücreti tüm alıcılara gösterilmez.

Yöntemler

activate

Mevcut bir özel paketi etkinleştirir.

create

Yeni bir özel paket oluşturur.

deactivate

Mevcut bir özel paketi devre dışı bırakır.

get

Kaynak adı verilen seçilmiş bir paketi alır.

list

Belirtilen seçiciye ait seçilmiş paketleri listeler.

patch

Mevcut bir seçilmiş paketi günceller.