Ad

یک آگهی

نمایندگی JSON 
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
فیلدها
resourceName

string

تغییرناپذیر. نام منبع آگهی نام منابع آگهی به شکل زیر است:

customers/{customerId}/ads/{ad_id}

finalUrls[]

string

لیست URL های نهایی ممکن پس از همه تغییر مسیرهای بین دامنه ای برای تبلیغ.

finalAppUrls[]

object ( FinalAppUrl )

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

finalMobileUrls[]

string

فهرست آدرس‌های اینترنتی نهایی تلفن همراه پس از همه تغییر مسیرهای بین دامنه‌ای برای آگهی.

urlCustomParameters[]

object ( CustomParameter )

فهرست نگاشت هایی که می توان برای جایگزینی برچسب های پارامتر سفارشی در trackingUrlTemplate ، finalUrls یا mobile_final_urls استفاده کرد. برای جهش، از عملیات پارامترهای سفارشی url استفاده کنید.

type

enum ( AdType )

فقط خروجی نوع تبلیغ.

devicePreference

enum ( Device )

اولویت دستگاه برای آگهی. شما فقط می توانید یک اولویت را برای دستگاه های تلفن همراه مشخص کنید. وقتی این تنظیمات برگزیده تنظیم شود، وقتی در دستگاه تلفن همراه نمایش داده می شود، تبلیغ نسبت به سایر تبلیغات ترجیح داده می شود. برای مثال، اگر تبلیغات دیگری در دسترس نباشد، همچنان می‌توان این تبلیغ را در انواع دستگاه‌های دیگر نمایش داد. اگر مشخص نباشد (بدون اولویت دستگاه)، همه دستگاه‌ها هدف قرار می‌گیرند. این فقط توسط برخی از انواع تبلیغات پشتیبانی می شود.

urlCollections[]

object ( UrlCollection )

نشانی‌های اینترنتی اضافی برای آگهی که با یک شناسه منحصربه‌فرد برچسب‌گذاری شده‌اند که می‌تواند از فیلدهای دیگر در آگهی ارجاع داده شود.

systemManagedResourceSource

enum ( SystemManagedResourceSource )

فقط خروجی اگر این تبلیغ توسط سیستم مدیریت شود، این قسمت منبع را نشان می دهد. این فیلد فقط خواندنی است.

id

string ( int64 format)

فقط خروجی شناسه آگهی

trackingUrlTemplate

string

الگوی URL برای ساخت URL ردیابی.

finalUrlSuffix

string

پسوندی که هنگام ساخت URL نهایی استفاده می شود.

displayUrl

string

نشانی اینترنتی که در توضیحات آگهی برای برخی از قالب‌های تبلیغاتی ظاهر می‌شود.

addedByGoogleAds

boolean

فقط خروجی نشان می دهد که آیا این تبلیغ به طور خودکار توسط Google Ads اضافه شده است یا نه توسط یک کاربر. به عنوان مثال، این ممکن است زمانی اتفاق بیفتد که تبلیغات به صورت خودکار به عنوان پیشنهاد برای تبلیغات جدید بر اساس آگاهی از نحوه عملکرد تبلیغات موجود ایجاد شود.

name

string

تغییرناپذیر. نام آگهی. این فقط برای شناسایی آگهی استفاده می شود. نیازی نیست منحصر به فرد باشد و بر تبلیغ ارائه شده تأثیری ندارد. فیلد نام در حال حاضر فقط برای DisplayUploadAd، ImageAd، ShoppingComparisonListingAd و VideoAd پشتیبانی می شود.

ad_data فیلد اتحادیه. جزئیات مربوط به نوع تبلیغ دقیقاً یک مقدار باید تنظیم شود. ad_data فقط می تواند یکی از موارد زیر باشد:
textAd

object ( TextAdInfo )

تغییرناپذیر. جزئیات مربوط به تبلیغات متنی

expandedTextAd

object ( ExpandedTextAdInfo )

جزئیات مربوط به یک آگهی متنی گسترده.

callAd

object ( CallAdInfo )

جزئیات مربوط به آگهی تماس.

expandedDynamicSearchAd

object ( ExpandedDynamicSearchAdInfo )

تغییرناپذیر. جزئیات مربوط به تبلیغ جستجوی پویا گسترده. این نوع آگهی دارای سرفصل، نشانی‌های اینترنتی نهایی و نشانی اینترنتی نمایشی است که در زمان ارائه براساس اطلاعات خاص نام دامنه ارائه‌شده توسط dynamicSearchAdsSetting در سطح کمپین به‌طور خودکار ایجاد می‌شوند.

hotelAd

object ( HotelAdInfo )

جزئیات مربوط به آگهی هتل

shoppingSmartAd

object ( ShoppingSmartAdInfo )

جزئیات مربوط به آگهی خرید هوشمند.

shoppingProductAd

object ( ShoppingProductAdInfo )

جزئیات مربوط به تبلیغ محصول خرید.

imageAd

object ( ImageAdInfo )

تغییرناپذیر. جزئیات مربوط به یک تبلیغ تصویری.

videoAd

object ( VideoAdInfo )

جزئیات مربوط به یک تبلیغ ویدیویی.

videoResponsiveAd

object ( VideoResponsiveAdInfo )

جزئیات مربوط به یک تبلیغ پاسخگو ویدیویی.

responsiveSearchAd

object ( ResponsiveSearchAdInfo )

جزئیات مربوط به یک تبلیغ جستجوی واکنشگرا.

legacyResponsiveDisplayAd

object ( LegacyResponsiveDisplayAdInfo )

جزئیات مربوط به یک تبلیغ نمایشی پاسخگو قدیمی.

appAd

object ( AppAdInfo )

جزئیات مربوط به تبلیغ اپلیکیشن

legacyAppInstallAd

object ( LegacyAppInstallAdInfo )

تغییرناپذیر. جزئیات مربوط به آگهی نصب برنامه قدیمی.

responsiveDisplayAd

object ( ResponsiveDisplayAdInfo )

جزئیات مربوط به یک تبلیغ نمایشی واکنشگرا.

localAd

object ( LocalAdInfo )

جزئیات مربوط به یک آگهی محلی

displayUploadAd

object ( DisplayUploadAdInfo )

جزئیات مربوط به آگهی آپلود نمایشی.

appEngagementAd

object ( AppEngagementAdInfo )

جزئیات مربوط به تبلیغ تعامل با برنامه.

shoppingComparisonListingAd

object ( ShoppingComparisonListingAdInfo )

جزئیات مربوط به آگهی فهرست مقایسه خرید.

smartCampaignAd

object ( SmartCampaignAdInfo )

جزئیات مربوط به تبلیغات کمپین هوشمند.

appPreRegistrationAd

object ( AppPreRegistrationAdInfo )

جزئیات مربوط به آگهی پیش ثبت نام برنامه.

demandGenMultiAssetAd

object ( DemandGenMultiAssetAdInfo )

جزئیات مربوط به آگهی چند دارایی تقاضای نسل.

demandGenVideoResponsiveAd

object ( DemandGenVideoResponsiveAdInfo )

جزئیات مربوط به یک آگهی ویدیویی پاسخگوی تقاضای نسل.

demandGenProductAd

object ( DemandGenProductAdInfo )

جزئیات مربوط به یک تبلیغ محصول نسل تقاضا.

travelAd

object ( TravelAdInfo )

جزئیات مربوط به آگهی سفر.

FinalAppUrl

URL برای پیوند عمیق به یک برنامه برای سیستم عامل داده شده.

نمایندگی JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
فیلدها
osType

enum ( AppUrlOperatingSystemType )

سیستم عامل هدف این URL. مورد نیاز.

url

string

URL پیوند عمیق برنامه. پیوندهای عمیق مکانی را در برنامه مشخص می کنند که با محتوایی که می خواهید نشان دهید مطابقت دارد و باید به شکل {scheme}://{host_path} باشد. این طرح مشخص می کند که کدام برنامه باز شود. برای برنامه خود، می توانید از یک طرح سفارشی استفاده کنید که با نام برنامه شروع می شود. میزبان و مسیر مکان منحصر به فرد را در برنامه ای که محتوای شما در آن وجود دارد مشخص می کند. مثال: "exampleapp://productid_1234". مورد نیاز.

AppUrlOperatingSystemType

سیستم عامل

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
IOS سیستم عامل Apple IOS.
ANDROID سیستم عامل اندروید.

نوع تبلیغ

انواع احتمالی یک آگهی

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_TRUEVIEW_IN_STREAM_AD تبلیغ ویدیویی TrueView در جریان.
VIDEO_RESPONSIVE_AD تبلیغ ویدئویی واکنشگرا
SMART_CAMPAIGN_AD تبلیغات کمپین هوشمند
CALL_AD آگهی تماس بگیرید.
APP_PRE_REGISTRATION_AD آگهی پیش ثبت نام جهانی برنامه.
IN_FEED_VIDEO_AD تبلیغ ویدیویی درون فید.
DEMAND_GEN_MULTI_ASSET_AD آگهی چند دارایی تقاضای نسل.
TRAVEL_AD آگهی سفر.
DEMAND_GEN_VIDEO_RESPONSIVE_AD آگهی پاسخگو ویدیویی تقاضای نسل.
DEMAND_GEN_PRODUCT_AD تبلیغ محصول نسل تقاضا

UrlCollection

مجموعه ای از آدرس های اینترنتی که با یک شناسه منحصر به فرد برچسب گذاری شده است.

نمایندگی JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
فیلدها
finalUrls[]

string

لیستی از URL های نهایی ممکن

finalMobileUrls[]

string

فهرستی از URL های نهایی ممکن موبایل.

urlCollectionId

string

شناسه منحصر به فرد برای این نمونه UrlCollection.

trackingUrlTemplate

string

قالب URL برای ساخت URL ردیابی.

SystemManagedResourceSource

فهرستی که منابع موجودیت مدیریت شده احتمالی سیستم را فهرست می کند.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
AD_VARIATIONS آگهی آزمایشی تغییرات تبلیغاتی ایجاد شده.

TextAdInfo

یک تبلیغ متنی

نمایندگی JSON 
{
  "headline": string,
  "description1": string,
  "description2": string
}
فیلدها
headline

string

تیتر آگهی.

description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

ExpandedTextAdInfo

یک تبلیغ متنی گسترده

نمایندگی JSON 
{
  "headlinePart1": string,
  "headlinePart2": string,
  "headlinePart3": string,
  "description": string,
  "description2": string,
  "path1": string,
  "path2": string
}
فیلدها
headlinePart1

string

قسمت اول تیتر آگهی.

headlinePart2

string

قسمت دوم تیتر آگهی.

headlinePart3

string

قسمت سوم تیتر آگهی.

description

string

توضیحات آگهی

description2

string

شرح دوم آگهی.

path1

string

متنی که می تواند در کنار URL نمایش داده شده تبلیغ ظاهر شود.

path2

string

متن اضافی که می تواند در کنار 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 (CallConversionReportingState),
  "path1": string,
  "path2": string
}
فیلدها
countryCode

string

کد کشور در آگهی

phoneNumber

string

شماره تلفن در آگهی

businessName

string

نام تجاری در آگهی

headline1

string

تیتر اول آگهی

headline2

string

عنوان دوم در آگهی

description1

string

خط اول توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

callTracked

boolean

فعال کردن ردیابی تماس برای خلاق. فعال کردن ردیابی تماس، تبدیل تماس را نیز فعال می کند.

disableCallConversion

boolean

غیرفعال کردن تبدیل تماس برای خلاق. اگر روی true تنظیم شود، حتی زمانی که callTracked true باشد، تبدیل تماس را غیرفعال می کند. اگر callTracked false باشد، این فیلد نادیده گرفته می شود.

phoneNumberVerificationUrl

string

URL مورد استفاده برای تأیید شماره تلفن.

conversionAction

string

عمل تبدیل برای نسبت دادن تبدیل تماس به. اگر تنظیم نشده باشد، از یک اقدام تبدیل پیش‌فرض استفاده می‌شود. این فیلد فقط در صورتی تأثیر دارد که callTracked روی true تنظیم شده باشد. در غیر این صورت این فیلد نادیده گرفته می شود.

conversionReportingState

enum ( CallConversionReportingState )

رفتار تبدیل تماس این تبلیغ تماس. می‌تواند از تنظیمات تبدیل تماس خود استفاده کند، تنظیمات سطح حساب را به ارث برده یا غیرفعال شود.

path1

string

قسمت اول متنی که می توان به URL موجود در آگهی اضافه کرد. اختیاری.

path2

string

قسمت دوم متن که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که path1 نیز تنظیم شده باشد. اختیاری.

ExpandedDynamicSearchAdInfo

یک تبلیغ جستجوی پویا گسترده

نمایندگی JSON 
{
  "description": string,
  "description2": string
}
فیلدها
description

string

توضیحات آگهی

description2

string

شرح دوم آگهی.

HotelAdInfo

این نوع هیچ فیلدی ندارد.

آگهی هتل

ShoppingSmartAdInfo

این نوع هیچ فیلدی ندارد.

یک آگهی خرید هوشمند

ShoppingProductAdInfo

این نوع هیچ فیلدی ندارد.

یک آگهی خرید استاندارد

ImageAdInfo

یک تبلیغ تصویری

نمایندگی JSON 
{
  "mimeType": enum (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
فیلدها
mimeType

enum ( MimeType )

نوع میم تصویر.

pixelWidth

string ( int64 format)

عرض تصویر بر حسب پیکسل.

pixelHeight

string ( int64 format)

ارتفاع تصویر در اندازه کامل بر حسب پیکسل.

imageUrl

string

URL تصویر در اندازه کامل.

previewPixelWidth

string ( int64 format)

عرض تصویر اندازه پیش نمایش بر حسب پیکسل.

previewPixelHeight

string ( int64 format)

ارتفاع تصویر اندازه پیش نمایش بر حسب پیکسل.

previewImageUrl

string

URL تصویر اندازه پیش نمایش.

name

string

نام تصویر. اگر تصویر از یک MediaFile ایجاد شده است، این نام MediaFile است. اگر تصویر از بایت ایجاد شده باشد، خالی است.

image میدان اتحادیه تصویری که از آن ImageAd ایجاد می شود. این را می توان به یکی از دو روش مشخص کرد. 1. یک منبع MediaFile موجود. 2. داده های تصویر خام به صورت بایت. image می تواند تنها یکی از موارد زیر باشد:
imageAsset

object ( AdImageAsset )

دارایی های تصویری که برای تبلیغ استفاده می شود.

data

string ( bytes format)

داده های تصویر خام به صورت بایت

رشته ای با کد base64.

adIdToCopyImageFrom

string ( int64 format)

شناسه آگهی برای کپی کردن تصویر.

AdImageAsset

دارایی تصویری که در یک آگهی استفاده می شود.

نمایندگی JSON 
{
  "asset": string
}
فیلدها
asset

string

نام منبع دارایی این تصویر.

VideoAdInfo

یک تبلیغ ویدیویی

نمایندگی JSON 
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
فیلدها
video

object ( AdVideoAsset )

دارایی های ویدیوی YouTube که برای تبلیغ استفاده می شود.

format فیلد اتحادیه طرح فرمت خاص برای فرمت های مختلف ویدئویی. format فقط می تواند یکی از موارد زیر باشد:
inStream

object ( VideoTrueViewInStreamAdInfo )

قالب تبلیغ ویدیویی TrueView در جریان.

bumper

object ( VideoBumperInStreamAdInfo )

باپر ویدیویی قالب تبلیغ در جریان.

outStream

object ( VideoOutstreamAdInfo )

فرمت تبلیغ ویدیویی خارج از جریان.

nonSkippable

object ( VideoNonSkippableInStreamAdInfo )

فرمت تبلیغات درون جریانی ویدیویی غیرقابل رد شدن.

inFeed

object ( InFeedVideoAdInfo )

قالب تبلیغات ویدیویی درون فید.

AdVideoAsset

دارایی ویدیویی که در آگهی استفاده می شود.

نمایندگی JSON 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
فیلدها
asset

string

نام منبع دارایی این ویدیو.

adVideoAssetInfo

object ( AdVideoAssetInfo )

حاوی فیلدهای اطلاعاتی برای این AdVideoAsset است.

AdVideoAssetInfo

حاوی فیلدهای اطلاعاتی AdVideoAssets است.

نمایندگی JSON 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
فیلدها
adVideoAssetInventoryPreferences

object ( AdVideoAssetInventoryPreferences )

فهرست موارد برگزیده موجودی برای این AdVideoAsset. این فیلد را فقط می توان برای DiscoveryVideoResponsiveAd تنظیم کرد. دارایی‌های ویدیویی با مجموعه برگزیده دارایی موجودی نسبت به سایر ویدیوهای همان آگهی در طول زمان ارائه ترجیح داده می‌شوند. به عنوان مثال، در نظر بگیرید که این آگهی برای یک موجودی خاص ارائه شده است. سرور ابتدا سعی می کند یک ویدیوی واجد شرایط را با اولویت منطبق با آن موجودی مطابقت دهد. ویدیوهای بدون اولویت تنها زمانی انتخاب می‌شوند که ویدیویی با اولویت‌های منطبق و واجد شرایط برای یک جایگاه آگهی خاص پیدا شود.

AdVideoAssetInventoryPreferences

تنظیمات برگزیده موجودی دارایی ویدیوی YouTube.

نمایندگی JSON 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
فیلدها
inFeedPreference

boolean

وقتی درست باشد، دارایی ویدیوی YouTube با این اولویت موجودی هنگام انتخاب ویدیویی برای ارائه در فید ترجیح داده می‌شود.

inStreamPreference

boolean

وقتی درست باشد، دارایی ویدیوی YouTube با این موجودی برگزیده هنگام انتخاب ویدیویی برای ارائه در جریان ترجیح داده می‌شود.

shortsPreference

boolean

وقتی درست باشد، دارایی ویدیوی YouTube با این موجودی برگزیده هنگام انتخاب ویدیویی برای نمایش در YouTube Shorts ترجیح داده می‌شود.

VideoTrueViewInStreamAdInfo

نمایش قالب تبلیغ ویدیویی TrueView در جریان (تبلیغی که در حین پخش ویدیو، اغلب در ابتدا نشان داده می‌شود، که دکمه پرش را چند ثانیه بعد از ویدیو نشان می‌دهد).

نمایندگی JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
فیلدها
actionButtonLabel

string

برچسب روی دکمه CTA (Call-to-Action) کاربر را به URL نهایی تبلیغ ویدیویی می برد. برای کمپین های اکشن TrueView مورد نیاز است، در غیر این صورت اختیاری است.

actionHeadline

string

متن اضافی با دکمه CTA (Call-to-Action) نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند.

companionBanner

object ( AdImageAsset )

دارایی های تصویری بنر همراه استفاده شده با آگهی.

VideoBumperInStreamAdInfo

نمایش فرمت آگهی ویدیویی بامپر در جریان (تبلیغ ویدیویی بسیار کوتاه و غیرقابل رد شدن در جریان).

نمایندگی JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
فیلدها
companionBanner

object ( AdImageAsset )

دارایی های تصویری بنر همراه استفاده شده با آگهی.

actionButtonLabel

string

برچسب روی دکمه «Call To Action» کاربر را به نشانی اینترنتی نهایی آگهی ویدیویی می برد.

actionHeadline

string

متن اضافی با دکمه CTA (Call-to-Action) نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند.

VideoOutstreamAdInfo

نمایش فرمت تبلیغ ویدیویی خارج از جریان (آگهی در کنار فید با پخش خودکار، بدون صدا نشان داده می شود).

نمایندگی JSON 
{
  "headline": string,
  "description": string
}
فیلدها
headline

string

تیتر آگهی.

description

string

خط توضیحات

VideoNonSkippableInStreamAdInfo

نمایش فرمت تبلیغ ویدیویی غیرقابل رد شدن در جریان (آگهی ویدیویی غیرقابل رد شدن در جریان 15 ثانیه).

نمایندگی JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
فیلدها
companionBanner

object ( AdImageAsset )

دارایی های تصویری بنر همراه استفاده شده با آگهی.

actionButtonLabel

string

برچسب روی دکمه «Call To Action» کاربر را به نشانی اینترنتی نهایی آگهی ویدیویی می برد.

actionHeadline

string

متن اضافی با دکمه "Call To Action" نمایش داده می شود تا زمینه را ارائه دهد و کلیک روی دکمه را تشویق کند.

InFeedVideoAdInfo

نمایش فرمت تبلیغات ویدیویی In-feed.

نمایندگی JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
فیلدها
headline

string

تیتر آگهی.

description1

string

خط اول متن آگهی

description2

string

خط دوم متن آگهی

thumbnail

enum ( VideoThumbnail )

تصویر کوچک ویدیویی برای استفاده.

تصویر کوچک ویدیو

Enum انواع احتمالی یک تصویر کوچک ویدیو را فهرست می کند.

Enums
UNSPECIFIED نوع آن مشخص نشده است.
UNKNOWN مقدار دریافتی در این نسخه مشخص نیست. این یک مقدار فقط پاسخگویی است.
DEFAULT_THUMBNAIL تصویر کوچک پیش فرض می تواند به صورت خودکار تولید شود یا توسط کاربر آپلود شود.
THUMBNAIL_1 تصویر بندانگشتی 1، ایجاد شده از ویدیو.
THUMBNAIL_2 تصویر بندانگشتی 2، ایجاد شده از ویدیو.
THUMBNAIL_3 تصویر کوچک 3، ایجاد شده از ویدیو.

VideoResponsiveAdInfo

یک تبلیغ ویدئویی واکنشگرا.

نمایندگی JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
فیلدها
headlines[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای تیتر کوتاه استفاده می شود. در حال حاضر، فقط یک مقدار برای عنوان کوتاه پشتیبانی می شود.

longHeadlines[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای تیتر طولانی استفاده می شود. در حال حاضر، تنها یک مقدار برای عنوان طولانی پشتیبانی می شود.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای توضیحات استفاده می شود. در حال حاضر، فقط یک مقدار برای توضیحات پشتیبانی می شود.

callToActions[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای دکمه استفاده می شود، به عنوان مثال، دکمه "Call To Action". در حال حاضر، تنها یک مقدار برای دکمه پشتیبانی می شود.

videos[]

object ( AdVideoAsset )

فهرست دارایی‌های ویدیویی YouTube که برای تبلیغ استفاده می‌شوند. در حال حاضر، تنها یک مقدار برای دارایی ویدیوی YouTube پشتیبانی می‌شود.

companionBanners[]

object ( AdImageAsset )

فهرست دارایی های تصویری استفاده شده برای بنر همراه. در حال حاضر، تنها یک مقدار برای دارایی بنر همراه پشتیبانی می‌شود.

breadcrumb1

string

قسمت اول متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

breadcrumb2

string

قسمت دوم متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

ResponsiveSearchAdInfo

یک تبلیغ جستجوی واکنشگرا

تبلیغات جستجوی واکنشگرا به شما امکان می دهد تبلیغی ایجاد کنید که برای نمایش متن بیشتر و پیام های مرتبط تر به مشتریان شما سازگار باشد. هنگام ایجاد یک تبلیغ جستجوی واکنشگرا، تیترها و توضیحات متعددی وارد کنید، و با گذشت زمان، Google Ads به طور خودکار ترکیب های مختلف را آزمایش می کند و یاد می گیرد که کدام ترکیب ها بهترین عملکرد را دارند. با تطبیق محتوای تبلیغ خود برای مطابقت بیشتر با عبارات جستجوی مشتریان بالقوه، تبلیغات جستجوی پاسخگو ممکن است عملکرد کمپین شما را بهبود بخشد.

اطلاعات بیشتر در https://support.google.com/google-ads/answer/7684791

نمایندگی JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
فیلدها
headlines[]

object ( AdTextAsset )

فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

path1

string

قسمت اول متنی که می توان به URL موجود در آگهی اضافه کرد.

path2

string

قسمت دوم متن که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که path1 نیز تنظیم شده باشد.

LegacyResponsiveDisplayAdInfo

یک تبلیغ نمایشی واکنشگرا قدیمی. تبلیغات از این نوع در رابط کاربری Google Ads با عنوان "تبلیغات پاسخگو" شناخته می شوند.

نمایندگی JSON 
{
  "formatSetting": enum (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
فیلدها
formatSetting

enum ( DisplayAdFormatSetting )

مشخص می کند که تبلیغ در چه قالبی ارائه می شود. پیش فرض ALL_FORMATS است.

shortHeadline

string

نسخه کوتاه تیتر آگهی.

longHeadline

string

نسخه طولانی تیتر آگهی.

description

string

توضیحات آگهی

businessName

string

نام تجاری در آگهی

allowFlexibleColor

boolean

رضایت تبلیغ کننده برای اجازه دادن به رنگ انعطاف پذیر. در صورت صحت، آگهی ممکن است در صورت لزوم با رنگ های مختلف ارائه شود. در صورت نادرست بودن، آگهی با رنگ های مشخص شده یا رنگ خنثی ارائه می شود. مقدار پیش فرض true است. اگر mainColor و accentColor تنظیم نشده باشند باید درست باشد.

accentColor

string

رنگ تاکیدی تبلیغ به صورت هگزا دسیمال، به عنوان مثال، #ffffff برای رنگ سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

mainColor

string

رنگ اصلی تبلیغ به صورت هگزادسیمال، به عنوان مثال، #ffffff برای سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

callToActionText

string

متن دعوت به اقدام برای تبلیغ.

logoImage

string

نام منبع MediaFile تصویر لوگوی استفاده شده در آگهی.

squareLogoImage

string

نام منبع MediaFile تصویر لوگوی مربعی استفاده شده در آگهی.

marketingImage

string

نام منبع MediaFile تصویر بازاریابی استفاده شده در آگهی.

squareMarketingImage

string

نام منبع MediaFile تصویر بازاریابی مربعی مورد استفاده در آگهی.

pricePrefix

string

پیشوند قبل از قیمت به عنوان مثال، "به اندازه پایین".

promoText

string

متن تبلیغاتی مورد استفاده برای قالب‌های پویا تبلیغات واکنش‌گرا. به عنوان مثال "ارسال رایگان دو روزه".

DisplayAdFormatSetting

تنظیمات قالب تبلیغات نمایشی را بر می شمارد.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN مقدار در این نسخه ناشناخته است.
ALL_FORMATS متن، تصویر و فرمت های بومی.
NON_NATIVE فرمت های متن و تصویر
NATIVE قالب بومی، برای مثال، رندر قالب توسط ناشر کنترل می شود نه توسط Google.

AppAdInfo

یک تبلیغ اپلیکیشن

نمایندگی JSON 
{
  "mandatoryAdText": {
    object (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
فیلدها
mandatoryAdText

object ( AdTextAsset )

متن آگهی اجباری

headlines[]

object ( AdTextAsset )

فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

images[]

object ( AdImageAsset )

فهرست دارایی های تصویری که ممکن است همراه با آگهی نمایش داده شوند.

youtubeVideos[]

object ( AdVideoAsset )

فهرست دارایی‌های ویدیوی YouTube که ممکن است همراه با آگهی نمایش داده شوند.

html5MediaBundles[]

object ( AdMediaBundleAsset )

فهرست دارایی‌های بسته رسانه‌ای که ممکن است با آگهی استفاده شود.

AdMediaBundleAsset

دارایی بسته رسانه ای که در یک آگهی استفاده می شود.

نمایندگی JSON 
{
  "asset": string
}
فیلدها
asset

string

نام منبع دارایی این بسته رسانه.

AdAppDeepLinkAsset

یک پیوند عمیق برنامه که در یک تبلیغ استفاده می شود.

نمایندگی JSON 
{
  "asset": string
}
فیلدها
asset

string

نام منبع دارایی این دارایی پیوند عمیق برنامه.

LegacyAppInstallAdInfo

یک تبلیغ نصب برنامه قدیمی که فقط می تواند توسط چند مشتری منتخب استفاده شود.

نمایندگی JSON 
{
  "appStore": enum (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
فیلدها
appStore

enum ( LegacyAppInstallAdAppStore )

فروشگاه اپلیکیشنی که اپلیکیشن موبایل در آن موجود است.

appId

string

شناسه اپلیکیشن موبایل

headline

string

تیتر آگهی.

description1

string

اولین خط توضیحات آگهی.

description2

string

خط دوم توضیحات آگهی.

LegacyAppInstallAdAppStore

فروشگاه برنامه در آگهی نصب برنامه قدیمی تایپ کنید.

Enums
UNSPECIFIED مشخص نشده است.
UNKNOWN فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
APPLE_APP_STORE اپل آیتونز.
GOOGLE_PLAY گوگل پلی.
WINDOWS_STORE فروشگاه ویندوز.
WINDOWS_PHONE_STORE فروشگاه ویندوز فون.
CN_APP_STORE این برنامه در یک فروشگاه برنامه چینی میزبانی می شود.

ResponsiveDisplayAdInfo

یک تبلیغ نمایشی واکنش گرا.

نمایندگی JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
فیلدها
marketingImages[]

object ( AdImageAsset )

تصاویر بازاریابی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 600x314 است و نسبت تصویر باید 1.91:1 (+-1%) باشد. حداقل یک marketingImage مورد نیاز است. در ترکیب با squareMarketingImages ، حداکثر 15 عدد است.

squareMarketingImages[]

object ( AdImageAsset )

تصاویر بازاریابی مربعی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 300x300 است و نسبت تصویر باید 1:1 (+-1%) باشد. حداقل یک marketingImage مربعی مورد نیاز است. در ترکیب با marketingImages ، حداکثر 15 عدد است.

logoImages[]

object ( AdImageAsset )

تصاویر لوگو برای استفاده در تبلیغات انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 512x128 است و نسبت تصویر باید 4:1 (+-1%) باشد. در ترکیب با squareLogoImages ، حداکثر 5 است.

squareLogoImages[]

object ( AdImageAsset )

تصاویر آرم مربعی برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد. همراه با logoImages ، حداکثر 5 است.

headlines[]

object ( AdTextAsset )

سرفصل های کوتاه فرمت آگهی. حداکثر طول 30 کاراکتر است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد.

longHeadline

object ( AdTextAsset )

یک عنوان با فرمت طولانی مورد نیاز. حداکثر طول 90 کاراکتر است.

descriptions[]

object ( AdTextAsset )

متن های توصیفی برای آگهی. حداکثر طول 90 کاراکتر است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد.

youtubeVideos[]

object ( AdVideoAsset )

ویدیوهای اختیاری YouTube برای آگهی. حداکثر 5 ویدیو را می توان مشخص کرد.

formatSetting

enum ( DisplayAdFormatSetting )

مشخص می کند که تبلیغ در چه قالبی ارائه می شود. پیش فرض ALL_FORMATS است.

controlSpec

object ( ResponsiveDisplayAdControlSpec )

مشخصات برای کنترل های خلاقانه مختلف.

businessName

string

تبلیغ کننده / نام تجاری. حداکثر عرض نمایش 25 است.

mainColor

string

رنگ اصلی تبلیغ به صورت هگزادسیمال، به عنوان مثال، #ffffff برای سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

accentColor

string

رنگ تاکیدی تبلیغ به صورت هگزا دسیمال، به عنوان مثال، #ffffff برای رنگ سفید. اگر یکی از mainColor و accentColor تنظیم شده باشد، دیگری نیز مورد نیاز است.

allowFlexibleColor

boolean

رضایت تبلیغ کننده برای اجازه دادن به رنگ انعطاف پذیر. در صورت صحت، آگهی ممکن است در صورت لزوم با رنگ های مختلف ارائه شود. در صورت نادرست بودن، آگهی با رنگ های مشخص شده یا رنگ خنثی ارائه می شود. مقدار پیش فرض true است. اگر mainColor و accentColor تنظیم نشده باشند باید درست باشد.

callToActionText

string

متن دعوت به اقدام برای تبلیغ. حداکثر عرض نمایش 30 است.

pricePrefix

string

پیشوند قبل از قیمت به عنوان مثال، "به اندازه پایین".

promoText

string

متن تبلیغاتی مورد استفاده برای قالب‌های پویا تبلیغات واکنش‌گرا. به عنوان مثال "ارسال رایگان دو روزه".

ResponsiveDisplayAdControlSpec

مشخصات کنترل‌های خلاقانه مختلف برای یک تبلیغ نمایشی واکنش‌گرا.

نمایندگی JSON 
{
  "enableAssetEnhancements": boolean,
  "enableAutogenVideo": boolean
}
فیلدها
enableAssetEnhancements

boolean

اینکه آیا تبلیغ‌کننده ویژگی بهبود دارایی را انتخاب کرده است یا خیر.

enableAutogenVideo

boolean

اینکه آیا تبلیغ‌کننده ویژگی ویدیوی تولید خودکار را انتخاب کرده است یا خیر.

LocalAdInfo

یک تبلیغ محلی

نمایندگی JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
فیلدها
headlines[]

object ( AdTextAsset )

فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند. حداقل 1 و حداکثر 5 عنوان باید مشخص شود.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 توصیف باید مشخص شود.

callToActions[]

object ( AdTextAsset )

فهرست دارایی‌های متنی برای دعوت به اقدام. هنگامی که تبلیغ ارائه می شود، دعوت به اقدام از این لیست انتخاب می شود. حداقل 1 و حداکثر 5 دعوت به اقدام باید مشخص شود.

marketingImages[]

object ( AdImageAsset )

فهرست دارایی های تصویر بازاریابی که ممکن است همراه با آگهی نمایش داده شوند. تصاویر باید 314x600 پیکسل یا 320x320 پیکسل باشند. حداقل 1 و حداکثر 20 دارایی تصویر باید مشخص شود.

logoImages[]

object ( AdImageAsset )

فهرست دارایی های تصویر لوگو که ممکن است همراه با آگهی نمایش داده شود. اندازه تصاویر باید 128x128 پیکسل باشد و از 120 کیلوبایت بیشتر نباشد. حداقل 1 و حداکثر 5 دارایی تصویر باید مشخص شود.

videos[]

object ( AdVideoAsset )

فهرست دارایی‌های ویدیوی YouTube که ممکن است همراه با آگهی نمایش داده شوند. حداقل 1 و حداکثر 20 دارایی ویدیو باید مشخص شود.

path1

string

قسمت اول متن اختیاری که می تواند به URL موجود در آگهی اضافه شود.

path2

string

قسمت دوم متن اختیاری که می تواند به URL موجود در آگهی اضافه شود. این فیلد فقط زمانی قابل تنظیم است که path1 نیز تنظیم شده باشد.

DisplayUploadAdInfo

یک نوع عمومی از تبلیغات نمایشی. قالب دقیق آگهی توسط فیلد displayUploadProductType کنترل می‌شود، که تعیین می‌کند چه نوع داده‌هایی باید در آگهی گنجانده شود.

نمایندگی JSON 
{
  "displayUploadProductType": enum (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
فیلدها
displayUploadProductType

enum ( DisplayUploadProductType )

نوع محصول این آگهی برای جزئیات بیشتر به نظرات روی enum مراجعه کنید.

media_asset میدان اتحادیه . داده های دارایی که آگهی را تشکیل می دهد. media_asset فقط می تواند یکی از موارد زیر باشد:
mediaBundle

object ( AdMediaBundleAsset )

دارایی بسته رسانه ای برای استفاده در آگهی. برای اطلاعات در مورد بسته رسانه برای HTML5_UPLOAD_AD، به https://support.google.com/google-ads/answer/1722096 بسته‌های رسانه‌ای که بخشی از انواع محصول پویا هستند، از قالب خاصی استفاده می‌کنند که باید ازطریق Google Web Designer ایجاد شود. برای اطلاعات بیشتر به 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 (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
فیلدها
headlines[]

object ( AdTextAsset )

فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

images[]

object ( AdImageAsset )

فهرست دارایی های تصویری که ممکن است همراه با آگهی نمایش داده شوند.

videos[]

object ( AdVideoAsset )

فهرست دارایی‌های ویدیویی که ممکن است همراه با آگهی نمایش داده شوند.

ShoppingComparisonListingAdInfo

آگهی فهرست مقایسه خرید.

نمایندگی JSON 
{
  "headline": string
}
فیلدها
headline

string

تیتر آگهی. این فیلد الزامی است. طول مجاز بین 25 تا 45 کاراکتر است.

AppPreRegistrationAdInfo

آگهی‌های پیش‌ثبت‌نام برنامه به فهرست برنامه یا بازی شما در Google Play پیوند دارند و می‌توانند در Google Play، YouTube (فقط در جریان) و در سایر برنامه‌ها و وب‌سایت‌های تلفن همراه در Display Network اجرا شوند. این کمک می کند تا علاقه افراد را به برنامه یا بازی خود جلب کنید و قبل از راه اندازی، یک پایگاه نصب اولیه برای برنامه یا بازی شما ایجاد کند.

نمایندگی JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
فیلدها
headlines[]

object ( AdTextAsset )

فهرست دارایی های متن برای سرفصل ها. هنگامی که تبلیغ ارائه می شود، سرفصل ها از این لیست انتخاب می شوند.

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متن برای توضیحات هنگامی که تبلیغ ارائه می شود، توضیحات از این لیست انتخاب می شود.

images[]

object ( AdImageAsset )

فهرست شناسه‌های دارایی تصویری که تصاویر آنها ممکن است همراه با آگهی نمایش داده شود.

youtubeVideos[]

object ( AdVideoAsset )

فهرست شناسه‌های دارایی ویدیوی YouTube که ویدیوهای آنها ممکن است همراه با آگهی نمایش داده شود.

DemandGenMultiAssetAdInfo

آگهی چند دارایی تقاضای نسل.

نمایندگی JSON 
{
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
فیلدها
marketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 600x314 است و نسبت تصویر باید 1.91:1 (+-1%) باشد. اگر SquareMarketingImages وجود نداشته باشد، الزامی است. ترکیب با squareMarketingImages ، portraitMarketingImages ، و tallPortraitMarketingImages حداکثر 20 عدد است.

squareMarketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی مربعی برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 300x300 است و نسبت تصویر باید 1:1 (+-1%) باشد. در صورت عدم وجود MarketingImages الزامی است. همراه با marketingImages ، portraitMarketingImages ، و tallPortraitMarketingImages حداکثر 20 عدد است.

portraitMarketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی پرتره برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 480x600 و نسبت تصویر باید 4:5 (+-1%) باشد. در ترکیب با marketingImages ، squareMarketingImages ، و tallPortraitMarketingImages حداکثر 20 عدد است.

tallPortraitMarketingImages[]

object ( AdImageAsset )

دارایی های تصویر بازاریابی پرتره بلند برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 600x1067 است و نسبت تصویر باید 9:16 (+-1%) باشد. در ترکیب با marketingImages ، squareMarketingImages ، و portraitMarketingImages ، حداکثر 20 عدد است.

logoImages[]

object ( AdImageAsset )

دارایی های تصویر آرم برای استفاده در آگهی. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد. حداقل 1 و حداکثر 5 تصویر لوگو را می توان مشخص کرد.

headlines[]

object ( AdTextAsset )

دارایی متن عنوان آگهی. حداکثر عرض نمایش 30 است. حداقل 1 و حداکثر 5 عنوان را می توان مشخص کرد.

descriptions[]

object ( AdTextAsset )

متن تشریحی آگهی. حداکثر عرض نمایش 90 است. حداقل 1 و حداکثر 5 توصیف را می توان مشخص کرد.

businessName

string

تبلیغ کننده/نام تجاری حداکثر عرض نمایش 25 است. الزامی است.

callToActionText

string

متن فراخوان برای اقدام.

leadFormOnly

boolean

گزینه Boolean که نشان می دهد آیا این آگهی باید با فرم سرنخ ارائه شود یا خیر.

DemandGenCarouselAdInfo

تبلیغ چرخ و فلک نسل تقاضا.

نمایندگی JSON 
{
  "businessName": string,
  "logoImage": {
    object (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
فیلدها
businessName

string

مورد نیاز. تبلیغ کننده/نام تجاری

logoImage

object ( AdImageAsset )

مورد نیاز. تصویر لوگو برای استفاده در تبلیغات. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد.

headline

object ( AdTextAsset )

مورد نیاز. تیتر آگهی.

description

object ( AdTextAsset )

مورد نیاز. متن تشریحی آگهی.

callToActionText

string

متن فراخوان برای اقدام.

carouselCards[]

object ( AdDemandGenCarouselCardAsset )

مورد نیاز. کارت های چرخ فلک که همراه با آگهی نمایش داده می شوند. حداقل 2 حداکثر 10.

AdDemandGenCarouselCardAsset

دارایی کارت چرخ فلک نسل تقاضا که در یک آگهی استفاده می شود.

نمایندگی JSON 
{
  "asset": string
}
فیلدها
asset

string

نام منبع دارایی این کارت چرخ فلک اکتشافی.

DemandGenVideoResponsiveAdInfo

یک تبلیغ ویدئویی پاسخگوی نسل تقاضا.

نمایندگی JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
فیلدها
headlines[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای تیتر کوتاه استفاده می شود.

longHeadlines[]

object ( AdTextAsset )

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

descriptions[]

object ( AdTextAsset )

فهرست دارایی های متنی که برای توضیحات استفاده می شود.

videos[]

object ( AdVideoAsset )

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

logoImages[]

object ( AdImageAsset )

تصویر لوگو برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد.

breadcrumb1

string

قسمت اول متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

breadcrumb2

string

قسمت دوم متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

businessName

object ( AdTextAsset )

مورد نیاز. تبلیغ کننده / نام تجاری.

callToActions[]

object ( AdCallToActionAsset )

دارایی هایی از نوع CallToActionAsset که برای دکمه "Call To Action" استفاده می شود.

AdCallToActionAsset

دارایی دعوت به اقدامی که در یک آگهی استفاده می شود.

نمایندگی JSON 
{
  "asset": string
}
فیلدها
asset

string

نام منبع دارایی این دارایی فراخوان برای اقدام.

DemandGenProductAdInfo

تبلیغ محصول نسل تقاضا

نمایندگی JSON 
{
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
فیلدها
breadcrumb1

string

قسمت اول متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

breadcrumb2

string

قسمت دوم متنی که با URL نمایش داده شده در آگهی ظاهر می شود.

businessName

object ( AdTextAsset )

مورد نیاز. تبلیغ کننده / نام تجاری.

headline

object ( AdTextAsset )

مورد نیاز. دارایی نوشتاری مورد استفاده برای عنوان کوتاه.

description

object ( AdTextAsset )

مورد نیاز. دارایی نوشتاری مورد استفاده برای توضیحات

logoImage

object ( AdImageAsset )

مورد نیاز. تصویر لوگو برای استفاده در تبلیغات. انواع تصویر معتبر GIF، JPEG و PNG هستند. حداقل اندازه 128x128 است و نسبت تصویر باید 1:1 (+-1%) باشد.

callToAction

object ( AdCallToActionAsset )

دارایی از نوع CallToActionAsset که برای دکمه "Call To Action" استفاده می شود.

TravelAdInfo

این نوع هیچ فیلدی ندارد.

یک آگهی مسافرتی