REST Resource: advertisers

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

Display & Video 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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus)
}
फ़ील्ड
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 का इस्तेमाल करता है. इसमें जनरेट किया गया आउटपुट हमेशा Z-नॉर्मलाइज़ किया जाएगा और इसमें 0, 3, 6 या 9 फ़्रैक्शनल अंक इस्तेमाल किए जाएंगे. "Z" के अलावा, अन्य ऑफ़सेट भी स्वीकार किए जाते हैं. उदाहरण: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" या "2014-10-02T15:01:23+05:30".
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)

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

enum (EuPoliticalAdvertisingStatus)

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

अगर इस फ़ील्ड को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING पर सेट किया जाता है, तो ये बदलाव होंगे:

  • विज्ञापन देने वाले इस व्यक्ति या कंपनी के लिए बनाए गए किसी भी नए लाइन आइटम को DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING असाइन किया जाएगा. हालांकि, ऐसा तब होगा, जब कोई और वैल्यू तय न की गई हो.
  • विज्ञापन देने वाले इस व्यक्ति या कंपनी के मौजूदा लाइन आइटम में से जिन लाइन आइटम के लिए वैल्यू सेट नहीं की गई है उन्हें एक दिन के अंदर DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING पर अपडेट किया जाएगा.

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 फ़्लडलाइट कॉन्फ़िगरेशन का खाता आईडी.
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

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

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

boolean

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

boolean

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

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

AdvertiserDataAccessConfig

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

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

object (AdvertiserSdfConfig)

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

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

AdvertiserSdfConfig

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

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

boolean

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

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

object (SdfConfig)

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

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

AdvertiserTargetingConfig

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

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

boolean

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

AdvertiserBillingConfig

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

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

string (int64 format)

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

तरीके

audit

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

create

 विज्ञापन देने वाले नए व्यक्ति या कंपनी का खाता बनाता है.

delete

 विज्ञापन देने वाले व्यक्ति या कंपनी का खाता मिटाता है.

editAssignedTargetingOptions

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

get

 विज्ञापन देने वाले व्यक्ति या कंपनी की जानकारी मिलती है.

list

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

listAssignedTargetingOptions

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

patch

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