REST Resource: advertisers

Kaynak: Reklamveren

Display & Video 360'ta (DV360) tek bir reklamveren.

JSON gösterimi 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
Alanlar
name

string

Yalnızca çıkış. Reklamverenin kaynak adı.
advertiserId

string (int64 format)

Yalnızca çıkış. Reklamverenin benzersiz kimliği. Sistem tarafından atanır.
partnerId

string (int64 format)

Zorunlu. Sabit. Reklamverenin ait olduğu iş ortağının benzersiz kimliği.
displayName

string

Zorunlu. Reklamverenin görünen adı.

Maksimum 240 baytlık bir boyutla kodlanmış UTF-8 olmalıdır.
entityStatus

enum (EntityStatus)

Zorunlu. Reklamverenin kampanya siparişlerinin ve satır öğelerinin bütçelerini ve envanter için teklif verip veremeyeceğini kontrol eder.

  • Kabul edilen değerler: ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED ve ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • Bu politika ENTITY_STATUS_SCHEDULED_FOR_DELETION değerine ayarlanırsa reklamveren, silinmek üzere programlandığı ilk tarihten 30 gün sonra silinir.
updateTime

string (Timestamp format)

Yalnızca çıkış. Reklamverenin son güncellendiği zaman damgası. Sistem tarafından atanır.

Nanosaniye çözünürlüğe ve en fazla dokuz kesir basamağına sahip, RFC3339 UTC "Zulu" biçiminde bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".
generalConfig

object (AdvertiserGeneralConfig)

Zorunlu. Reklamverenin genel ayarları.
adServerConfig

object (AdvertiserAdServerConfig)

Zorunlu. Sabit. Reklamverenin reklam sunucusuyla ilgili ayarları.
creativeConfig

object (AdvertiserCreativeConfig)

Zorunlu. Reklamverenin reklam öğeleriyle ilgili ayarları.
dataAccessConfig

object (AdvertiserDataAccessConfig)

Reklamveren verilerine nasıl erişilebileceğini kontrol eden ayarlar.
integrationDetails

object (IntegrationDetails)

Reklamverenin entegrasyon ayrıntıları. Reklamveren için şu anda yalnızca integrationCode kullanılabilir. Diğer IntegrationDetails alanları desteklenmez ve sağlanırsa yoksayılır.
servingConfig

object (AdvertiserTargetingConfig)

Reklamverenin reklam sunumuyla ilgili hedefleme ayarları.
prismaEnabled

boolean

Mediaocean (Prisma) ile entegrasyonun etkin olup olmadığı. Bu özelliği etkinleştirerek şunları kabul etmiş olursunuz:

Şirketim adına Mediaocean'a (Prisma) Google'a bütçe segmenti planları gönderme yetkisi veriyorum ve Google'a bu reklamveren için bütçe planlaması, faturalandırma ve mutabakat amacıyla ilgili raporları ve faturaları DV360'tan Mediaocean'a gönderme yetkisi veriyorum.

AdvertiserGeneralConfig

Bir reklamverenin genel ayarları.

JSON gösterimi 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
Alanlar
domainUrl

string

Zorunlu. Reklamverenin birincil web sitesinin alan adı URL'si. Sistem, bu bilgileri bir kampanyayı bir reklamverenle ilişkilendirmek için web sitesi URL'sine gereksinim duyan yayıncılara gönderir.

http: veya https: ile başlayan, yol veya sorgu dizesi içermeyen bir URL sağlayın. Örneğin http://www.example.com
timeZone

string

Yalnızca çıkış. Reklamverenin saat diliminin standart TZ veritabanı adı. Örneğin, America/New_York.

Daha fazla bilgi için: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

CM360 karma reklamverenleri için saat dilimi, ilişkilendirilmiş CM360 hesabının saat dilimiyle aynıdır; yalnızca üçüncü taraf reklamverenler için saat dilimi ana iş ortağının saat dilimiyle aynıdır.
currencyCode

string

Zorunlu. Sabit. Reklamverenin ISO 4217 biçimindeki para birimi.

Kabul edilen kodlar ve temsil ettikleri para birimleri şunlardır:

Para Birimi Kodu : Para Birimi Adı

  • ARS : Arjantin pezosu
  • AUD : Avustralya Doları
  • BRL : Brezilya reali
  • CAD : Kanada Doları
  • CHF : İsviçre frangı
  • CLP : Şili Pesosu
  • CNY : Çin yuanı
  • COP : Kolombiya Pesosu
  • CZK : Çek Korunası
  • DKK : Danimarka Kronu
  • EGP : Mısır poundu
  • EUR : Avro
  • GBP : İngiliz sterlini
  • HKD : Hong Kong Doları
  • HUF : Macar forinti
  • IDR : Endonezya Rupiahı
  • ILS : İsrail Şekeli
  • INR : Hindistan Rupisi
  • JPY : Japon Yeni
  • KRW : Güney Kore wonu
  • MXN : Meksika pezosu
  • MYR : Malezya ringiti
  • NGN : Nijerya nairası
  • NOK : Norveç Kronu
  • NZD : Yeni Zelanda doları
  • PEN : Peru Nuevo Solu
  • PLN : Polonya Zlotisi
  • RON : Yeni Rumen Leyi
  • RUB : Rus rublesi
  • SEK : İsveç Kronu
  • TRY : Türk Lirası
  • TWD : Yeni Tayvan Doları
  • USD : ABD doları
  • ZAR : Güney Afrika Randı

AdvertiserAdServerConfig

Bir reklamverenin reklam sunucusuyla ilgili ayarları.

JSON gösterimi 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
Alanlar
ad_server_config_scheme alanı. Zorunlu. ad_server_config_scheme şunlardan yalnızca biri olabilir:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Yalnızca üçüncü taraf reklam sunucuları kullanan reklamverenler için yapılandırma.
cmHybridConfig

object (CmHybridConfig)

Hem Campaign Manager 360 (CM360) hem de üçüncü taraf reklam sunucularını kullanan reklamverenler için yapılandırma.

ThirdPartyOnlyConfig

Yalnızca üçüncü taraf reklam sunucuları kullanan reklamverenlere yönelik ayarlar.

JSON gösterimi 
{
  "pixelOrderIdReportingEnabled": boolean
}
Alanlar
pixelOrderIdReportingEnabled

boolean

Pikseller için sipariş kimliği raporlamasının etkinleştirilip etkinleştirilmediği. Bu değer, true olarak ayarlandıktan sonra değiştirilemez.

CmHybridConfig

Hem Campaign Manager 360 (CM360) hem de üçüncü taraf reklam sunucularını kullanan reklamverenlerin ayarları.

JSON gösterimi 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Alanlar
cmAccountId

string (int64 format)

Zorunlu. Sabit. DV360 reklamvereniyle bağlantılı CM360 Floodlight yapılandırmasının hesap kimliği.
cmFloodlightConfigId

string (int64 format)

Zorunlu. Sabit. DV360 reklamvereniyle bağlantılı CM360 Floodlight yapılandırmasının kimliği.
cmSyncableSiteIds[]

string (int64 format)

Yerleşimleri, reklam öğesi olarak DV360 ile senkronize edilecek CM360 sitelerinin listesi.

advertisers.create yönteminde eksik veya boşsa sistem otomatik olarak bir CM360 sitesi oluşturur.

Sitelerin bu listeden kaldırılması, CM360'tan senkronize edilen DV360 reklam öğelerinin silinmesine neden olabilir. En az bir site belirtilmelidir.
dv360ToCmDataSharingEnabled

boolean

DV360 verilerinin CM360 veri aktarımı raporlarına dahil edilip edilmeyeceğini belirtir.
dv360ToCmCostReportingEnabled

boolean

DV360 maliyetinin CM360'a bildirilip bildirilmeyeceği.
cmFloodlightLinkingAuthorized

boolean

Zorunlu. Sabit. Bu alanı true olarak ayarladığınızda, şirketiniz adına belirtilen Floodlight yapılandırmasındaki bilgilerin bu Display & Video 360 reklamvereniyle paylaşılması için yetki vermiş olursunuz.

AdvertiserCreativeConfig

Bir reklamverenin reklam öğeleriyle ilgili ayarları.

JSON gösterimi 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
Alanlar
iasClientId

string (int64 format)

Kampanya izlemeyi yapılandırmak için Integral Ad Service (IAS) tarafından sağlanan kimlik. DV360 sistemi, reklam öğesi etiketine bu kimliği içeren IAS "Campaign Monitor" etiketini ekler.
obaComplianceDisabled

boolean

DV360'ın Dijital Davranışsal Reklamcılık (OBA) uyumluluğunun kullanılıp kullanılmayacağı.

Uyarı: OBA ayarlarının değiştirilmesi, reklam öğelerinizin denetim durumunun bazı Ad Exchange'ler tarafından sıfırlanmasına neden olabilir. Bu durumda, reklam öğeleriniz yeniden onaylanana kadar yayınlanmaya uygun olmaz.
dynamicCreativeEnabled

boolean

Reklamverenin dinamik reklamlar için etkinleştirilip etkinleştirilmediği.
videoCreativeDataSharingAuthorized

boolean

Bu alanı true olarak ayarladığınızda, şirketiniz adına Google'a bu Display & Video 360 reklamvereniyle ilişkili video reklam öğelerini, reklamverenin televizyon kampanyalarıyla ilgili raporlar ve özellikler sağlaması için kullanma yetkisi vermiş olursunuz.

Yalnızca reklamverenin CM360 hybrid reklam sunucusu yapılandırması olduğunda geçerlidir.

AdvertiserDataAccessConfig

Reklamverenle ilgili verilere nasıl erişilebileceğini kontrol eden ayarlar.

JSON gösterimi 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
Alanlar
sdfConfig

object (AdvertiserSdfConfig)

Reklamveren için Yapılandırılmış Veri Dosyaları (SDF) ayarları.

Belirtilmezse ana iş ortağının SDF ayarları kullanılır.

AdvertiserSdfConfig

Bir reklamverenin Yapılandırılmış Veri Dosyaları (SDF) ayarları.

JSON gösterimi 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
Alanlar
overridePartnerSdfConfig

boolean

Bu reklamverenin, üst iş ortağının SDF yapılandırmasını geçersiz kılıp kılmadığı.

Varsayılan olarak reklamveren, SDF yapılandırmasını üst iş ortağından devralır. İş ortağı yapılandırmasını geçersiz kılmak için bu alanı true olarak ayarlayın ve yeni yapılandırmayı sdfConfig bölümüne girin.
sdfConfig

object (SdfConfig)

Reklamveren için SDF yapılandırması.

AdvertiserTargetingConfig

Bir reklamverenin reklam sunumuyla ilgili hedefleme ayarları.

JSON gösterimi 
{
  "exemptTvFromViewabilityTargeting": boolean
}
Alanlar
exemptTvFromViewabilityTargeting

boolean

Bağlı TV cihazlarının, reklamveren altındaki tüm video satır öğeleri için görüntülenebilirlik hedeflemeden muaf olup olmadığı.

Yöntemler

audit

 Bir reklamvereni denetler.

bulkEditAdvertiserAssignedTargetingOptions

 Hedefleme seçeneklerini tek bir reklamveren altında toplu olarak düzenler.

bulkListAdvertiserAssignedTargetingOptions

 Hedefleme türleri genelinde bir reklamverenin atanan hedefleme seçeneklerini listeler.

create

 Yeni bir reklamveren oluşturur.

delete

 Reklamvereni siler.

get

 Reklamveren alır.

list

 Geçerli kullanıcı tarafından erişilebilen reklamverenleri listeler.

patch

 Mevcut bir reklamvereni günceller.