REST Resource: firstAndThirdPartyAudiences

रिसॉर्स: FirstAndFirstPartyAudience

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

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)

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

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

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string (int64 format)

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

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

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

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

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

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

displayMobileWebAudienceSize

string (int64 format)

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

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

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

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

displayDesktopAudienceSize

string (int64 format)

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

अगर साइज़ 1,000 से कम है, तो नंबर छिपा दिया जाएगा. साथ ही, निजता को ध्यान में रखते हुए 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 &से शुरू हुए वीडियो 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 ऑब्जेक्ट की सूची. contactInfo के बंटवारे के बाद सदस्यों की संख्या 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

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

editCustomerMatchMembers

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

get

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

list

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

patch

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