- משאב: מודעה
- FinalAppUrl
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- מכשיר
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint,
- CountryConstraintList
- CountryConstraint
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
- שיטות
משאב: מודעה
מודעה.
ייצוג JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
שדות | |
---|---|
resourceName |
בלתי משתנה. שם המשאב של המודעה. השמות של משאבי המודעות הם בפורמט הבא:
|
finalUrls[] |
הרשימה של כתובות ה-URL הסופיות האפשריות לאחר כל ההפניות האוטומטיות בדומיינים של המודעה. |
finalAppUrls[] |
רשימה של כתובות ה-URL הסופיות של האפליקציה שהמערכת תשתמש בהן לנייד אם האפליקציה הספציפית מותקנת במכשיר. |
finalMobileUrls[] |
הרשימה של כתובות ה-URL הסופיות האפשריות בנייד לאחר כל ההפניות האוטומטיות בדומיינים של המודעה. |
urlCustomParameters[] |
רשימת המיפויים שאפשר להשתמש בהם כדי להחליף תגי פרמטרים מותאמים אישית ב- |
type |
פלט בלבד. סוג המודעה. |
devicePreference |
העדפת המכשיר עבור המודעה. ניתן לציין העדפה למכשירים ניידים בלבד. כאשר העדפה זו מוגדרת, המודעה תקבל עדיפות על פני מודעות אחרות בעת הצגתה בנייד. המודעה עדיין יכולה להופיע בסוגים אחרים של מכשירים, לדוגמה, אם אין מודעות אחרות זמינות. אם לא צוינה (אין העדפת מכשיר), יתבצע טירגוט לכל המכשירים. האפשרות הזו נתמכת רק בחלק מסוגי המודעות. |
urlCollections[] |
כתובות URL נוספות של המודעה עם תיוג של מזהה ייחודי, שניתן להפנות אליו משדות אחרים במודעה. |
systemManagedResourceSource |
פלט בלבד. אם המודעה מנוהלת על ידי המערכת, השדה הזה יציין את המקור. השדה הזה הוא לקריאה בלבד. |
id |
פלט בלבד. המזהה של המודעה. |
trackingUrlTemplate |
התבנית של כתובת ה-URL ליצירת כתובת URL למעקב. |
finalUrlSuffix |
הסיומת שבה צריך להשתמש כשיוצרים כתובת URL סופית. |
displayUrl |
כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות. |
addedByGoogleAds |
פלט בלבד. שדה זה מציין אם המודעה נוספה אוטומטית על ידי Google Ads ולא על ידי משתמש. לדוגמה, מצב כזה יכול לקרות כאשר מודעות נוצרות באופן אוטומטי כהצעות למודעות חדשות, על סמך ידיעת הביצועים של המודעות הקיימות. |
name |
בלתי משתנה. השם של המודעה. הוא משמש רק כדי לזהות את המודעה. הוא לא חייב להיות ייחודי ואין לו השפעה על המודעה המוצגת. שדה השם נתמך כרגע רק עבור DisplayUploadAd, ImageAd, ShoppingComparisonListingAd ו-VideoAd. |
שדה איחוד ad_data . פרטים שרלוונטיים לסוג המודעה. יש להגדיר ערך אחד בדיוק. ad_data יכול להיות רק אחד מהבאים: |
|
textAd |
בלתי משתנה. פרטים שקשורים למודעת טקסט. |
expandedTextAd |
פרטים שקשורים למודעת טקסט מורחבת. |
callAd |
פרטים שקשורים למודעה לשיחות. |
expandedDynamicSearchAd |
בלתי משתנה. פרטים שקשורים למודעה דינמית מורחבת לרשת החיפוש. למודעה מסוג זה יש כותרת, כתובות URL סופיות וכתובת URL לתצוגה שנוצרו באופן אוטומטי בזמן ההצגה, בהתאם למידע הספציפי לשם הדומיין שסופק על ידי |
hotelAd |
פרטים שקשורים למודעה להזמנת חדרים. |
shoppingSmartAd |
פרטים שקשורים למודעת שופינג חכמה. |
shoppingProductAd |
פרטים שקשורים למודעת שופינג למוצר. |
imageAd |
בלתי משתנה. פרטים שקשורים למודעת תמונה. |
videoAd |
פרטים שקשורים למודעת וידאו. |
videoResponsiveAd |
פרטים שקשורים למודעת וידאו רספונסיבית. |
responsiveSearchAd |
פרטים שקשורים למודעה רספונסיבית לרשת החיפוש. |
legacyResponsiveDisplayAd |
פרטים שקשורים למודעה רספונסיבית מדור קודם לרשת המדיה. |
appAd |
פרטים שקשורים למודעה לאפליקציה. |
legacyAppInstallAd |
בלתי משתנה. פרטים שקשורים למודעה מדור קודם להתקנת אפליקציה. |
responsiveDisplayAd |
פרטים שקשורים למודעה רספונסיבית לרשת המדיה (RDA). |
localAd |
פרטים שקשורים למודעה מקומית. |
displayUploadAd |
פרטים שקשורים למודעה להעלאה לרשת המדיה. |
appEngagementAd |
פרטים שקשורים למודעה לעידוד השימוש באפליקציה. |
shoppingComparisonListingAd |
פרטים שקשורים למודעת השוואת מחירים בשופינג. |
smartCampaignAd |
פרטים שקשורים למודעה בקמפיין חכם. |
appPreRegistrationAd |
פרטים שקשורים למודעה לרישום מראש לאפליקציה. |
discoveryMultiAssetAd |
פרטים שקשורים למודעת Discovery עם כמה נכסים. |
discoveryCarouselAd |
פרטים שקשורים למודעת קרוסלה Discovery. |
discoveryVideoResponsiveAd |
פרטים שקשורים למודעת רספונסיבית של וידאו Discovery. |
demandGenProductAd |
פרטים שקשורים למודעת מוצר ליצירת ביקוש. |
travelAd |
פרטים שקשורים למודעה בנושא נסיעות. |
FinalAppUrl
כתובת URL לקישור עומק לאפליקציה שמיועדת למערכת ההפעלה הנתונה.
ייצוג JSON |
---|
{
"osType": enum ( |
שדות | |
---|---|
osType |
מערכת ההפעלה שכתובת ה-URL הזו מטרגטת. חובה. |
url |
כתובת ה-URL של קישור העומק לאפליקציה. קישורי עומק מציינים מיקום באפליקציה התואם לתוכן שברצונך להציג, והם צריכים להיות בפורמט {scheme}://{host_path}. הסכמה מזהה את האפליקציה שיש לפתוח. עבור האפליקציה, אפשר להשתמש בסכמה מותאמת אישית שמתחילה בשם האפליקציה. המארח והנתיב מציינים את המיקום הייחודי באפליקציה שבו נמצא התוכן שלכם. דוגמה: "exampleapp://productid_1234". חובה. |
AppUrlOperatingSystemType
מערכת הפעלה
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
IOS |
מערכת ההפעלה של Apple IOS. |
ANDROID |
מערכת ההפעלה Android. |
CustomParameter
מיפוי שיכול לשמש תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate
, finalUrls
או mobile_final_urls
.
ייצוג JSON |
---|
{ "key": string, "value": string } |
שדות | |
---|---|
key |
המפתח שתואם לשם של תג הפרמטר. |
value |
הערך להחלפה. |
AdType
הסוגים האפשריים של מודעה.
טיפוסים בני מנייה (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 |
המודעה היא מודעה רספונסיבית לרשת המדיה (RDA). |
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_OUTSTREAM_AD |
מודעת וידאו Outstream. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
מודעת וידאו TrueView In-stream. |
VIDEO_RESPONSIVE_AD |
מודעת וידאו רספונסיבית. |
SMART_CAMPAIGN_AD |
מודעה בקמפיין חכם. |
CALL_AD |
מודעה לשיחות. |
APP_PRE_REGISTRATION_AD |
מודעה אוניברסלית לרישום מראש באפליקציות. |
IN_FEED_VIDEO_AD |
מודעת וידאו בגוף הפיד. |
DISCOVERY_MULTI_ASSET_AD |
מודעת Discovery עם כמה נכסים. |
DISCOVERY_CAROUSEL_AD |
מודעת קרוסלה Discovery. |
TRAVEL_AD |
מודעה לנסיעות. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
מודעה רספונסיבית של וידאו Discovery. |
DEMAND_GEN_PRODUCT_AD |
מודעת מוצר ליצירת ביקוש. |
מכשיר
פירוט של מכשירי Google Ads שזמינים לטירגוט.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
MOBILE |
ניידים עם דפדפני אינטרנט מלאים. |
TABLET |
טאבלטים עם דפדפנים מלאים. |
DESKTOP |
מחשבים. |
CONNECTED_TV |
טלוויזיות חכמות וקונסולות משחקים. |
OTHER |
סוגי מכשירים אחרים. |
UrlCollection
אוסף של כתובות URL שתויגו במזהה ייחודי.
ייצוג 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 |
סוג ה-MIME של התמונה. |
pixelWidth |
רוחב התמונה בגודל מלא בפיקסלים. |
pixelHeight |
הגובה בפיקסלים של התמונה בגודל מלא. |
imageUrl |
כתובת ה-URL של התמונה בגודל מלא. |
previewPixelWidth |
הרוחב בפיקסלים של התמונה בגודל התצוגה המקדימה. |
previewPixelHeight |
הגובה בפיקסלים של התמונה בגודל התצוגה המקדימה. |
previewImageUrl |
כתובת ה-URL של התמונה בגודל התצוגה המקדימה. |
name |
שם התמונה. אם התמונה נוצרה מ-MediaFile, זהו השם של MediaFile. אם התמונה נוצרה מבייטים, השדה הזה ריק. |
שדה איחוד image . התמונה שממנה יש ליצור את מודעת התמונה. אפשר לציין את זה באחת משתי דרכים. 1. משאב קיים של MediaFile. 2. נתוני התמונה הגולמיים כבייטים. image יכול להיות רק אחד מהבאים: |
|
imageAsset |
נכסי התמונות ששימשו למודעה. |
data |
נתוני תמונות גולמיים כבייטים. מחרוזת בקידוד base64. |
adIdToCopyImageFrom |
מזהה מודעה שממנו מעתיקים את התמונה. |
MimeType
סוג MIME
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
סוג ה-MIME לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
IMAGE_JPEG |
סוג MIME של התמונה/jpeg. |
IMAGE_GIF |
סוג MIME של התמונה/ה-GIF. |
IMAGE_PNG |
סוג MIME של התמונה/png. |
FLASH |
סוג MIME של היישום/x-shockwave-Flash. |
TEXT_HTML |
סוג MIME של הטקסט/html. |
PDF |
סוג MIME של האפליקציה/pdf. |
MSWORD |
סוג MIME של האפליקציה/מילת המפתח. |
MSEXCEL |
סוג MIME של application/vnd.ms-excel. |
RTF |
סוג MIME של האפליקציה/rtf. |
AUDIO_WAV |
סוג MIME של Audio/wav. |
AUDIO_MP3 |
סוג MIME של האודיו/mp3. |
HTML5_AD_ZIP |
סוג MIME של application/x-html5-ad-zip. |
AdImageAsset
נכס תמונות שמופיע במודעה.
ייצוג JSON |
---|
{ "asset": string } |
שדות | |
---|---|
asset |
שם המשאב של התמונה הזו. |
VideoAdInfo
מודעת וידאו.
ייצוג JSON |
---|
{ "video": { object ( |
שדות | |
---|---|
video |
נכסי הווידאו ב-YouTube ששימשו למודעה. |
שדה איחוד format . סכימה ספציפית לפורמט לפורמטים השונים של וידאו. format יכול להיות רק אחד מהבאים: |
|
inStream |
פורמט של מודעת וידאו TrueView In-stream. |
bumper |
פורמט של מודעת וידאו באמפר מסוג In-stream. |
outStream |
פורמט של מודעת וידאו Outstream. |
nonSkippable |
פורמט של מודעת וידאו In-stream שלא ניתן לדלג עליה. |
inFeed |
פורמט של מודעת וידאו בגוף הפיד. |
AdVideoAsset
נכס וידאו בתוך מודעה.
ייצוג JSON |
---|
{ "asset": string } |
שדות | |
---|---|
asset |
שם המשאב של הנכס בסרטון הזה. |
VideoTrueViewInStreamAdInfo
ייצוג של פורמט מודעת וידאו TrueView In-stream (מודעה שמוצגת במהלך הפעלת סרטון, לעיתים קרובות בתחילת הסרטון), שבה מוצג לחצן דילוג מספר שניות לאחר תחילת הסרטון).
ייצוג JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
שדות | |
---|---|
actionButtonLabel |
התווית בלחצן ה-CTA (קריאה לפעולה) שמעביר את המשתמש לכתובת ה-URL הסופית של מודעת הווידאו. חובה בקמפיינים של TrueView עם קריאה לפעולה. אחרת, אופציונלי. |
actionHeadline |
טקסט נוסף שמוצג עם לחצן ה-CTA (קריאה לפעולה) כדי לתת הקשר ולעודד לחיצה על הלחצן. |
companionBanner |
נכסי התמונות של מודעת הבאנר הנלווית שבה נעשה שימוש עם המודעה. |
VideoBumperInStreamAdInfo
ייצוג של פורמט מודעת וידאו In-stream (מודעת וידאו In-stream קצרה מאוד שלא ניתן לדלג עליה).
ייצוג JSON |
---|
{
"companionBanner": {
object ( |
שדות | |
---|---|
companionBanner |
נכסי התמונות של מודעת הבאנר הנלווית שבה נעשה שימוש עם המודעה. |
actionButtonLabel |
התווית בלחצן 'קריאה לפעולה', שמעביר את המשתמש לכתובת האתר הסופית של מודעת הווידאו. |
actionHeadline |
טקסט נוסף שמוצג עם לחצן ה-CTA (קריאה לפעולה) כדי לתת הקשר ולעודד לחיצה על הלחצן. |
VideoOutstreamAdInfo
ייצוג פורמט של מודעת וידאו Outstream (מודעה שמוצגת לצד פיד עם הפעלה אוטומטית, ללא קול).
ייצוג JSON |
---|
{ "headline": string, "description": string } |
שדות | |
---|---|
headline |
הכותרת של המודעה. |
description |
שורת התיאור. |
VideoNonSkippableInStreamAdInfo
ייצוג פורמט של מודעת וידאו In-stream שלא ניתן לדלג עליה (מודעת וידאו In-stream באורך 15 שניות שלא ניתן לדלג עליה).
ייצוג JSON |
---|
{
"companionBanner": {
object ( |
שדות | |
---|---|
companionBanner |
נכסי התמונות של מודעת הבאנר הנלווית שבה נעשה שימוש עם המודעה. |
actionButtonLabel |
התווית בלחצן 'קריאה לפעולה', שמעביר את המשתמש לכתובת האתר הסופית של מודעת הווידאו. |
actionHeadline |
טקסט נוסף שמוצג עם הלחצן "קריאה לפעולה" כדי לתת הקשר ולעודד לחיצה על הלחצן. |
InFeedVideoAdInfo
ייצוג הפורמט של מודעת וידאו בגוף הפיד.
ייצוג JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
שדות | |
---|---|
headline |
הכותרת של המודעה. |
description1 |
שורת הטקסט הראשונה של המודעה. |
description2 |
שורת טקסט שנייה למודעה. |
thumbnail |
תמונה ממוזערת של סרטון לשימוש. |
VideoThumbnail
רשימת הסוגים האפשריים של תמונות ממוזערות של סרטון.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסוג לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
DEFAULT_THUMBNAIL |
התמונה הממוזערת המוגדרת כברירת מחדל. ניתן ליצור באופן אוטומטי או להעלות את הסרטון על ידי משתמש. |
THUMBNAIL_1 |
תמונה ממוזערת 1, שנוצרה מהסרטון. |
THUMBNAIL_2 |
תמונה ממוזערת 2, שנוצרה מהסרטון. |
THUMBNAIL_3 |
תמונה ממוזערת 3, שנוצרה מהסרטון. |
VideoResponsiveAdInfo
מודעת וידאו רספונסיבית.
ייצוג JSON |
---|
{ "headlines": [ { object ( |
שדות | |
---|---|
headlines[] |
רשימה של נכסי הטקסט המשמשים לכותרת הקצרה. כרגע יש תמיכה רק בערך אחד לכותרת הקצרה. |
longHeadlines[] |
רשימה של נכסי הטקסט שמשמשים לכותרת הארוכה. בשלב הזה יש תמיכה רק בערך אחד לכותרת הארוכה. |
descriptions[] |
רשימה של נכסי טקסט שמשמשים לתיאור. בשלב הזה, יש תמיכה רק בערך אחד לתיאור. |
callToActions[] |
רשימה של נכסי הטקסט שנעשה בהם שימוש כשלוחצים על הלחצן, כמו הלחצן 'קריאה לפעולה'. כרגע יש תמיכה רק בערך אחד של הלחצן. |
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 |
הנכס שימש בכותרת ארוכה (נעשה בה שימוש במודעות רספונסיביות עם נכסים מרובים). |
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 |
הנכס הזה משמש בתור Sitelink. |
CALL |
הנכס הזה משמש לקריאה. |
MOBILE_APP |
הנכס הזה משמש כאפליקציה לנייד. |
CALLOUT |
הנכס הזה משמש כנכס יתרונות מרכזיים. |
STRUCTURED_SNIPPET |
הנכס הזה משמש כנכס מידע מובנה. |
PRICE |
הנכס הזה משמש בתור מחיר. |
PROMOTION |
הנכס הזה משמש בתור קידום מכירות. |
AD_IMAGE |
הנכס הזה משמש כתמונה. |
LEAD_FORM |
הנכס משמש כנכס השארת פרטים. |
BUSINESS_LOGO |
הנכס משמש כלוגו של העסק. |
AssetPerformanceLabel
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 או שאינו פועל בכל המיקומים במכשירים נפוצים. |
WebsiteList
רשימת האתרים שגרמו לקביעת המדיניות. משמש, לדוגמה, לנושא המדיניות של ONE_WEBSITE_PER_AD_GROUP. אם קיימים יותר מחמישה אתרים, רק חמשת האתרים המובילים (אלה שמופיעים הכי הרבה במשאבים) יפורטו כאן.
ייצוג JSON |
---|
{ "websites": [ string ] } |
שדות | |
---|---|
websites[] |
האתרים שגרמו לקביעת המדיניות. |
TextList
רשימה של קטעי טקסט שהפרו מדיניות.
ייצוג JSON |
---|
{ "texts": [ string ] } |
שדות | |
---|---|
texts[] |
קטעי הטקסט מהמשאב שגרמו לממצא המדיניות. |
DestinationTextList
רשימה של מחרוזות שנמצאו בדף היעד שגרמו לממצא של מדיניות.
ייצוג JSON |
---|
{ "destinationTexts": [ string ] } |
שדות | |
---|---|
destinationTexts[] |
רשימת הטקסט שנמצאת בדף היעד של המשאב. |
DestinationMismatch
ראיות לחוסר התאמה בין כתובות ה-URL של משאב.
ייצוג JSON |
---|
{
"urlTypes": [
enum ( |
שדות | |
---|---|
urlTypes[] |
קבוצה של כתובות URL שלא תאמו זו את זו. |
PolicyTopicEvidenceDestinationMismatchUrlType
נושא המדיניות האפשרי הוא עדות לסוגי כתובות URL של חוסר התאמה בין מודעות ליעדיהן.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
DISPLAY_URL |
כתובת ה-URL לתצוגה. |
FINAL_URL |
כתובת ה-URL הסופית. |
FINAL_MOBILE_URL |
כתובת ה-URL הסופית לנייד. |
TRACKING_URL |
התבנית של כתובת ה-URL למעקב, עם כתובת ה-URL החלופית למחשב. |
MOBILE_TRACKING_URL |
תבנית כתובת ה-URL למעקב עם כתובת 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. זה לא אומר שדף הנחיתה לא פועל. Google תסרוק מחדש את דף הנחיתה. |
PolicyTopicConstraint
מתאר את ההשפעה של רשומה של נושא מדיניות על הצגת המודעות.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד value . מידע ספציפי על האילוץ. value יכול להיות רק אחד מהבאים: |
|
countryConstraintList |
מדינות שבהן המשאב לא יכול להופיע. |
resellerConstraint |
אילוץ של מפיץ. |
certificateMissingInCountryList |
המדינות שבהן נדרש אישור כדי להציג מודעות. |
certificateDomainMismatchInCountryList |
מדינות שבהן הדומיין של המשאב לא נכלל באישורים שמשויכים אליו. |
CountryConstraintList
רשימת המדינות שבהן הצגת המשאב מוגבלת.
ייצוג JSON |
---|
{
"countries": [
{
object ( |
שדות | |
---|---|
countries[] |
המדינות שבהן הצגת המודעות מוגבלת. |
totalTargetedCountries |
המספר הכולל של מדינות שהמשאב מטרגט. |
CountryConstraint
מאפיין זה מציין שהיכולת של המשאב להופיע במדינה מסוימת מוגבלת.
ייצוג JSON |
---|
{ "countryCriterion": string } |
שדות | |
---|---|
countryCriterion |
שם המשאב הקבוע של המיקוד הגיאוגרפי של המדינה שבה הצגת המודעות מוגבלת. |
ResellerConstraint
אין שדות בסוג הזה.
הסטטוס הזה מציין שהנושא של המדיניות הוגבל בגלל שהאתר לא אושר למטרות מפיצים.
PolicyReviewStatus
הסטטוסים האפשריים של בדיקת התאימות למדיניות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
REVIEW_IN_PROGRESS |
בבדיקה כרגע. |
REVIEWED |
הבדיקה הראשית הושלמה. יכול להיות שבדיקות אחרות יימשכו. |
UNDER_APPEAL |
המשאב נשלח מחדש לאישור או שהוגש ערעור לגבי ההחלטה שהתקבלה לגבי המדיניות שלו. |
ELIGIBLE_MAY_SERVE |
המשאב כשיר ויכול להיות שהוא מוצג, אבל הוא עדיין עשוי לעבור בדיקה נוספת. |
PolicyApprovalStatus
הסטטוסים האפשריים של אישור המדיניות. כשיש כמה סטטוסים זמינים של אישור, המערכת תשתמש בסטטוס החמור ביותר. סדר החומרה הוא 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 |
הסכמת המפרסם לאפשר שימוש בצבע גמיש. אם הערך הוא True, המודעה יכולה להופיע בצבע שונה בהתאם לצורך. אם הערך הוא False, המודעה תוצג בצבעים שצוינו או בצבע ניטרלי. ערך ברירת המחדל הוא |
accentColor |
צבע ההדגשה של המודעה בהקסדצימלית, לדוגמה, #תתאים ללבן. אם מגדירים אחד מהשניים |
mainColor |
הצבע העיקרי של המודעה בהקסדצימלי, לדוגמה, #⌘ ללבן. אם מגדירים אחד מהשניים |
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 |
Apple iTunes. |
GOOGLE_PLAY |
Google Play. |
WINDOWS_STORE |
חנות Windows. |
WINDOWS_PHONE_STORE |
חנות Windows Phone |
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 תווים. אפשר לציין לפחות כותרת אחת ועד 5 כותרות. |
longHeadline |
נדרשת כותרת ארוכה בפורמט. האורך המקסימלי הוא 90 תווים. |
descriptions[] |
טקסטים תיאוריים למודעה. האורך המקסימלי הוא 90 תווים. אפשר לציין לפחות כותרת אחת ועד 5 כותרות. |
youtubeVideos[] |
סרטוני YouTube אופציונליים עבור המודעה. אפשר לציין עד 5 סרטונים. |
formatSetting |
ציון הפורמט שבו המודעה תוצג. ברירת המחדל היא ALL_FORMATS. |
controlSpec |
מפרט לפקדי קריאייטיב שונים. |
businessName |
שם המפרסם/המותג. רוחב התצוגה המקסימלי הוא 25. |
mainColor |
הצבע העיקרי של המודעה בהקסדצימלי, לדוגמה, #⌘ ללבן. אם מגדירים אחד מהשניים |
accentColor |
צבע ההדגשה של המודעה בהקסדצימלית, לדוגמה, #תתאים ללבן. אם מגדירים אחד מהשניים |
allowFlexibleColor |
הסכמת המפרסם לאפשר שימוש בצבע גמיש. אם הערך הוא True, המודעה יכולה להופיע בצבע שונה בהתאם לצורך. אם הערך הוא False, המודעה תוצג בצבעים שצוינו או בצבע ניטרלי. ערך ברירת המחדל הוא |
callToActionText |
טקסט הקריאה לפעולה במודעה. רוחב התצוגה המקסימלי הוא 30. |
pricePrefix |
מוסיפים תחילית לפני המחיר. לדוגמה, 'החל מ-'. |
promoText |
טקסט לקידום מכירות המשמש לפורמטים דינמיים של מודעות רספונסיביות. לדוגמה, 'משלוח חינם תוך יומיים בלבד'. |
ResponsiveDisplayAdControlSpec
מפרט של פקדי קריאייטיב שונים למודעה רספונסיבית לרשת המדיה (RDA).
ייצוג JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
שדות | |
---|---|
enableAssetEnhancements |
האם המפרסם הביע הסכמה לשימוש בתכונה 'שיפורי נכסים'. |
enableAutogenVideo |
אם המפרסם הביע הסכמה לשימוש בתכונת וידאו ליצירה אוטומטית. |
LocalAdInfo
מודעה מקומית.
ייצוג JSON |
---|
{ "headlines": [ { object ( |
שדות | |
---|---|
headlines[] |
רשימה של נכסי טקסט לכותרות. כאשר המודעה תוצג, הכותרות ייבחרו מהרשימה הזו. יש לציין לפחות כותרת אחת ולא יותר מ-5. |
descriptions[] |
רשימה של נכסי טקסט לתיאורים. המועד שבו התיאורים יוצגו במודעה ייבחרו מהרשימה הזו. יש לציין לפחות תיאור אחד ולא יותר מ-5. |
callToActions[] |
רשימה של נכסי טקסט לקריאות לפעולה. המועד שבו המודעה מציגה את הקריאות לפעולה ייבחרו מהרשימה הזו. יש לציין קריאה לפעולה אחת לפחות ועד 5. |
marketingImages[] |
רשימת נכסים של תמונות שיווקיות שייתכן שיוצגו עם המודעה. התמונות חייבות להיות בגודל 314x600 פיקסלים או 320x320 פיקסלים. יש לציין נכס תמונה אחד לכל היותר. |
logoImages[] |
רשימת נכסים של תמונות לוגו שייתכן שיוצגו עם המודעה. התמונות צריכות להיות בגודל של 128x128 פיקסלים ולא יותר מ-120KB. יש לציין לפחות נכס תמונה אחד ולא יותר מ-5. |
videos[] |
רשימה של נכסי וידאו ב-YouTube שניתן להציג עם המודעה. יש לציין נכס וידאו אחד לכל היותר. |
path1 |
החלק הראשון של הטקסט האופציונלי שניתן לצרף לכתובת ה-URL במודעה. |
path2 |
החלק השני של הטקסט האופציונלי שניתן לצרף לכתובת ה-URL במודעה. אפשר להגדיר את השדה הזה רק אם מגדירים גם |
DisplayUploadAdInfo
סוג כללי של מודעה לרשת המדיה. פורמט המודעה המדויק נקבע על ידי השדה displayUploadProductType
, שקובע אילו סוגי נתונים צריכים להיכלל במודעה.
ייצוג JSON |
---|
{ "displayUploadProductType": enum ( |
שדות | |
---|---|
displayUploadProductType |
סוג המוצר של המודעה הזו. לפרטים נוספים, יש לעיין בתגובות לגבי הספירה לאחור. |
שדה איחוד media_asset . נתוני הנכס שמהם מורכבת המודעה. media_asset יכול להיות רק אחד מהבאים: |
|
mediaBundle |
נכס של חבילת מדיה לשימוש במודעה. מידע על חבילת המדיה עבור 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. אפשר להשתמש במאפיין הזה רק בקמפיין ל-Google נסיעות. |
DYNAMIC_HTML5_HOTEL_AD |
מודעת HTML5 דינמית לקידום מלון. כדי להשתמש בסוג המוצר הזה, צריך להגדיר את השדה upload_media_bundle ב-DisplayUploadAdInfo. אפשר להשתמש במאפיין הזה רק בקמפיין לקידום מלון. |
AppEngagementAdInfo
מודעות לעידוד השימוש באפליקציה מאפשרות לכם לנסח טקסט שמעודד פעולה מסוימת באפליקציה, כמו לעשות צ'ק-אין, לבצע רכישה או להזמין טיסה. הם מאפשרים להפנות את המשתמשים לחלק ספציפי באפליקציה, שבו הם יוכלו למצוא את מה שהם מחפשים בקלות ובמהירות.
ייצוג JSON |
---|
{ "headlines": [ { object ( |
שדות | |
---|---|
headlines[] |
רשימה של נכסי טקסט לכותרות. כאשר המודעה תוצג, הכותרות ייבחרו מהרשימה הזו. |
descriptions[] |
רשימה של נכסי טקסט לתיאורים. המועד שבו התיאורים יוצגו במודעה ייבחרו מהרשימה הזו. |
images[] |
רשימה של נכסי תמונות שייתכן שיוצגו עם המודעה. |
videos[] |
רשימה של נכסי וידאו שייתכן שיוצגו עם המודעה. |
ShoppingComparisonListingAdInfo
מודעת השוואת מחירים.
ייצוג JSON |
---|
{ "headline": string } |
שדות | |
---|---|
headline |
הכותרת של המודעה. חובה לבחור אפשרות לשדה הזה. האורך המותר הוא בין 25 ל-45 תווים. |
SmartCampaignAdInfo
מודעה בקמפיין חכם.
ייצוג JSON |
---|
{ "headlines": [ { object ( |
שדות | |
---|---|
headlines[] |
רשימה של נכסי טקסט, שכל אחד מהם תואם לכותרת בזמן שהמודעה מוצגת. רשימה זו כוללת לפחות 3 ועד 15 נכסי טקסט. |
descriptions[] |
רשימה של נכסי טקסט, שכל אחד מהם תואם לתיאור של המודעה. רשימה זו כוללת לפחות 2 ועד 4 נכסי טקסט. |
AppPreRegistrationAdInfo
מודעות לרישום מראש של אפליקציות מקשרות לדף האפליקציה או המשחק ב-Google Play, ויכולות להופיע ב-Google Play, ב-YouTube (מודעות וידאו In-stream בלבד) ובאפליקציות אחרות ובאתרים אחרים לנייד ברשת המדיה. זה יעזור לעורר עניין של אנשים באפליקציה או במשחק שלכם וליצור בסיס התקנות מוקדם של האפליקציה או המשחק, לפני ההשקה.
ייצוג 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%). ניתן לציין לפחות תמונת לוגו אחת ולא יותר מ-5 תמונות לוגו. |
headlines[] |
נכס טקסט כותרת של המודעה. רוחב התצוגה המקסימלי הוא 30. אפשר לציין לפחות כותרת אחת ועד 5 כותרות. |
descriptions[] |
הטקסט התיאורי של המודעה. רוחב התצוגה המקסימלי הוא 90. אפשר לציין לפחות תיאור אחד ולא יותר מ-5 תיאורים. |
businessName |
שם המפרסם/המותג. רוחב התצוגה המקסימלי הוא 25. חובה. |
callToActionText |
טקסט של קריאה לפעולה. |
leadFormOnly |
אפשרות בוליאנית שמציינת אם צריך להציג את המודעה הזאת עם טופס להשארת פרטים. |
DiscoveryCarouselAdInfo
מודעת קרוסלה Discovery.
ייצוג JSON |
---|
{ "businessName": string, "logoImage": { object ( |
שדות | |
---|---|
businessName |
חובה. שם המפרסם/המותג. |
logoImage |
חובה. תמונת לוגו שתוצג במודעה. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). |
headline |
חובה. הכותרת של המודעה. |
description |
חובה. הטקסט התיאורי של המודעה. |
callToActionText |
טקסט של קריאה לפעולה. |
carouselCards[] |
חובה. כרטיסי קרוסלה שיוצגו עם המודעה. מינימום 2 עד 10. |
AdDiscoveryCarouselCardAsset
נכס כרטיס קרוסלה Discovery שנמצא בשימוש במודעה.
ייצוג JSON |
---|
{ "asset": string } |
שדות | |
---|---|
asset |
שם משאב הנכס בכרטיס קרוסלה Discovery הזה. |
DiscoveryVideoResponsiveAdInfo
מודעת וידאו רספונסיבית מסוג Discovery.
ייצוג 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 |
שם משאב הנכס של נכס הקריאה לפעולה הזה. |
DemandGenProductAdInfo
מודעת מוצר ליצירת ביקוש.
ייצוג JSON |
---|
{ "breadcrumb1": string, "breadcrumb2": string, "businessName": { object ( |
שדות | |
---|---|
breadcrumb1 |
החלק הראשון של הטקסט שמופיע במודעה עם כתובת ה-URL המוצגת. |
breadcrumb2 |
החלק השני של הטקסט שמופיע במודעה עם כתובת ה-URL המוצגת. |
businessName |
חובה. שם המפרסם/המותג. |
headline |
חובה. נכס הטקסט שמשמש לכותרת הקצרה. |
description |
חובה. נכס הטקסט שמשמש לתיאור. |
logoImage |
חובה. תמונת לוגו שתוצג במודעה. סוגי התמונות הקבילים הם GIF, JPEG ו-PNG. הגודל המינימלי הוא 128x128 ויחס הגובה-רוחב חייב להיות 1:1 (+-1%). |
callToAction |
נכס מסוג CallToActionAsset שנעשה בו שימוש ללחצן 'קריאה לפעולה'. |
TravelAdInfo
אין שדות בסוג הזה.
מודעה לנסיעות.
שיטות |
|
---|---|
|
מחזירה את המודעה המבוקשת בפירוט מלא. |
|
מעדכנות מודעות. |