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
}
फ़ील्ड
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 को संबंधित रिपोर्टिंग और इनवॉइस भेज सके.

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,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
फ़ील्ड
cmAccountId

string (int64 format)

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

string (int64 format)

ज़रूरी है. इम्यूटेबल. DV360 विज्ञापन देने वाले से जुड़े 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 सिस्टम, क्रिएटिव टैग में इस आईडी वाला आईएएस "कैंपेन मॉनिटर" टैग जोड़ेगा.
obaComplianceDisabled

boolean

DV360 के ऑनलाइन व्यवहार के आधार पर दिखने वाले विज्ञापन (OBA) के नियमों का इस्तेमाल करना है या नहीं.

चेतावनी: OBA की सेटिंग बदलने से, कुछ विज्ञापन एक्सचेंज से आपके क्रिएटिव की ऑडिट स्थिति रीसेट हो सकती है. इसकी वजह से, जब तक उन्हें फिर से अनुमति नहीं मिल जाती, तब तक वे नहीं दिखाए जा सकेंगे.
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)

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

  • अगर overridePartnerSdfConfig की वैल्यू true है, तो इसका इस्तेमाल करना ज़रूरी है.
  • आउटपुट सिर्फ़ तब, जब overridePartnerSdfConfig false हो.

AdvertiserTargetingConfig

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

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

boolean

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

तरीके

audit

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

bulkEditAdvertiserAssignedTargetingOptions

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

bulkListAdvertiserAssignedTargetingOptions

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

create

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

delete

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

get

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

list

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

patch

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