REST Resource: firstPartyAndPartnerAudiences

Resource: 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
}
فیلدها
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)

فقط خروجی. اندازه تخمینی مخاطب برای شبکه 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

اختیاری. appId با نوع mobileDeviceIds که بارگذاری می‌شود مطابقت دارد.

فقط برای audienceType CUSTOMER_MATCH_DEVICE_ID قابل‌اعمال است

FirstPartyAndPartnerAudienceType

انواع احتمالی منبع مخاطب شریک و طرف اول.

شمارشی‌ها
FIRST_PARTY_AND_PARTNER_AUDIENCE_TYPE_UNSPECIFIED مقدار پیش‌فرض وقتی نوع مشخص نشده یا ناشناخته است.
TYPE_FIRST_PARTY مخاطبی که ازطریق استفاده از داده‌های کارخواه ایجاد شده است.
TYPE_PARTNER مخاطبی که توسط ارائه‌دهندگان داده شخص ثالث ارائه می‌شود.

AudienceType

انواع احتمالی مخاطبان.

شمارشی‌ها
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 مخاطبان ارائه‌شده توسط آژانس تبلیغاتی.

AudienceSource

منابع مخاطبان احتمالی.

شمارشی‌ها
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 منشأ گرفته است.

روش‌ها

get

 مخاطب شخص اول یا شریک را دریافت می‌کند.

list

 مخاطبان طرف اول و شریک را فهرست می‌کند.