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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  }
}
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 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.
entityStatus

enum (EntityStatus)

Zorunlu. Reklamverenin kampanya siparişlerinin ve satır öğelerinin bütçelerini harcayıp harcayamayacağını 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.
  • ENTITY_STATUS_SCHEDULED_FOR_DELETION olarak ayarlanırsa reklamveren, silinmek üzere ilk kez planlandığı tarihten 30 gün sonra silinir.
updateTime

string (Timestamp format)

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

Nanosaniye çözünürlüğüne sahip ve en fazla dokuz kesirli basamak içeren 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. Değişmez. Reklamverenin reklam sunucusuyla ilgili ayarları.
creativeConfig

object (AdvertiserCreativeConfig)

Zorunlu. Reklamverenin reklam öğesiyle 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 geçerlidir. IntegrationDetails'nin diğer alanları desteklenmez ve sağlanırsa yoksayılır.
servingConfig

object (AdvertiserTargetingConfig)

Reklamverenin reklam sunmasıyla ilgili hedefleme ayarları.
prismaEnabled

boolean

Mediaocean (Prisma) entegrasyonunun etkin olup olmadığı. Bu özelliği etkinleştirerek aşağıdakileri kabul etmiş olursunuz:

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

object (AdvertiserBillingConfig)

Zorunlu. Reklamverenin faturalandırmayla ilgili ayarları.

AdvertiserGeneralConfig

Reklamverenin genel ayarları.

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

string

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

http: veya https: ile başlayan, yol veya sorgu dizesi içermeyen bir URL girin. Ö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şkili CM360 hesabının saat dilimine, yalnızca üçüncü taraf reklamverenler için ise ana iş ortağının saat dilimine eşittir.
currencyCode

string

Zorunlu. Değişmez. 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 pesosu
  • AUD : Avustralya doları
  • BRL : Brezilya reali
  • CAD : Kanada doları
  • CHF : İsviçre Frangı
  • CLP : Şili Pezosu
  • CNY : Çin yuanı
  • COP : Kolombiya Pezosu
  • CZK : Çek Cumhuriyeti Korunası
  • DKK : Danimarka kronu
  • EGP : Mısır lirası
  • EUR : Euro
  • 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 pesosu
  • 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
Birlik alanı ad_server_config_scheme. Zorunlu. ad_server_config_scheme yalnızca aşağıdakilerden 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 reklamverenler için ayarlar.

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

boolean

Pikseller için sipariş kimliği raporlamasının etkin olup olmadığı. 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,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
Alanlar
cmAccountId

string (int64 format)

Zorunlu. Değişmez. DV360 reklamverenine bağlı CM360 Floodlight yapılandırmasının hesap kimliği.
cmFloodlightConfigId

string (int64 format)

Zorunlu. Değişmez. DV360 reklamverenine bağlı CM360 Floodlight yapılandırmasının kimliği.
cmAdvertiserIds[]

string (int64 format)

Yalnızca çıkış. CM360 Floodlight yapılandırmasını paylaşan CM360 reklamveren kimlikleri grubu.
cmSyncableSiteIds[]

string (int64 format)

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

advertisers.create yönteminde yoksa 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ği.
dv360ToCmCostReportingEnabled

boolean

DV360 maliyetinin CM360'a raporlanıp raporlanmayacağı.
cmFloodlightLinkingAuthorized

boolean

Zorunlu. Sabit. Bu alanı true olarak ayarlayarak, şirketiniz adına belirli bir Floodlight yapılandırmasında bulunan bilgilerin bu Display & Video 360 reklamvereniyle paylaşılmasına yetki vermiş olursunuz.

AdvertiserCreativeConfig

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, bu kimliği içeren bir IAS "Campaign Monitor" etiketini reklam öğesi etiketine ekler.
obaComplianceDisabled

boolean

Davranışa Dayalı Çevrimiçi Reklamcılık (OBA) ve yasal şartlar için reklamlarınıza rozet (içeriği reklam olarak tanımlamak için) ve şeffaflık bilgileri ("Bu reklam hakkında" özelliğiyle ilgili etkileşim) ekleyen Google'ın "Bu reklam hakkında" özelliğinin devre dışı bırakılıp bırakılmayacağı. "Bu reklam hakkında" seçeneği, kullanıcıların gördükleri reklamlar üzerinde daha fazla kontrol sahibi olmasını sağlar ve reklamınızı neden gördüklerini açıklamanıza yardımcı olur. Daha fazla bilgi edinin.

Bu alanı true olarak ayarlarsanız Display & Video 360 üzerinden yayınlanan reklamların aşağıdakilere uyması gerektiğini unutmayın:

  • Google Marketing Platform ile yaptığınız sözleşmeye göre Davranışa Dayalı Dijital Reklamcılık (OBA) ile uyumlu olmak.
  • Avrupa Ekonomik Alanı'nda (AEA) şeffaflık bilgilerini ve kullanıcıların reklamlardaki yasa dışı içerikleri bildirebilecekleri bir mekanizmayı ekleyin. Alternatif bir reklam rozeti, şeffaflık ve raporlama çözümü kullanıyorsanız bu çözümün gerekli şeffaflık bilgilerini ve yasa dışı içerik işaretleme mekanizmasını içerdiğinden ve yasa dışı içerik bildirimlerini uygun formu kullanarak Google'a bildirdiğinizden emin olmanız gerekir.
dynamicCreativeEnabled

boolean

Reklamverenin dinamik reklam öğeleri için etkin olup olmadığı.
videoCreativeDataSharingAuthorized

boolean

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

Yalnızca reklamverenin CM360 hybrid reklam sunucusu yapılandırması varsa 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ı.

Belirtilmemişse üst 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ığı.

Reklamverenler varsayılan olarak 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 sdfConfig alanında yeni yapılandırmayı sağlayın.
sdfConfig

object (SdfConfig)

Reklamverenin SDF yapılandırması.

AdvertiserTargetingConfig

Bir reklamverenin reklam sunmasıyla ilgili hedefleme ayarları.

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

boolean

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

AdvertiserBillingConfig

Reklamverenin faturalandırmayla ilgili ayarları.

JSON gösterimi 
{
  "billingProfileId": string
}
Alanlar
billingProfileId

string (int64 format)

Zorunlu. Reklamverene atanan faturalandırma profilinin kimliği.

Yöntemler

audit

 Reklamvereni denetler.

create

 Yeni bir reklamveren oluşturur.

delete

 Reklamvereni siler.

editAssignedTargetingOptions

 Tek bir reklamveren altındaki hedefleme seçeneklerini düzenler.

get

 Bir reklamveren sağlar.

list

 Geçerli kullanıcının erişebildiği reklamverenleri listeler.

listAssignedTargetingOptions

 Reklamverenin hedefleme türleri genelinde atanmış hedefleme seçeneklerini listeler.

patch

 Mevcut bir reklamvereni günceller.