REST Resource: firstPartyAndPartnerAudiences

संसाधन: FirstPartyAndPartnerAudience

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

JSON के काेड में दिखाना
{
  "name": string,
  "firstPartyAndPartnerAudienceId": string,
  "displayName": string,
  "description": string,
  "firstPartyAndPartnerAudienceType": enum (FirstPartyAndPartnerAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string
}
फ़ील्ड
name

string

सिर्फ़ आउटपुट के लिए. पहले पक्ष और पार्टनर ऑडियंस के संसाधन का नाम.

firstPartyAndPartnerAudienceId

string (int64 format)

आइडेंटिफ़ायर. पहले पक्ष और पार्टनर ऑडियंस का यूनीक आईडी. सिस्टम ने असाइन किया है.

displayName

string

ज़रूरी नहीं. पहले पक्ष और पार्टनर ऑडियंस का डिसप्ले नेम.

description

string

ज़रूरी नहीं. उपयोगकर्ता ने ऑडियंस के बारे में जो जानकारी दी है.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

सिर्फ़ आउटपुट के लिए. क्या ऑडियंस, पहले पक्ष की ऑडियंस और पार्टनर ऑडियंस है.

audienceType

enum (AudienceType)

इम्यूटेबल. ऑडियंस का टाइप.

audienceSource

enum (AudienceSource)

सिर्फ़ आउटपुट के लिए. ऑडियंस का सोर्स.

membershipDurationDays

string (int64 format)

ज़रूरी नहीं. शर्त पूरी करने वाले इवेंट के बाद, ऑडियंस में कोई एंट्री कितने दिनों तक मौजूद रहती है. सेट की गई वैल्यू, 0 से ज़्यादा और 540 से कम या इसके बराबर होनी चाहिए.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

अगर इनमें से किसी एक audienceType का इस्तेमाल किया जाता है, तो यह फ़ील्ड भरना ज़रूरी है:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. Display Network के लिए अनुमानित ऑडियंस साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखेगा. ऐसा न करने पर, संख्या को दो अंकों तक राउंड ऑफ़ कर दिया जाएगा.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

activeDisplayAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. पिछले महीने, Display Network के लिए ऑडियंस का अनुमानित साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखाया जाएगा. ऐसा न करने पर, संख्या को दो अंकों तक राउंड ऑफ़ कर दिया जाएगा.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

youtubeAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. YouTube नेटवर्क के लिए अनुमानित ऑडियंस साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखाया जाएगा. ऐसा न करने पर, संख्या को दो अंकों तक राउंड ऑफ़ कर दिया जाएगा.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

gmailAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. Gmail नेटवर्क के लिए अनुमानित ऑडियंस साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखाया जाएगा. ऐसा न करने पर, संख्या को दो अंकों तक राउंड ऑफ़ कर दिया जाएगा.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

displayMobileAppAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. Display Network में, मोबाइल ऐप्लिकेशन की ऑडियंस का अनुमानित साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखाया जाएगा. ऐसा न करने पर, संख्या को दो सार्थक अंकों तक राउंड ऑफ़ कर दिया जाएगा.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

displayMobileWebAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. Display Network में, मोबाइल वेब ऑडियंस का अनुमानित साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखेगा. ऐसा न करने पर, संख्या को दो अंकों तक राउंड ऑफ़ कर दिया जाएगा.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

displayDesktopAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. Display Network में, डेस्कटॉप पर मौजूद ऑडियंस का अनुमानित साइज़.

अगर साइज़ 1,000 से कम है, तो निजता की वजहों से संख्या को छिपा दिया जाएगा और 0 दिखाया जाएगा. ऐसा न करने पर, संख्या को दो सार्थक अंकों तक राउंड ऑफ़ कर दिया जाएगा.

यह सिर्फ़ पहले पक्ष की ऑडियंस पर लागू होता है.

सिर्फ़ GET अनुरोध में दिखाया जाता है.

appId

string

ज़रूरी नहीं. appId, अपलोड किए जा रहे mobileDeviceIds के टाइप से मैच करता हो.

सिर्फ़ audienceType CUSTOMER_MATCH_DEVICE_ID पर लागू होगा

FirstPartyAndPartnerAudienceType

पहले पक्ष और पार्टनर ऑडियंस के संसाधन के संभावित टाइप.

Enums
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED यह डिफ़ॉल्ट वैल्यू तब इस्तेमाल की जाती है, जब टाइप की जानकारी न दी गई हो या उसके बारे में पता न हो.
TYPE_FIRST_PARTY क्लाइंट के डेटा का इस्तेमाल करके बनाई गई ऑडियंस.
TYPE_PARTNER डेटा उपलब्ध करवाने वाली तीसरे पक्ष की कंपनियों से मिली ऑडियंस.

AudienceType

ऑडियंस के संभावित टाइप.

Enums
AUDIENCE_TYPE_UNSPECIFIED यह डिफ़ॉल्ट वैल्यू तब इस्तेमाल की जाती है, जब टाइप की जानकारी न दी गई हो या उसके बारे में पता न हो.
CUSTOMER_MATCH_CONTACT_INFO ऑडियंस को, ग्राहकों की संपर्क जानकारी से मैच करके जनरेट किया गया था.
CUSTOMER_MATCH_DEVICE_ID ग्राहकों को जाने-पहचाने मोबाइल डिवाइस आईडी से मैच करके, ऑडियंस जनरेट की गई थी.
CUSTOMER_MATCH_USER_ID ऑडियंस को, जाने-पहचाने यूज़र आईडी से मैच करने वाले ग्राहकों के ज़रिए जनरेट किया गया था.
ACTIVITY_BASED

अब काम नहीं करता: ऑडियंस को कैंपेन की गतिविधि के आधार पर बनाया गया था.

FREQUENCY_CAP

अब इस्तेमाल नहीं किया जा सकता: ऑडियंस को, उन्हें दिखाए गए इंप्रेशन की संख्या को छोड़कर बनाया गया था.

TAG_BASED ऑडियंस को पिक्सल से जुड़े कस्टम वैरिएबल के आधार पर बनाया गया था.
YOUTUBE_USERS ऑडियंस को वीडियो, YouTube विज्ञापनों या YouTube चैनल के साथ हुए पिछले इंटरैक्शन के आधार पर बनाया गया हो.
THIRD_PARTY ऑडियंस को इस्तेमाल करने का लाइसेंस, तीसरे पक्ष से लिया गया है.
COMMERCE कॉमर्स पार्टनर, फ़ीस लेकर ऑडियंस का डेटा उपलब्ध कराते हैं.
LINEAR लीनियर टीवी कॉन्टेंट के लिए ऑडियंस.
AGENCY किसी एजेंसी से मिली ऑडियंस.

AudienceSource

संभावित ऑडियंस सोर्स.

Enums
AUDIENCE_SOURCE_UNSPECIFIED यह डिफ़ॉल्ट वैल्यू तब इस्तेमाल की जाती है, जब ऑडियंस सोर्स की जानकारी न दी गई हो या उसके बारे में पता न हो.
DISPLAY_VIDEO_360 Display & Video 360 से शुरू किया गया.
CAMPAIGN_MANAGER Campaign Manager 360 से जनरेट हुआ हो.
AD_MANAGER Google Ad Manager से शुरू किया गया हो.
SEARCH_ADS_360 Search Ads 360 से जनरेट किया गया.
YOUTUBE इसकी शुरुआत YouTube से हुई थी.
ADS_DATA_HUB Ads Data Hub से जनरेट किया गया हो.

तरीके

get

पहले पक्ष या पार्टनर ऑडियंस की जानकारी फ़ेच करता है.

list

पहले पक्ष और पार्टनर ऑडियंस की सूची दिखाता है.