- منبع: آگهی
- FinalAppUrl
- AppUrlOperatingSystemType
- پارامتر سفارشی
- نوع تبلیغ
- دستگاه
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- تصویر کوچک ویدیو
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- Asset PerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- لیست وب سایت
- TextList
- DestinationTextList
- عدم تطابق مقصد
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintList
- کشور محدودیت
- محدودیت Reseller
- PolicyReviewStatus
- وضعیت تأیید سیاست
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- TravelAdInfo
- مواد و روش ها
منبع: آگهی
آگهی.
نمایندگی JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
زمینه های | |
---|---|
resourceName | تغییرناپذیر. نام منبع آگهی نام منابع آگهی به شکل زیر است: |
finalUrls[] | لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ. |
finalAppUrls[] | فهرستی از نشانیهای اینترنتی نهایی برنامه که در صورت نصب برنامه خاص در تلفن همراه استفاده میشوند. |
finalMobileUrls[] | فهرست آدرسهای اینترنتی نهایی تلفن همراه پس از همه تغییر مسیرهای بین دامنهای برای آگهی. |
urlCustomParameters[] | فهرست نگاشت هایی که می توان برای جایگزینی برچسب های پارامتر سفارشی در |
type | فقط خروجی نوع تبلیغ. |
devicePreference | اولویت دستگاه برای آگهی. شما فقط می توانید یک اولویت را برای دستگاه های تلفن همراه مشخص کنید. وقتی این تنظیمات برگزیده تنظیم شود، وقتی در دستگاه تلفن همراه نمایش داده می شود، تبلیغ نسبت به سایر تبلیغات ترجیح داده می شود. برای مثال، اگر تبلیغات دیگری در دسترس نباشد، همچنان میتوان این تبلیغ را در انواع دستگاههای دیگر نمایش داد. اگر مشخص نباشد (بدون اولویت دستگاه)، همه دستگاهها هدف قرار میگیرند. این فقط توسط برخی از انواع تبلیغات پشتیبانی می شود. |
urlCollections[] | نشانیهای اینترنتی اضافی برای آگهی که با یک شناسه منحصربهفرد برچسبگذاری شدهاند که میتواند از فیلدهای دیگر در آگهی ارجاع داده شود. |
systemManagedResourceSource | فقط خروجی اگر این تبلیغ توسط سیستم مدیریت شود، این قسمت منبع را نشان می دهد. این فیلد فقط خواندنی است. |
id | فقط خروجی شناسه آگهی |
trackingUrlTemplate | الگوی URL برای ساخت URL ردیابی. |
finalUrlSuffix | پسوندی که هنگام ساخت URL نهایی استفاده می شود. |
displayUrl | نشانی اینترنتی که در توضیحات آگهی برای برخی از قالبهای تبلیغاتی ظاهر میشود. |
addedByGoogleAds | فقط خروجی نشان می دهد که آیا این تبلیغ به طور خودکار توسط Google Ads اضافه شده است یا نه توسط یک کاربر. به عنوان مثال، این ممکن است زمانی اتفاق بیفتد که تبلیغات به صورت خودکار به عنوان پیشنهادی برای تبلیغات جدید بر اساس آگاهی از نحوه عملکرد تبلیغات موجود ایجاد شود. |
name | تغییرناپذیر. نام آگهی. این فقط برای شناسایی آگهی استفاده می شود. نیازی نیست منحصر به فرد باشد و بر تبلیغ ارائه شده تأثیری ندارد. فیلد نام در حال حاضر فقط برای DisplayUploadAd، ImageAd، ShoppingComparisonListingAd و VideoAd پشتیبانی می شود. |
ad_data فیلد اتحادیه. جزئیات مربوط به نوع تبلیغ دقیقاً یک مقدار باید تنظیم شود. ad_data فقط می تواند یکی از موارد زیر باشد: | |
textAd | تغییرناپذیر. جزئیات مربوط به تبلیغات متنی |
expandedTextAd | جزئیات مربوط به یک آگهی متنی گسترده. |
callAd | جزئیات مربوط به آگهی تماس. |
expandedDynamicSearchAd | تغییرناپذیر. جزئیات مربوط به تبلیغ جستجوی پویا گسترده. این نوع آگهی دارای سرفصل، نشانیهای اینترنتی نهایی و نشانی اینترنتی نمایشی است که در زمان ارائه براساس اطلاعات خاص نام دامنه ارائهشده توسط |
hotelAd | جزئیات مربوط به آگهی هتل |
shoppingSmartAd | جزئیات مربوط به آگهی خرید هوشمند. |
shoppingProductAd | جزئیات مربوط به تبلیغ محصول خرید. |
imageAd | تغییرناپذیر. جزئیات مربوط به یک تبلیغ تصویری. |
videoAd | جزئیات مربوط به یک تبلیغ ویدیویی. |
videoResponsiveAd | جزئیات مربوط به یک تبلیغ پاسخگو ویدیویی. |
responsiveSearchAd | جزئیات مربوط به یک تبلیغ جستجوی واکنشگرا. |
legacyResponsiveDisplayAd | جزئیات مربوط به یک تبلیغ نمایشی پاسخگو قدیمی. |
appAd | جزئیات مربوط به تبلیغ اپلیکیشن |
legacyAppInstallAd | تغییرناپذیر. جزئیات مربوط به آگهی نصب برنامه قدیمی. |
responsiveDisplayAd | جزئیات مربوط به یک تبلیغ نمایشی واکنشگرا. |
localAd | جزئیات مربوط به یک آگهی محلی |
displayUploadAd | جزئیات مربوط به آگهی آپلود نمایشی. |
appEngagementAd | جزئیات مربوط به تبلیغ تعامل با برنامه. |
shoppingComparisonListingAd | جزئیات مربوط به آگهی فهرست مقایسه خرید. |
smartCampaignAd | جزئیات مربوط به تبلیغات کمپین هوشمند. |
appPreRegistrationAd | جزئیات مربوط به آگهی پیش ثبت نام برنامه. |
discoveryMultiAssetAd | جزئیات مربوط به آگهی چند دارایی اکتشافی. |
discoveryCarouselAd | جزئیات مربوط به آگهی چرخ و فلک اکتشافی. |
discoveryVideoResponsiveAd | جزئیات مربوط به یک تبلیغ پاسخگو ویدیوی اکتشافی. |
travelAd | جزئیات مربوط به آگهی سفر. |
FinalAppUrl
URL برای پیوند عمیق به یک برنامه برای سیستم عامل داده شده.
نمایندگی JSON |
---|
{
"osType": enum ( |
زمینه های | |
---|---|
osType | سیستم عامل هدف این URL. ضروری. |
url | URL پیوند عمیق برنامه. پیوندهای عمیق مکانی را در برنامه مشخص می کنند که با محتوایی که می خواهید نشان دهید مطابقت دارد و باید به شکل {scheme}://{host_path} باشد. این طرح مشخص می کند که کدام برنامه باز شود. برای برنامه خود، می توانید از یک طرح سفارشی استفاده کنید که با نام برنامه شروع می شود. میزبان و مسیر مکان منحصر به فرد را در برنامه ای که محتوای شما در آن وجود دارد مشخص می کند. مثال: "exampleapp://productid_1234". ضروری. |
AppUrlOperatingSystemType
سیستم عامل
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
IOS | سیستم عامل Apple IOS. |
ANDROID | سیستم عامل اندروید. |
پارامتر سفارشی
نقشهبرداری که میتواند توسط برچسبهای پارامتر سفارشی در trackingUrlTemplate
، finalUrls
یا mobile_final_urls
استفاده شود.
نمایندگی JSON |
---|
{ "key": string, "value": string } |
زمینه های | |
---|---|
key | کلید مطابق با نام تگ پارامتر. |
value | مقداری که باید جایگزین شود. |
نوع تبلیغ
انواع احتمالی یک آگهی
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
TEXT_AD | آگهی یک تبلیغ متنی است. |
EXPANDED_TEXT_AD | آگهی یک تبلیغ متنی گسترده است. |
EXPANDED_DYNAMIC_SEARCH_AD | تبلیغ یک تبلیغ جستجوی پویا گسترده است. |
HOTEL_AD | آگهی آگهی هتل است. |
SHOPPING_SMART_AD | این تبلیغ یک آگهی خرید هوشمند است. |
SHOPPING_PRODUCT_AD | آگهی یک آگهی خرید استاندارد است. |
VIDEO_AD | تبلیغ یک تبلیغ ویدیویی است. |
IMAGE_AD | این تبلیغ یک تبلیغ تصویری است. |
RESPONSIVE_SEARCH_AD | آگهی یک آگهی جستجوی واکنشگرا است. |
LEGACY_RESPONSIVE_DISPLAY_AD | این تبلیغ یک تبلیغ نمایشی پاسخگو قدیمی است. |
APP_AD | تبلیغ یک تبلیغ اپلیکیشن است. |
LEGACY_APP_INSTALL_AD | این تبلیغ یک تبلیغ نصب برنامه قدیمی است. |
RESPONSIVE_DISPLAY_AD | تبلیغ یک تبلیغ نمایشی واکنش گرا است. |
LOCAL_AD | آگهی یک آگهی محلی است. |
HTML5_UPLOAD_AD | این تبلیغ یک آگهی آپلود نمایشی با نوع محصول HTML5_UPLOAD_AD است. |
DYNAMIC_HTML5_AD | این تبلیغ یک آگهی آپلود نمایشی با یکی از انواع محصول DYNAMIC_HTML5_* است. |
APP_ENGAGEMENT_AD | تبلیغ یک تبلیغ تعامل با اپلیکیشن است. |
SHOPPING_COMPARISON_LISTING_AD | این آگهی یک آگهی فهرست مقایسه خرید است. |
VIDEO_BUMPER_AD | تبلیغ ویدیویی بامپر. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD | تبلیغ ویدیویی غیرقابل رد شدن در جریان. |
VIDEO_OUTSTREAM_AD | تبلیغ ویدیویی خارج از جریان |
VIDEO_TRUEVIEW_IN_STREAM_AD | تبلیغ ویدیویی TrueView در جریان. |
VIDEO_RESPONSIVE_AD | تبلیغ ویدئویی واکنشگرا |
SMART_CAMPAIGN_AD | تبلیغات کمپین هوشمند |
CALL_AD | آگهی تماس بگیرید. |
APP_PRE_REGISTRATION_AD | آگهی پیش ثبت نام جهانی برنامه. |
IN_FEED_VIDEO_AD | تبلیغ ویدیویی درون فید. |
DISCOVERY_MULTI_ASSET_AD | تبلیغ چند دارایی Discovery. |
DISCOVERY_CAROUSEL_AD | تبلیغ چرخ فلک کشف. |
TRAVEL_AD | آگهی سفر. |
DISCOVERY_VIDEO_RESPONSIVE_AD | تبلیغ پاسخگو ویدیوی اکتشافی. |
دستگاه
دستگاههای Google Ads را برای هدفیابی برمیشمارد.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | مقدار در این نسخه ناشناخته است. |
MOBILE | دستگاه های تلفن همراه با مرورگرهای کامل. |
TABLET | تبلت با مرورگر کامل |
DESKTOP | کامپیوترها |
CONNECTED_TV | تلویزیون های هوشمند و کنسول های بازی. |
OTHER | انواع دستگاه های دیگر |
UrlCollection
مجموعه ای از آدرس های اینترنتی که با یک شناسه منحصر به فرد برچسب گذاری شده است.
نمایندگی JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
زمینه های | |
---|---|
finalUrls[] | لیستی از URL های نهایی ممکن |
finalMobileUrls[] | فهرستی از URL های نهایی ممکن موبایل. |
urlCollectionId | شناسه منحصر به فرد برای این نمونه UrlCollection. |
trackingUrlTemplate | الگوی URL برای ساخت URL ردیابی. |
SystemManagedResourceSource
فهرستی که منابع موجودیت مدیریت شده احتمالی سیستم را فهرست می کند.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
AD_VARIATIONS | آگهی آزمایشی تغییرات تبلیغاتی ایجاد شده. |
TextAdInfo
یک تبلیغ متنی
نمایندگی JSON |
---|
{ "headline": string, "description1": string, "description2": string } |
زمینه های | |
---|---|
headline | تیتر آگهی. |
description1 | خط اول توضیحات آگهی. |
description2 | خط دوم توضیحات آگهی. |
ExpandedTextAdInfo
یک تبلیغ متنی گسترده
نمایندگی JSON |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
زمینه های | |
---|---|
headlinePart1 | قسمت اول تیتر آگهی. |
headlinePart2 | قسمت دوم تیتر آگهی. |
headlinePart3 | قسمت سوم تیتر آگهی. |
description | توضیحات آگهی |
description2 | شرح دوم آگهی. |
path1 | متنی که می تواند در کنار URL نمایش داده شده تبلیغ ظاهر شود. |
path2 | متن اضافی که می تواند در کنار URL نمایش داده شده آگهی ظاهر شود. |
CallAdInfo
تبلیغ تماس
نمایندگی JSON |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
زمینه های | |
---|---|
countryCode | کد کشور در آگهی |
phoneNumber | شماره تلفن در آگهی |
businessName | نام تجاری در آگهی |
headline1 | تیتر اول آگهی |
headline2 | عنوان دوم در آگهی |
description1 | خط اول توضیحات آگهی. |
description2 | خط دوم توضیحات آگهی. |
callTracked | فعال کردن ردیابی تماس برای خلاق. فعال کردن ردیابی تماس، تبدیل تماس را نیز فعال می کند. |
disableCallConversion | غیرفعال کردن تبدیل تماس برای خلاق. اگر روی |
phoneNumberVerificationUrl | URL مورد استفاده برای تأیید شماره تلفن. |
conversionAction | عمل تبدیل برای نسبت دادن تبدیل تماس به. اگر تنظیم نشده باشد، از یک اقدام تبدیل پیشفرض استفاده میشود. این فیلد فقط در صورتی تأثیر دارد که |
conversionReportingState | رفتار تبدیل تماس این تبلیغ تماس. میتواند از تنظیمات تبدیل تماس خود استفاده کند، تنظیمات سطح حساب را به ارث برده یا غیرفعال شود. |
path1 | قسمت اول متنی که می توان به URL موجود در آگهی اضافه کرد. اختیاری. |
path2 | قسمت دوم متن که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که |
CallConversionReportingState
انواع داده های احتمالی برای وضعیت اقدام تبدیل تماس.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
DISABLED | اقدام تبدیل تماس غیرفعال است. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION | اقدام تبدیل تماس از نوع تبدیل تماس تنظیم شده در سطح حساب استفاده می کند. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION | اقدام تبدیل تماس از نوع تبدیل تماس تنظیم شده در سطح منبع (فقط تبلیغات/افزونههای تماس) استفاده میکند. |
ExpandedDynamicSearchAdInfo
یک تبلیغ جستجوی پویا گسترده
نمایندگی JSON |
---|
{ "description": string, "description2": string } |
زمینه های | |
---|---|
description | توضیحات آگهی |
description2 | شرح دوم آگهی. |
HotelAdInfo
این نوع هیچ فیلدی ندارد.
آگهی هتل
ShoppingSmartAdInfo
این نوع هیچ فیلدی ندارد.
یک آگهی خرید هوشمند
ShoppingProductAdInfo
این نوع هیچ فیلدی ندارد.
یک آگهی خرید استاندارد
ImageAdInfo
یک تبلیغ تصویری
نمایندگی JSON |
---|
{ "mimeType": enum ( |
زمینه های | |
---|---|
mimeType | نوع میم تصویر. |
pixelWidth | عرض تصویر بر حسب پیکسل. |
pixelHeight | ارتفاع تصویر در اندازه کامل بر حسب پیکسل. |
imageUrl | URL تصویر در اندازه کامل. |
previewPixelWidth | عرض تصویر اندازه پیش نمایش بر حسب پیکسل. |
previewPixelHeight | ارتفاع تصویر اندازه پیش نمایش بر حسب پیکسل. |
previewImageUrl | URL تصویر اندازه پیش نمایش. |
name | نام تصویر. اگر تصویر از یک MediaFile ایجاد شده است، این نام MediaFile است. اگر تصویر از بایت ایجاد شده باشد، خالی است. |
image میدان اتحادیه تصویری که از آن ImageAd ایجاد می شود. این را می توان به یکی از دو روش مشخص کرد. 1. یک منبع MediaFile موجود. 2. داده های تصویر خام به صورت بایت. image می تواند تنها یکی از موارد زیر باشد: | |
imageAsset | دارایی های تصویری مورد استفاده برای تبلیغ. |
data | داده های تصویر خام به صورت بایت رشته ای با کد base64. |
adIdToCopyImageFrom | شناسه آگهی برای کپی کردن تصویر. |
MimeType
نوع میم
Enums | |
---|---|
UNSPECIFIED | نوع mime مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
IMAGE_JPEG | نوع MIME تصویر/jpeg. |
IMAGE_GIF | نوع MIME تصویر/گیف. |
IMAGE_PNG | نوع MIME تصویر/png. |
FLASH | نوع MIME برنامه/x-shockwave-flash. |
TEXT_HTML | نوع MIME متن/html. |
PDF | نوع MIME برنامه/pdf. |
MSWORD | نوع MIME برنامه/msword. |
MSEXCEL | نوع MIME برنامه/vnd.ms-excel. |
RTF | نوع MIME برنامه/rtf. |
AUDIO_WAV | نوع MIME صدا/wav. |
AUDIO_MP3 | نوع MIME صدا/mp3. |
HTML5_AD_ZIP | نوع MIME برنامه/x-html5-ad-zip. |
AdImageAsset
دارایی تصویری که در یک آگهی استفاده می شود.
نمایندگی JSON |
---|
{ "asset": string } |
زمینه های | |
---|---|
asset | نام منبع دارایی این تصویر. |
VideoAdInfo
یک تبلیغ ویدیویی
نمایندگی JSON |
---|
{ "video": { object ( |
زمینه های | |
---|---|
video | دارایی های ویدیوی YouTube که برای تبلیغ استفاده می شود. |
format فیلد اتحادیه طرح فرمت خاص برای فرمت های مختلف ویدئویی. format فقط می تواند یکی از موارد زیر باشد: | |
inStream | قالب تبلیغ ویدیویی TrueView در جریان. |
bumper | باپر ویدیویی قالب تبلیغ در جریان. |
outStream | فرمت تبلیغ ویدیویی خارج از جریان. |
nonSkippable | فرمت تبلیغات درون جریانی ویدیویی غیرقابل رد شدن. |
inFeed | قالب تبلیغات ویدیویی درون فید. |
AdVideoAsset
دارایی ویدیویی که در آگهی استفاده می شود.
نمایندگی JSON |
---|
{ "asset": string } |
زمینه های | |
---|---|
asset | نام منبع دارایی این ویدیو. |
VideoTrueViewInStreamAdInfo
نمایش فرمت تبلیغ ویدیویی TrueView در جریان (آگهی در حین پخش ویدیو، اغلب در ابتدا نشان داده می شود، که دکمه پرش را چند ثانیه بعد از ویدیو نشان می دهد).
نمایندگی JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
زمینه های | |
---|---|
actionButtonLabel | برچسب روی دکمه CTA (Call-to-Action) کاربر را به URL نهایی تبلیغ ویدیویی می برد. برای کمپین های اکشن TrueView مورد نیاز است، در غیر این صورت اختیاری است. |
actionHeadline | متن اضافی با دکمه CTA (Call-to-Action) نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند. |
companionBanner | دارایی های تصویری بنر همراه استفاده شده با آگهی. |
VideoBumperInStreamAdInfo
نمایش فرمت آگهی ویدیویی بامپر در جریان (تبلیغ ویدیویی بسیار کوتاه و غیرقابل رد شدن در جریان).
نمایندگی JSON |
---|
{
"companionBanner": {
object ( |
زمینه های | |
---|---|
companionBanner | دارایی های تصویری بنر همراه استفاده شده با آگهی. |
actionButtonLabel | برچسب روی دکمه «Call To Action» کاربر را به نشانی اینترنتی نهایی آگهی ویدیویی می برد. |
actionHeadline | متن اضافی با دکمه CTA (Call-to-Action) نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند. |
VideoOutstreamAdInfo
نمایش فرمت تبلیغ ویدیویی خارج از جریان (آگهی در کنار فید با پخش خودکار، بدون صدا نشان داده می شود).
نمایندگی JSON |
---|
{ "headline": string, "description": string } |
زمینه های | |
---|---|
headline | تیتر آگهی. |
description | خط توضیحات |
VideoNonSkippableInStreamAdInfo
نمایش فرمت تبلیغ ویدیویی غیرقابل رد شدن در جریان (آگهی ویدیویی غیرقابل رد شدن در جریان 15 ثانیه).
نمایندگی JSON |
---|
{
"companionBanner": {
object ( |
زمینه های | |
---|---|
companionBanner | دارایی های تصویری بنر همراه استفاده شده با آگهی. |
actionButtonLabel | برچسب روی دکمه «Call To Action» کاربر را به نشانی اینترنتی نهایی آگهی ویدیویی می برد. |
actionHeadline | متن اضافی با دکمه "Call To Action" نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند. |
InFeedVideoAdInfo
نمایش فرمت تبلیغات ویدیویی In-feed.
نمایندگی JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
زمینه های | |
---|---|
headline | تیتر آگهی. |
description1 | خط اول متن آگهی |
description2 | خط دوم متن آگهی |
thumbnail | تصویر کوچک ویدیویی برای استفاده. |
تصویر کوچک ویدیو
Enum انواع احتمالی یک تصویر کوچک ویدیو را فهرست می کند.
Enums | |
---|---|
UNSPECIFIED | نوع آن مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
DEFAULT_THUMBNAIL | تصویر کوچک پیش فرض می تواند به صورت خودکار تولید شود یا توسط کاربر آپلود شود. |
THUMBNAIL_1 | تصویر بندانگشتی 1، ایجاد شده از ویدیو. |
THUMBNAIL_2 | تصویر بندانگشتی 2، ایجاد شده از ویدیو. |
THUMBNAIL_3 | تصویر کوچک 3، ایجاد شده از ویدیو. |
VideoResponsiveAdInfo
یک تبلیغ ویدئویی واکنشگرا.
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | فهرست دارایی های متنی که برای تیتر کوتاه استفاده می شود. در حال حاضر، فقط یک مقدار برای عنوان کوتاه پشتیبانی می شود. |
longHeadlines[] | فهرست دارایی های متنی که برای تیتر طولانی استفاده می شود. در حال حاضر، تنها یک مقدار برای عنوان طولانی پشتیبانی می شود. |
descriptions[] | فهرست دارایی های متنی که برای توضیحات استفاده می شود. در حال حاضر، فقط یک مقدار برای توضیحات پشتیبانی می شود. |
callToActions[] | فهرست دارایی های متنی که برای دکمه استفاده می شود، به عنوان مثال، دکمه "Call To Action". در حال حاضر، تنها یک مقدار برای دکمه پشتیبانی می شود. |
videos[] | فهرست داراییهای ویدیویی YouTube که برای تبلیغ استفاده میشوند. در حال حاضر، تنها یک مقدار برای دارایی ویدیوی YouTube پشتیبانی میشود. |
companionBanners[] | فهرست دارایی های تصویری استفاده شده برای بنر همراه. در حال حاضر، تنها یک مقدار برای دارایی بنر همراه پشتیبانی میشود. |
breadcrumb1 | قسمت اول متنی که با URL نمایش داده شده در آگهی ظاهر می شود. |
breadcrumb2 | قسمت دوم متنی که با URL نمایش داده شده در آگهی ظاهر می شود. |
AdTextAsset
دارایی متنی که در یک آگهی استفاده می شود.
نمایندگی JSON |
---|
{ "pinnedField": enum ( |
زمینه های | |
---|---|
pinnedField | فیلد پین شده دارایی. این امر دارایی را محدود می کند تا فقط در این زمینه ارائه شود. دارایی های متعدد را می توان به یک فیلد پین کرد. داراییای که پین نشده یا به فیلد دیگری پین شده است، در فیلدی که دارایی دیگری پین شده است، استفاده نمیشود. |
assetPerformanceLabel | برچسب عملکرد این دارایی متنی. |
policySummaryInfo | خلاصه خط مشی این دارایی متن. |
text | متن دارایی |
ServedAssetFieldType
انواع فیلد دارایی ممکن
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
HEADLINE_1 | دارایی در عنوان 1 استفاده شده است. |
HEADLINE_2 | دارایی در عنوان 2 استفاده شده است. |
HEADLINE_3 | دارایی در عنوان 3 استفاده شده است. |
DESCRIPTION_1 | دارایی در توضیح 1 استفاده شده است. |
DESCRIPTION_2 | دارایی در شرح 2 استفاده شده است. |
HEADLINE | دارایی در یک عنوان استفاده شد. فقط در صورتی از این مورد استفاده کنید که فقط یک عنوان در آگهی وجود داشته باشد. در غیر این صورت، از شماره های HEADLINE_1، HEADLINE_2 یا HEADLINE_3 استفاده کنید |
HEADLINE_IN_PORTRAIT | دارایی به عنوان عنوان در تصویر پرتره استفاده شد. |
LONG_HEADLINE | دارایی در یک عنوان طولانی استفاده شده است (در MultiAssetResponsiveAd استفاده شده است). |
DESCRIPTION | دارایی در توضیحات استفاده شد. فقط در صورتی از این مورد استفاده کنید که فقط یک توضیح در آگهی وجود داشته باشد. در غیر این صورت، از فهرست DESCRIPTION_1 یا DESCRIPTION_@ استفاده کنید |
DESCRIPTION_IN_PORTRAIT | دارایی به عنوان توضیحات در تصویر پرتره استفاده شد. |
BUSINESS_NAME_IN_PORTRAIT | دارایی به عنوان نام تجاری در تصویر پرتره استفاده شد. |
BUSINESS_NAME | دارایی به عنوان نام تجاری استفاده شد. |
MARKETING_IMAGE | دارایی به عنوان تصویر بازاریابی استفاده شد. |
MARKETING_IMAGE_IN_PORTRAIT | این دارایی به عنوان یک تصویر بازاریابی در تصویر پرتره استفاده شد. |
SQUARE_MARKETING_IMAGE | دارایی به عنوان یک تصویر بازاریابی مربعی استفاده شد. |
PORTRAIT_MARKETING_IMAGE | این دارایی به عنوان یک تصویر بازاریابی پرتره استفاده شد. |
LOGO | دارایی به عنوان لوگو استفاده شد. |
LANDSCAPE_LOGO | دارایی به عنوان لوگوی منظره استفاده شد. |
CALL_TO_ACTION | دارایی به عنوان یک فراخوان برای اقدام استفاده شد. |
YOU_TUBE_VIDEO | این دارایی به عنوان یک ویدیوی YouTube استفاده شد. |
SITELINK | این دارایی به عنوان لینک سایت استفاده می شود. |
CALL | این دارایی به عنوان تماس استفاده می شود. |
MOBILE_APP | این دارایی به عنوان یک برنامه تلفن همراه استفاده می شود. |
CALLOUT | این دارایی به عنوان فراخوان استفاده می شود. |
STRUCTURED_SNIPPET | این دارایی به عنوان یک قطعه ساختاریافته استفاده می شود. |
PRICE | این دارایی به عنوان قیمت استفاده می شود. |
PROMOTION | این دارایی به عنوان تبلیغ استفاده می شود. |
AD_IMAGE | این دارایی به عنوان تصویر استفاده می شود. |
LEAD_FORM | دارایی به عنوان فرم سرب استفاده می شود. |
BUSINESS_LOGO | دارایی به عنوان لوگوی تجاری استفاده می شود. |
Asset PerformanceLabel
Enum برچسب های عملکرد احتمالی یک دارایی را توصیف می کند که معمولاً در زمینه یک پیوند محاسبه می شود.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
PENDING | این دارایی هنوز هیچ اطلاعات عملکردی ندارد. این ممکن است به این دلیل باشد که هنوز در حال بررسی است. |
LEARNING | دارایی شروع به دریافت نمایش کرده است، اما آمارها از نظر آماری به اندازه کافی قابل توجه نیستند تا برچسب عملکرد دارایی را دریافت کنند. |
LOW | دارایی با بدترین عملکرد |
GOOD | دارایی هایی با عملکرد خوب |
BEST | دارایی با بهترین عملکرد |
AdAssetPolicySummary
حاوی اطلاعات خطمشی یک دارایی در آگهی است.
نمایندگی JSON |
---|
{ "policyTopicEntries": [ { object ( |
زمینه های | |
---|---|
policyTopicEntries[] | فهرست یافته های خط مشی برای این دارایی. |
reviewStatus | جایی که در فرآیند بررسی این دارایی است. |
approvalStatus | وضعیت تأیید کلی این دارایی، که بر اساس وضعیت ورودیهای موضوع خطمشی فردی آن محاسبه میشود. |
PolicyTopicEntry
یافتن خط مشی پیوست شده به یک منبع (به عنوان مثال، خط مشی الکل مرتبط با سایتی که الکل می فروشد).
هر PolicyTopicEntry دارای موضوعی است که خط مشی تبلیغات خاصی را که ورودی در مورد آن است نشان می دهد و نوعی برای نشان دادن تأثیری که ورودی بر ارائه خواهد داشت. ممکن است به صورت اختیاری یک یا چند مدرک داشته باشد که دلیل این یافته را نشان دهد. همچنین ممکن است به صورت اختیاری یک یا چند محدودیت داشته باشد که جزئیاتی را در مورد نحوه محدود کردن خدمات ارائه می دهد.
نمایندگی JSON |
---|
{ "type": enum ( |
زمینه های | |
---|---|
type | تأثیر منفی یا مثبتی را که این خطمشی بر ارائه خواهد داشت، شرح میدهد. |
evidences[] | اطلاعات اضافی که یافتن خط مشی را توضیح می دهد (به عنوان مثال، نام تجاری برای یافتن علامت تجاری). |
constraints[] | نشان می دهد که چگونه خدمت به این منبع ممکن است تحت تأثیر قرار گیرد (به عنوان مثال، خدمت نکردن در یک کشور). |
topic | موضوع سیاستی که این یافته به آن اشاره دارد. به عنوان مثال، "ALCOHOL"، "TRADEMARKS_IN_AD_TEXT"، یا "DESTINATION_NOT_WORKING". مجموعه موضوعات احتمالی خط مشی برای یک نسخه API خاص ثابت نیست و ممکن است در هر زمان تغییر کند. |
PolicyTopicEntryType
انواع ورودی موضوع خط مشی ممکن
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
PROHIBITED | منبع ارائه نخواهد شد. |
LIMITED | منبع تحت برخی شرایط ارائه نخواهد شد. |
FULLY_LIMITED | این منبع به دلیل معیارهای هدف گذاری فعلی به هیچ وجه نمی تواند خدمت کند. |
DESCRIPTIVE | ممکن است جالب باشد، اما نحوه ارائه منبع را محدود نمی کند. |
BROADENING | می تواند پوشش را فراتر از حد معمول افزایش دهد. |
AREA_OF_INTEREST_ONLY | برای همه کشورهای هدف محدود شده است، اما ممکن است از طریق منطقه مورد علاقه در کشورهای دیگر خدمت کند. |
PolicyTopicEvidence
اطلاعات اضافی که یک یافته خط مشی را توضیح می دهد.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
value فیلد اتحادیه اطلاعات شواهد خاص بسته به نوع شواهد. value فقط می تواند یکی از موارد زیر باشد: | |
websiteList | لیست وب سایت های مرتبط با این منبع. |
textList | فهرست شواهد موجود در متن یک منبع. |
languageCode | زبانی که منبع شناسایی شد که با آن نوشته شده است. این یک برچسب زبان IETF مانند "en-US" است. |
destinationTextList | متنی در مقصد منبع که باعث پیدا کردن خط مشی می شود. |
destinationMismatch | عدم تطابق بین مقصد URL های یک منبع. |
destinationNotWorking | جزئیات زمانی که مقصد یک کد خطای HTTP را برمیگرداند یا در همه مکانها برای دستگاههای معمولی کاربردی نیست. |
لیست وب سایت
فهرستی از وبسایتهایی که باعث یافتن خطمشی شدند. برای مثال برای موضوع خطمشی ONE_WEBSITE_PER_AD_GROUP استفاده میشود. در صورتی که بیش از پنج وب سایت وجود داشته باشد، فقط پنج وب سایت برتر (آنهایی که بیشتر در منابع ظاهر می شوند) در اینجا فهرست می شوند.
نمایندگی JSON |
---|
{ "websites": [ string ] } |
زمینه های | |
---|---|
websites[] | وب سایت هایی که باعث یافتن خط مشی شدند. |
TextList
فهرستی از بخشهایی از متن که خطمشی را نقض میکند.
نمایندگی JSON |
---|
{ "texts": [ string ] } |
زمینه های | |
---|---|
texts[] | تکه های متن از منبعی که باعث یافتن خط مشی شد. |
DestinationTextList
فهرستی از رشتههای یافت شده در صفحه مقصد که باعث یافتن خطمشی شده است.
نمایندگی JSON |
---|
{ "destinationTexts": [ string ] } |
زمینه های | |
---|---|
destinationTexts[] | فهرست متن یافت شده در صفحه مقصد منبع. |
عدم تطابق مقصد
شواهد عدم تطابق بین URL های یک منبع.
نمایندگی JSON |
---|
{
"urlTypes": [
enum ( |
زمینه های | |
---|---|
urlTypes[] | مجموعه URL هایی که با یکدیگر مطابقت نداشتند. |
PolicyTopicEvidenceDestinationMismatchUrlType
شواهد موضوع خط مشی احتمالی عدم تطابق نوع نشانی وب مقصد.
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
DISPLAY_URL | نشانی اینترنتی نمایشگر |
FINAL_URL | آدرس نهایی. |
FINAL_MOBILE_URL | آدرس نهایی موبایل |
TRACKING_URL | الگوی URL ردیابی، با آدرس دسکتاپ جایگزین شده است. |
MOBILE_TRACKING_URL | الگوی آدرس اینترنتی ردیابی، با آدرس اینترنتی تلفن همراه جایگزین شده است. |
DestinationNotWorking
جزئیات شواهد زمانی که مقصد یک کد خطای HTTP را برمیگرداند یا در همه مکانها برای دستگاههای پرکاربرد کار نمیکند.
نمایندگی JSON |
---|
{ "device": enum ( |
زمینه های | |
---|---|
device | نوع دستگاهی که نتوانست URL را بارگیری کند. |
expandedUrl | URL کامل که کار نکرد. |
lastCheckedDateTime | زمانی که URL آخرین بار بررسی شد. قالب "YYYY-MM-DD HH:MM:SS" است. مثالها: "2018-03-05 09:15:00" یا "2018-02-01 14:34:30" |
reason میدانی اتحادیه . دلیل یافتن خطمشی DESTINATION_NOT_WORKING را نشان میدهد. reason می تواند تنها یکی از موارد زیر باشد: | |
dnsErrorType | نوع خطای DNS. |
httpErrorCode | کد خطای HTTP |
PolicyTopicEvidenceDestinationNotWorkingDevice
مبحث احتمالی خط مشی شواهد مقصد دستگاه ها کار نمی کند.
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
DESKTOP | صفحه فرود در دستگاه دسکتاپ کار نمی کند. |
ANDROID | صفحه فرود در دستگاه Android کار نمی کند. |
IOS | صفحه فرود در دستگاه iOS کار نمی کند. |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
مقصد شواهد موضوع خط مشی احتمالی که کار نمی کند انواع خطای DNS.
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
HOSTNAME_NOT_FOUND | هنگام واکشی صفحه فرود، نام میزبان در DNS یافت نشد. |
GOOGLE_CRAWLER_DNS_ISSUE | مشکل خزنده داخلی Google هنگام برقراری ارتباط با DNS. این خطا به این معنی نیست که صفحه فرود کار نمی کند. گوگل صفحه فرود را دوباره خزیده می کند. |
PolicyTopicConstraint
تأثیری را که ورودی موضوع خطمشی بر ارائه خواهد داشت، توضیح میدهد.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
value فیلد اتحادیه اطلاعات خاص در مورد محدودیت value فقط می تواند یکی از موارد زیر باشد: | |
countryConstraintList | کشورهایی که منبع نمی تواند در آنها خدمت کند. |
resellerConstraint | محدودیت فروشندگان |
certificateMissingInCountryList | کشورهایی که برای خدمت در آنها گواهینامه لازم است. |
certificateDomainMismatchInCountryList | کشورهایی که دامنه منبع تحت پوشش گواهینامه های مرتبط با آن نیست. |
CountryConstraintList
فهرستی از کشورهایی که خدمات یک منبع در آنها محدود است.
نمایندگی JSON |
---|
{
"countries": [
{
object ( |
زمینه های | |
---|---|
countries[] | کشورهایی که خدمت در آنها محدود شده است. |
totalTargetedCountries | تعداد کل کشورهای هدف منبع. |
کشور محدودیت
نشان می دهد که توانایی یک منبع برای خدمت در یک کشور خاص محدود است.
نمایندگی JSON |
---|
{ "countryCriterion": string } |
زمینه های | |
---|---|
countryCriterion | نام منبع ثابت هدف جغرافیایی کشوری که خدمات در آن محدود شده است. |
محدودیت Reseller
این نوع هیچ فیلدی ندارد.
نشان میدهد که یک موضوع خطمشی به دلیل عدم تأیید وبسایت برای اهداف فروش محدود شده است.
PolicyReviewStatus
وضعیت های احتمالی بررسی خط مشی
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
REVIEW_IN_PROGRESS | در حال حاضر در دست بررسی است. |
REVIEWED | بررسی اولیه کامل شد. بررسی های دیگر ممکن است ادامه داشته باشد. |
UNDER_APPEAL | منبع مجدداً برای تأیید ارسال شده است یا تصمیم خط مشی آن درخواست تجدیدنظر شده است. |
ELIGIBLE_MAY_SERVE | این منبع واجد شرایط است و ممکن است در حال استفاده باشد، اما همچنان میتواند تحت بررسی بیشتر قرار گیرد. |
وضعیت تأیید سیاست
وضعیت های احتمالی تایید خط مشی هنگامی که چندین وضعیت تأیید موجود باشد، شدیدترین مورد استفاده خواهد شد. ترتیب شدت DISAPPROVED، AREA_OF_INTEREST_ONLY، APPROVED_LIMITED و APPROVED است.
Enums | |
---|---|
UNSPECIFIED | هیچ مقداری مشخص نشده است. |
UNKNOWN | مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است. |
DISAPPROVED | خدمت نخواهد کرد. |
APPROVED_LIMITED | با محدودیت خدمت می کند. |
APPROVED | بدون محدودیت خدمت می کند. |
AREA_OF_INTEREST_ONLY | در کشورهای هدف ارائه نمی شود، اما ممکن است برای کاربرانی که در جستجوی اطلاعاتی در مورد کشورهای هدف هستند استفاده شود. |
ResponsiveSearchAdInfo
یک تبلیغ جستجوی واکنشگرا
تبلیغات جستجوی واکنشگرا به شما امکان می دهد تبلیغی ایجاد کنید که برای نمایش متن بیشتر و پیام های مرتبط تر به مشتریان شما سازگار باشد. هنگام ایجاد یک تبلیغ جستجوی واکنشگرا، چندین عنوان و توضیحات وارد کنید، و با گذشت زمان، Google Ads به طور خودکار ترکیب های مختلف را آزمایش می کند و یاد می گیرد که کدام ترکیب ها بهترین عملکرد را دارند. با تطبیق محتوای تبلیغ خود برای مطابقت بیشتر با عبارات جستجوی مشتریان بالقوه، تبلیغات جستجوی پاسخگو ممکن است عملکرد کمپین شما را بهبود بخشد.
اطلاعات بیشتر در https://support.google.com/google-ads/answer/7684791
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند. |
descriptions[] | فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود. |
path1 | قسمت اول متنی که می توان به URL موجود در آگهی اضافه کرد. |
path2 | قسمت دوم متن که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که |
LegacyResponsiveDisplayAdInfo
یک تبلیغ نمایشی واکنشگرا قدیمی. تبلیغات از این نوع در رابط کاربری Google Ads با عنوان "تبلیغات پاسخگو" شناخته می شوند.
نمایندگی JSON |
---|
{
"formatSetting": enum ( |
زمینه های | |
---|---|
formatSetting | مشخص می کند که تبلیغ در چه قالبی ارائه می شود. پیش فرض ALL_FORMATS است. |
shortHeadline | نسخه کوتاه تیتر آگهی. |
longHeadline | نسخه طولانی تیتر آگهی. |
description | توضیحات آگهی |
businessName | نام تجاری در آگهی |
allowFlexibleColor | رضایت تبلیغ کننده برای اجازه دادن به رنگ انعطاف پذیر. در صورت صحت، آگهی ممکن است در صورت لزوم با رنگ های مختلف ارائه شود. در صورت نادرست بودن، آگهی با رنگ های مشخص شده یا رنگ خنثی ارائه می شود. مقدار پیش فرض |
accentColor | رنگ تاکیدی تبلیغ به صورت هگزا دسیمال، به عنوان مثال، #ffffff برای رنگ سفید. اگر یکی از |
mainColor | رنگ اصلی تبلیغ به صورت هگزادسیمال، به عنوان مثال، #ffffff برای سفید. اگر یکی از |
callToActionText | متن دعوت به اقدام برای تبلیغ. |
logoImage | نام منبع MediaFile تصویر لوگوی استفاده شده در آگهی. |
squareLogoImage | نام منبع MediaFile تصویر لوگوی مربعی استفاده شده در آگهی. |
marketingImage | نام منبع MediaFile تصویر بازاریابی استفاده شده در آگهی. |
squareMarketingImage | نام منبع MediaFile تصویر بازاریابی مربعی مورد استفاده در آگهی. |
pricePrefix | پیشوند قبل از قیمت به عنوان مثال، "به اندازه پایین". |
promoText | متن تبلیغاتی مورد استفاده برای قالبهای پویا تبلیغات واکنشگرا. به عنوان مثال "ارسال رایگان دو روزه". |
DisplayAdFormatSetting
تنظیمات قالب تبلیغات نمایشی را بر می شمارد.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | مقدار در این نسخه ناشناخته است. |
ALL_FORMATS | متن، تصویر و فرمت های بومی. |
NON_NATIVE | فرمت های متن و تصویر |
NATIVE | قالب بومی، برای مثال، رندر قالب توسط ناشر کنترل می شود نه توسط Google. |
AppAdInfo
یک تبلیغ اپلیکیشن
نمایندگی JSON |
---|
{ "mandatoryAdText": { object ( |
زمینه های | |
---|---|
mandatoryAdText | متن آگهی اجباری |
headlines[] | فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند. |
descriptions[] | فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود. |
images[] | فهرست دارایی های تصویری که ممکن است همراه با آگهی نمایش داده شوند. |
youtubeVideos[] | فهرست داراییهای ویدیوی YouTube که ممکن است همراه با آگهی نمایش داده شوند. |
html5MediaBundles[] | فهرست داراییهای بسته رسانهای که ممکن است با آگهی استفاده شود. |
AdMediaBundleAsset
دارایی بسته رسانه ای که در یک آگهی استفاده می شود.
نمایندگی JSON |
---|
{ "asset": string } |
زمینه های | |
---|---|
asset | نام منبع دارایی این بسته رسانه. |
LegacyAppInstallAdInfo
یک تبلیغ نصب برنامه قدیمی که فقط می تواند توسط چند مشتری منتخب استفاده شود.
نمایندگی JSON |
---|
{
"appStore": enum ( |
زمینه های | |
---|---|
appStore | فروشگاه اپلیکیشنی که اپلیکیشن موبایل در آن موجود است. |
appId | شناسه اپلیکیشن موبایل |
headline | تیتر آگهی. |
description1 | اولین خط توضیحات آگهی. |
description2 | خط دوم توضیحات آگهی. |
LegacyAppInstallAdAppStore
فروشگاه برنامه در آگهی نصب برنامه قدیمی تایپ کنید.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است. |
UNKNOWN | فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است. |
APPLE_APP_STORE | اپل آیتونز. |
GOOGLE_PLAY | گوگل پلی. |
WINDOWS_STORE | فروشگاه ویندوز. |
WINDOWS_PHONE_STORE | فروشگاه ویندوز فون. |
CN_APP_STORE | این برنامه در یک فروشگاه برنامه چینی میزبانی می شود. |
ResponsiveDisplayAdInfo
یک تبلیغ نمایشی واکنشگرا
نمایندگی JSON |
---|
{ "marketingImages": [ { object ( |
زمینه های | |
---|---|
marketingImages[] | تصاویر بازاریابی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 600x314 و نسبت تصویر باید 1.91:1 (+-1%) باشد. حداقل یک |
squareMarketingImages[] | تصاویر بازاریابی مربعی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 300x300 است و نسبت تصویر باید 1:1 (+-1%) باشد. حداقل یک |
logoImages[] | تصاویر لوگو برای استفاده در تبلیغات انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 512x128 است و نسبت تصویر باید 4:1 (+-1%) باشد. در ترکیب با |
squareLogoImages[] | تصاویر آرم مربعی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد. همراه با |
headlines[] | سرفصل های کوتاه فرمت آگهی. حداکثر طول 30 کاراکتر است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد. |
longHeadline | یک عنوان با فرمت طولانی مورد نیاز. حداکثر طول 90 کاراکتر است. |
descriptions[] | متن های توصیفی برای آگهی. حداکثر طول 90 کاراکتر است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد. |
youtubeVideos[] | ویدیوهای اختیاری YouTube برای آگهی. حداکثر 5 ویدیو را می توان مشخص کرد. |
formatSetting | مشخص می کند که تبلیغ در چه قالبی ارائه می شود. پیش فرض ALL_FORMATS است. |
controlSpec | مشخصات برای کنترل های خلاقانه مختلف. |
businessName | تبلیغ کننده / نام تجاری. حداکثر عرض نمایش 25 است. |
mainColor | رنگ اصلی تبلیغ به صورت هگزادسیمال، به عنوان مثال، #ffffff برای سفید. اگر یکی از |
accentColor | رنگ تاکیدی تبلیغ به صورت هگزا دسیمال، به عنوان مثال، #ffffff برای رنگ سفید. اگر یکی از |
allowFlexibleColor | رضایت تبلیغ کننده برای اجازه دادن به رنگ انعطاف پذیر. در صورت صحت، آگهی ممکن است در صورت لزوم با رنگ های مختلف ارائه شود. در صورت نادرست بودن، آگهی با رنگ های مشخص شده یا رنگ خنثی ارائه می شود. مقدار پیش فرض |
callToActionText | متن دعوت به اقدام برای تبلیغ. حداکثر عرض نمایش 30 است. |
pricePrefix | پیشوند قبل از قیمت به عنوان مثال، "به اندازه پایین". |
promoText | متن تبلیغاتی مورد استفاده برای قالبهای پویا تبلیغات واکنشگرا. به عنوان مثال "ارسال رایگان دو روزه". |
ResponsiveDisplayAdControlSpec
مشخصات کنترلهای خلاقانه مختلف برای یک تبلیغ نمایشی واکنشگرا.
نمایندگی JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
زمینه های | |
---|---|
enableAssetEnhancements | اینکه آیا تبلیغکننده ویژگی بهبود دارایی را انتخاب کرده است یا خیر. |
enableAutogenVideo | اینکه آیا تبلیغکننده ویژگی ویدیوی تولید خودکار را انتخاب کرده است یا خیر. |
LocalAdInfo
یک تبلیغ محلی
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | لیست دارایی های متنی برای عناوین. هنگامی که تبلیغ در خدمت عناوین از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 عنوان باید مشخص شود. |
descriptions[] | لیست دارایی های متنی برای توضیحات. هنگامی که تبلیغ در خدمت توضیحات از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 توصیف باید مشخص شود. |
callToActions[] | لیست دارایی های متنی برای تماس با اقدامات. هنگامی که تبلیغ در خدمت تماس با اقدامات است ، از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 تماس با اقدامات باید مشخص شود. |
marketingImages[] | لیست دارایی های تصویر بازاریابی که ممکن است با تبلیغ نمایش داده شود. تصاویر باید 314x600 پیکسل یا 320x320 پیکسل باشد. حداقل 1 و حداکثر 20 دارایی تصویر باید مشخص شود. |
logoImages[] | لیست دارایی های تصویر آرم که ممکن است با آگهی نمایش داده شود. تصاویر باید 128x128 پیکسل و بزرگتر از 120kb نباشند. حداقل 1 و حداکثر 5 دارایی تصویر باید مشخص شود. |
videos[] | لیست دارایی های ویدیویی YouTube که ممکن است با تبلیغ نمایش داده شود. حداقل 1 و حداکثر 20 دارایی ویدیویی باید مشخص شود. |
path1 | قسمت اول متن اختیاری که می تواند در AD در URL ضمیمه شود. |
path2 | بخش دوم متن اختیاری که می تواند در AD در URL ضمیمه شود. این قسمت فقط در صورت تنظیم |
displayuploadadinfo
یک نوع عمومی از آگهی نمایشگر. قالب AD دقیق توسط قسمت displayUploadProductType
کنترل می شود ، که تعیین می کند چه نوع داده هایی باید با AD گنجانده شود.
نمایندگی JSON |
---|
{ "displayUploadProductType": enum ( |
زمینه های | |
---|---|
displayUploadProductType | نوع محصول این تبلیغ. برای جزئیات بیشتر به نظرات در مورد enum مراجعه کنید. |
Union Field media_asset . داده های دارایی که تبلیغ را تشکیل می دهند. media_asset فقط می تواند یکی از موارد زیر باشد: | |
mediaBundle | دارایی بسته نرم افزاری رسانه ای که در تبلیغ استفاده می شود. برای کسب اطلاعات در مورد بسته رسانه ای برای html5_upload_ad ، به https://support.google.com/google-ads/answer/1722096 بسته های رسانه ای که بخشی از انواع محصولات پویا هستند ، مراجعه کنید و از فرمت خاصی استفاده کنید که باید از طریق طراح وب Google ایجاد شود . برای کسب اطلاعات بیشتر به https://support.google.com/webdesigner/answer/7543898 مراجعه کنید. |
DisplayUploadproductType
انواع محصول بارگذاری نمایش را نشان می دهد.
Enums | |
---|---|
UNSPECIFIED | مشخص نشده است |
UNKNOWN | مقدار در این نسخه ناشناخته است. |
HTML5_UPLOAD_AD | تبلیغ بارگذاری HTML5. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. |
DYNAMIC_HTML5_EDUCATION_AD | آگهی آموزش HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین آموزشی قابل استفاده است. |
DYNAMIC_HTML5_FLIGHT_AD | تبلیغ پرواز HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین پرواز قابل استفاده است. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD | هتل پویا HTML5 و آگهی اجاره. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کارزار هتل قابل استفاده است. |
DYNAMIC_HTML5_JOB_AD | آگهی شغلی HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین شغلی قابل استفاده است. |
DYNAMIC_HTML5_LOCAL_AD | تبلیغات محلی HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین محلی قابل استفاده است. |
DYNAMIC_HTML5_REAL_ESTATE_AD | آگهی املاک و مستغلات پویا HTML5. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین املاک و مستغلات قابل استفاده است. |
DYNAMIC_HTML5_CUSTOM_AD | آگهی سفارشی HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین سفارشی قابل استفاده است. |
DYNAMIC_HTML5_TRAVEL_AD | آگهی سفر HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کمپین مسافرتی قابل استفاده است. |
DYNAMIC_HTML5_HOTEL_AD | آگهی هتل HTML5 پویا. این نوع محصول نیاز به تنظیم قسمت upload_media_bundle در displayuploadadinfo دارد. فقط در یک کارزار هتل قابل استفاده است. |
AppEngagementAdinfo
تبلیغات نامزدی برنامه به شما امکان می دهد متن را با تشویق یک عمل خاص در برنامه بنویسید ، مانند ورود به سیستم ، خرید یا رزرو پرواز. آنها به شما امکان می دهند کاربران را به قسمت خاصی از برنامه خود بفرستید تا بتوانند آنچه را که به دنبال آنها آسانتر و سریعتر هستند پیدا کنند.
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | لیست دارایی های متنی برای عناوین. هنگامی که تبلیغ در خدمت عناوین از این لیست انتخاب می شود. |
descriptions[] | لیست دارایی های متنی برای توضیحات. هنگامی که تبلیغ در خدمت توضیحات از این لیست انتخاب می شود. |
images[] | لیست دارایی های تصویر که ممکن است با تبلیغ نمایش داده شود. |
videos[] | لیست دارایی های ویدیویی که ممکن است با آگهی نمایش داده شود. |
خرید comparisonlistingadinfo
یک آگهی لیست مقایسه خرید.
نمایندگی JSON |
---|
{ "headline": string } |
زمینه های | |
---|---|
headline | تیتر تبلیغ. این فیلد الزامی است. طول مجاز بین 25 تا 45 کاراکتر است. |
SmartCampaignAdinfo
یک تبلیغ کمپین هوشمند
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | لیست دارایی های متنی ، که هر یک از آنها در هنگام ارائه تبلیغات مربوط به تیتر است. این لیست از حداقل 3 و حداکثر 15 دارایی متنی تشکیل شده است. |
descriptions[] | لیست دارایی های متنی ، که هر یک از آنها هنگام ارائه تبلیغات مربوط به توضیحات است. این لیست از حداقل 2 و حداکثر 4 دارایی متنی تشکیل شده است. |
AppRereGistrationAdinfo
برنامه تبلیغات پیش ثبت نام برنامه به برنامه یا لیست بازی شما در Google Play پیوند می دهد و می تواند در Google Play ، در YouTube (فقط در جریان) و در سایر برنامه ها و وب سایت های تلفن همراه در شبکه نمایش اجرا شود. این به جذب علاقه افراد به برنامه یا بازی شما کمک می کند و قبل از راه اندازی یک پایه نصب اولیه برای برنامه یا بازی شما ایجاد می کند.
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | لیست دارایی های متنی برای عناوین. هنگامی که تبلیغ در خدمت عناوین از این لیست انتخاب می شود. |
descriptions[] | لیست دارایی های متنی برای توضیحات. هنگامی که تبلیغ در خدمت توضیحات از این لیست انتخاب می شود. |
images[] | لیست شناسه های دارایی تصویر که تصاویر آنها ممکن است با آگهی نمایش داده شود. |
youtubeVideos[] | لیست شناسه های دارایی ویدیویی YouTube که فیلم های آنها ممکن است با تبلیغ نمایش داده شود. |
DiscoverymultiassetAdinfo
یک آگهی چند دارایی Discovery.
نمایندگی JSON |
---|
{ "marketingImages": [ { object ( |
زمینه های | |
---|---|
marketingImages[] | دارایی های تصویر بازاریابی که در تبلیغ استفاده می شود. انواع تصویر معتبر GIF ، JPEG و PNG هستند. حداقل اندازه 600x314 و نسبت ابعاد باید 1.91: 1 (+-1 ٪) باشد. در صورت عدم حضور SquaremarketingImages ، لازم است. همراه با |
squareMarketingImages[] | دارایی های تصویر بازاریابی مربع که در آگهی مورد استفاده قرار می گیرند. انواع تصویر معتبر GIF ، JPEG و PNG هستند. حداقل اندازه 300x300 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد. در صورت عدم وجود بازاریابی ، مورد نیاز است. همراه با |
portraitMarketingImages[] | دارایی های تصویر بازاریابی پرتره که در تبلیغ استفاده می شود. انواع تصویر معتبر GIF ، JPEG و PNG هستند. حداقل اندازه 480x600 و نسبت ابعاد باید 4: 5 (+-1 ٪) باشد. همراه با |
logoImages[] | دارایی های تصویر آرم که در تبلیغ استفاده می شود. انواع تصویر معتبر GIF ، JPEG و PNG هستند. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد. حداقل 1 و حداکثر تصاویر آرم را می توان مشخص کرد. |
headlines[] | دارایی متنی تیتر تبلیغ. حداکثر عرض نمایش 30 است. حداقل 1 و حداکثر 5 عنوان قابل مشخص است. |
descriptions[] | متن توصیفی آگهی. حداکثر عرض نمایش 90 است. حداقل 1 و حداکثر 5 توضیحات را می توان مشخص کرد. |
businessName | تبلیغ کننده/نام تجاری. حداکثر عرض صفحه نمایش 25 است. |
callToActionText | متن عمل را فراخوانی کنید. |
leadFormOnly | گزینه Boolean که نشان می دهد آیا این تبلیغ باید با فرم سرب ارائه شود یا خیر. |
DiscoverycarouselAdinfo
یک آگهی کاروسل کشف.
نمایندگی JSON |
---|
{ "businessName": string, "logoImage": { object ( |
زمینه های | |
---|---|
businessName | ضروری. تبلیغ کننده/نام تجاری. |
logoImage | ضروری. تصویر آرم برای استفاده در آگهی. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد. |
headline | ضروری. تیتر تبلیغ. |
description | ضروری. متن توصیفی آگهی. |
callToActionText | متن عمل را فراخوانی کنید. |
carouselCards[] | ضروری. کارتهای چرخ فلک که با تبلیغ نمایش داده می شوند. حداقل 2 حداکثر 10. |
addiscoverycarouselcardasset
دارایی کارت چرخ فلک کشف که در داخل یک تبلیغ استفاده می شود.
نمایندگی JSON |
---|
{ "asset": string } |
زمینه های | |
---|---|
asset | نام منابع دارایی این کارت Carousel Discovery Carousel. |
DiscoveryVideorEsponsiveAdinfo
یک آگهی پاسخگو ویدیویی کشف.
نمایندگی JSON |
---|
{ "headlines": [ { object ( |
زمینه های | |
---|---|
headlines[] | لیست دارایی های متنی مورد استفاده برای تیتر کوتاه. |
longHeadlines[] | لیست دارایی های متنی مورد استفاده برای تیتر طولانی. |
descriptions[] | لیست دارایی های متنی مورد استفاده برای توضیحات. |
videos[] | لیست دارایی های ویدیویی YouTube که برای تبلیغ استفاده می شود. |
logoImages[] | تصویر آرم برای استفاده در آگهی. انواع تصویر معتبر GIF ، JPEG و PNG هستند. حداقل اندازه 128x128 و نسبت ابعاد باید 1: 1 (+-1 ٪) باشد. |
breadcrumb1 | قسمت اول متن که در آگهی با URL نمایش داده شده ظاهر می شود. |
breadcrumb2 | قسمت دوم متن که در تبلیغ با URL نمایش داده شده ظاهر می شود. |
businessName | ضروری. تبلیغ کننده/نام تجاری. |
callToActions[] | دارایی های نوع calltoactionasset برای دکمه "تماس به عمل" استفاده می شود. |
adcalltoactionasset
فراخوانی به دارایی عمل که در داخل یک تبلیغ استفاده می شود.
نمایندگی JSON |
---|
{ "asset": string } |
زمینه های | |
---|---|
asset | نام منابع دارایی این فراخوان به Action Asset. |
TravelAdinfo
این نوع هیچ فیلدی ندارد.
یک آگهی مسافرتی
مواد و روش ها | |
---|---|
| تبلیغات درخواست شده را با جزئیات کامل برمی گرداند. |
| تبلیغات را به روز می کند. |