REST Resource: advertisers

संसाधन: विज्ञापन देने वाले व्यक्ति या कंपनी

Display &Video 360 में, विज्ञापन देने वाला एक व्यक्ति वीडियो 360 (DV360).

JSON के काेड में दिखाना
{
  "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)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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

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

JSON के काेड में दिखाना
{
  "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

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

JSON के काेड में दिखाना
{

  // 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

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

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

boolean

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

CmHybridConfig

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

JSON के काेड में दिखाना
{
  "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 खाते के साथ शेयर करने की अनुमति दी है वीडियो 360 की मदद से विज्ञापन देने वाला.

AdvertiserCreativeConfig

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

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

string (int64 format)

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

obaComplianceDisabled

boolean

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

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

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

boolean

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

videoCreativeDataSharingAuthorized

boolean

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

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

AdvertiserDataAccessConfig

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

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

object (AdvertiserSdfConfig)

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

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

AdvertiserSdfConfig

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

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

boolean

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

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

sdfConfig

object (SdfConfig)

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

AdvertiserTargetingConfig

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

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

boolean

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

AdvertiserBillingConfig

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

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

string (int64 format)

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

तरीके

audit

ऐडवर्टाइज़र खाते का ऑडिट करता है.

create

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

delete

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

editAssignedTargetingOptions

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

get

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

list

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

listAssignedTargetingOptions

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

patch

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