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

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