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)

רשימה של כתובות URL סופיות של האפליקציה שבהן המערכת תשתמש בנייד אם האפליקציה הספציפית מותקנת אצל המשתמש.
finalMobileUrls[]

string

רשימת כתובות ה-URL הסופיות האפשריות בנייד אחרי כל ההפניות האוטומטיות בין דומיינים של המודעה.
urlCustomParameters[]

object (CustomParameter)

רשימת המיפויים שאפשר להשתמש בהם כדי להחליף תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls. כדי לבצע שינויים, צריך להשתמש בפעולות של פרמטרים מותאמים אישית של כתובת URL.
type

enum (AdType)

פלט בלבד. סוג המודעה.
devicePreference

enum (Device)

העדפת המכשיר של המודעה. אפשר לציין רק העדפה למכשירים ניידים. כשמגדירים את ההעדפה הזו, המודעה תקבל עדיפות על פני מודעות אחרות כשהיא תוצג במכשיר נייד. המודעה עדיין יכולה להופיע בסוגי מכשירים אחרים, למשל אם אין מודעות אחרות זמינות. אם לא צוין (אין העדפת מכשיר), כל המכשירים ייכללו בטירגוט. האפשרות הזו נתמכת רק בחלק מסוגי המודעות.
urlCollections[]

object (UrlCollection)

כתובות URL נוספות של המודעה שמתויגות במזהה ייחודי שאפשר להפנות אליו משדות אחרים במודעה.
systemManagedResourceSource

enum (SystemManagedResourceSource)

פלט בלבד. אם המודעה הזו מנוהלת על ידי המערכת, השדה הזה יציין את המקור. השדה הזה הוא לקריאה בלבד.
id

string (int64 format)

פלט בלבד. המזהה של המודעה.
trackingUrlTemplate

string

תבנית כתובת ה-URL ליצירת כתובת URL למעקב.
finalUrlSuffix

string

הסיומת שבה משתמשים בזמן יצירת כתובת URL סופית.
displayUrl

string

כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות.
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)

לא ניתן לשינוי. פרטים שקשורים למודעה דינמית מורחבת לרשת החיפוש. הכותרת, כתובות ה-URL הסופיות וכתובת ה-URL לתצוגה של מודעות מהסוג הזה נוצרות באופן אוטומטי בזמן הצגת המודעה, בהתאם למידע ספציפי לגבי שם הדומיין שסופק על ידי 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

מערכת הפעלה

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
IOS מערכת ההפעלה Apple IOS.
ANDROID מערכת ההפעלה Android.

AdType

הסוגים האפשריים של מודעה.

טיפוסים בני מנייה (enum)
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 מודעת וידאו In-stream שלא ניתן לדלג עליה.
VIDEO_TRUEVIEW_IN_STREAM_AD מודעת וידאו TrueView In-stream.
VIDEO_RESPONSIVE_AD מודעת וידאו רספונסיבית.
SMART_CAMPAIGN_AD מודעת קמפיין חכם.
CALL_AD מודעה לשיחות.
APP_PRE_REGISTRATION_AD מודעה לרישום מראש בקמפיין אוניברסלי לאפליקציה.
IN_FEED_VIDEO_AD מודעת וידאו בגוף הפיד.
DEMAND_GEN_MULTI_ASSET_AD מודעת Demand Gen עם כמה נכסים.
TRAVEL_AD מודעת נסיעות.
DEMAND_GEN_VIDEO_RESPONSIVE_AD מודעת וידאו עם קריאה לפעולה ליצירת ביקוש.
DEMAND_GEN_PRODUCT_AD מודעת מוצר ליצירת ביקוש.

UrlCollection

אוסף של כתובות URL שמתויגות במזהה ייחודי.

ייצוג ב-JSON 
{
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCollectionId": string,
  "trackingUrlTemplate": string
}
שדות
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות.
finalMobileUrls[]

string

רשימה של כתובות URL סופיות אפשריות לנייד.
urlCollectionId

string

המזהה הייחודי של מופע UrlCollection הזה.
trackingUrlTemplate

string

תבנית של כתובת URL ליצירת כתובת URL למעקב.

SystemManagedResourceSource

Enum שמפרט את המקורות האפשריים של ישויות שמנוהלות על ידי המערכת.

טיפוסים בני מנייה (enum)
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)

סוג ה-MIME של התמונה.
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 In-stream.
bumper

object (VideoBumperInStreamAdInfo)

פורמט של מודעת וידאו באמפר בסרטון.
outStream

object (VideoOutstreamAdInfo)

פורמט של מודעת וידאו מחוץ לזרם.
nonSkippable

object (VideoNonSkippableInStreamAdInfo)

פורמט של מודעת וידאו In-stream שלא ניתן לדלג עליה.
inFeed

object (InFeedVideoAdInfo)

פורמט של מודעת וידאו בגוף הפיד.

AdVideoAsset

נכס וידאו שמשמש במודעה.

ייצוג ב-JSON 
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
שדות
asset

string

שם המשאב של הנכס של הסרטון הזה.
adVideoAssetInfo

object (AdVideoAssetInfo)

מכיל שדות מידע של AdVideoAsset הזה.

AdVideoAssetInfo

מכיל שדות מידע של נכסי וידאו של מודעות.

ייצוג ב-JSON 
{
  "adVideoAssetInventoryPreferences": {
    object (AdVideoAssetInventoryPreferences)
  }
}
שדות
adVideoAssetInventoryPreferences

object (AdVideoAssetInventoryPreferences)

רשימת ההעדפות של מלאי שטחי הפרסום של AdVideoAsset הזה. אפשר להגדיר את השדה הזה רק ל-DiscoveryVideoResponsiveAd. נכסי הווידאו שהוגדרה להם העדפה לנכס במלאי שטחי הפרסום יקבלו עדיפות על פני סרטונים אחרים מאותה מודעה במהלך זמן ההצגה. לדוגמה, נניח שהמודעה הזו מוצגת במלאי שטחי פרסום ספציפי. השרת ינסה קודם להתאים סרטון מתאים להעדפה תואמת במלאי שטחי הפרסום הזה. סרטונים ללא העדפות נבחרים רק אם לא ניתן למצוא סרטון עם העדפה תואמת שעומד בדרישות של מיקום מודעה נתון.

AdVideoAssetInventoryPreferences

העדפות לגבי מלאי שטחי פרסום לנכסי וידאו ב-YouTube.

ייצוג ב-JSON 
{
  "inFeedPreference": boolean,
  "inStreamPreference": boolean,
  "shortsPreference": boolean
}
שדות
inFeedPreference

boolean

אם הערך הוא True, נכס וידאו ב-YouTube עם העדפת מלאי שטחי הפרסום הזו יקבל עדיפות כשבוחרים סרטון להצגה בפיד.
inStreamPreference

boolean

אם הערך הוא true, נכס וידאו ב-YouTube עם העדפת מלאי שטחי הפרסום הזו יהיה המועדף כשבוחרים סרטון להצגה במודעות וידאו In-stream.
shortsPreference

boolean

אם הערך של הפרמטר הזה הוא true, נכס הווידאו ב-YouTube עם ההעדפה הזו לגבי מלאי שטחי הפרסום יקבל עדיפות כשבוחרים סרטון להצגה ב-YouTube Shorts.

VideoTrueViewInStreamAdInfo

ייצוג של פורמט מודעת וידאו TrueView In-stream (מודעה שמוצגת במהלך הפעלת הסרטון, לרוב בהתחלה, ומוצג בה לחצן דילוג כמה שניות אחרי תחילת הסרטון).

ייצוג ב-JSON 
{
  "actionButtonLabel": string,
  "actionHeadline": string,
  "companionBanner": {
    object (AdImageAsset)
  }
}
שדות
actionButtonLabel

string

התווית בלחצן הקריאה לפעולה, שלחיצה עליו מעבירה את המשתמש לכתובת ה-URL הסופית של מודעת הווידאו. חובה בקמפיינים מסוג TrueView עם קריאה לפעולה, אופציונלי במקרים אחרים.
actionHeadline

string

טקסט נוסף שמוצג עם לחצן הקריאה לפעולה (CTA) כדי לספק הקשר ולעודד לחיצה על הלחצן.
companionBanner

object (AdImageAsset)

נכסי התמונות של מודעת הבאנר הנלווית שנעשה בה שימוש עם המודעה.

VideoBumperInStreamAdInfo

ייצוג של פורמט של מודעת וידאו באמפר In-stream (מודעת וידאו קצרה מאוד ב-In-stream שלא ניתן לדלג עליה).

ייצוג ב-JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
שדות
companionBanner

object (AdImageAsset)

נכסי התמונות של מודעת הבאנר הנלווית שנעשה בה שימוש עם המודעה.
actionButtonLabel

string

התווית בלחצן 'קריאה לפעולה', שלחיצה עליו מעבירה את המשתמש לכתובת ה-URL הסופית של מודעת הווידאו.
actionHeadline

string

טקסט נוסף שמוצג עם לחצן הקריאה לפעולה (CTA) כדי לספק הקשר ולעודד לחיצה על הלחצן.

VideoOutstreamAdInfo

ייצוג של פורמט של מודעת וידאו Outstream (מודעה שמוצגת לצד פיד עם הפעלה אוטומטית, ללא צליל).

ייצוג ב-JSON 
{
  "headline": string,
  "description": string
}
שדות
headline

string

הכותרת של המודעה.
description

string

שורת התיאור.

VideoNonSkippableInStreamAdInfo

ייצוג של פורמט של מודעת וידאו In-stream שלא ניתן לדלג עליה (מודעת וידאו In-stream באורך 15 שניות שלא ניתן לדלג עליה).

ייצוג ב-JSON 
{
  "companionBanner": {
    object (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
שדות
companionBanner

object (AdImageAsset)

נכסי התמונות של מודעת הבאנר הנלווית שנעשה בה שימוש עם המודעה.
actionButtonLabel

string

התווית בלחצן 'קריאה לפעולה', שלחיצה עליו מעבירה את המשתמש לכתובת ה-URL הסופית של מודעת הווידאו.
actionHeadline

string

טקסט נוסף שמוצג עם לחצן הקריאה לפעולה כדי לספק הקשר ולעודד לחיצה על הלחצן.

InFeedVideoAdInfo

ייצוג של פורמט מודעת הווידאו בגוף הפיד.

ייצוג ב-JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "thumbnail": enum (VideoThumbnail)
}
שדות
headline

string

הכותרת של המודעה.
description1

string

שורת הטקסט הראשונה של המודעה.
description2

string

שורת הטקסט השנייה של המודעה.
thumbnail

enum (VideoThumbnail)

תמונה ממוזערת של הסרטון לשימוש.

VideoThumbnail

Enum שמפרט את הסוגים האפשריים של תמונה ממוזערת של סרטון.

טיפוסים בני מנייה (enum)
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)

רשימה של נכסי טקסט ששימשו ללחצן, למשל לחצן 'קריאה לפעולה'. בשלב הזה יש תמיכה רק בערך יחיד ללחצן.
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, ייתכן שהמודעה תוצג בצבע שונה במקרה הצורך. כשהערך הוא false, המודעה תוצג עם הצבעים שצוינו או עם צבע נייטרלי. ערך ברירת המחדל הוא true. הערך חייב להיות 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

מציג פירוט של הגדרות הפורמט של מודעות לרשת המדיה.

טיפוסים בני מנייה (enum)
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

סוג חנות האפליקציות במודעה קודמת להתקנת אפליקציה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
APPLE_APP_STORE Apple iTunes.
GOOGLE_PLAY Google Play.
WINDOWS_STORE Windows Store.
WINDOWS_PHONE_STORE חנות Windows Phone.
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 תווים. אפשר לציין לפחות כותרת אחת ועד 5 כותרות.
longHeadline

object (AdTextAsset)

כותרת ארוכה חובה. האורך המקסימלי הוא 90 תווים.
descriptions[]

object (AdTextAsset)

טקסטים תיאוריים של המודעה. האורך המקסימלי הוא 90 תווים. אפשר לציין לפחות כותרת אחת ועד 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, ייתכן שהמודעה תוצג בצבע שונה במקרה הצורך. כשהערך הוא false, המודעה תוצג עם הצבעים שצוינו או עם צבע נייטרלי. ערך ברירת המחדל הוא true. הערך חייב להיות 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)

רשימה של נכסי טקסט לכותרות. כשהמודעה תוצג, הכותרות ייבחרו מהרשימה הזו. צריך לציין לפחות כותרת אחת ולפחות 5 כותרות.
descriptions[]

object (AdTextAsset)

רשימת נכסי טקסט לתיאורים. כשהמודעה תוצג, התיאורים ייבחרו מהרשימה הזו. צריך לציין לפחות תיאור אחד ולפחות 5 תיאורים.
callToActions[]

object (AdTextAsset)

רשימת נכסי טקסט לקריאות לפעולה. כשהמודעה תוצג, הקריאות לפעולה ייבחרו מהרשימה הזו. צריך לציין לפחות קריאה אחת לפעולה ולפחות 5 קריאות לפעולה.
marketingImages[]

object (AdImageAsset)

רשימה של נכסי תמונות שיווקיות שעשויים להופיע עם המודעה. התמונות חייבות להיות בגודל 314x600 פיקסלים או 320x320 פיקסלים. צריך לציין לפחות נכס תמונה אחד ולפחות 20 נכסי תמונה.
logoImages[]

object (AdImageAsset)

רשימת נכסי תמונות הלוגו שעשויים להופיע עם המודעה. התמונות צריכות להיות בגודל 128x128 פיקסלים ובגודל של עד 120KB. צריך לציין לפחות נכס תמונה אחד ולפחות 5 נכסי תמונה.
videos[]

object (AdVideoAsset)

רשימה של נכסי וידאו ב-YouTube שעשויים להופיע עם המודעה. צריך לציין לפחות נכס וידאו אחד ולפחות 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

מציגה את סוגי המוצרים להעלאה לרשת המדיה.

טיפוסים בני מנייה (enum)
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 (In-stream בלבד) ובתוך אפליקציות ואתרים אחרים לנייד ברשת המדיה. הקמפיין יעזור לכם למשוך את תשומת הלב של אנשים לאפליקציה או למשחק שלכם וליצור בסיס התקנות מוקדם לאפליקציה או למשחק לפני ההשקה.

ייצוג ב-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

מודעת Demand Gen עם כמה נכסים.

ייצוג ב-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. הגודל המינימלי הוא 600x1,067 ויחס הגובה-רוחב חייב להיות 9:16 (+-1%). יחד עם marketingImages,‏ squareMarketingImages ו-portraitMarketingImages, המספר המקסימלי הוא 20.
logoImages[]

object (AdImageAsset)

נכסי תמונות של הלוגו שישמשו במודעה. סוגי התמונות התקינים הם GIF,‏ JPEG ו-PNG. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). אפשר לציין לפחות תמונת לוגו אחת ועד 5 תמונות לוגו.
headlines[]

object (AdTextAsset)

נכס הטקסט של הכותרת של המודעה. רוחב התצוגה המקסימלי הוא 30. אפשר לציין לפחות כותרת אחת ועד 5 כותרות.
descriptions[]

object (AdTextAsset)

הטקסט התיאורי של המודעה. רוחב התצוגה המקסימלי הוא 90. אפשר לציין לפחות תיאור אחד ולמעלה מ-5 תיאורים.
businessName

string

שם המפרסם או המותג. רוחב התצוגה המקסימלי הוא 25. חובה.
callToActionText

string

טקסט של קריאה לפעולה.
leadFormOnly

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

שם המשאב של הנכס בכרטיס קרוסלה Discovery הזה.

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 המשמשים ללחצן 'קריאה לפעולה'.

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 שמשמש ללחצן 'קריאה לפעולה'.

TravelAdInfo

אין שדות לסוג הזה.

מודעת נסיעות.