REST Resource: firstAndThirdPartyAudiences

संसाधन: FirstAndThirdPartyAudience

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

JSON के काेड में दिखाना 
{
  "name": string,
  "firstAndThirdPartyAudienceId": string,
  "displayName": string,
  "description": string,
  "firstAndThirdPartyAudienceType": enum (FirstAndThirdPartyAudienceType),
  "audienceType": enum (AudienceType),
  "audienceSource": enum (AudienceSource),
  "membershipDurationDays": string,
  "displayAudienceSize": string,
  "activeDisplayAudienceSize": string,
  "youtubeAudienceSize": string,
  "gmailAudienceSize": string,
  "displayMobileAppAudienceSize": string,
  "displayMobileWebAudienceSize": string,
  "displayDesktopAudienceSize": string,
  "appId": string,

  // Union field members can be only one of the following:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of list of possible types for union field members.
}
फ़ील्ड
name

string

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

string (int64 format)

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

string

पहले और तीसरे पक्ष की ऑडियंस का डिसप्ले नेम.
description

string

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

यह सुविधा सिर्फ़ पहले पक्ष की ऑडियंस के लिए उपलब्ध है.
firstAndThirdPartyAudienceType

enum (FirstAndThirdPartyAudienceType)

ऑडियंस, पहले या तीसरे पक्ष की ऑडियंस है या नहीं.
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)

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

अगर साइज़ 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)

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

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

यह सुविधा सिर्फ़ पहले पक्ष की ऑडियंस के लिए उपलब्ध है.

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

string (int64 format)

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

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

यह सुविधा सिर्फ़ पहले पक्ष की ऑडियंस के लिए उपलब्ध है.

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

string (int64 format)

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

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

यह सुविधा सिर्फ़ पहले पक्ष की ऑडियंस के लिए उपलब्ध है.

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

string

appId, अपलोड किए जा रहे mobileDeviceIds के टाइप से मेल खाता हो.

सिर्फ़ audienceType CUSTOMER_MATCH_DEVICE_ID पर लागू होगा
यूनियन फ़ील्ड members. कस्टमर मैच ऑडियंस के शुरुआती सदस्य. members इनमें से सिर्फ़ एक हो सकता है:
contactInfoList

object (ContactInfoList)

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

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

object (MobileDeviceIdList)

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

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

FirstAndThirdPartyAudienceType

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

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

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 चैनल के साथ हुए पिछले इंटरैक्शन के आधार पर बनाया गया था.
LICENSED तीसरे पक्ष की ऑडियंस टाइप का सबटाइप.

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

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 पर सेट किया जाता है, तो अनुरोध में गड़बड़ी दिखेगी.

तरीके

create

 यह फ़ंक्शन, FirstAndThirdPartyAudience बनाता है.

editCustomerMatchMembers

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

get

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

list

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

patch

 इस तरीके का इस्तेमाल करके, किसी मौजूदा FirstAndThirdPartyAudience को अपडेट किया जा सकता है.