REST Resource: advertisers

संसाधन: विज्ञापन देने वाला

Display & Video 360 (DV360) में एक विज्ञापन देने वाला.

जेएसओएन के काेड में दिखाना 
{
  "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)
  }
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले के संसाधन का नाम.
advertiserId

string (int64 format)

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

string (int64 format)

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

string

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

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

enum (EntityStatus)

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

  • ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED, और ENTITY_STATUS_SCHEDULED_FOR_DELETION वैल्यू स्वीकार की गई हैं.
  • अगर विज्ञापन देने वाले व्यक्ति या कंपनी को ENTITY_STATUS_SCHEDULED_FOR_DELETION पर सेट किया जाता है, तो उसे मिटाने के लिए पहली बार शेड्यूल किए जाने के 30 दिन बाद, उसे मिटा दिया जाएगा.
updateTime

string (Timestamp format)

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

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

object (AdvertiserGeneralConfig)

ज़रूरी है. विज्ञापन देने वाले की सामान्य सेटिंग.
adServerConfig

object (AdvertiserAdServerConfig)

ज़रूरी है. इम्यूटेबल. विज्ञापन देने वाले के विज्ञापन सर्वर से जुड़ी सेटिंग.
creativeConfig

object (AdvertiserCreativeConfig)

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

object (AdvertiserDataAccessConfig)

ऐसी सेटिंग जो विज्ञापन देने वाले के डेटा को ऐक्सेस करने के तरीके को कंट्रोल करती हैं.
integrationDetails

object (IntegrationDetails)

विज्ञापन देने वाले के इंटिग्रेशन की जानकारी. फ़िलहाल, सिर्फ़ integrationCode का इस्तेमाल विज्ञापन देने वाले के लिए किया जा सकता है. IntegrationDetails के अन्य फ़ील्ड इस्तेमाल नहीं किए जा सकते. अगर फ़ील्ड दिए गए हैं, तो उन्हें अनदेखा कर दिया जाएगा.
servingConfig

object (AdvertiserTargetingConfig)

विज्ञापन देने वाले के विज्ञापन दिखाने से जुड़ी टारगेटिंग सेटिंग.
prismaEnabled

boolean

Mediaocean (Prisma) के साथ इंटिग्रेशन चालू है या नहीं. इसे चालू करने का मतलब है कि आप इन शर्तों से सहमत हैं:

मैं अपनी कंपनी की ओर से Mediaocean (Prisma) को बजट सेगमेंट प्लान Google को भेजने की अनुमति देता/देती हूं, साथ ही मैं Google को अनुमति देता/देती हूं कि वह DV360 से इसकी रिपोर्ट और इनवॉइस, Mediaocean को भेज सकता है. इसका मकसद, विज्ञापन देने वाले के बजट की प्लानिंग, बिलिंग, और इस समस्या को ठीक करना है.
billingConfig

object (AdvertiserBillingConfig)

विज्ञापन देने वाले की बिलिंग से जुड़ी सेटिंग.

AdvertiserGeneralConfig

विज्ञापन देने वाले की सामान्य सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
फ़ील्ड
domainUrl

string

ज़रूरी है. विज्ञापन देने वाले की मुख्य वेबसाइट का डोमेन यूआरएल. सिस्टम यह जानकारी उन पब्लिशर को भेजेगा जिन्हें किसी कैंपेन को विज्ञापन देने वाले के साथ जोड़ने के लिए, वेबसाइट के यूआरएल की ज़रूरत होती है.

http: या https: से शुरू होने वाला बिना पाथ या क्वेरी स्ट्रिंग वाला यूआरएल दें. उदाहरण के लिए, http://www.example.com
timeZone

string

सिर्फ़ आउटपुट के लिए. विज्ञापन देने वाले के टाइम ज़ोन का स्टैंडर्ड TZ डेटाबेस का नाम. उदाहरण के लिए, America/New_York.

यहां ज़्यादा देखें: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

विज्ञापन देने वाले जो लोग या कंपनियां, CM360 के हाइब्रिड वर्शन से जुड़े हैं उनके लिए टाइम ज़ोन, उससे जुड़े CM360 खाते के टाइम ज़ोन जैसा ही होता है. सिर्फ़ तीसरे पक्ष के विज्ञापन देने वालों के लिए, टाइम ज़ोन और पैरंट पार्टनर का टाइम ज़ोन एक ही होता है.
currencyCode

string

ज़रूरी है. इम्यूटेबल. ISO 4217 फ़ॉर्मैट में, विज्ञापन देने वाले की मुद्रा.

स्वीकार किए जाने वाले कोड और इस्तेमाल की जाने वाली मुद्राएं ये हैं:

मुद्रा का कोड : मुद्रा का नाम

  • ARS : अर्जेंटीन पेसो
  • AUD : ऑस्ट्रेलियन डॉलर
  • BRL : ब्राज़ीलियन रियाल
  • CAD : कनेडियन डॉलर
  • CHF : स्विस फ़्रैंक
  • CLP : चिलियन पेसो
  • CNY : चाइनीज़ युआन
  • COP : कोलंबियन पेसो
  • CZK : चेक कोरुना
  • DKK : डेनिश क्रोन
  • EGP : इजिप्शन पाउंड
  • EUR : यूरो
  • GBP : ब्रिटिश पाउंड
  • HKD : हॉन्ग कॉन्ग डॉलर
  • HUF : हंगेरियन फ़ोरिंट
  • IDR : इंडोनेशियन रुपया
  • ILS : इज़रायली शेकेल
  • INR : भारतीय रुपया
  • JPY : जैपनीज़ येन
  • KRW : साउथ कोरियन वॉन
  • MXN : मेक्सिकन पेसो
  • MYR : मलेशियन रिंग्गिट
  • NGN : नाइजीरियन नैरा
  • NOK : नॉर्वेजियन क्रोना
  • NZD : न्यूज़ीलैंड डॉलर
  • PEN : पेरूवियन न्यूवो सोल
  • PLN : पोलिश ज़्लोटी
  • RON : न्यू रोमानियन ल्यू
  • RUB : रशियन रूबल
  • SEK : स्वीडिश क्रोना
  • TRY : टर्किश लीरा
  • TWD : नया ताइवान डॉलर
  • USD : अमेरिकी डॉलर
  • ZAR : साउथ अफ़्रीकन रैंड

AdvertiserAdServerConfig

विज्ञापन देने वाले की विज्ञापन सर्वर से जुड़ी सेटिंग.

जेएसओएन के काेड में दिखाना 
{

  // 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.
}
फ़ील्ड
यूनियन फ़ील्ड ad_server_config_scheme. ज़रूरी है. ad_server_config_scheme इनमें से सिर्फ़ एक हो सकती है:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

विज्ञापन देने वाली उन कंपनियों के लिए कॉन्फ़िगरेशन जो सिर्फ़ तीसरे पक्ष के विज्ञापन सर्वर का इस्तेमाल करती हैं.
cmHybridConfig

object (CmHybridConfig)

विज्ञापन देने वाली उन कंपनियों के लिए कॉन्फ़िगरेशन जो Campaign Manager 360 (CM360) और तीसरे पक्ष के विज्ञापन सर्वर, दोनों का इस्तेमाल करती हैं.

ThirdPartyOnlyConfig

विज्ञापन देने वाली उन कंपनियों के लिए सेटिंग जो सिर्फ़ तीसरे पक्ष के विज्ञापन सर्वर का इस्तेमाल करती हैं.

जेएसओएन के काेड में दिखाना 
{
  "pixelOrderIdReportingEnabled": boolean
}
फ़ील्ड
pixelOrderIdReportingEnabled

boolean

पिक्सल के लिए ऑर्डर आईडी की रिपोर्टिंग चालू है या नहीं. true पर सेट करने के बाद, इस वैल्यू को बदला नहीं जा सकता.

CmHybridConfig

विज्ञापन देने वाली ऐसी कंपनियों के लिए सेटिंग जो Campaign Manager 360 (CM360) और तीसरे पक्ष के विज्ञापन सर्वर, दोनों का इस्तेमाल करती हैं.

जेएसओएन के काेड में दिखाना 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
फ़ील्ड
cmAccountId

string (int64 format)

ज़रूरी है. इम्यूटेबल. DV360 की मदद से विज्ञापन देने वाले से लिंक किए गए CM360 Floodlight कॉन्फ़िगरेशन का खाता आईडी.
cmFloodlightConfigId

string (int64 format)

ज़रूरी है. इम्यूटेबल. DV360 ऐडवर्टाइज़र से लिंक किए गए CM360 Floodlight कॉन्फ़िगरेशन का आईडी.
cmAdvertiserIds[]

string (int64 format)

सिर्फ़ आउटपुट के लिए. CM360 विज्ञापन देने वाले के आईडी का सेट, जो CM360 Floodlight कॉन्फ़िगरेशन को शेयर करता है.
cmSyncableSiteIds[]

string (int64 format)

CM360 की उन साइटों की सूची जिनके प्लेसमेंट को DV360 के साथ क्रिएटिव के तौर पर सिंक किया जाएगा.

अगर यह advertisers.create तरीके में मौजूद नहीं है या खाली है, तो सिस्टम अपने-आप CM360 साइट बना देगा.

इस सूची से साइटों को हटाने पर, CM360 से सिंक किए गए DV360 क्रिएटिव मिट सकते हैं. कम से कम एक साइट का होना ज़रूरी है.
dv360ToCmDataSharingEnabled

boolean

CM360 डेटा ट्रांसफ़र रिपोर्ट में DV360 डेटा शामिल करना है या नहीं.
dv360ToCmCostReportingEnabled

boolean

DV360 की लागत CM360 को रिपोर्ट की जाए या नहीं.
cmFloodlightLinkingAuthorized

boolean

ज़रूरी है. इम्यूटेबल. इस फ़ील्ड को true पर सेट करने का मतलब है कि आपने अपनी कंपनी के लिए, Floodlight कॉन्फ़िगरेशन से मिली जानकारी को इस Display & Video 360 पर विज्ञापन देने वाले के साथ शेयर करने की अनुमति दी है.

AdvertiserCreativeConfig

विज्ञापन देने वाले के क्रिएटिव से जुड़ी सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
फ़ील्ड
iasClientId

string (int64 format)

Integral Ad Service (IAS) से मिलने वाली कैंपेन मॉनिटरिंग को कॉन्फ़िगर करने का आईडी. DV360 सिस्टम, क्रिएटिव टैग में इस आईडी वाले IAS "Campaign Monitor" टैग को जोड़ देगा.
obaComplianceDisabled

boolean

ऑनलाइन व्यवहार के आधार पर दिखने वाले विज्ञापन (ओबीए) और नियमों के पालन के लिए, Google की 'विज्ञापन के बारे में जानकारी' वाली सुविधा बंद करनी है या नहीं, जो आपके विज्ञापनों में बैज (विज्ञापन के तौर पर कॉन्टेंट की पहचान करने के लिए) और पारदर्शिता की जानकारी (इस विज्ञापन के बारे में जानकारी के साथ इंटरैक्शन पर) जोड़ी गई है या नहीं. इस विज्ञापन की जानकारी से, उपयोगकर्ताओं को दिखने वाले विज्ञापनों पर ज़्यादा कंट्रोल मिलता है. साथ ही, इससे आपको यह समझने में भी मदद मिलती है कि वे आपका विज्ञापन क्यों देख रहे हैं. ज़्यादा जानें.

अगर इस फ़ील्ड को true पर सेट किया जाता है, तो ध्यान रखें कि Display & Video 360 से दिखाए जाने वाले विज्ञापनों को इन शर्तों का पालन करना होगा:

  • Google Marketing Platform के साथ अपने अनुबंध के मुताबिक, ऑनलाइन व्यवहार के आधार पर दिखने वाले विज्ञापन (OBA) का पालन करना.
  • यूरोपियन इकनॉमिक एरिया (ईईए) में, उपयोगकर्ताओं के लिए, विज्ञापनों में गैर-कानूनी कॉन्टेंट की शिकायत करने का तरीका और पारदर्शिता की जानकारी शामिल करें. किसी वैकल्पिक विज्ञापन बैज, पारदर्शिता, और रिपोर्टिंग समाधान का इस्तेमाल करने पर, आपको यह पक्का करना होगा कि इसमें ज़रूरी पारदर्शिता जानकारी और गैर-कानूनी कॉन्टेंट फ़्लैग करने का तरीका शामिल हो. साथ ही, आपको सही फ़ॉर्म का इस्तेमाल करके, Google को किसी भी गैर-कानूनी कॉन्टेंट की रिपोर्ट के बारे में सूचना देनी होगी.
dynamicCreativeEnabled

boolean

विज्ञापन देने वाले व्यक्ति या कंपनी को डाइनैमिक क्रिएटिव के लिए चालू किया गया है या नहीं.
videoCreativeDataSharingAuthorized

boolean

इस फ़ील्ड को true पर सेट करने का मतलब है कि आप अपनी कंपनी की ओर से, Google को इस Display & Video 360 पर विज्ञापन देने वाले के वीडियो क्रिएटिव का इस्तेमाल करने की अनुमति देते हैं, ताकि वह विज्ञापन देने वाले के टेलिविज़न कैंपेन की रिपोर्टिंग और सुविधाएं उपलब्ध करा सके.

यह सिर्फ़ तब लागू होता है, जब विज्ञापन देने वाले के पास CM360 hybrid विज्ञापन सर्वर कॉन्फ़िगरेशन हो.

AdvertiserDataAccessConfig

ऐसी सेटिंग जो विज्ञापन देने वाले से जुड़े डेटा को ऐक्सेस करने के तरीके को कंट्रोल करती हैं.

जेएसओएन के काेड में दिखाना 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
फ़ील्ड
sdfConfig

object (AdvertiserSdfConfig)

विज्ञापन देने वाले के लिए स्ट्रक्चर्ड डेटा फ़ाइलों (एसडीएफ़) की सेटिंग.

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

AdvertiserSdfConfig

विज्ञापन देने वाले की स्ट्रक्चर्ड डेटा फ़ाइलें (एसडीएफ़) सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
फ़ील्ड
overridePartnerSdfConfig

boolean

विज्ञापन देने वाली यह कंपनी, अपने पैरंट पार्टनर के एसडीएफ़ कॉन्फ़िगरेशन को बदलती है या नहीं.

विज्ञापन देने वाले व्यक्ति या कंपनी को डिफ़ॉल्ट रूप से, पैरंट पार्टनर के एसडीएफ़ कॉन्फ़िगरेशन को असाइन किया जाता है. पार्टनर कॉन्फ़िगरेशन को बदलने के लिए, इस फ़ील्ड को true पर सेट करें और sdfConfig में नया कॉन्फ़िगरेशन दें.
sdfConfig

object (SdfConfig)

विज्ञापन देने वाले के लिए एसडीएफ़ कॉन्फ़िगरेशन.

AdvertiserTargetingConfig

विज्ञापन देने वाले के विज्ञापन दिखाने से जुड़ी टारगेटिंग सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "exemptTvFromViewabilityTargeting": boolean
}
फ़ील्ड
exemptTvFromViewabilityTargeting

boolean

विज्ञापन देने वाले के चैनल पर सभी वीडियो लाइन आइटम के लिए, कनेक्टेड टीवी डिवाइसों को विज्ञापन दिखने से जुड़े आंकड़े टारगेटिंग की छूट दी गई है या नहीं.

AdvertiserBillingConfig

विज्ञापन देने वाले की बिलिंग से जुड़ी सेटिंग.

जेएसओएन के काेड में दिखाना 
{
  "billingProfileId": string
}
फ़ील्ड
billingProfileId

string (int64 format)

विज्ञापन देने वाले को असाइन की गई बिलिंग प्रोफ़ाइल का आईडी.

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

तरीके

audit

 किसी 'विज्ञापन देने वाले' को ऑडिट करता है.

create

 नया विज्ञापन देने वाला बनाता है.

delete

 विज्ञापन देने वाले को मिटाता है.

editAssignedTargetingOptions

 किसी एक विज्ञापन देने वाले के तहत टारगेटिंग के विकल्पों में बदलाव करता है.

get

 विज्ञापन देने वाला बनाता है.

list

 यह उन विज्ञापन देने वालों की सूची बनाता है जो मौजूदा उपयोगकर्ता के लिए उपलब्ध हैं.

listAssignedTargetingOptions

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

patch

 किसी मौजूदा विज्ञापन देने वाले को अपडेट करता है.