REST Resource: advertisers.campaigns

{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "campaignGoal": {
    object (CampaignGoal)
  },
  "campaignFlight": {
    object (CampaignFlight)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "campaignBudgets": [
    {
      object (CampaignBudget)
    }
  ]
}

string

Yalnızca çıkış. Kampanyanın kaynak adı.

string (int64 format)

Yalnızca çıkış. Kampanyanın ait olduğu reklamverenin benzersiz kimliği.

string (int64 format)

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

string

Zorunlu. Kampanyanın görünen adı.

Maksimum 240 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.

enum (EntityStatus)

Zorunlu. Bu kampanya kapsamındaki kampanya siparişlerinin bütçelerini harcayıp envantere teklif edip edemeyeceğini kontrol eder.

• Kabul edilen değerler: ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED ve ENTITY_STATUS_PAUSED.
• campaigns.create yöntemi için ENTITY_STATUS_ARCHIVED öğesine izin verilmez.

string (Timestamp format)

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

RFC3339 UTC "Zulu" zaman damgası biçiminde olmalıdır. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

object (CampaignGoal)

Zorunlu. Kampanyanın hedefi.

object (CampaignFlight)

Zorunlu. Kampanyanın planlanan harcaması ve süresi.

object (FrequencyCap)

Zorunlu. Kampanyanın sıklık sınırı ayarı.

object (CampaignBudget)

Bu kampanya için kullanılabilen bütçelerin listesi.

Bu alan ayarlanmazsa kampanya sınırsız bir bütçe kullanır.

{
  "campaignGoalType": enum (CampaignGoalType),
  "performanceGoal": {
    object (PerformanceGoal)
  }
}

enum (CampaignGoalType)

Zorunlu. Kampanya hedefinin türü.

object (PerformanceGoal)

Zorunlu. Kampanyanın performans hedefi.

performanceGoalType için kabul edilebilir değerler:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_OTHER

{
  "plannedSpendAmountMicros": string,
  "plannedDates": {
    object (DateRange)
  }
}

string (int64 format)

Kampanyanın belirtilen plannedDates için harcaması beklenen tutar. Bu, yayınlamayı sınırlamaz ancak DV360 kullanıcı arayüzünde harcamayı izlemek için kullanılır.

Tutar, mikro cinsindendir. 0'dan büyük veya 0'a eşit olmalıdır. Örneğin, 500000000, para biriminin 500 standart birimini temsil eder.

object (DateRange)

Zorunlu. Kampanyanın yayınlanması beklenen tarihler. Üst reklamverenin saat dilimine göre çözümlenirler.

• Burada belirtilen tarihler yayını etkilemez. Bunlar, uyarı ve uyarı oluşturmak için kullanılır. Örneğin, herhangi bir alt kampanya siparişinin yayın tarihi bu tarihlerin aralığının dışındaysa kullanıcı arayüzü bir uyarı gösterir.
• startDate zorunludur ve geçerli tarih veya daha sonrası olmalıdır.
• endDate isteğe bağlıdır. Belirtilmişse startDate veya daha sonraki bir tarih olmalıdır.
• Belirtilen herhangi bir tarih, 2037 yılından önce olmalıdır.

{
  "budgetId": string,
  "displayName": string,
  "budgetUnit": enum (BudgetUnit),
  "budgetAmountMicros": string,
  "dateRange": {
    object (DateRange)
  },
  "externalBudgetSource": enum (ExternalBudgetSource),
  "externalBudgetId": string,
  "invoiceGroupingId": string,
  "prismaConfig": {
    object (PrismaConfig)
  }
}

string (int64 format)

Kampanya bütçesinin benzersiz kimliği. Sistem tarafından atanır. Yeni bütçeler için ayarlama.

campaignBudgets adlı kampanyaya bütçe güncellerken veya bütçe eklerken dahil edilmelidir. Aksi takdirde, yeni bir kimlik oluşturulup atanır.

string

Zorunlu. Bütçenin görünen adı.

Maksimum 240 bayt boyutta UTF-8 olarak kodlanmış olmalıdır.

enum (BudgetUnit)

Zorunlu. Sabit. Bütçenin para birimi cinsinden mi yoksa gösterim cinsinden mi ölçüldüğünü belirtir.

string (int64 format)

Zorunlu. Bağlı kampanya siparişi segmentlerinin bütçelendirebileceği toplam tutar.

Tutar, mikro cinsindendir. 0'dan büyük olmalıdır. Örneğin, 500000000, para biriminin 500 standart birimini temsil eder.

object (DateRange)

Zorunlu. Kampanya bütçesinin tarih aralığı. Bağlı bütçe segmentlerinin tarih aralığı farklı olabilir. Üst reklamverenin saat dilimine göre çözümlenirler.

Hem startDate hem de endDate, 2037 yılından önce olmalıdır.

enum (ExternalBudgetSource)

Zorunlu. Bütçenin harici kaynağı.

string

Sabit. Bu bütçeyi harici kaynağa tanımlayan kimlik.

Bu alan ayarlanır ve ilgili faturalandırma profilinin fatura ayrıntı düzeyi "Bütçe düzeyi PO" olarak ayarlanırsa bu bütçeyle sunulan tüm gösterimler faturada bu kimliği içerir.

Kampanya altında benzersiz olmalıdır.

string

Sabit. Aynı faturaya dahil edilecek bütçeleri gruplandırmak için kullanılan kimlik.

Bu alan ayarlanırsa ve ilgili faturalandırma profilinin fatura düzeyi "Bütçe faturası gruplandırma kimliği" olarak ayarlanırsa aynı invoiceGroupingId öğesini paylaşan tüm externalBudgetId aynı faturada gruplandırılır.

object (PrismaConfig)

Mediaocean Prisma aracı tarafından kullanılacak ek meta veriler.

Mediaocean bütçeleri için zorunludur.

Yalnızca prismaEnabled reklamveren için geçerlidir.

{
  "prismaType": enum (PrismaType),
  "prismaCpeCode": {
    object (PrismaCpeCode)
  },
  "supplier": string
}

enum (PrismaType)

Zorunlu. Prizma türü.

object (PrismaCpeCode)

Zorunlu. Mediaocean Prisma aracından alınan ilgili müşteri, ürün ve tahmin kodları.

string

Zorunlu. Bu bütçeyi tüzel kişi (TTP, site vb.) ayırmıştır.

{
  "prismaClientCode": string,
  "prismaProductCode": string,
  "prismaEstimateCode": string
}

string

Prisma istemci kodu.

string

Prisma ürün kodu.

string

Prizma tahmin kodu.