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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of mutually exclusive fields.
}
फ़ील्ड
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)

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

अगर साइज़ 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 पर लागू होता है
कस्टमर मैच ऑडियंस के शुरुआती सदस्य. यहां ऐसे फ़ील्ड की सूची दी गई है जिनमें से सिर्फ़ एक को चुना जा सकता है. जवाब में ज़्यादा से ज़्यादा एक फ़ील्ड सेट किया जाएगा:
contactInfoList

object (ContactInfoList)

सिर्फ़ इनपुट के लिए. ऑडियंस के शुरुआती सदस्यों को तय करने के लिए, संपर्क जानकारी की सूची.

सिर्फ़ audienceType CUSTOMER_MATCH_CONTACT_INFO पर लागू होता है
mobileDeviceIdList

object (MobileDeviceIdList)

सिर्फ़ इनपुट के लिए. ऑडियंस के शुरुआती सदस्यों को तय करने के लिए, मोबाइल डिवाइस आईडी की सूची.

सिर्फ़ audienceType CUSTOMER_MATCH_DEVICE_ID पर लागू होता है
एक-दूसरे से अलग फ़ील्ड के आखिर में.

ContactInfoList

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

JSON के काेड में दिखाना 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
फ़ील्ड
contactInfos[]

object (ContactInfo)

ज़रूरी नहीं. ContactInfo ऑब्जेक्ट की सूची, जिसमें कस्टमर मैच के लिए ऑडियंस के सदस्यों के बारे में जानकारी होती है. contactInfos को अलग-अलग करने के बाद, सदस्यों की संख्या 5,00,000 से ज़्यादा नहीं होनी चाहिए.
consent

object (Consent)

सिर्फ़ इनपुट के लिए. contactInfos में मौजूद उपयोगकर्ताओं के लिए सहमति मोड की सेटिंग.

इस फ़ील्ड को सेट न करने का मतलब है कि सहमति के बारे में नहीं बताया गया है.

अगर adUserData या adPersonalization फ़ील्ड को CONSENT_STATUS_DENIED पर सेट किया जाता है, तो अनुरोध में गड़बड़ी दिखेगी.

ContactInfo

कस्टमर मैच ऑडियंस सेगमेंट के सदस्य की संपर्क जानकारी.

JSON के काेड में दिखाना 
{
  "hashedEmails": [
    string
  ],
  "hashedPhoneNumbers": [
    string
  ],
  "zipCodes": [
    string
  ],
  "hashedFirstName": string,
  "hashedLastName": string,
  "countryCode": string
}
फ़ील्ड
hashedEmails[]

string

ज़रूरी नहीं. सदस्य के SHA256 हैश किए गए ईमेल की सूची. हैश करने से पहले, सभी व्हाइटस्पेस हटा दें. साथ ही, पक्का करें कि स्ट्रिंग पूरी तरह से लोअरकेस में हो.
hashedPhoneNumbers[]

string

ज़रूरी नहीं. सदस्य के SHA256 हैश किए गए फ़ोन नंबर की सूची. हैश करने से पहले, सभी फ़ोन नंबरों को E.164 फ़ॉर्मैट में फ़ॉर्मैट किया जाना चाहिए. साथ ही, उनमें देश का कॉलिंग कोड शामिल होना चाहिए.
zipCodes[]

string

ज़रूरी नहीं. सदस्य के पिन कोड की सूची.

इसे इन फ़ील्ड के साथ भी सेट किया जाना चाहिए:
hashedFirstName

string

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

इसे इन फ़ील्ड के साथ भी सेट किया जाना चाहिए:
hashedLastName

string

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

इसे इन फ़ील्ड के साथ भी सेट किया जाना चाहिए:
countryCode

string

ज़रूरी नहीं. सदस्य के देश का कोड.

इसे इन फ़ील्ड के साथ भी सेट किया जाना चाहिए:

ConsentStatus

सहमति की स्थिति.

Enums
CONSENT_STATUS_UNSPECIFIED इस वर्शन में टाइप की वैल्यू मौजूद नहीं है या इसकी जानकारी नहीं है.
CONSENT_STATUS_GRANTED सहमति दी गई है.
CONSENT_STATUS_DENIED सहमति नहीं दी गई.

MobileDeviceIdList

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

JSON के काेड में दिखाना 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
फ़ील्ड
mobileDeviceIds[]

string

ज़रूरी नहीं. मोबाइल डिवाइस आईडी की एक सूची, जिसमें कस्टमर मैच ऑडियंस के सदस्यों के बारे में बताया गया हो. mobileDeviceIds का साइज़ 5,00,000 से ज़्यादा नहीं होना चाहिए.
consent

object (Consent)

सिर्फ़ इनपुट के लिए. mobileDeviceIds में मौजूद उपयोगकर्ताओं के लिए सहमति मोड की सेटिंग.

इस फ़ील्ड को सेट न करने का मतलब है कि सहमति के बारे में नहीं बताया गया है.

अगर adUserData या adPersonalization फ़ील्ड को CONSENT_STATUS_DENIED पर सेट किया जाता है, तो अनुरोध में गड़बड़ी दिखेगी.

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 से मिला है.

तरीके

create

 यह FirstPartyAndPartnerAudience बनाता है.

editCustomerMatchMembers

 यह अनुरोध, कस्टमर मैच ऑडियंस की सदस्य सूची को अपडेट करता है.

get

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

list

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

patch

 यह मौजूदा FirstPartyAndPartnerAudience को अपडेट करता है.