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,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "contactInfoList": {
    object (ContactInfoList)
  },
  "mobileDeviceIdList": {
    object (MobileDeviceIdList)
  }
  // End of mutually exclusive fields.
}
ক্ষেত্র
name

string

শুধুমাত্র আউটপুট। ফার্স্ট পার্টি এবং পার্টনার অডিয়েন্সের রিসোর্স নেম।

firstPartyAndPartnerAudienceId

string ( int64 format)

শনাক্তকারী। ফার্স্ট পার্টি এবং পার্টনার অডিয়েন্সের অনন্য আইডি। সিস্টেম দ্বারা নির্ধারিত।

displayName

string

ঐচ্ছিক। ফার্স্ট পার্টি এবং পার্টনার অডিয়েন্সের প্রদর্শিত নাম।

description

string

ঐচ্ছিক। ব্যবহারকারীর দেওয়া দর্শকগোষ্ঠীর বিবরণ।

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

firstPartyAndPartnerAudienceType

enum ( FirstPartyAndPartnerAudienceType )

শুধুমাত্র আউটপুট। দর্শক প্রথম পক্ষের এবং অংশীদার দর্শক কিনা।

audienceType

enum ( AudienceType )

অপরিবর্তনীয়। শ্রোতাদের ধরণ।

audienceSource

enum ( AudienceSource )

শুধুমাত্র আউটপুট। দর্শকের উৎস।

membershipDurationDays

string ( int64 format)

ঐচ্ছিক। বাছাই পর্বের পর একটি এন্ট্রি কত দিন পর্যন্ত দর্শক তালিকায় থাকবে, তার সময়কাল (দিনে)। নির্ধারিত মান অবশ্যই ০-এর বেশি এবং ৫৪০-এর সমান বা তার কম হতে হবে।

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

নিম্নলিখিত audienceType মধ্যে কোনো একটি ব্যবহার করা হলে এই ফিল্ডটি আবশ্যক:

  • CUSTOMER_MATCH_CONTACT_INFO
  • CUSTOMER_MATCH_DEVICE_ID
displayAudienceSize

string ( int64 format)

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

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

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

activeDisplayAudienceSize

string ( int64 format)

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

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

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

youtubeAudienceSize

string ( int64 format)

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

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

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

gmailAudienceSize

string ( int64 format)

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

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

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

displayMobileAppAudienceSize

string ( int64 format)

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

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

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

displayMobileWebAudienceSize

string ( int64 format)

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

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

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

displayDesktopAudienceSize

string ( int64 format)

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

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

শুধুমাত্র ফার্স্ট পার্টি অডিয়েন্সের জন্য প্রযোজ্য।

শুধুমাত্র GET অনুরোধে ফেরত দেওয়া হয়।

appId

string

ঐচ্ছিক। অ্যাপআইডিটি আপলোড করা মোবাইল ডিভাইসআইডিগুলোর ধরনের সাথে মিলতে হবে।

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

কাস্টমার ম্যাচ অডিয়েন্সের প্রাথমিক সদস্যগণ। নিচে পারস্পরিকভাবে স্বতন্ত্র ফিল্ডগুলোর একটি তালিকা দেওয়া হলো। একটি রেসপন্সে এই ফিল্ডগুলোর মধ্যে সর্বাধিক একটি সেট করা হবে:
contactInfoList

object ( ContactInfoList )

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

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

mobileDeviceIdList

object ( MobileDeviceIdList )

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

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

পারস্পরিকভাবে বর্জনশীল ক্ষেত্রসমূহের সমাপ্তি।

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

কাস্টমার ম্যাচ অডিয়েন্স সদস্যদের পরিচয় নির্ধারণকারী যোগাযোগের তথ্যের তালিকার জন্য র‍্যাপার মেসেজ।

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

object ( ContactInfo )

ঐচ্ছিক। কাস্টমার ম্যাচ অডিয়েন্স সদস্যদের সংজ্ঞায়িত করে এমন ContactInfo অবজেক্টের একটি তালিকা। ContactInfo-গুলো বিভক্ত করার পর সদস্য সংখ্যা অবশ্যই ৫,০০,০০০-এর বেশি হবে না।

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

ঐচ্ছিক। কাস্টমার ম্যাচ অডিয়েন্স সদস্যদের পরিচয় বহনকারী মোবাইল ডিভাইস আইডিগুলোর একটি তালিকা। mobileDeviceIds-এর সংখ্যা ৫,০০,০০০-এর বেশি হতে পারবে না।

consent

object ( Consent )

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

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

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

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

ফার্স্ট পার্টি এবং পার্টনার অডিয়েন্স রিসোর্সের সম্ভাব্য প্রকারভেদ।

এনাম
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 ভিডিও, ইউটিউব বিজ্ঞাপন বা ইউটিউব চ্যানেলের সাথে পূর্ববর্তী মিথস্ক্রিয়ার উপর ভিত্তি করে দর্শকগোষ্ঠী তৈরি করা হয়েছিল।
THIRD_PARTY Audience একটি তৃতীয় পক্ষ থেকে ব্যবহারের জন্য লাইসেন্স পেয়েছে।
COMMERCE বাণিজ্যিক অংশীদারদের দ্বারা অর্থের বিনিময়ে দর্শক সরবরাহ করা হয়।
LINEAR লিনিয়ার টিভি কন্টেন্টের দর্শক।
AGENCY দর্শকবৃন্দ একটি এজেন্সি কর্তৃক সরবরাহকৃত।

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

সম্ভাব্য দর্শক উৎস।

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

পদ্ধতি

create

 একটি ফার্স্টপার্টি এবং পার্টনার অডিয়েন্স তৈরি করে।

editCustomerMatchMembers

 কাস্টমার ম্যাচ অডিয়েন্সের সদস্য তালিকা আপডেট করে।

get

 ফার্স্ট পার্টি বা পার্টনার অডিয়েন্স পায়।

list

 ফার্স্ট পার্টি এবং পার্টনার অডিয়েন্সের তালিকা দেখায়।

patch

 বিদ্যমান FirstPartyAndPartnerAudience-কে হালনাগাদ করে।