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)

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

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

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

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID

displayAudienceSize

string ( int64 format)

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

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

শুধুমাত্র GET অনুরোধে ফিরে এসেছে।

activeDisplayAudienceSize

string ( int64 format)

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

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

শুধুমাত্র GET অনুরোধে ফিরে এসেছে।

youtubeAudienceSize

string ( int64 format)

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

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

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

শুধুমাত্র GET অনুরোধে ফিরে এসেছে।

gmailAudienceSize

string ( int64 format)

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

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

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

শুধুমাত্র GET অনুরোধে ফিরে এসেছে।

displayMobileAppAudienceSize

string ( int64 format)

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

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

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

শুধুমাত্র GET অনুরোধে ফিরে এসেছে।

displayMobileWebAudienceSize

string ( int64 format)

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

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

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

শুধুমাত্র GET অনুরোধে ফিরে এসেছে।

displayDesktopAudienceSize

string ( int64 format)

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

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

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

শুধুমাত্র 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 এর জন্য প্রযোজ্য৷

ফার্স্টপার্টি এবং পার্টনার অডিয়েন্স টাইপ

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

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

দর্শকের ধরন

সম্ভাব্য ধরনের শ্রোতা।

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 লিনিয়ার টিভি বিষয়বস্তুর জন্য দর্শক।

অডিয়েন্স সোর্স

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

Enums
AUDIENCE_SOURCE_UNSPECIFIED ডিফল্ট মান যখন শ্রোতা উৎস নির্দিষ্ট করা হয় না বা অজানা হয়।
DISPLAY_VIDEO_360 Display & Video 360 থেকে উদ্ভূত।
CAMPAIGN_MANAGER ক্যাম্পেইন ম্যানেজার 360 থেকে উদ্ভূত।
AD_MANAGER গুগল অ্যাড ম্যানেজার থেকে উদ্ভূত।
SEARCH_ADS_360 অনুসন্ধান বিজ্ঞাপন 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

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

এছাড়াও নিম্নলিখিত ক্ষেত্রগুলির সাথে সেট করা আবশ্যক:

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

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

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

মোবাইলডিভাইসআইডিলিস্ট

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

JSON প্রতিনিধিত্ব 
{
  "mobileDeviceIds": [
    string
  ],
  "consent": {
    object (Consent)
  }
}
ক্ষেত্র
mobileDeviceIds[]

string

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

consent

object ( Consent )

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

এই ক্ষেত্রটি সেট না করে রেখে যাওয়া ইঙ্গিত দেয় যে সম্মতি নির্দিষ্ট করা নেই।

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

পদ্ধতি

create

 একটি FirstPartyAndPartnerAudience তৈরি করে।

editCustomerMatchMembers

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

get

 একটি প্রথম পক্ষ বা অংশীদার দর্শক পায়.

list

 প্রথম পক্ষ এবং অংশীদার শ্রোতাদের তালিকা করুন৷

patch

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