REST Resource: advertisers

Kaynak: Reklamveren

Display & Video 360'taki (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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
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. Değiştirilemez. Reklamverenin ait olduğu iş ortağının benzersiz kimliği.
displayName

string

Zorunlu. Reklamverenin görünen adı.

Maksimum 240 bayt boyutunda UTF-8 kodlu 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'dir.
  • ENTITY_STATUS_SCHEDULED_FOR_DELETION olarak ayarlanırsa reklamveren, ilk silinme planından 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.

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".
generalConfig

object (AdvertiserGeneralConfig)

Zorunlu. Reklamverenin genel ayarları.
adServerConfig

object (AdvertiserAdServerConfig)

Zorunlu. Değiştirilemez. 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ı. Şu anda yalnızca integrationCode reklamveren için geçerlidir. IntegrationDetails'nın diğer alanları desteklenmez ve sağlandığında 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 aşağıdakileri kabul etmiş olursunuz:

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

object (AdvertiserBillingConfig)

Zorunlu. Reklamverenin faturalandırmayla ilgili ayarları.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

İsteğe bağlıdır. Bu reklamverenin, Avrupa Birliği siyasi reklamları yayınlayan satır öğeleri içerip içermediği.

Bu alan DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING olarak ayarlanırsa:

  • Bu reklamveren altında oluşturulan tüm yeni satır öğeleri, aksi belirtilmedikçe DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING olarak atanır.
  • Bu reklamveren altındaki mevcut satır öğelerinden değeri ayarlanmamış olanlar bir gün içinde DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING olarak güncellenir.
defaultBusinessName

string

İsteğe bağlıdır. Reklamverenin varsayılan işletme adı.

İşletme adı sağlanmadığı takdirde bu reklamveren altındaki YouTube ve Talep Yaratma reklamları tarafından kullanılan değerdir.
defaultLogoAssetId

string (int64 format)

İsteğe bağlıdır. Reklamverenin varsayılan logo resminin öğe kimliği.

Bu, bir logo öğesi sağlanmadığı takdirde bu reklamveren altındaki YouTube ve talep reklamları tarafından kullanılacak öğe kimliğidir.

Bu öğeyi API kullanarak yüklemek için advertisers.adAssets.upload kullanmanız gerekir.

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, bir kampanyayı reklamverenle ilişkilendirmek için web sitesi URL'si gerektiren yayıncılara bu bilgileri 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şkili CM360 hesabının saat dilimiyle aynıdır. Yalnızca üçüncü taraf reklam sunucusu kullanan reklamverenler için saat dilimi, üst iş ortağının saat dilimiyle aynıdır.
currencyCode

string

Zorunlu. Değiştirilemez. 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 pezosu
  • CNY : Çin Yuanı
  • COP : Kolombiya Pezosu
  • CZK : Çek 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 pezosu
  • MYR : Malezya Ringgiti
  • 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
Alanlar
Zorunlu. Aşağıda, aynı anda kullanılamayan alanların listesi verilmiştir. Yanıt olarak en fazla bir alan ayarlanır:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

Yalnızca üçüncü taraf reklam sunucularını kullanan reklamverenlerin yapılandırması.
cmHybridConfig

object (CmHybridConfig)

Hem Campaign Manager 360'ı (CM360) hem de üçüncü taraf reklam sunucularını kullanan reklamverenler için yapılandırma.
Birbirini dışlayan alanların sonu.

ThirdPartyOnlyConfig

Yalnızca üçüncü taraf reklam sunucularını kullanan reklamverenlere yönelik 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ştirilemez. DV360 reklamvereniyle bağlantılı CM360 Floodlight yapılandırmasının hesap kimliği.
cmFloodlightConfigId

string (int64 format)

Zorunlu. Değiştirilemez. DV360 reklamvereniyle bağlantı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 DV360 ile reklam öğesi olarak senkronize edilecek CM360 sitelerinin listesi.

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

Siteleri bu listeden kaldırmak, 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 bildirilip bildirilmeyeceği.
cmFloodlightLinkingAuthorized

boolean

Zorunlu. Değiştirilemez. Bu alanı true olarak ayarlayarak şirketiniz adına, belirtilen Floodlight yapılandırmasındaki bilgilerin bu Display & Video 360 reklamvereniyle paylaşılmasına yetki vermiş olursunuz.

AdvertiserCreativeConfig

Reklamverenlerin reklam öğeleriyle ilgili ayarları.

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

string (int64 format)

Integral Ad Service (IAS) tarafından sağlanan kampanya izlemeyi yapılandırmak için kullanılan kimlik. DV360 sistemi, bu kimliği içeren bir IAS "Kampanya İzleme" 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ği ile ilgili etkileşim için) ekleyen Google'ın "Bu reklam hakkında" özelliğinin devre dışı bırakılıp bırakılmayacağı. Bu Reklam Hakkında, kullanıcılara gördükleri reklamlar üzerinde daha fazla kontrol imkanı sunar ve reklamınızın neden gösterildiğini açıklamanıza yardımcı olur. Daha fazla bilgi

Bu alanı true olarak ayarlamayı seçerseniz 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 online davranışa dayalı reklamcılık (OBA) ile uyumlu olmalıdır.
  • Avrupa Ekonomik Alanı'nda (AEA) şeffaflık bilgileri ve kullanıcılara yasa dışı içerikleri bildirmelerini sağlayacak bir mekanizma ekleyin. Alternatif bir reklam etiketi, şeffaflık ve raporlama çözümü kullanıyorsanız gerekli şeffaflık bilgilerini ve yasa dışı içerik işaretleme mekanizmasını içerdiğinden emin olmanız ve uygun formu kullanarak yasa dışı içerik bildirimlerini Google'a iletmeniz gerekir.
dynamicCreativeEnabled

boolean

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

boolean

Bu alanı true olarak ayarlayarak şirketiniz adına, Google'ın bu Display & Video 360 reklamvereniyle ilişkili video reklam öğelerini kullanarak reklamverenin televizyon kampanyalarıyla ilgili raporlama ve özellikler sağlamasına yetki veriyorsunuz.

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 dosyası (SDF) ayarları.

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

AdvertiserSdfConfig

Bir reklamverenin yapılandırılmış veri dosyası (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, bir 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 içinde sağlayın.
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, reklamverenin altındaki tüm video satır öğeleri için görüntülenebilirlik hedeflemeden muaf olup olmadığı.

AdvertiserBillingConfig

Bir 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

 Bir reklamvereni denetler.

create

 Yeni bir reklamveren oluşturur.

delete

 Bir reklamvereni siler.

editAssignedTargetingOptions

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

get

 Bir reklamvereni alır.

list

 Mevcut kullanıcının erişebildiği reklamverenleri listeler.

listAssignedTargetingOptions

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

patch

 Mevcut bir reklamvereni günceller.