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

सिर्फ़ आउटपुट के लिए. कैंपेन के संसाधन का नाम.

string (int64 format)

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले उस व्यक्ति या कंपनी का यूनीक आईडी जिससे कैंपेन जुड़ा है.

string (int64 format)

सिर्फ़ आउटपुट के लिए. कैंपेन का यूनीक आईडी. सिस्टम ने असाइन किया है.

string

ज़रूरी है. कैंपेन का डिसप्ले नेम.

यह UTF-8 कोड में बदला गया होना चाहिए और इसका साइज़ 240 बाइट से ज़्यादा नहीं होना चाहिए.

enum (EntityStatus)

ज़रूरी है. यह नीति कंट्रोल करती है कि इस कैंपेन के इंसर्शन ऑर्डर से, बजट और बिडिंग को इन्वेंट्री पर खर्च किया जा सकता है या नहीं.

• ENTITY_STATUS_ACTIVE, ENTITY_STATUS_ARCHIVED, और ENTITY_STATUS_PAUSED ही वैल्यू स्वीकार की जाती हैं.
• campaigns.create तरीके के लिए, ENTITY_STATUS_ARCHIVED की अनुमति नहीं है.

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. कैंपेन को आखिरी बार अपडेट किए जाने का टाइमस्टैंप. सिस्टम ने असाइन किया है.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

object (CampaignGoal)

ज़रूरी है. कैंपेन का लक्ष्य.

object (CampaignFlight)

ज़रूरी है. कैंपेन का तय खर्च और कुल समय.

object (FrequencyCap)

ज़रूरी है. कैंपेन की फ़्रीक्वेंसी कैप सेटिंग.

object (CampaignBudget)

इस कैंपेन के लिए उपलब्ध बजट की सूची.

अगर यह फ़ील्ड सेट नहीं है, तो कैंपेन अनलिमिटेड बजट का इस्तेमाल करता है.

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

enum (CampaignGoalType)

ज़रूरी है. कैंपेन के लक्ष्य का टाइप.

object (PerformanceGoal)

ज़रूरी है. कैंपेन की परफ़ॉर्मेंस का लक्ष्य.

performanceGoalType के लिए ये वैल्यू स्वीकार की जाती हैं:

• 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

{
  "performanceGoalType": enum (PerformanceGoalType),

  // Union field performance_goal_value can be only one of the following:
  "performanceGoalAmountMicros": string,
  "performanceGoalPercentageMicros": string,
  "performanceGoalString": string
  // End of list of possible types for union field performance_goal_value.
}

enum (PerformanceGoalType)

ज़रूरी है. परफ़ॉर्मेंस के लक्ष्य का टाइप.

string (int64 format)

लक्ष्य की रकम, विज्ञापन देने वाले की मुद्रा के माइक्रो में.

तब लागू होता है, जब performanceGoalType इनमें से एक हो:

• PERFORMANCE_GOAL_TYPE_CPM
• PERFORMANCE_GOAL_TYPE_CPC
• PERFORMANCE_GOAL_TYPE_CPA
• PERFORMANCE_GOAL_TYPE_CPIAVC
• PERFORMANCE_GOAL_TYPE_VCPM

उदाहरण के लिए, 1500000 मुद्रा की 1.5 स्टैंडर्ड यूनिट को दिखाता है.

string (int64 format)

माइक्रो में लक्ष्य प्रतिशत की दशमलव प्रदर्शन.

तब लागू होता है, जब performanceGoalType इनमें से एक हो:

• PERFORMANCE_GOAL_TYPE_CTR
• PERFORMANCE_GOAL_TYPE_VIEWABILITY
• PERFORMANCE_GOAL_TYPE_CLICK_CVR
• PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR
• PERFORMANCE_GOAL_TYPE_VTR
• PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE
• PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE

उदाहरण के लिए, 70000 का मतलब 7% है (दशमलव 0.07).

string

एक मुख्य परफ़ॉर्मेंस इंडिकेटर (केपीआई) स्ट्रिंग, जो खाली हो सकती है. UTF-8 कोड में बदला जाना चाहिए और इसमें 100 से ज़्यादा वर्ण नहीं होने चाहिए.

यह तब लागू होता है, जब performanceGoalType को PERFORMANCE_GOAL_TYPE_OTHER पर सेट किया जाता है.

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

string (int64 format)

वह रकम जिसे कैंपेन, दिए गए plannedDates के लिए खर्च कर सकता है. इससे विज्ञापन सीमित तौर पर दिखेंगे. हालांकि, इसका इस्तेमाल DV360 यूज़र इंटरफ़ेस (यूआई) में खर्च को ट्रैक करने के लिए किया जाएगा.

राशि माइक्रो में है. वैल्यू 0 से ज़्यादा या इसके बराबर होनी चाहिए. उदाहरण के लिए, 500000000 मुद्रा की 500 स्टैंडर्ड यूनिट को दिखाता है.

object (DateRange)

ज़रूरी है. वे तारीखें जिन पर कैंपेन के चलने की उम्मीद है. इनका समाधान, पैरंट विज्ञापन देने वाले के टाइम ज़ोन के हिसाब से किया जाता है.

• यहां बताई गई तारीखों से, विज्ञापन दिखाने पर कोई असर नहीं पड़ेगा. इनका इस्तेमाल, चेतावनियां और चेतावनियां जनरेट करने के लिए किया जाता है. उदाहरण के लिए, अगर किसी चाइल्ड इंसर्शन ऑर्डर की फ़्लाइट की तारीख इन तारीखों की सीमा से बाहर है, तो यूज़र इंटरफ़ेस एक चेतावनी दिखाएगा.
• startDate ज़रूरी है और यह मौजूदा या उसके बाद की तारीख होनी चाहिए.
• endDate का इस्तेमाल करना ज़रूरी नहीं है. अगर बताया गया है, तो यह startDate या उसके बाद का वर्शन होना चाहिए.
• डाली गई कोई भी तारीख, साल 2037 से पहले की होनी चाहिए.

{
  "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)

कैंपेन के बजट का यूनीक आईडी. सिस्टम ने असाइन किया है. नए बजट के लिए सेट न करें.

campaignBudgets में बजट अपडेट करते या जोड़ते समय शामिल किया जाना चाहिए. ऐसा न करने पर, एक नया आईडी जनरेट और असाइन किया जाएगा.

string

ज़रूरी है. बजट का डिसप्ले नेम.

यह UTF-8 कोड में बदला गया होना चाहिए और इसका साइज़ 240 बाइट से ज़्यादा नहीं होना चाहिए.

enum (BudgetUnit)

ज़रूरी है. इम्यूटेबल. इससे पता चलता है कि बजट को मुद्रा के हिसाब से मेज़र किया जाता है या इंप्रेशन के तौर पर.

string (int64 format)

ज़रूरी है. वह कुल रकम जिसका बजट, जोड़े गए इंसर्शन ऑर्डर के सेगमेंट से बनाया जा सकता है.

राशि माइक्रो में है. 0 से ज़्यादा होना चाहिए. उदाहरण के लिए, 500000000 मुद्रा की 500 स्टैंडर्ड यूनिट को दिखाता है.

object (DateRange)

ज़रूरी है. कैंपेन के बजट के लिए तारीख की सीमा. लिंक किए गए बजट सेगमेंट की तारीख की सीमा अलग हो सकती है. इनका समाधान, पैरंट विज्ञापन देने वाले के टाइम ज़ोन के हिसाब से किया जाता है.

startDate और endDate, दोनों, साल 2037 से पहले की होनी चाहिए.

enum (ExternalBudgetSource)

ज़रूरी है. बजट का बाहरी सोर्स.

string

इम्यूटेबल. बाहरी सोर्स को इस बजट की पहचान करने वाला आईडी.

अगर यह फ़ील्ड सेट है और इससे जुड़ी बिलिंग प्रोफ़ाइल के इनवॉइस की जानकारी का लेवल, "बजट लेवल पीओ" पर सेट है, तो इस बजट से दिखाए गए सभी इंप्रेशन के इनवॉइस में यह आईडी शामिल होगा.

कैंपेन के तहत यूनीक होना चाहिए.

string

इम्यूटेबल. बजट का ग्रुप बनाने के लिए इस्तेमाल किया जाने वाला आईडी, ताकि एक ही इनवॉइस को शामिल किया जा सके.

अगर यह फ़ील्ड सेट है और संबंधित बिलिंग प्रोफ़ाइल का इनवॉइस लेवल "बजट इनवॉइस ग्रुप आईडी" पर सेट है, तो invoiceGroupingId से जुड़े सभी externalBudgetId एक ही इनवॉइस में ग्रुप कर दिए जाएंगे.

object (PrismaConfig)

Mediaocean Prisma टूल के लिए इस्तेमाल किया जाने वाला अतिरिक्त मेटाडेटा.

Mediaocean बजट के लिए ज़रूरी है.

सिर्फ़ prismaEnabled विज्ञापन देने वालों पर लागू होता है.

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

enum (PrismaType)

ज़रूरी है. Prisma का टाइप.

object (PrismaCpeCode)

ज़रूरी है. Mediaocean Prisma टूल से, काम के क्लाइंट, प्रॉडक्ट, और अनुमान कोड.

string

ज़रूरी है. इस बजट को तय की गई इकाई (डीएसपी, साइट वगैरह).

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

string

Prisma का क्लाइंट कोड.

string

Prisma का प्रॉडक्ट कोड.

string

Prisma का अनुमान कोड.