- منبع: FirstAndThirdPartyAudience
- FirstAndThirdPartyAudienceType
- نوع مخاطب
- منبع مخاطب
- ContactInfoList
- اطلاعات تماس
- MobileDeviceIdList
- روش ها
منبع: FirstAndThirdPartyAudience
فهرست مخاطبان شخص اول یا ثالث را که برای هدفیابی استفاده میشود، توصیف میکند. مخاطبان شخص اول از طریق استفاده از داده های مشتری ایجاد می شوند. مخاطبان شخص ثالث توسط ارائه دهندگان داده شخص ثالث ارائه می شوند و فقط می توانند برای مشتریان مجوز بگیرند.
نمایندگی JSON |
---|
{ "name": string, "firstAndThirdPartyAudienceId": string, "displayName": string, "description": string, "firstAndThirdPartyAudienceType": enum ( |
فیلدها | |
---|---|
name | فقط خروجی نام منبع مخاطب اول و سوم. |
firstAndThirdPartyAudienceId | فقط خروجی شناسه منحصر به فرد مخاطب اول و سوم. توسط سیستم تعیین شده است. |
displayName | نام نمایشی مخاطب اول و سوم. |
description | توضیحات ارائه شده توسط کاربر از مخاطبان. فقط برای مخاطبان شخص اول قابل اجرا است. |
firstAndThirdPartyAudienceType | خواه مخاطب مخاطب اول باشد یا شخص ثالث. |
audienceType | نوع مخاطب. |
audienceSource | فقط خروجی منبع مخاطب. |
membershipDurationDays | مدت زمانی که یک ورودی پس از رویداد مقدماتی در بین مخاطبان باقی می ماند. اگر مخاطب انقضا ندارد مقدار این فیلد را 10000 قرار دهید در غیر این صورت مقدار تنظیم شده باید بزرگتر از 0 و کمتر یا مساوی 540 باشد. فقط برای مخاطبان شخص اول قابل اجرا است. اگر از یکی از
|
displayAudienceSize | فقط خروجی اندازه تخمینی مخاطبان برای شبکه نمایش. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط در درخواست GET برگردانده شد. |
activeDisplayAudienceSize | فقط خروجی اندازه تخمینی مخاطبان برای شبکه نمایش در ماه گذشته. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط در درخواست GET برگردانده شد. |
youtubeAudienceSize | فقط خروجی اندازه تخمینی مخاطب برای شبکه YouTube. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط برای مخاطبان شخص اول قابل اجرا است. فقط در درخواست GET برگردانده شد. |
gmailAudienceSize | فقط خروجی اندازه تخمینی مخاطب برای شبکه Gmail. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط برای مخاطبان شخص اول قابل اجرا است. فقط در درخواست GET برگردانده شد. |
displayMobileAppAudienceSize | فقط خروجی اندازه تخمینی مخاطبان برنامه تلفن همراه در شبکه نمایش. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط برای مخاطبان شخص اول قابل اجرا است. فقط در درخواست GET برگردانده شد. |
displayMobileWebAudienceSize | فقط خروجی تخمین اندازه مخاطبان وب تلفن همراه در شبکه نمایش. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط برای مخاطبان شخص اول قابل اجرا است. فقط در درخواست GET برگردانده شد. |
displayDesktopAudienceSize | فقط خروجی اندازه تخمینی مخاطب دسکتاپ در شبکه نمایش. اگر اندازه کمتر از 1000 باشد، به دلایل حفظ حریم خصوصی، عدد پنهان می شود و 0 برگردانده می شود. در غیر این صورت، عدد به دو رقم قابل توجه گرد می شود. فقط برای مخاطبان شخص اول قابل اجرا است. فقط در درخواست GET برگردانده شد. |
appId | appId با نوع MobileDeviceIds در حال آپلود مطابقت دارد. فقط برای |
members میدان اتحادیه اعضای اولیه مخاطبان مطابقت مشتری. members فقط می توانند یکی از موارد زیر باشند: | |
contactInfoList | فقط ورودی فهرستی از اطلاعات تماس برای تعیین مخاطبان اولیه. فقط برای |
mobileDeviceIdList | فقط ورودی فهرستی از شناسههای دستگاه تلفن همراه برای تعیین مخاطبان اولیه. فقط برای |
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 | مخاطبی که توسط ارائه دهندگان داده شخص ثالث ارائه می شود. |
نوع مخاطب
انواع احتمالی مخاطبان
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 | نوع فرعی از نوع مخاطب شخص ثالث. |
منبع مخاطب
منابع احتمالی مخاطب
Enums | |
---|---|
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 | نشات گرفته از یوتیوب. |
ADS_DATA_HUB | نشات گرفته از Ads Data Hub. |
ContactInfoList
پیام Wrapper برای لیستی از اطلاعات تماس که اعضای مخاطبان مطابقت مشتری را تعریف می کند.
نمایندگی JSON |
---|
{
"contactInfos": [
{
object ( |
فیلدها | |
---|---|
contactInfos[] | فهرستی از اشیاء ContactInfo که اعضای مخاطبان مطابقت مشتری را تعریف میکنند. اندازه اعضا پس از تقسیم contactInfos نباید بیشتر از 500000 باشد. |
اطلاعات تماس
اطلاعات تماسی که یک عضو مخاطب مطابق با مشتری را تعریف می کند.
نمایندگی JSON |
---|
{ "hashedEmails": [ string ], "hashedPhoneNumbers": [ string ], "zipCodes": [ string ], "hashedFirstName": string, "hashedLastName": string, "countryCode": string } |
فیلدها | |
---|---|
hashedEmails[] | لیستی از ایمیل های هش شده SHA256 عضو. قبل از هش کردن، تمام فضای خالی را بردارید و مطمئن شوید که رشته تماماً با حروف کوچک است. |
hashedPhoneNumbers[] | فهرستی از شماره تلفن های هش شده SHA256 عضو. قبل از هش کردن، همه شمارههای تلفن باید با فرمت E.164 قالببندی شوند و کد تماس کشور را در بر گیرند. |
zipCodes[] | لیستی از کدهای پستی اعضا. همچنین باید با فیلدهای زیر تنظیم شود: |
hashedFirstName | SHA256 نام کوچک عضو را درهم کرده است. قبل از هش کردن، تمام فضای خالی را بردارید و مطمئن شوید که رشته تماماً با حروف کوچک است. همچنین باید با فیلدهای زیر تنظیم شود: |
hashedLastName | SHA256 نام خانوادگی هش شده عضو. قبل از هش کردن، تمام فضای خالی را بردارید و مطمئن شوید که رشته تماماً با حروف کوچک است. همچنین باید با فیلدهای زیر تنظیم شود: |
countryCode | کد کشور عضو همچنین باید با فیلدهای زیر تنظیم شود: |
MobileDeviceIdList
پیام پوششی برای فهرستی از شناسههای دستگاه تلفن همراه که اعضای مخاطبان مطابقت مشتری را تعریف میکند.
نمایندگی JSON |
---|
{ "mobileDeviceIds": [ string ] } |
فیلدها | |
---|---|
mobileDeviceIds[] | فهرستی از شناسههای دستگاه تلفن همراه که اعضای مخاطبان مطابقت مشتری را تعریف میکنند. اندازه MobileDeviceIds نباید بیشتر از 500000 باشد. |
روش ها | |
---|---|
| یک مخاطب FirstAndThirdParty ایجاد می کند. |
| لیست اعضای یک مخاطب مطابقت مشتری را به روز می کند. |
| مخاطبان شخص اول و سوم را جذب می کند. |
| مخاطبان شخص اول و سوم را فهرست می کند. |
| یک مخاطب FirstAndThirdParty موجود را به روز می کند. |