REST Resource: firstAndThirdPartyAudiences

संसाधन: FirstAndrdPartyऑडियंस

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

जेएसओएन के काेड में दिखाना 
{
  "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 के लिए ऑडियंस का अनुमानित साइज़.

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
activeDisplayAudienceSize

string (int64 format)

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

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
youtubeAudienceSize

string (int64 format)

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

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

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
gmailAudienceSize

string (int64 format)

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

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

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
displayMobileAppAudienceSize

string (int64 format)

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

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

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
displayMobileWebAudienceSize

string (int64 format)

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

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

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
displayDesktopAudienceSize

string (int64 format)

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

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

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

सिर्फ़ जीईटी अनुरोध में लौटाया गया.
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

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

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

object (ContactInfo)

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

object (Consent)

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

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

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

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

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

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

ConsentStatus

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

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

MobileDeviceIdList

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

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

string

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

object (Consent)

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

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

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

तरीके

create

 FirstAndrdPartyऑडियंस बनाता है.

editCustomerMatchMembers

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

get

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

list

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

patch

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