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,

  // 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

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

firstPartyAndPartnerAudienceId

string (int64 format)

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

displayName

string

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

description

string

सिर्फ़ आउटपुट के लिए. उपयोगकर्ता की ओर से दी गई ऑडियंस की जानकारी.

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

firstPartyAndPartnerAudienceType

enum (FirstPartyAndPartnerAudienceType)

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

audienceType

enum (AudienceType)

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

audienceSource

enum (AudienceSource)

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

membershipDurationDays

string (int64 format)

सिर्फ़ आउटपुट के लिए. क्वालीफ़ाइंग इवेंट के बाद, ऑडियंस में शामिल रहने की अवधि (दिनों में). अगर ऑडियंस की समयसीमा खत्म नहीं होती है, तो इस फ़ील्ड की वैल्यू को 10,000 पर सेट करें. अगर ऐसा नहीं है, तो सेट की गई वैल्यू 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 पर लागू होगा

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

object (ContactInfoList)

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

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

mobileDeviceIdList

object (MobileDeviceIdList)

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

सिर्फ़ 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 लीनियर टीवी कॉन्टेंट के लिए ऑडियंस.

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

FirstPartyAndPartnerAudience बनाता है.

editCustomerMatchMembers

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

get

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

list

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

patch

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