REST Resource: firstPartyAndPartnerAudiences

রিসোর্স: ফার্স্টপার্টিএন্ডপার্টনারঅডিয়েন্স

টার্গেট করার জন্য ব্যবহৃত একটি প্রথম বা অংশীদার শ্রোতা তালিকা বর্ণনা করে। ক্লায়েন্ট ডেটা ব্যবহারের মাধ্যমে প্রথম পক্ষের শ্রোতা তৈরি করা হয়। অংশীদার শ্রোতা তৃতীয় পক্ষের ডেটা সরবরাহকারীদের দ্বারা সরবরাহ করা হয় এবং শুধুমাত্র গ্রাহকদের জন্য লাইসেন্সপ্রাপ্ত হতে পারে।

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)

শুধুমাত্র আউটপুট। যোগ্যতা অর্জনের পরে দর্শকদের মধ্যে একটি এন্ট্রি যতদিন থাকবে ততদিনের সময়কাল। সেট মান অবশ্যই 0 এর বেশি এবং 540 এর কম বা সমান হতে হবে।

শুধুমাত্র প্রথম পক্ষের দর্শকদের জন্য প্রযোজ্য।

নিম্নলিখিত audienceType ব্যবহার করা হলে এই ক্ষেত্রটি প্রয়োজন:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। ডিসপ্লে নেটওয়ার্কের জন্য আনুমানিক দর্শকের আকার।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

activeDisplayAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। গত মাসে ডিসপ্লে নেটওয়ার্কের আনুমানিক দর্শক সংখ্যা।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

youtubeAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। YouTube নেটওয়ার্কের জন্য আনুমানিক দর্শকের আকার।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র প্রথম পক্ষের দর্শকদের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

gmailAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। Gmail নেটওয়ার্কের জন্য আনুমানিক দর্শকের আকার।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র প্রথম পক্ষের দর্শকদের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

displayMobileAppAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। ডিসপ্লে নেটওয়ার্কে আনুমানিক মোবাইল অ্যাপ দর্শকের আকার।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র প্রথম পক্ষের দর্শকদের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

displayMobileWebAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। ডিসপ্লে নেটওয়ার্কে আনুমানিক মোবাইল ওয়েব দর্শকের আকার।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র প্রথম পক্ষের দর্শকদের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

displayDesktopAudienceSize

string ( int64 format)

শুধুমাত্র আউটপুট। ডিসপ্লে নেটওয়ার্কে আনুমানিক ডেস্কটপ দর্শকের আকার।

যদি আকার ১০০০ এর কম হয়, তাহলে সংখ্যাটি লুকানো থাকবে এবং গোপনীয়তার কারণে ০ প্রদান করা হবে। অন্যথায়, সংখ্যাটি দুটি উল্লেখযোগ্য সংখ্যায় পূর্ণসংখ্যা করা হবে।

শুধুমাত্র প্রথম পক্ষের দর্শকদের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত পাঠানো হয়েছে।

appId

string

ঐচ্ছিক। অ্যাপআইডিটি আপলোড করা মোবাইল ডিভাইস আইডির ধরণের সাথে মিলে যায়।

শুধুমাত্র audienceType জন্য প্রযোজ্য প্রকার CUSTOMER_MATCH_DEVICE_ID

ইউনিয়ন ফিল্ড members । কাস্টমার ম্যাচ অডিয়েন্সের প্রাথমিক members নিম্নলিখিতগুলির মধ্যে কেবল একজন হতে পারেন:
contactInfoList

object ( ContactInfoList )

শুধুমাত্র ইনপুট। প্রাথমিক শ্রোতা সদস্যদের সংজ্ঞায়িত করার জন্য যোগাযোগের তথ্যের একটি তালিকা।

শুধুমাত্র audienceType জন্য প্রযোজ্য প্রকার CUSTOMER_MATCH_CONTACT_INFO

mobileDeviceIdList

object ( MobileDeviceIdList )

শুধুমাত্র ইনপুট। প্রাথমিক শ্রোতা সদস্যদের সংজ্ঞায়িত করার জন্য মোবাইল ডিভাইস আইডিগুলির একটি তালিকা।

শুধুমাত্র audienceType জন্য প্রযোজ্য প্রকার CUSTOMER_MATCH_DEVICE_ID

প্রথম পক্ষ এবং অংশীদারশ্রোতাপ্রকার

প্রথম পক্ষ এবং অংশীদার শ্রোতা সম্পদের সম্ভাব্য প্রকারগুলি।

এনামস
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED যখন প্রকার নির্দিষ্ট করা না থাকে বা অজানা থাকে তখন ডিফল্ট মান।
TYPE_FIRST_PARTY ক্লায়েন্ট ডেটা ব্যবহারের মাধ্যমে তৈরি করা দর্শক।
TYPE_PARTNER তৃতীয় পক্ষের ডেটা প্রদানকারীরা যে দর্শকদের তথ্য প্রদান করে।

দর্শকের ধরণ

সম্ভাব্য ধরণের দর্শক।

এনামস
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 লিনিয়ার টিভি কন্টেন্টের দর্শক।
AGENCY একটি সংস্থা কর্তৃক প্রদত্ত দর্শক।

শ্রোতা উৎস

সম্ভাব্য শ্রোতা উৎস।

এনামস
AUDIENCE_SOURCE_UNSPECIFIED যখন শ্রোতা উৎস নির্দিষ্ট করা না থাকে বা অজানা থাকে তখন ডিফল্ট মান।
DISPLAY_VIDEO_360 ডিসপ্লে এবং ভিডিও 360 থেকে উদ্ভূত।
CAMPAIGN_MANAGER ক্যাম্পেইন ম্যানেজার 360 থেকে উদ্ভূত।
AD_MANAGER গুগল অ্যাড ম্যানেজার থেকে উদ্ভূত।
SEARCH_ADS_360 Search Ads 360 থেকে উদ্ভূত।
YOUTUBE ইউটিউব থেকে উদ্ভূত।
ADS_DATA_HUB অ্যাডস ডেটা হাব থেকে উদ্ভূত।

যোগাযোগ তথ্য তালিকা

গ্রাহক ম্যাচ শ্রোতা সদস্যদের সংজ্ঞায়িত যোগাযোগের তথ্যের তালিকার জন্য মোড়ক বার্তা।

JSON উপস্থাপনা 
{
  "contactInfos": [
    {
      object (ContactInfo)
    }
  ],
  "consent": {
    object (Consent)
  }
}
ক্ষেত্র
contactInfos[]

object ( ContactInfo )

গ্রাহক ম্যাচ শ্রোতা সদস্যদের সংজ্ঞায়িত করে ContactInfo অবজেক্টের একটি তালিকা। contactInfos বিভক্ত করার পরে সদস্যদের আকার 500,000 এর বেশি হওয়া উচিত নয়।

consent

object ( Consent )

শুধুমাত্র ইনপুট। contactInfos এ থাকা ব্যবহারকারীদের জন্য সম্মতি সেটিং।

এই ক্ষেত্রটি সেট না করে রেখে দিলে বোঝা যাবে যে সম্মতি নির্দিষ্ট করা হয়নি।

যদি adUserData অথবা adPersonalization ক্ষেত্রগুলি CONSENT_STATUS_DENIED তে সেট করা থাকে, তাহলে অনুরোধটি একটি ত্রুটি ফেরত দেবে।

যোগাযোগের তথ্য

গ্রাহক ম্যাচ শ্রোতা সদস্যকে সংজ্ঞায়িত করে যোগাযোগের তথ্য।

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

সদস্যের দেশের কোড।

নিম্নলিখিত ক্ষেত্রগুলির সাথেও সেট করতে হবে:

সম্মতির স্থিতি

সম্মতির অবস্থা।

এনামস
CONSENT_STATUS_UNSPECIFIED এই সংস্করণে প্রকারের মান নির্দিষ্ট করা নেই অথবা অজানা।
CONSENT_STATUS_GRANTED সম্মতি মঞ্জুর করা হয়।
CONSENT_STATUS_DENIED সম্মতি অস্বীকার করা হচ্ছে।

মোবাইল ডিভাইস আইডি তালিকা

গ্রাহক ম্যাচ দর্শকদের সংজ্ঞায়িত করে মোবাইল ডিভাইস আইডির তালিকার জন্য র‍্যাপার বার্তা।

JSON উপস্থাপনা 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
ক্ষেত্র
mobileDeviceIds[]

string

গ্রাহক মিল শ্রোতা সদস্যদের সংজ্ঞায়িত করে এমন মোবাইল ডিভাইস আইডির একটি তালিকা। মোবাইল ডিভাইস আইডির আকার ৫০০,০০০ এর বেশি হওয়া উচিত নয়।

consent

object ( Consent )

শুধুমাত্র ইনপুট। mobileDeviceIds এ ব্যবহারকারীদের জন্য সম্মতি সেটিং।

এই ক্ষেত্রটি সেট না করে রেখে দিলে বোঝা যাবে যে সম্মতি নির্দিষ্ট করা হয়নি।

যদি adUserData অথবা adPersonalization ক্ষেত্রগুলি CONSENT_STATUS_DENIED তে সেট করা থাকে, তাহলে অনুরোধটি একটি ত্রুটি ফেরত দেবে।

পদ্ধতি

create

 একটি FirstPartyAndPartnerশ্রোতা তৈরি করে।

editCustomerMatchMembers

 গ্রাহক ম্যাচ দর্শকদের সদস্য তালিকা আপডেট করে।

get

 প্রথম পক্ষ বা অংশীদার দর্শক পায়।

list

 প্রথম পক্ষ এবং অংশীদার দর্শকদের তালিকা তৈরি করে।

patch

 একটি বিদ্যমান FirstPartyAndPartnerAudience আপডেট করে।