REST Resource: firstAndThirdPartyAudiences

संसाधन: FirstAndतीसराPartyऑडियंस

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

जेएसओएन के काेड में दिखाना 
{
  "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)

शर्तों को पूरा करने वाले इवेंट के बाद, ऑडियंस में एंट्री के बने रहने की अवधि. अगर ऑडियंस के लिए डेटा तय करने की समयसीमा खत्म नहीं हुई है, तो इस फ़ील्ड की वैल्यू 10,000 पर सेट करें. अगर ऐसा नहीं है, तो सेट की गई वैल्यू 0 से ज़्यादा और 540 से कम या उसके बराबर होनी चाहिए.

सिर्फ़ पहले पक्ष की ऑडियंस के लिए है.

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

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

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
activeDisplayAudienceSize

string (int64 format)

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

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

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
youtubeAudienceSize

string (int64 format)

सिर्फ़ आउटपुट के लिए. YouTube नेटवर्क के लिए दर्शकों की अनुमानित संख्या.

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

सिर्फ़ पहले पक्ष की ऑडियंस के लिए है.

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
gmailAudienceSize

string (int64 format)

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

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

सिर्फ़ पहले पक्ष की ऑडियंस के लिए है.

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
displayMobileAppAudienceSize

string (int64 format)

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

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

सिर्फ़ पहले पक्ष की ऑडियंस के लिए है.

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
displayMobileWebAudienceSize

string (int64 format)

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

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

सिर्फ़ पहले पक्ष की ऑडियंस के लिए है.

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
displayDesktopAudienceSize

string (int64 format)

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

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

सिर्फ़ पहले पक्ष की ऑडियंस के लिए है.

सिर्फ़ जीईटी अनुरोध के बाद नतीजा मिला.
appId

string

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

सिर्फ़ 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

ग्राहक मिलान ऑडियंस सदस्यों को परिभाषित करने वाली संपर्क जानकारी की सूची के लिए रैपर मैसेज.

जेएसओएन के काेड में दिखाना 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ]
}
फ़ील्ड
contactInfos[]

object (ContactInfo)

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

ContactInfo

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

जेएसओएन के काेड में दिखाना 
{
  "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

सदस्य का देश कोड.

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

MobileDeviceIdList

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

जेएसओएन के काेड में दिखाना 
{
  "mobileDeviceIds": [
    string
  ]
}
फ़ील्ड
mobileDeviceIds[]

string

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

तरीके

create

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

editCustomerMatchMembers

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

get

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

list

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

patch

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