- ייצוג JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting (הגדרת טירגוט)
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- מודעה
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- מכשיר
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- נכס
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- קמפיין
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- קהל
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- לקוח
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- תווית
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- ביקור
- ProductChannel
- המרה
- AttributionType
- ConversionStatus
- מדדים
- ערך
- QualityScoreBucket
- InteractionEventType
- פלחים
- AdNetworkType
- מילת מפתח
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
שורה שהוחזרה מהשאילתה.
ייצוג JSON |
---|
{ "adGroup": { object ( |
שדות | |
---|---|
adGroup |
קבוצת המודעות שמצוינת בשאילתה. |
adGroupAd |
המודעה שמצוינת בשאילתה. |
adGroupAdLabel |
תווית המודעה של קבוצת המודעות שהשאילתה מפנה אליה. |
adGroupAsset |
הנכס ברמת קבוצת המודעות שהשאילתה מפנה אליו. |
adGroupAssetSet |
קבוצת הנכסים של קבוצת המודעות שאליה הפניה בשאילתה. |
adGroupAudienceView |
תצוגת הקהל של קבוצת המודעות שאליה יש הפניה בשאילתה. |
adGroupBidModifier |
התאמת הצעת המחיר המצוינת בשאילתה. |
adGroupCriterion |
הקריטריון שצוין בשאילתה. |
adGroupCriterionLabel |
תווית הקריטריון של קבוצת המודעות שיש הפניה אליה בשאילתה. |
adGroupLabel |
תווית קבוצת המודעות שאליה בוצעה הפניה בשאילתה. |
ageRangeView |
תצוגת טווח הגילאים שמוזכרת בשאילתה. |
asset |
הנכס שיש אליו הפניה בשאילתה. |
assetGroupAsset |
הנכס ברמת קבוצת הנכסים שהשאילתה מפנה אליו. |
assetGroupSignal |
האות של קבוצת הנכסים שהשאילתה מפנה אליה. |
assetGroupListingGroupFilter |
מסנן הקבוצות של כרטיסי המוצר בנכסים דיגיטליים שהשאילתה מפנה אליו. |
assetGroupTopCombinationView |
תצוגת השילוב העליונה של קבוצת הנכסים שאליה בוצעה הפניה בשאילתה. |
assetGroup |
קבוצת הנכסים שהוזכרה בשאילתה. |
assetSetAsset |
נכס קבוצת הנכסים שהשאילתה מפנה אליו. |
assetSet |
קבוצת הנכסים שהשאילתה מפנה אליה. |
biddingStrategy |
שיטת הבידינג שמצוינת בשאילתה. |
campaignBudget |
תקציב הקמפיין שמצוינת בשאילתה. |
campaign |
הקמפיין שהשאילתה מפנה אליו. |
campaignAsset |
נכס הקמפיין שהשאילתה מפנה אליו. |
campaignAssetSet |
קבוצת הנכסים של הקמפיין המצוינת בשאילתה. |
campaignAudienceView |
תצוגת הקהל של הקמפיין שמצוינת בשאילתה. |
campaignCriterion |
קריטריון הקמפיין שהשאילתה מפנה אליו. |
campaignLabel |
תווית הקמפיין שמצוינת בשאילתה. |
cartDataSalesView |
תצוגת המכירות של נתוני עגלות הקניות שמצוינת בשאילתה. |
audience |
הקהל שיש אליו הפניה בשאילתה. |
conversionAction |
פעולת ההמרה שמצוינת בשאילתה. |
conversionCustomVariable |
המשתנה המותאם אישית של ההמרה שצוין בשאילתה. |
customer |
הלקוח שמצוינת בשאילתה. |
customerAsset |
נכס הלקוח שהשאילתה מפנה אליו. |
customerAssetSet |
קבוצת נכסי הלקוח המצוינת בשאילתה. |
accessibleBiddingStrategy |
שיטת הבידינג הנגישה שמצוינת בשאילתה. |
customerManagerLink |
ה-CustomerManagerLink שהשאילתה מפנה אליו. |
customerClient |
הלקוח של הלקוח שצוין בשאילתה. |
dynamicSearchAdsSearchTermView |
תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש שיש הפניה אליה בשאילתה. |
genderView |
התצוגה המפורטת לפי מגדר שמצוינת בשאילתה. |
geoTargetConstant |
קבוע היעד הגיאוגרפי שצוין בשאילתה. |
keywordView |
התצוגה של מילת המפתח שאליה מפנה השאילתה. |
label |
התווית שהוזכרה בשאילתה. |
languageConstant |
קבוע השפה בשאילתה. |
locationView |
תצוגת המיקום שמצוינת בשאילתה. |
productBiddingCategoryConstant |
הקטגוריה של בידינג על מוצרים שמצוינת בשאילתה. |
productGroupView |
התצוגה של קבוצת המוצרים שיש אליה הפניה בשאילתה. |
shoppingPerformanceView |
תצוגת ביצועי השופינג שהשאילתה מפנה אליה. |
userList |
רשימת המשתמשים שיש אליה הפניה בשאילתה. |
webpageView |
תצוגת דף האינטרנט שיש אליה הפניה בשאילתה. |
visit |
הביקור ברמת האירוע שצוין בשאילתה. |
conversion |
ההמרה ברמת האירוע שמוזכרת בשאילתה. |
metrics |
המדדים. |
segments |
הפלחים. |
customColumns[] |
העמודות בהתאמה אישית. |
AdGroup
קבוצת מודעות.
ייצוג JSON |
---|
{ "resourceName": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוצת המודעות. השמות של משאבי קבוצת המודעות הם בפורמט הבא:
|
status |
הסטטוס של קבוצת המודעות. |
type |
הסוג של קבוצת המודעות. |
adRotationMode |
מצב סבב המודעות של קבוצת המודעות. |
creationTime |
חותמת הזמן של מועד היצירה של קבוצת המודעות הזו. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
targetingSetting |
הגדרה לטירגוט לתכונות קשורות. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקבוצת המודעות הזו. |
engineId |
המזהה של קבוצת המודעות בחשבון החיצוני של מנוע החיפוש. השדה הזה מיועד רק לחשבון שאינו של Google Ads, למשל Yahoo Japan , Microsoft , Baidu וכו'. לישות ב-Google Ads, צריך להשתמש במקום זאת בערך adGroup.id. |
startDate |
התאריך שבו קבוצת המודעות תתחיל להציג מודעות. כברירת מחדל, קבוצת המודעות מתחילה עכשיו או תאריך ההתחלה של קבוצת המודעות, המוקדם מביניהם. אם מגדירים את השדה הזה, קבוצת המודעות מתחילה בתחילת התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות Microsoft Advertising ו-Facebook Gateway. פורמט: YYYY-MM-DD לדוגמה: 2019-03-14 |
endDate |
התאריך שבו הצגת המודעות בקבוצת המודעות תסתיים. כברירת מחדל, קבוצת המודעות מסתיימת בתאריך הסיום של קבוצת המודעות. אם מגדירים את השדה הזה, קבוצת המודעות תסתיים בסוף התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות Microsoft Advertising ו-Facebook Gateway. פורמט: YYYY-MM-DD לדוגמה: 2019-03-14 |
languageCode |
השפה של המודעות ומילות המפתח בקבוצת מודעות. השדה הזה זמין רק בחשבונות Microsoft Advertising. פרטים נוספים: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
lastModifiedTime |
התאריך והשעה שבהם קבוצת המודעות הזו שונתה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
id |
המזהה של קבוצת המודעות. |
name |
השם של קבוצת המודעות. זהו שדה חובה ולא יכול להיות ריק כשיוצרים קבוצות מודעות חדשות. היא חייבת להכיל פחות מ-255 תווים ברוחב מלא מסוג UTF-8. היא לא יכולה להכיל תווים מסוג null (נקודת קוד 0x0), פיד שורה של NL (נקודת קוד 0xA) או תווים של חזרה לתחילת השורה (נקודת קוד 0xD). |
cpcBidMicros |
הצעת המחיר המקסימלית לקליק. |
engineStatus |
סטטוס המנוע בקבוצת המודעות. |
AdGroupStatus
הסטטוסים האפשריים של קבוצת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסטטוס לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קבוצת המודעות מופעלת. |
PAUSED |
קבוצת המודעות מושהית. |
REMOVED |
קבוצת המודעות תוסר. |
AdGroupType
רשימת הסוגים האפשריים של קבוצת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסוג לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
SEARCH_STANDARD |
סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת החיפוש. |
DISPLAY_STANDARD |
סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת המדיה. |
SHOPPING_PRODUCT_ADS |
סוג קבוצת המודעות לקמפיינים של שופינג שמציגים מודעות מוצר רגילות. |
SHOPPING_SHOWCASE_ADS |
הסוג של קבוצות של מודעות שמוגבלות להצגת מודעות קטלוג או מודעות של מוכר בתוצאות של שופינג. |
HOTEL_ADS |
סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לקידום מלונות. |
SHOPPING_SMART_ADS |
הסוג של קבוצות של מודעות בקמפיינים חכמים לשופינג. |
VIDEO_BUMPER |
מודעות וידאו קצרות בסרטון שלא ניתן לדלג עליהן. |
VIDEO_TRUE_VIEW_IN_STREAM |
מודעות וידאו TrueView In-stream (שניתן לדלג עליהן). |
VIDEO_TRUE_VIEW_IN_DISPLAY |
מודעות וידאו מסוג TrueView ברשת המדיה. |
VIDEO_NON_SKIPPABLE_IN_STREAM |
מודעות וידאו In-stream שלא ניתן לדלג עליהן |
VIDEO_OUTSTREAM |
מודעות וידאו Outstream. |
SEARCH_DYNAMIC_ADS |
סוג קבוצת המודעות לקבוצות של מודעות דינמיות לרשת החיפוש. |
SHOPPING_COMPARISON_LISTING_ADS |
הסוג של קבוצות של מודעות בקמפיינים של השוואת מחירים. |
PROMOTED_HOTEL_ADS |
הסוג של קבוצת המודעות בקבוצות של מודעות לקידום מלונות. |
VIDEO_RESPONSIVE |
קבוצות של מודעות וידאו רספונסיביות. |
VIDEO_EFFICIENT_REACH |
קבוצות של מודעות וידאו לשיפור פוטנציאל החשיפה. |
SMART_CAMPAIGN_ADS |
סוג קבוצת המודעות בקמפיינים חכמים. |
TRAVEL_ADS |
סוג קבוצת המודעות בקמפיינים ל-Google נסיעות. |
AdGroupAdRotationMode
המצבים האפשריים של סבב מודעות בקבוצת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין מצב סבב מודעות. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
OPTIMIZE |
מבצעים אופטימיזציה של מודעות בקבוצת המודעות על סמך קליקים או המרות. |
ROTATE_FOREVER |
סובב באופן שווה לנצח. |
AdGroupEngineStatus
הסטטוס של המנוע של קבוצת המודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
AD_GROUP_ELIGIBLE |
הוּצא משימוש. אין להשתמש בו. |
AD_GROUP_EXPIRED |
לא מוצגות מודעות עבור קבוצת מודעות זו, מפני שתאריך הסיום של קבוצת המודעות חלף. |
AD_GROUP_REMOVED |
קבוצת המודעות נמחקה. |
AD_GROUP_DRAFT |
לא מוצגות מודעות עבור קבוצת המודעות הזו מפני שקבוצת המודעות המשויכת עדיין נמצאת במצב טיוטה. |
AD_GROUP_PAUSED |
קבוצת המודעות הושהתה. |
AD_GROUP_SERVING |
קבוצת המודעות פעילה ומציגה כרגע מודעות. |
AD_GROUP_SUBMITTED |
קבוצת המודעות נשלחה (הסטטוס הקודם של Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
אין מודעות המוצגות עבור קבוצת המודעות הזו, מפני שהקמפיין הושהה. |
ACCOUNT_PAUSED |
לא מוצגות מודעות עבור קבוצת המודעות הזו מפני שהחשבון הושהה. |
TargetingSetting
הגדרות של התכונות הקשורות לטירגוט, ברמת הקמפיין וקבוצת המודעות. מידע נוסף על הגדרת הטירגוט זמין בכתובת https://support.google.com/google-ads/answer/7365594
ייצוג JSON |
---|
{
"targetRestrictions": [
{
object ( |
שדות | |
---|---|
targetRestrictions[] |
הגדרה של כל מאפיין טירגוט, שמגבילה את פוטנציאל החשיפה של הקמפיין או של קבוצת המודעות. |
TargetRestriction
רשימה של הגדרות טירגוט לכל מאפיין טירגוט.
ייצוג JSON |
---|
{
"targetingDimension": enum ( |
שדות | |
---|---|
targetingDimension |
מאפיין הטירגוט שעליו חלות ההגדרות האלה. |
bidOnly |
בעמודה הזו מציינים אם להגביל את הצגת המודעות רק לפי הקריטריונים שבחרתם למאפיין הטירגוט הזה, או לטרגט את כל הערכים של מאפיין הטירגוט הזה ולהציג מודעות על סמך הטירגוט במאפיינים אחרים לטירגוט. המשמעות של ערך של |
TargetingDimension
מספר שמתאר מאפייני מיקוד אפשריים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
KEYWORD |
קריטריונים של מילות מפתח, לדוגמה, 'שייט במאדים'. ניתן להשתמש ב-KEYWORD כמאפיין של הצעת מחיר מותאמת אישית. מילות מפתח הן תמיד מאפיין טירגוט, ולכן לא ניתן להגדיר אותן כמאפיין יעד מסוג TargetRestriction. |
AUDIENCE |
קריטריונים לקהל, כולל רשימת משתמשים, תחומי עניין של משתמשים, קהל בהתאמה אישית עם תחום עניין משותף וקהל בהתאמה אישית עם כוונת רכישה. |
TOPIC |
קריטריונים של נושאים לטירגוט לקטגוריות של תוכן, לדוגמה, 'category::בעלי חיים>חיות מחמד' המשמש לטירגוט לרשת המדיה ולווידאו. |
GENDER |
קריטריונים למיקוד לפי מגדר. |
AGE_RANGE |
קריטריונים לטירגוט טווחי גילאים. |
PLACEMENT |
קריטריונים למיקום מודעות, שכוללים אתרים כמו 'www.flowers4sale.com', וכן אפליקציות לנייד, קטגוריות של אפליקציות לנייד, סרטונים ב-YouTube וערוצי YouTube. |
PARENTAL_STATUS |
קריטריונים לטירגוט לפי סטטוס הורה. |
INCOME_RANGE |
קריטריונים לטירגוט לפי טווח הכנסה. |
AdGroupAd
מודעה בקבוצת מודעות.
ייצוג JSON |
---|
{ "resourceName": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של המודעה. השמות של משאבי המודעות בקבוצת המודעות הם:
|
status |
הסטטוס של המודעה. |
ad |
המודעה. |
creationTime |
חותמת הזמן של מועד היצירה של adGroupAd זו. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
labels[] |
שמות המשאבים של תוויות שמצורפות למודעה בקבוצת המודעות הזו. |
engineId |
המזהה של המודעה בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד לחשבון Search Ads 360 בלבד, לדוגמה, Yahoo Japan, Microsoft, Baidu וכו'. לישות שאינה של Search Ads 360, צריך להשתמש במקום זאת ב-"adGroupAd.ad.id". |
engineStatus |
סטטוס נוסף של המודעה בחשבון של מנוע החיפוש החיצוני. הסטטוסים האפשריים (בהתאם לסוג החשבון החיצוני) כוללים: 'פעיל', 'כשיר', 'בהמתנה לבדיקה' וכו'. |
lastModifiedTime |
התאריך והשעה שבהם המודעה בקבוצת המודעות הזו שונתה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
AdGroupAdStatus
הסטטוסים האפשריים של קבוצת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
המודעה בקבוצת המודעות מופעלת. |
PAUSED |
המודעה בקבוצת המודעות מושהית. |
REMOVED |
המודעה שמוגדרת בקבוצת המודעות הוסרה. |
מודעה
מודעה.
ייצוג JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של המודעה. השמות של משאבי המודעות הם בפורמט הבא:
|
finalUrls[] |
הרשימה של כתובות ה-URL הסופיות האפשריות לאחר כל ההפניות האוטומטיות בדומיינים של המודעה. |
type |
סוג המודעה. |
id |
המזהה של המודעה. |
displayUrl |
כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות. |
name |
השם של המודעה. הוא משמש רק כדי לזהות את המודעה. הוא לא חייב להיות ייחודי ואין לו השפעה על המודעה המוצגת. שדה השם נתמך כרגע רק עבור DisplayUploadAd, ImageAd, ShoppingComparisonListingAd ו-VideoAd. |
שדה איחוד ad_data . פרטים שרלוונטיים לסוג המודעה. יש להגדיר ערך אחד בדיוק. ad_data יכול להיות רק אחד מהבאים: |
|
textAd |
פרטים שקשורים למודעת טקסט. |
expandedTextAd |
פרטים שקשורים למודעת טקסט מורחבת. |
responsiveSearchAd |
פרטים שקשורים למודעה רספונסיבית לרשת החיפוש. |
productAd |
פרטים שקשורים למודעה לקידום מוצר. |
expandedDynamicSearchAd |
פרטים שקשורים למודעה דינמית מורחבת לרשת החיפוש. |
AdType
הסוגים האפשריים של מודעה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
TEXT_AD |
המודעה היא מודעת טקסט. |
EXPANDED_TEXT_AD |
המודעה היא מודעת טקסט מורחבת. |
CALL_ONLY_AD |
המודעה היא מודעה לשיחות בלבד. |
EXPANDED_DYNAMIC_SEARCH_AD |
המודעה היא מודעה דינמית מורחבת לרשת החיפוש. |
HOTEL_AD |
מדובר במודעה להזמנת חדרים. |
SHOPPING_SMART_AD |
המודעה היא מודעת שופינג חכמה. |
SHOPPING_PRODUCT_AD |
המודעה היא מודעת שופינג רגילה. |
VIDEO_AD |
המודעה היא מודעת וידאו. |
GMAIL_AD |
המודעה הזו היא מודעת Gmail. |
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_DISCOVERY_AD |
מודעת וידאו TrueView ברשת המדיה. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
מודעת וידאו TrueView In-stream. |
VIDEO_RESPONSIVE_AD |
מודעת וידאו רספונסיבית. |
SMART_CAMPAIGN_AD |
מודעה בקמפיין חכם. |
APP_PRE_REGISTRATION_AD |
מודעה אוניברסלית לרישום מראש באפליקציות. |
DISCOVERY_MULTI_ASSET_AD |
מודעת Discovery עם כמה נכסים. |
DISCOVERY_CAROUSEL_AD |
מודעת קרוסלה Discovery. |
TRAVEL_AD |
מודעה לנסיעות. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
מודעה רספונסיבית של וידאו Discovery. |
SearchAds360TextAdInfo
מודעת טקסט של Search Ads 360.
ייצוג JSON |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
שדות | |
---|---|
headline |
הכותרת של המודעה. |
description1 |
השורה הראשונה בתיאור המודעה. |
description2 |
השורה השנייה בתיאור המודעה. |
displayUrl |
כתובת ה-URL לתצוגה של המודעה. |
displayMobileUrl |
כתובת ה-URL המוצגת בנייד של המודעה. |
adTrackingId |
המזהה לצורכי מעקב של המודעה. |
SearchAds360ExpandedTextAdInfo
מודעת טקסט מורחבת ב-Search Ads 360.
ייצוג JSON |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
שדות | |
---|---|
headline |
הכותרת של המודעה. |
headline2 |
הכותרת השנייה של המודעה. |
headline3 |
הכותרת השלישית של המודעה. |
description1 |
השורה הראשונה בתיאור המודעה. |
description2 |
השורה השנייה בתיאור המודעה. |
path1 |
טקסט שנוסף לכתובת ה-URL הגלויה שנוצרה באופן אוטומטי באמצעות תו מפריד. |
path2 |
הטקסט מצורף לנתיב 1 עם מפריד. |
adTrackingId |
המזהה לצורכי מעקב של המודעה. |
SearchAds360ResponsiveSearchAdInfo
מודעה רספונסיבית לרשת החיפוש ב-Search Ads 360.
ייצוג JSON |
---|
{ "path1": string, "path2": string, "adTrackingId": string } |
שדות | |
---|---|
path1 |
טקסט שנוסף לכתובת ה-URL הגלויה שנוצרה באופן אוטומטי באמצעות תו מפריד. |
path2 |
הטקסט מצורף לנתיב 1 עם מפריד. |
adTrackingId |
המזהה לצורכי מעקב של המודעה. |
SearchAds360ProductAdInfo
אין שדות בסוג הזה.
מודעת מוצר ב-Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
מודעת חיפוש דינמית מורחבת.
ייצוג JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
שדות | |
---|---|
description1 |
השורה הראשונה בתיאור המודעה. |
description2 |
השורה השנייה בתיאור המודעה. |
adTrackingId |
המזהה לצורכי מעקב של המודעה. |
AdGroupAdEngineStatus
מציין את הסטטוסים של המנוע של קבוצת המודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
AD_GROUP_AD_ELIGIBLE |
הוּצא משימוש. אין להשתמש בו. |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: הקריאייטיב לא אושר. |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: כתובת ה-URL לניידים נמצאת בבדיקה. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: הקריאייטיב לא תקין בנייד, אבל במחשב. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: הקריאייטיב מוכן להפעלה. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: הקריאייטיב לא נבדק. |
AD_GROUP_AD_ON_HOLD |
הוּצא משימוש. אין להשתמש בו. נעשה שימוש בעבר על ידי Gemini |
AD_GROUP_AD_PAUSED |
הקריאייטיב הושהה. |
AD_GROUP_AD_REMOVED |
הקריאייטיב הוסר. |
AD_GROUP_AD_PENDING_REVIEW |
הקריאייטיב ממתין לבדיקה. |
AD_GROUP_AD_UNDER_REVIEW |
הקריאייטיב בבדיקה. |
AD_GROUP_AD_APPROVED |
הקריאייטיב אושר. |
AD_GROUP_AD_DISAPPROVED |
הקריאייטיב נדחה. |
AD_GROUP_AD_SERVING |
הקריאייטיב מוצג. |
AD_GROUP_AD_ACCOUNT_PAUSED |
הקריאייטיב הושהה מפני שהחשבון מושהה. |
AD_GROUP_AD_CAMPAIGN_PAUSED |
הקריאייטיב הושהה מפני שהקמפיין מושהה. |
AD_GROUP_AD_AD_GROUP_PAUSED |
הקריאייטיב הושהה מפני שקבוצת המודעות מושהית. |
AdGroupAdLabel
קשר בין מודעה בקבוצת מודעות לתווית.
ייצוג JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תווית המודעה של קבוצת המודעות. שמות המשאבים של תוויות מודעות ברמת קבוצת המודעות מופיעים בצורה הבאה: |
adGroupAd |
המודעה בקבוצת המודעות שאליה מצורפת התווית. |
label |
התווית שהוקצתה למודעה בקבוצת המודעות. |
AdGroupAsset
קישור בין קבוצת מודעות לבין נכס.
ייצוג JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הנכס בקבוצת המודעות. שמות המשאבים של קבוצת המודעות הם בפורמט הבא:
|
adGroup |
חובה. קבוצת המודעות שאליה הנכס מקושר. |
asset |
חובה. הנכס שמקושר לקבוצת המודעות. |
status |
הסטטוס של הנכס בקבוצת המודעות. |
AssetLinkStatus
טיפוסים בני מנייה (enum) שמתארים את הסטטוסים של קישור לנכס.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
הקישור לנכס מופעל. |
REMOVED |
הקישור לנכס הוסר. |
PAUSED |
קישור הנכס מושהה. |
AdGroupAssetSet
AdGroupAssetSet הוא הקישור בין קבוצת מודעות לקבוצת נכסים. יצירת קבוצת נכסים דיגיטליים מקשרת קבוצת נכסים לקבוצת מודעות.
ייצוג JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוצת הנכסים של קבוצת המודעות. דוגמאות לשמות משאבים בקבוצות של מודעות בפורמט הבא:
|
adGroup |
קבוצת המודעות שאליה קבוצת הנכסים הזו מקושרת. |
assetSet |
קבוצת הנכסים שמקושרת לקבוצת המודעות. |
status |
הסטטוס של קבוצת הנכסים בקבוצת המודעות. קריאה בלבד. |
AssetSetLinkStatus
הסטטוסים האפשריים של הקישור בין קבוצת הנכסים לבין המאגר שלה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסטטוס לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הקישור בין קבוצת הנכסים לבין המאגר שלה מופעל. |
REMOVED |
הקישור בין קבוצת הנכסים לבין המאגר שלה הוסר. |
AdGroupAudienceView
תצוגת קהל של קבוצת מודעות. כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג עבור מודעות ברשת המדיה וברשת YouTube, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שנצברו ברמת הקהל.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת הקהל של קבוצת המודעות. שמות המשאבים לתצוגת קהל של קבוצת המודעות הם בפורמט הבא:
|
AdGroupBidModifier
מייצג התאמת הצעת מחיר לקבוצת מודעות.
ייצוג JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
שדות | |
---|---|
resourceName |
שם המשאב של התאמת הצעת המחיר לקבוצת המודעות. שמות המשאבים של התאמת הצעת המחיר לקבוצת המודעות מופיעים בתבנית הבאה:
|
bidModifier |
ערך ההתאמה של הצעת המחיר כאשר הקריטריון תואם. ערך ההתאמה חייב להיות בטווח: 0.1 - 10.0. הטווח הוא 1.0 עד 6.0 עבור PreferredContent. כדי לבטל את ההסכמה לסוג מכשיר מסוים, צריך להקיש על 0. |
שדה איחוד נדרש בפעולות יצירה שמתחילות ב-V5. |
|
device |
קריטריון של מכשיר. |
DeviceInfo
קריטריון של מכשיר.
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
סוג המכשיר. |
מכשיר
פירוט של מכשירי Google Ads שזמינים לטירגוט.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
MOBILE |
ניידים עם דפדפני אינטרנט מלאים. |
TABLET |
טאבלטים עם דפדפנים מלאים. |
DESKTOP |
מחשבים. |
CONNECTED_TV |
טלוויזיות חכמות וקונסולות משחקים. |
OTHER |
סוגי מכשירים אחרים. |
AdGroupCriterion
קריטריון של קבוצת מודעות. הדוח adGroupCriterion מחזיר רק קריטריונים שנוספו במפורש לקבוצת המודעות.
ייצוג JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קריטריון קבוצת המודעות. שמות המשאבים של קריטריון של קבוצות מודעות בפורמט הבא:
|
creationTime |
חותמת הזמן של מועד יצירת הקריטריון של קבוצת המודעות. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
status |
הסטטוס של הקריטריון. זהו הסטטוס של ישות הקריטריון של קבוצת המודעות, שהוגדרה על ידי הלקוח. הערה: יכול להיות שבדוחות בממשק המשתמש יש מידע נוסף שמשפיע על העמידה של קריטריון מסוים. במקרים מסוימים, קריטריון שהוסר מ-API עדיין עשוי להופיע כמופעל בממשק המשתמש. לדוגמה, קמפיינים מוצגים כברירת מחדל למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש כל טווח גילאים יוצג כ'מופעל', מכיוון שטווח הגילאים יהיה 'מופעל'. לעומת זאת, ב-AdGroupCriterion.status יוצג הסטטוס 'הוסר' מפני שלא נוסף קריטריון חיובי. |
qualityInfo |
מידע בנוגע לאיכות הקריטריון. |
type |
סוג הקריטריון. |
labels[] |
שמות המשאבים של התוויות המצורפות לקריטריון של קבוצת המודעות הזו. |
positionEstimates |
אומדנים של הצעות מחיר לקריטריון במיקומים שונים. |
finalUrls[] |
הרשימה של כתובות ה-URL הסופיות האפשריות לאחר כל ההפניות האוטומטיות בדומיינים של המודעה. |
engineId |
מזהה הקריטריון של קבוצת המודעות בחשבון החיצוני של מנוע החיפוש. השדה הזה מיועד רק לחשבון שאינו של Google Ads, למשל Yahoo Japan , Microsoft , Baidu וכו'. לישות ב-Google Ads, צריך להשתמש במקום זאת בערך adGroupCriterion.criterion_id. |
lastModifiedTime |
התאריך והשעה שבהם הקריטריון של קבוצת המודעות השתנה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
criterionId |
מזהה הקריטריון. |
adGroup |
קבוצת המודעות שאליה שייך הקריטריון. |
negative |
האם לטרגט ( אי אפשר לשנות את השדה הזה. כדי לשנות קריטריון מחיובי לשלילי, יש להסיר אותו ולהוסיף אותו מחדש. |
bidModifier |
ערך ההתאמה של הצעת המחיר כאשר הקריטריון תואם. ערך ההתאמה חייב להיות בטווח: 0.1 - 10.0. רוב סוגי הקריטריונים שניתן לטרגט תומכים במגבילי התאמה. |
cpcBidMicros |
הצעת המחיר לקליק (CPC). |
effectiveCpcBidMicros |
הצעת המחיר האפקטיבית לקליק. |
engineStatus |
סטטוס המנוע בקריטריון של קבוצת המודעות. |
finalUrlSuffix |
תבנית לכתובת URL להוספת פרמטרים לכתובת URL סופית. |
trackingUrlTemplate |
התבנית של כתובת ה-URL ליצירת כתובת URL למעקב. |
שדה איחוד יש להגדיר בדיוק ערך אחד. |
|
keyword |
מילת מפתח. |
listingGroup |
הקבוצה של כרטיסי המוצר. |
ageRange |
טווח גילאים. |
gender |
מגדר. |
userList |
רשימת משתמשים. |
webpage |
דף אינטרנט |
location |
מיקום. |
AdGroupCriterionStatus
הסטטוסים האפשריים של קבוצת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קריטריון של קבוצת מודעות מופעל. |
PAUSED |
קריטריון קבוצת המודעות מושהה. |
REMOVED |
קריטריון של קבוצת מודעות הוסר. |
QualityInfo
מאגר למידע על איכות של קריטריון של קבוצת מודעות.
ייצוג JSON |
---|
{ "qualityScore": integer } |
שדות | |
---|---|
qualityScore |
ציון האיכות. ייתכן שהשדה הזה לא יאוכלס אם אין ל-Google מספיק מידע כדי לקבוע ערך. |
CriterionType
טיפוסים בני מנייה (enum) שמתארים סוגי קריטריונים אפשריים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
KEYWORD |
מילת מפתח, לדוגמה, 'שייט במאדים'. |
PLACEMENT |
מיקום, שנקרא גם 'אתר', לדוגמה 'www.flowers4sale.com' |
MOBILE_APP_CATEGORY |
לקטגוריות של יישומים לנייד למיקוד. |
MOBILE_APPLICATION |
יישומים לנייד למיקוד. |
DEVICE |
מכשירים לטירגוט. |
LOCATION |
מיקומים גיאוגרפיים לטירגוט. |
LISTING_GROUP |
קבוצות של כרטיסי מוצר לטירגוט. |
AD_SCHEDULE |
תזמון הצגת מודעות. |
AGE_RANGE |
טווח גילאים. |
GENDER |
מגדר. |
INCOME_RANGE |
טווח הכנסה. |
PARENTAL_STATUS |
סטטוס הורה. |
YOUTUBE_VIDEO |
סרטון ב-YouTube. |
YOUTUBE_CHANNEL |
ערוץ YouTube. |
USER_LIST |
רשימת משתמשים. |
PROXIMITY |
קירבה. |
TOPIC |
טירגוט לפי נושא ברשת המדיה (לדוגמה, 'חיות מחמד ובעלי חיים'). |
LISTING_SCOPE |
היקף הדף העסקי לטירגוט. |
LANGUAGE |
שפה. |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
תווית תוכן להחרגת קטגוריה. |
CARRIER |
ספק. |
USER_INTEREST |
קטגוריה שבה המשתמש מתעניין. |
WEBPAGE |
קריטריון של דף אינטרנט למודעות דינמיות לרשת החיפוש. |
OPERATING_SYSTEM_VERSION |
גרסת מערכת הפעלה. |
APP_PAYMENT_MODEL |
מודל תשלום לאפליקציה. |
MOBILE_DEVICE |
נייד. |
CUSTOM_AFFINITY |
קהל בהתאמה אישית עם תחום עניין משותף. |
CUSTOM_INTENT |
קהל בהתאמה אישית לפי העדפות תוכן. |
LOCATION_GROUP |
קבוצת מיקומים. |
CUSTOM_AUDIENCE |
קהל בהתאמה אישית |
COMBINED_AUDIENCE |
קהל משולב |
KEYWORD_THEME |
נושא של מילות מפתח בקמפיין חכם |
AUDIENCE |
קהל |
LOCAL_SERVICE_ID |
מזהה שירות המודעות של 'Google בעלי מקצוע'. |
BRAND |
מותג |
BRAND_LIST |
רשימת מותגים |
LIFE_EVENT |
אירוע משמעותי בחיים |
PositionEstimates
אומדנים של הצעות מחיר לקריטריון במיקומים שונים.
ייצוג JSON |
---|
{ "topOfPageCpcMicros": string } |
שדות | |
---|---|
topOfPageCpcMicros |
האומדן של הצעת המחיר לקליק הדרושה כדי שהמודעה תוצג בראש הדף הראשון של תוצאות החיפוש. |
AdGroupCriterionEngineStatus
מציין את הסטטוסים של המנוע של AdGroupCriterion.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
AD_GROUP_CRITERION_ELIGIBLE |
הוּצא משימוש. אין להשתמש בו. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: הצעת המחיר או האיכות נמוכות מדי ואי אפשר להציג אותן. |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: הצעת המחיר או האיכות נמוכות מדי לנייד, אבל יכולות להופיע במחשבים. |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: הצעת המחיר או האיכות נמוכה מדי למחשבים, אבל עומדת בדרישות להצגה בניידים. |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: הצעת המחיר או האיכות נמוכות מדי ואי אפשר להציג אותן. |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: הושהה על ידי Baidu בגלל נפח חיפושים נמוך. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: כתובת ה-URL לניידים נמצאת בבדיקה. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: דף הנחיתה של מכשיר אחד לא תקין, ואילו דף הנחיתה של המכשיר השני לא תקין. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: מילת המפתח נוצרה ומושהית על ידי ניהול החשבון ב-Baidu, ועכשיו אפשר להפעיל אותה. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: בתהליך בדיקה של Baidu. Gemini: הקריטריון בבדיקה. |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: קריטריון לבדיקה. |
AD_GROUP_CRITERION_ON_HOLD |
הוּצא משימוש. אין להשתמש בו. נעשה שימוש בעבר על ידי Gemini |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : הקריטריון בהמתנה לבדיקה |
AD_GROUP_CRITERION_PAUSED |
הקריטריון הושהה. |
AD_GROUP_CRITERION_REMOVED |
הקריטריון הוסר. |
AD_GROUP_CRITERION_APPROVED |
הקריטריון אושר. |
AD_GROUP_CRITERION_DISAPPROVED |
הקריטריון לא אושר. |
AD_GROUP_CRITERION_SERVING |
הקריטריון פעיל ומציג מודעות. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
הקריטריון הושהה מפני שהחשבון מושהה. |
KeywordInfo
קריטריון של מילת מפתח.
ייצוג JSON |
---|
{
"matchType": enum ( |
שדות | |
---|---|
matchType |
סוג ההתאמה של מילת המפתח. |
text |
הטקסט של מילת המפתח (עד 80 תווים ו-10 מילים). |
KeywordMatchType
סוגי התאמה אפשריים של מילות מפתח.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
EXACT |
התאמה מדויקת. |
PHRASE |
התאמה לביטוי. |
BROAD |
התאמה רחבה. |
ListingGroupInfo
קריטריון של קבוצה של כרטיסי מוצר.
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
סוג הקבוצה של כרטיסי המוצר. |
ListingGroupType
סוג הקבוצה של כרטיסי המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SUBDIVISION |
חלוקת משנה של מוצרים לאורך מאפיין מסוים של כרטיס המוצר. הצמתים האלה לא משמשים לצורך טירגוט ערכים של רישומים, אלא רק כדי להגדיר את מבנה העץ. |
UNIT |
יחידה של קבוצה של כרטיסי מוצר שמגדירה הצעת מחיר. |
AgeRangeInfo
קריטריון של טווח גילאים.
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
הסוג של טווח הגילאים. |
AgeRangeType
הסוג של טווחי הגילאים הדמוגרפיים (לדוגמה, בין 18 ל-24).
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
AGE_RANGE_18_24 |
בין גיל 18 ל-24. |
AGE_RANGE_25_34 |
בין גיל 25 ל-34. |
AGE_RANGE_35_44 |
בין 35 ל-44. |
AGE_RANGE_45_54 |
בין 45 ל-54. |
AGE_RANGE_55_64 |
בין גיל 55 ל-64. |
AGE_RANGE_65_UP |
65 שנים ומעלה. |
AGE_RANGE_UNDETERMINED |
טווח גילאים לא ידוע. |
GenderInfo
קריטריון של מגדר.
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
סוג המגדר. |
GenderType
סוג המגדרים הדמוגרפיים (לדוגמה, נשים).
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
MALE |
זכר. |
FEMALE |
נקבה. |
UNDETERMINED |
מגדר לא ידוע. |
UserListInfo
קריטריון של רשימת משתמשים. רשימת משתמשים שהוגדרה על ידי המפרסם לטירגוט.
ייצוג JSON |
---|
{ "userList": string } |
שדות | |
---|---|
userList |
שם המשאב של 'רשימת משתמשים'. |
WebpageInfo
מייצג קריטריון לטירגוט לדפי אינטרנט של אתר מפרסם.
ייצוג JSON |
---|
{
"conditions": [
{
object ( |
שדות | |
---|---|
conditions[] |
תנאים, או ביטויים לוגיים, לטירגוט של דפי אינטרנט. כשמתבצעת הערכה של הטירגוט לצורך טירגוט, המערכת משלבת בין רשימת התנאים לטירגוט של דפי אינטרנט. אם רשימת תנאים ריקה, פירוש הדבר הוא שכל הדפים באתר של הקמפיין מטורגטים. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
coveragePercentage |
אחוז הכיסוי של קריטריוני האתר. זהו האחוז המחושב של כיסוי אתר על סמך יעד האתר, יעד שלילי לאתר ומילות מפתח שליליות בקבוצת המודעות ובקמפיין. למשל, כשהכיסוי מחזיר את הערך 1, המשמעות היא שיש לו 100% כיסוי. השדה הזה הוא לקריאה בלבד. |
criterionName |
שם הקריטריון שמוגדר על ידי הפרמטר הזה. ערך השם ישמש לזיהוי, למיון ולסינון של קריטריונים מסוג זה של פרמטרים. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
WebpageConditionInfo
ביטוי לוגי לטירגוט דפי אינטרנט של אתר מפרסם.
ייצוג JSON |
---|
{ "operand": enum ( |
שדות | |
---|---|
operand |
תנאי טירגוט של דפי אינטרנט. |
operator |
מפעיל של תנאי טירגוט של דף אינטרנט. |
argument |
ארגומנט של תנאי טירגוט לדף אינטרנט. |
WebpageConditionOperand
אופרנד תנאי דף אינטרנט בקריטריון של דף אינטרנט.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
URL |
ציון של תנאי טירגוט לכתובת URL של דף אינטרנט. |
CATEGORY |
ציון של תנאי טירגוט לפי קטגוריית דפי אינטרנט. |
PAGE_TITLE |
ציון של תנאי טירגוט לכותרת של דף אינטרנט. |
PAGE_CONTENT |
ציון של תנאי טירגוט לתוכן בדף אינטרנט. |
CUSTOM_LABEL |
ציון של תנאי טירגוט לפי תווית מותאמת אישית של דף אינטרנט. |
WebpageConditionOperator
האופרטור של תנאי דף אינטרנט בקריטריון של דף אינטרנט.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
EQUALS |
תנאי האינטרנט של הארגומנט שווה לתנאי האינטרנט להשוואה. |
CONTAINS |
תנאי האינטרנט של הארגומנט הוא חלק מתנאי האינטרנט להשוואה. |
LocationInfo
קריטריון של מיקום.
ייצוג JSON |
---|
{ "geoTargetConstant": string } |
שדות | |
---|---|
geoTargetConstant |
שם המשאב הקבוע של המיקוד הגיאוגרפי. |
AdGroupCriterionLabel
קשר בין קריטריון של קבוצת מודעות לבין תווית.
ייצוג JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תווית הקריטריון של קבוצת המודעות. שמות המשאבים של תוויות קריטריון של קבוצת מודעות מופיעים בצורה הבאה: |
adGroupCriterion |
הקריטריון של קבוצת המודעות שאליו התווית מצורפת. |
label |
התווית שהוקצתה לקריטריון של קבוצת המודעות. |
AdGroupLabel
קשר גומלין בין קבוצת מודעות לתווית.
ייצוג JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תווית קבוצת המודעות. שמות המשאבים של תוויות קבוצת מודעות מופיעים בתבנית הבאה: |
adGroup |
קבוצת המודעות שאליה מצורפת התווית. |
label |
התווית שהוקצתה לקבוצת המודעות. |
AgeRangeView
תצוגה של טווח גילאים.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת טווח הגילאים. שמות המשאבים בתצוגה של טווח הגילאים מופיעים בצורה הבאה:
|
הנכס
נכס הוא חלק ממודעה שאפשר לשתף בין מספר מודעות. זה יכול להיות תמונה (ImageAsset), סרטון (YouTubeVideoAsset) וכו'. אי אפשר לשנות את הנכסים ולכן לא ניתן להסיר אותם. כדי להפסיק את ההצגה של נכס, צריך להסיר את הנכס מהישות שמשתמשת בו.
ייצוג JSON |
---|
{ "resourceName": string, "type": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הנכס. השמות של משאבי הנכסים הם בפורמט הבא:
|
type |
סוג הנכס. |
finalUrls[] |
רשימה של כתובות URL סופיות אפשריות לאחר כל ההפניות האוטומטיות בדומיינים שונים. |
status |
סטטוס הנכס. |
creationTime |
חותמת הזמן של מועד יצירת הנכס הזה. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
lastModifiedTime |
התאריך והשעה שבהם הנכס הזה השתנה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
id |
מזהה הנכס. |
name |
שם אופציונלי של הנכס. |
trackingUrlTemplate |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
engineStatus |
סטטוס המנוע של הנכס. |
שדה איחוד asset_data . הסוג הספציפי של הנכס. asset_data יכול להיות רק אחד מהבאים: |
|
youtubeVideoAsset |
נכס וידאו ב-YouTube. |
imageAsset |
נכס תמונות. |
textAsset |
נכס טקסט. |
calloutAsset |
נכס יתרונות מרכזיים מאוחד. |
sitelinkAsset |
נכס Sitelink מאוחד. |
pageFeedAsset |
נכס מאוחד של פיד דפי נחיתה. |
mobileAppAsset |
נכס אפליקציה לנייד. |
callAsset |
נכס התקשרות מאוחד. |
callToActionAsset |
נכס של קריאה לפעולה. |
locationAsset |
נכס מיקום מאוחד. |
AssetType
רשימת סוגי הנכסים האפשריים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
YOUTUBE_VIDEO |
נכס וידאו ב-YouTube. |
MEDIA_BUNDLE |
נכס של חבילת מדיה. |
IMAGE |
נכס תמונות. |
TEXT |
נכס טקסט. |
LEAD_FORM |
נכס השארת פרטים. |
BOOK_ON_GOOGLE |
נכס הזמנה דרך Google. |
PROMOTION |
נכס קידום מכירות. |
CALLOUT |
נכס יתרונות מרכזיים. |
STRUCTURED_SNIPPET |
נכס מידע מובנה. |
SITELINK |
נכס Sitelink. |
PAGE_FEED |
נכס של פיד דפי נחיתה. |
DYNAMIC_EDUCATION |
נכס דיגיטלי דינמי שקשור ללימודים. |
MOBILE_APP |
נכס אפליקציה לנייד. |
HOTEL_CALLOUT |
נכס יתרונות מרכזיים של מלון. |
CALL |
נכס התקשרות. |
PRICE |
נכס מחיר. |
CALL_TO_ACTION |
נכס של קריאה לפעולה. |
DYNAMIC_REAL_ESTATE |
נכס נדל"ן דינמי. |
DYNAMIC_CUSTOM |
נכס דינמי בהתאמה אישית. |
DYNAMIC_HOTELS_AND_RENTALS |
נכס דינמי של מלונות ויחידות נופש להשכרה. |
DYNAMIC_FLIGHTS |
נכס טיסות דינמי. |
DISCOVERY_CAROUSEL_CARD |
נכס של כרטיס קרוסלה Discovery. |
DYNAMIC_TRAVEL |
נכס נסיעות דינמי. |
DYNAMIC_LOCAL |
נכס מקומי דינמי. |
DYNAMIC_JOBS |
נכס דינמי שקשור למשרות. |
LOCATION |
נכס מיקום. |
HOTEL_PROPERTY |
נכס של נכס מלון. |
AssetStatus
הסטטוסים האפשריים של הנכס.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסטטוס לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הנכס מופעל. |
REMOVED |
הנכס הוסר. |
ARCHIVED |
הנכס נמצא בארכיון. |
PENDING_SYSTEM_GENERATED |
הנכס נוצר על ידי המערכת וממתין לבדיקה של משתמש. |
AssetEngineStatus
המזהה הבא = 11
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SERVING |
הנכס פעיל. |
SERVING_LIMITED |
הנכס פעיל מוגבל. |
DISAPPROVED |
הנכס נדחה (לא עומד בדרישות). |
DISABLED |
הנכס לא פעיל (בהמתנה). |
REMOVED |
הנכס הוסר. |
YoutubeVideoAsset
נכס ב-YouTube.
ייצוג JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
שדות | |
---|---|
youtubeVideoTitle |
שם הסרטון ב-YouTube. |
youtubeVideoId |
מזהה הווידאו ב-YouTube. זהו ערך של מחרוזת באורך 11 תווים המשמש בכתובת ה-URL של סרטון YouTube. |
ImageAsset
נכס תמונות.
ייצוג JSON |
---|
{ "mimeType": enum ( |
שדות | |
---|---|
mimeType |
סוג ה-MIME של נכס התמונות. |
fullSize |
מטא-נתונים לתמונה הזו בגודלה המקורי. |
fileSize |
גודל הקובץ של נכס התמונה בבייטים. |
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. |
ImageDimension
מטא-נתונים של תמונה בגודל מסוים, מקורי או בגודל שונה.
ייצוג JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
שדות | |
---|---|
heightPixels |
גובה התמונה. |
widthPixels |
רוחב התמונה. |
url |
כתובת URL שמחזירה את התמונה עם הגובה והרוחב האלה. |
TextAsset
נכס טקסט.
ייצוג JSON |
---|
{ "text": string } |
שדות | |
---|---|
text |
תוכן הטקסט של נכס הטקסט. |
UnifiedCalloutAsset
נכס יתרונות מרכזיים מאוחד.
ייצוג JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
שדות | |
---|---|
calloutText |
טקסט היתרונות המרכזיים. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל. |
startDate |
תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd. |
endDate |
התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd. |
adScheduleTargets[] |
רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול. |
useSearcherTimeZone |
האם להציג את הנכס באזור הזמן של המשתמש בחיפוש. המידע מתייחס ל-Microsoft Ads. |
AdScheduleInfo
מייצג קריטריון של תזמון הצגת מודעות.
תזמון הצגת המודעות מוגדר כיום בשבוע וכמרווח הזמן שבמהלכו המודעות יוצגו.
לא ניתן להוסיף יותר מ-6 לוחות זמנים של מודעות באותו יום.
ייצוג JSON |
---|
{ "startMinute": enum ( |
שדות | |
---|---|
startMinute |
דקות אחרי שעת ההתחלה שבה לוח הזמנים הזה מתחיל. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
endMinute |
דקות אחרי שעת הסיום שבה לוח הזמנים הזה מסתיים. לוח הזמנים לא כולל את דקת הסיום. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
dayOfWeek |
היום בשבוע שעליו חל לוח הזמנים. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
startHour |
שעת התחלה בפרק זמן של 24 שעות. השדה הזה חייב להיות בין 0 ל-23, כולל. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
endHour |
שעת סיום בפרק זמן של 24 שעות; 24 מייצג את סוף היום. השדה הזה חייב להיות מספר בין 0 ל-24, כולל. השדה הזה נדרש לפעולות CREATE והוא אסור בפעולות UPDATE. |
MinuteOfHour
ספירה של רבע שעות. לדוגמה, "FIFTEEN"
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
ZERO |
אפס דקות מעבר לשעה. |
FIFTEEN |
15 דקות אחרי השעה. |
THIRTY |
30 דקות מעבר לשעה. |
FORTY_FIVE |
ארבעים וחמש דקות מעבר לשעה. |
DayOfWeek
מציין את הימים בשבוע, לדוגמה, "Monday".
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
MONDAY |
יום שני. |
TUESDAY |
יום שלישי. |
WEDNESDAY |
יום רביעי. |
THURSDAY |
חמישי. |
FRIDAY |
יום שישי. |
SATURDAY |
יום שבת. |
SUNDAY |
יום ראשון. |
UnifiedSitelinkAsset
נכס Sitelink מאוחד.
ייצוג JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
שדות | |
---|---|
linkText |
טקסט התצוגה של כתובת ה-URL עבור ה-Sitelink. המחרוזת הזו צריכה להיות בין 1 ל-25, כולל. |
description1 |
השורה הראשונה של התיאור של ה-Sitelink. אם הוא מוגדר, האורך צריך להיות בין 1 ל-35, כולל, וגם יש להגדיר את תיאור2. |
description2 |
השורה השנייה בתיאור של ה-Sitelink. אם המאפיין מוגדר, האורך צריך להיות בין 1 ל-35, כולל, וגם יש להגדיר תיאור1. |
startDate |
תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd. |
endDate |
התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd. |
adScheduleTargets[] |
רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול. |
trackingId |
המזהה משמש למעקב אחר קליקים של נכס ה-Sitelink. מדובר בחשבון Yahoo! ביפן בלבד. |
useSearcherTimeZone |
האם להציג את נכס ה-Sitelink באזור הזמן של המשתמש ברשת החיפוש. המידע מתייחס ל-Microsoft Ads. |
mobilePreferred |
האם ההעדפה היא שנכס ה-Sitelink יוצג במכשירים ניידים. המידע מתייחס ל-Microsoft Ads. |
UnifiedPageFeedAsset
נכס מאוחד של פיד דפי נחיתה.
ייצוג JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
שדות | |
---|---|
pageUrl |
דף האינטרנט שהמפרסמים רוצים למקד אליו. |
labels[] |
תוויות המשמשות לקיבוץ כתובות ה-URL של הדפים. |
MobileAppAsset
נכס שמייצג אפליקציה לנייד.
ייצוג JSON |
---|
{
"appId": string,
"appStore": enum ( |
שדות | |
---|---|
appId |
חובה. מחרוזת שמזהה באופן ייחודי אפליקציה לנייד. הוא צריך להכיל רק את מזהה הפלטפורמה המקורי, כמו "com.android.ebay" ל-Android או "12345689" ל-iOS. |
appStore |
חובה. חנות האפליקציות שמפיצה את האפליקציה הספציפית הזו. |
MobileAppVendor
סוג ספק האפליקציה לנייד
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
APPLE_APP_STORE |
ספק אפליקציות לנייד עבור Apple App Store. |
GOOGLE_APP_STORE |
ספק האפליקציות לנייד עבור חנות האפליקציות של Google. |
UnifiedCallAsset
נכס התקשרות מאוחד.
ייצוג JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
שדות | |
---|---|
countryCode |
קוד מדינה בן שתי אותיות של מספר הטלפון. לדוגמה: 'US', 'us'. |
phoneNumber |
מספר הטלפון הגולמי של המפרסם. דוגמאות: '1234567890', '(123)456-7890' |
callConversionReportingState |
מציין אם CallAsset הזה צריך להשתמש בהגדרה משלו של המרת שיחה, בהתאם להגדרה ברמת החשבון או להשבית את המרת השיחה. |
callConversionAction |
פעולת ההמרה שאליה רוצים לשייך המרה מסוג שיחה. אם המדיניות לא מוגדרת, המערכת תשתמש בפעולת ההמרה שהוגדרה כברירת מחדל. השדה הזה רלוונטי רק אם הערך callConversionReportingState מוגדר לערך USE_Resource_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
רשימה של לוחות זמנים שאינם חופפים, המציינים את כל מרווחי הזמן שעבורם הנכס עשוי להופיע. אפשר להשתמש ב-6 לוחות זמנים לכל היותר ביום, 42 בסך הכול. |
callOnly |
האם בשיחה מוצג רק מספר הטלפון, בלי קישור לאתר. המידע מתייחס ל-Microsoft Ads. |
callTrackingEnabled |
האם יש להפעיל את השיחה במעקב אחר שיחות. המידע מתייחס ל-Microsoft Ads. |
useSearcherTimeZone |
האם להציג את תוסף השיחה באזור הזמן של משתמש החיפוש. המידע מתייחס ל-Microsoft Ads. |
startDate |
תאריך ההתחלה שבו הנכס הזה ייכנס לתוקף ויוכל להתחיל להציג אותו, בפורמט yyyy-MM-dd. |
endDate |
התאריך האחרון שבו הנכס הזה בתוקף ועדיין מוצג, בפורמט yyyy-MM-dd. |
CallConversionReportingState
סוגי נתונים אפשריים למצב של פעולת המרה מסוג שיחה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
DISABLED |
פעולת ההמרה מסוג שיחה מושבתת. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
פעולת המרה מסוג שיחה תשתמש בסוג המרת השיחה שהוגדר ברמת החשבון. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
פעולת המרה מסוג שיחה תשתמש בסוג המרה מסוג שיחה שהוגדר ברמת המשאב (מודעות לשיחות בלבד/תוספי שיחה). |
CallToActionAsset
נכס של קריאה לפעולה.
ייצוג JSON |
---|
{
"callToAction": enum ( |
שדות | |
---|---|
callToAction |
קריאה לפעולה. |
CallToActionType
סוגי קריאה לפעולה אפשריים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
LEARN_MORE |
סוג הקריאה לפעולה הוא 'מידע נוסף'. |
GET_QUOTE |
סוג הקריאה לפעולה הוא 'קבלת עלות משוערת'. |
APPLY_NOW |
סוג הקריאה לפעולה חל עכשיו. |
SIGN_UP |
סוג הקריאה לפעולה הוא רישום. |
CONTACT_US |
סוג הקריאה לפעולה הוא 'יצירת קשר'. |
SUBSCRIBE |
סוג הקריאה לפעולה הוא 'הרשמה'. |
DOWNLOAD |
סוג הקריאה לפעולה הוא הורדה. |
BOOK_NOW |
סוג הקריאה לפעולה הוא 'הזמנה'. |
SHOP_NOW |
סוג הקריאה לפעולה הוא 'לקנייה'. |
BUY_NOW |
סוג הקריאה לפעולה זמין עכשיו לרכישה. |
DONATE_NOW |
סוג הקריאה לפעולה יתרום עכשיו. |
ORDER_NOW |
סוג הקריאה לפעולה הוא 'להזמנה'. |
PLAY_NOW |
סוג הקריאה לפעולה מופעל עכשיו. |
SEE_MORE |
סוג הקריאה לפעולה הוא עוד אפשרויות. |
START_NOW |
סוג הקריאה לפעולה מתחיל עכשיו. |
VISIT_SITE |
סוג הקריאה לפעולה הוא 'ביקור באתר'. |
WATCH_NOW |
סוג הקריאה לפעולה זמין עכשיו לצפייה. |
UnifiedLocationAsset
נכס מיקום מאוחד.
ייצוג JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
שדות | |
---|---|
placeId |
מזהי המקומות מזהים מקום באופן ייחודי במסד הנתונים של 'מקומות Google' ובמפות Google. השדה הזה ייחודי לכל מספר לקוח ולסוג נכס. מידע נוסף על מזהה מקום זמין בכתובת https://developers.google.com/places/web-service/place-id. |
businessProfileLocations[] |
רשימת מיקומי העסק עבור הלקוח. הערך הזה יוחזר רק אם נכס המיקום מסתנכרן מהחשבון ב'פרופיל העסק ב-Google'. אפשר לשייך לאותו חשבון כמה דפים עסקיים ב'פרופיל העסק ב-Google', שמפנים לאותו מזהה מקום. |
locationOwnershipType |
סוג הבעלות על המיקום. אם הסוג הוא BUSINESS_OWNER, הוא יוצג כתוסף מיקום. אם הסוג הוא שותף עצמאי, הוא יוצג כמיקום של מפיץ. |
BusinessProfileLocation
נתוני המיקום של פרופיל העסק סונכרנו מהחשבון המקושר של 'פרופיל העסק ב-Google'.
ייצוג JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
שדות | |
---|---|
labels[] |
המפרסם ציין את התווית של המיקום בחשבון של פרופיל העסק. הנתונים האלה מסונכרנים מהחשבון ב'פרופיל העסק ב-Google'. |
storeCode |
קוד החנות שרשום בפרופיל העסק במיקום הזה. הנתונים האלה מסונכרנים מהחשבון ב'פרופיל העסק ב-Google'. |
listingId |
מזהה כרטיס המוצר של המיקום הזה בפרופיל העסק. הנתונים האלה מסונכרנים מהחשבון המקושר ב'פרופיל העסק ב-Google'. |
LocationOwnershipType
סוגים אפשריים של בעלות על מיקום.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
BUSINESS_OWNER |
בעל העסק של המיקום(תוסף המיקום הקודם - LE). |
AFFILIATE |
מיקום מקושר(תוסף מיקום של צד שלישי - ALE). |
AssetGroupAsset
AssetGroupAsset הוא הקישור בין הנכס לקבוצת הנכסים. הוספה של AssetGroupAsset מקשרת בין נכס לקבוצת נכסים.
ייצוג JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הנכס בקבוצת הנכסים. הפורמט של שם משאב הנכס של קבוצת הנכסים הוא:
|
assetGroup |
קבוצת הנכסים שהנכס של קבוצת הנכסים הזה מקשר אליה. |
asset |
הנכס שהנכס של קבוצת הנכסים הזה מקשר אליו. |
fieldType |
התיאור של מיקום הנכס בקבוצת הנכסים. לדוגמה: HEADLINE, YOUTUBE_VIDEO וכו' |
status |
סטטוס הקישור בין הנכס לבין קבוצת הנכסים. |
AssetFieldType
מספר ה-Enum המתאר את המיקומים האפשריים של הנכס.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
HEADLINE |
הנכס מקושר לשימוש ככותרת. |
DESCRIPTION |
הנכס מקושר לשימוש כתיאור. |
MANDATORY_AD_TEXT |
הנכס מקושר לשימוש כטקסט חובה במודעה. |
MARKETING_IMAGE |
הנכס מקושר לשימוש כתמונה שיווקית. |
MEDIA_BUNDLE |
הנכס מקושר לשימוש כחבילת מדיה. |
YOUTUBE_VIDEO |
הנכס מקושר לשימוש כסרטון ב-YouTube. |
BOOK_ON_GOOGLE |
הנכס מקושר כדי לציין שבקמפיין לקידום מלון מופעלת האפשרות 'הזמנה דרך Google'. |
LEAD_FORM |
הנכס מקושר לשימוש כתוסף השארת פרטים. |
PROMOTION |
הנכס מקושר לשימוש כתוסף קידום מכירות. |
CALLOUT |
הנכס מקושר לשימוש כתוסף יתרונות מרכזיים. |
STRUCTURED_SNIPPET |
הנכס מקושר לשימוש כתוסף מידע מובנה. |
SITELINK |
הנכס מקושר לשימוש כ-Sitelink. |
MOBILE_APP |
הנכס מקושר לשימוש כתוסף אפליקציה לנייד. |
HOTEL_CALLOUT |
הנכס מקושר לשימוש כתוסף יתרונות מרכזיים של מלון. |
CALL |
הנכס מקושר לשימוש כתוסף שיחה. |
PRICE |
הנכס מקושר לשימוש כתוסף מחיר. |
LONG_HEADLINE |
הנכס מקושר לשימוש ככותרת ארוכה. |
BUSINESS_NAME |
הנכס מקושר לשימוש כשם עסק. |
SQUARE_MARKETING_IMAGE |
הנכס מקושר לשימוש כתמונה שיווקית ריבועית. |
PORTRAIT_MARKETING_IMAGE |
הנכס מקושר לשימוש כתמונה שיווקית לאורך. |
LOGO |
הנכס מקושר לשימוש כלוגו. |
LANDSCAPE_LOGO |
הנכס מקושר לשימוש כלוגו בתצוגה לרוחב. |
VIDEO |
הנכס מקושר לשימוש כלוגו שאינו של YouTube. |
CALL_TO_ACTION_SELECTION |
הנכס מקושר לשימוש לצורך בחירת קריאה לפעולה. |
AD_IMAGE |
הנכס מקושר לשימוש לצורך בחירת תמונה למודעה. |
BUSINESS_LOGO |
הנכס מקושר לשימוש כלוגו של העסק. |
HOTEL_PROPERTY |
הנכס מקושר לשימוש כמלון בקמפיין למיקסום הביצועים לענף התיירות והאירוח. |
DISCOVERY_CAROUSEL_CARD |
הנכס מקושר לשימוש ככרטיס קרוסלה Discovery. |
AssetGroupSignal
AssetGroupSignal מייצג אות בקבוצת נכסים. הקיום של אות מציין לקמפיין למיקסום הביצועים שהסיכוי שישלימו המרות הוא הגבוה ביותר. כשמשתמשים בקמפיינים למיקסום הביצועים, המערכת משתמשת באות הקהל כדי לחפש אנשים חדשים עם כוונת רכישה דומה או גבוהה יותר, וכך להשיג יותר המרות בחיפוש, ברשת המדיה, בווידאו ועוד.
ייצוג JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
שדות | |
---|---|
resourceName |
שם המשאב שמוגדר באות של קבוצת הנכסים. הפורמט של שם משאב האותות של קבוצת הנכסים הוא:
|
assetGroup |
קבוצת הנכסים שאליה שייך האות הזה של קבוצת הנכסים. |
שדה איחוד signal . האות של קבוצת הנכסים. signal יכול להיות רק אחד מהבאים: |
|
audience |
אות הקהל שישמש בקמפיין למיקסום הביצועים. |
AudienceInfo
קריטריון של קהל.
ייצוג JSON |
---|
{ "audience": string } |
שדות | |
---|---|
audience |
השם של משאב הקהל. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter מייצג צומת עץ של מסנן קבוצות של כרטיסי מוצר בקבוצת נכסים.
ייצוג JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב במסנן הקבוצות של כרטיסי המוצר בנכסים דיגיטליים. שם המשאב של מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים הוא בפורמט הבא:
|
assetGroup |
קבוצת הנכסים שמסנן הקבוצות של כרטיסי המוצר בנכסים דיגיטליים הוא חלק ממנה. |
id |
המזהה של ListingGroupFilter. |
type |
סוג הצומת של מסנן הקבוצות של כרטיסי המוצר. |
vertical |
התעשייה המסוימת שעץ הצמתים הנוכחי מייצג. כל הצמתים באותו עץ חייבים להשתייך לאותה תעשייה. |
caseValue |
ערך המאפיין שלפיו הקבוצה של כרטיסי המוצר משפרת את ההורה שלה. לא מוגדר לקבוצת הבסיס. |
parentListingGroupFilter |
שם המשאב בחלוקת המשנה של הקבוצה של כרטיסי המוצר ברמה העליונה. null עבור צומת המסנן של הקבוצה של כרטיסי המוצר ברמה הבסיסית. |
path |
נתיב המאפיינים המגדירים את מסנן הקבוצות של כרטיסי המוצר. |
ListingGroupFilterType
סוג מסנן הקבוצות של כרטיסי המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SUBDIVISION |
חלוקת משנה של מוצרים לאורך חלק ממאפייני כרטיס המוצר. |
UNIT_INCLUDED |
צומת עלה של מסנן של קבוצה של כרטיסי מוצר כלול. |
UNIT_EXCLUDED |
צומת עלה של מסנן של קבוצה של כרטיסי מוצר שהוחרגה. |
ListingGroupFilterVertical
סוג המסנן האנכי של הקבוצה של כרטיסי המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SHOPPING |
מייצג את ענף הקניות. מותר להשתמש בענף מסוים רק בקמפיינים למיקסום הביצועים בתחום הקמעונאות. |
ListingGroupFilterDimension
מאפיינים של דף אפליקציה למסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד dimension . המאפיין של אחד מהסוגים שלמטה תמיד קיים. dimension יכול להיות רק אחד מהבאים: |
|
productBiddingCategory |
קטגוריית בידינג של מוצר. |
productBrand |
מותג של מוצר שאתם מציעים. |
productChannel |
הרשות המוניציפאלית שבה המוצר נמכר. |
productCondition |
המצב של המוצר המוצע. |
productCustomAttribute |
מאפיין מותאם אישית של מוצר. |
productItemId |
מזהה הפריט של מוצר מסוים. |
productType |
סוג המוצר. |
ProductBiddingCategory
רכיב אחד של קטגוריית בידינג ברמה מסוימת. קטגוריות ברמה עליונה הן ברמה 1, הילדים ברמה 2 וכן הלאה. בשלב הזה אנחנו תומכים ב-5 רמות לכל היותר. המשתמש צריך לציין סוג מאפיין שמציין את רמת הקטגוריה. כל המקרים של אותה חלוקת משנה צריכים להיות מאותו סוג מאפיין (ברמת הקטגוריה).
ייצוג JSON |
---|
{
"level": enum ( |
שדות | |
---|---|
level |
מציין את רמת הקטגוריה בטקסונומיה. |
id |
המזהה של קטגוריית הבידינג על המוצר. המזהה הזה זהה למזהה של google_product_category, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436 |
ListingGroupFilterBiddingCategoryLevel
רמת קטגוריית הבידינג של מסנן קבוצות של כרטיסי מוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
LEVEL1 |
רמה 1. |
LEVEL2 |
רמה 2. |
LEVEL3 |
רמה 3. |
LEVEL4 |
רמה 4. |
LEVEL5 |
רמה 5. |
ProductBrand
המותג של המוצר.
ייצוג JSON |
---|
{ "value": string } |
שדות | |
---|---|
value |
ערך מחרוזת של מותג המוצר. |
ProductChannel
הרשות המוניציפאלית שבה המוצר נמכר.
ייצוג JSON |
---|
{
"channel": enum ( |
שדות | |
---|---|
channel |
הערך של הרשות המוניציפאלית. |
ListingGroupFilterProductChannel
ערכים מספריים המתארים את הרשות המוניציפאלית של מוצר מסוים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ONLINE |
הפריט נמכר באינטרנט. |
LOCAL |
הפריט נמכר בחנויות מקומיות. |
ProductCondition
המצב של המוצר המוצע.
ייצוג JSON |
---|
{
"condition": enum ( |
שדות | |
---|---|
condition |
הערך של התנאי. |
ListingGroupFilterProductCondition
ערכים מספריים המתארים את מצב המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
NEW |
מצב המוצר חדש. |
REFURBISHED |
מצב המוצר מחודש. |
USED |
צוין מצב המוצר. |
ProductCustomAttribute
מאפיין מותאם אישית של מוצר.
ייצוג JSON |
---|
{
"index": enum ( |
שדות | |
---|---|
index |
מציין את האינדקס של המאפיין המותאם אישית. |
value |
ערך המחרוזת של המאפיין המותאם אישית של המוצר. |
ListingGroupFilterCustomAttributeIndex
האינדקס של מאפייני הלקוח.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
INDEX0 |
מאפיין מותאם אישית לסינון לפי קבוצה של כרטיסי מוצר. |
INDEX1 |
מאפיין מותאם אישית למסנן שני של כרטיסי מוצר. |
INDEX2 |
מאפיין מותאם אישית למסנן קבוצות של כרטיסי מוצר. |
INDEX3 |
מאפיין מותאם אישית לסינון קבוצות של כרטיסי מוצר. |
INDEX4 |
מאפיין מותאם אישית לסינון לפי הקבוצה של כרטיסי המוצר החמישים. |
ProductItemId
מזהה הפריט של מוצר מסוים.
ייצוג JSON |
---|
{ "value": string } |
שדות | |
---|---|
value |
הערך של המזהה. |
ProductType
סוג המוצר.
ייצוג JSON |
---|
{
"level": enum ( |
שדות | |
---|---|
level |
רמת הסוג. |
value |
הערך של הסוג. |
ListingGroupFilterProductTypeLevel
מספרים שמתארים את רמת הסוג של מוצר מסוים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
LEVEL1 |
רמה 1. |
LEVEL2 |
רמה 2. |
LEVEL3 |
רמה 3. |
LEVEL4 |
רמה 4. |
LEVEL5 |
רמה 5. |
ListingGroupFilterDimensionPath
הגדרת הנתיב של מאפיינים שמגדירים מסנן קבוצות של כרטיסי מוצר.
ייצוג JSON |
---|
{
"dimensions": [
{
object ( |
שדות | |
---|---|
dimensions[] |
הנתיב המלא של המאפיינים דרך היררכיית הסינון של הקבוצות של כרטיסי המוצר (לא כולל הצומת הבסיסית) עד למסנן הזה של הקבוצות של כרטיסי המוצר. |
AssetGroupTopCombinationView
תצוגה על השימוש בשילוב של נכסים שמצורפים למודעות ברמת קבוצת המודעות.
ייצוג JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
שדות | |
---|---|
resourceName |
שם המשאב בתצוגת השילוב העליון של קבוצת הנכסים. שמות המשאבים של תצוגות מפורטות מובילים בשילוב עם AssetGroup הם בפורמט הבא: |
assetGroupTopCombinations[] |
שילובי הנכסים המובילים שהוצגו יחד. |
AssetGroupAssetCombinationData
נתוני שילוב נכסים של קבוצת נכסים
ייצוג JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
שדות | |
---|---|
assetCombinationServedAssets[] |
נכסים מוצגים. |
AssetUsage
מכיל את פרטי השימוש של הנכס.
ייצוג JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
שדות | |
---|---|
asset |
שם המשאב של הנכס. |
servedAssetFieldType |
סוג השדה המוצג של הנכס. |
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 |
הנכס משמש כלוגו של העסק. |
AssetGroup
קבוצת נכסים. AssetGroupAsset משמש לקישור נכס לקבוצת הנכסים. AssetGroupSignal משמש לשיוך אות לקבוצת נכסים.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוצת הנכסים. דוגמאות לשמות משאבים בקבוצות נכסים:
|
id |
המזהה של קבוצת הנכסים. |
campaign |
הקמפיין שאליו קבוצת הנכסים הזו משויכת. הנכס שמקושר לקבוצת הנכסים. |
name |
חובה. השם של קבוצת הנכסים. חובה. האורך המינימלי צריך להיות 1 והאורך המקסימלי הוא 128. המזהה לצורכי קמפיין חייב להיות ייחודי. |
finalUrls[] |
רשימה של כתובות URL סופיות לאחר כל ההפניות האוטומטיות בדומיינים שונים. בקמפיינים למיקסום הביצועים, כברירת מחדל, כתובות ה-URL כשירות להרחבה אלא אם בוחרים שלא להשתמש בהן. |
finalMobileUrls[] |
רשימה של כתובות הדף הסופיות בנייד לאחר כל ההפניות האוטומטיות בדומיינים שונים. בקמפיינים למיקסום הביצועים, כברירת מחדל, כתובות ה-URL כשירות להרחבה אלא אם בוחרים שלא להשתמש בהן. |
status |
הסטטוס של קבוצת הנכסים. |
path1 |
החלק הראשון של הטקסט שעשוי להיות מצורף לכתובת ה-URL שמוצגת במודעה. |
path2 |
החלק השני של הטקסט שעשוי להופיע כמצורף לכתובת ה-URL המוצגת במודעה. אפשר להגדיר את השדה הזה רק כשמוגדר נתיב 1. |
adStrength |
חוזק המודעה הכולל של קבוצת הנכסים הזו. |
AssetGroupStatus
הסטטוסים האפשריים של קבוצת נכסים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסטטוס לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. |
ENABLED |
קבוצת הנכסים מופעלת. |
PAUSED |
קבוצת הנכסים מושהית. |
REMOVED |
קבוצת הנכסים הוסרה. |
AdStrength
רשימה של חוזקות המודעה האפשריות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
PENDING |
חוזק המודעה נמצא כרגע בהמתנה. |
NO_ADS |
לא ניתן ליצור מודעות. |
POOR |
חוזק חלש. |
AVERAGE |
חוזק ממוצע. |
GOOD |
חוזק טוב. |
EXCELLENT |
חוזק מצוין. |
AssetSetAsset
AssetSetAsset הוא הקישור בין הנכס לקבוצת נכסים. הוספה של AssetSetAsset מקשרת נכס לקבוצת נכסים.
ייצוג JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצת הנכסים מופיעים בפורמט הבא:
|
assetSet |
קבוצת הנכסים שאליה הנכס בקבוצת הנכסים מקושר. |
asset |
הנכס שאליו קבוצת הנכסים הזו מקשר. |
status |
הסטטוס של הנכס שהוגדר בקבוצת הנכסים. קריאה בלבד. |
AssetSetAssetStatus
הסטטוסים האפשריים של קבוצת נכסים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
הסטטוס לא צוין. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הנכס של קבוצת הנכסים מופעל. |
REMOVED |
הנכס בקבוצת הנכסים הוסר. |
AssetSet
קבוצת נכסים שמייצגת אוסף של נכסים. אפשר להשתמש ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.
ייצוג JSON |
---|
{ "id": string, "resourceName": string } |
שדות | |
---|---|
id |
המזהה של קבוצת הנכסים. |
resourceName |
שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצת הנכסים מופיעים בצורה הבאה:
|
BiddingStrategy
שיטת בידינג.
ייצוג JSON |
---|
{ "resourceName": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של שיטת הבידינג. שמות המשאבים של שיטת הבידינג מופיעים בפורמט הבא:
|
status |
הסטטוס של שיטת הבידינג. השדה הזה הוא לקריאה בלבד. |
type |
הסוג של שיטת הבידינג. כדי ליצור שיטת בידינג, מגדירים את סכמת הבידינג. השדה הזה הוא לקריאה בלבד. |
currencyCode |
המטבע שבו משתמשת שיטת הבידינג (קוד בן שלוש אותיות לפי תקן ISO 4217). כשמשתמשים בשיטות בידינג ללקוחות עם חשבון ניהול, אפשר להגדיר את המטבע הזה בזמן היצירה וברירת המחדל שלו היא המטבע שמוגדר בחשבון הלקוח של חשבון הניהול. לא ניתן להגדיר את השדה הזה עבור לקוחות להצגת מודעות. כל האסטרטגיות של לקוח להצגת מודעות משתמשות באופן לא מפורש במטבע של הלקוח להצגת מודעות. בכל המקרים השדה validCurrencyCode מחזיר את המטבע שבו נעשה שימוש בשיטה. |
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. לכל שיטות הבידינג בחשבון צריך להיות שם ייחודי. האורך של המחרוזת הזו צריך להיות בין 1 ל-255, כולל, בקידוד UTF-8 בייטים (חתוך). |
effectiveCurrencyCode |
המטבע שבו משתמשת שיטת הבידינג (קוד בן שלוש אותיות לפי תקן ISO 4217). כשמדובר בשיטות בידינג בלקוחות ניהול, זהו המטבע שהוגדר על ידי המפרסם בזמן יצירת השיטה. זהו קוד המטבע של הלקוח, לצורך הצגת מודעות. המדדים של שיטת הבידינג מדווחים במטבע הזה. השדה הזה הוא לקריאה בלבד. |
campaignCount |
מספר הקמפיינים המשויכים לשיטת הבידינג הזו. השדה הזה הוא לקריאה בלבד. |
nonRemovedCampaignCount |
מספר הקמפיינים שלא הוסרו הקשורים לשיטת הבידינג הזו. השדה הזה הוא לקריאה בלבד. |
שדה איחוד אפשר להגדיר רק ערך אחד. |
|
enhancedCpc |
שיטת בידינג מגדילה את הצעות המחיר לקליקים שנראים כבעלי סיכוי גבוה יותר להוביל להמרה, ומקטינה אותם לקליקים שבהם נראה שהסבירות נמוכה יותר. |
maximizeConversionValue |
שיטת בידינג אוטומטית שעוזרת לקבל את ערך ההמרות הגבוה ביותר בקמפיינים במסגרת התקציב. |
maximizeConversions |
שיטת בידינג אוטומטית שעוזרת לקבל כמה שיותר המרות בקמפיינים במסגרת התקציב. |
targetCpa |
שיטת בידינג שמגדירה הצעות מחיר באופן שיעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שקבעתם. |
targetImpressionShare |
שיטת בידינג שמבצעת אופטימיזציה באופן אוטומטי כדי לעזור לכם להשיג אחוז מסוים של חשיפות. |
targetOutrankShare |
שיטת בידינג שמגדירה הצעות מחיר על סמך נתח היעד של המכרזים שבהם המפרסם צריך לקבל דירוג גבוה יותר ממתחרה מסוים. השדה הזה הוצא משימוש. יצירה של שיטת בידינג חדשה עם השדה הזה או צירוף שיטות בידינג עם השדה הזה לקמפיין ייכשלו. מותר לבצע שינויים באסטרטגיות שהסכימה הזו כבר מופיעה בהן. |
targetRoas |
שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך הממוצע של יעד החזר על הוצאות פרסום (ROAS). |
targetSpend |
שיטת בידינג שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
BiddingStrategyStatus
הסטטוסים האפשריים של שיטת בידינג.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
שיטת הבידינג מופעלת. |
REMOVED |
שיטת הבידינג הוסרה. |
BiddingStrategyType
ספירה שמתארת סוגים אפשריים של שיטות בידינג.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
COMMISSION |
'עמלות' היא שיטת בידינג אוטומטית שבה המפרסם משלם חלק מסוים מערך ההמרה. |
ENHANCED_CPC |
'אופטימיזציית עלות לקליק' היא שיטת בידינג שמגדילה את הצעות המחיר לקליקים שנראים כבעלי סיכוי גבוה יותר להוביל להמרה, ומקטינה אותם לקליקים שבהם נראה שהסבירות נמוכה יותר. |
INVALID |
משמש לציון הערך המוחזר בלבד. מציין שלקמפיין אין שיטת בידינג. הסיבה לכך היא שהמודעות בקמפיין לא מוצגות. לדוגמה, יכול להיות שקמפיין מסוים יצורף לשיטת בידינג של ניהול, ולאחר מכן הקישור של החשבון להצגת המודעות ינותק מחשבון הניהול. במקרה כזה, הקמפיין ינותק באופן אוטומטי משיטת הבידינג הניהול שאינה נגישה כרגע ויועבר לשיטת בידינג לא חוקית. |
MANUAL_CPA |
שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לפי פעולה שהמפרסם הגדיר. |
MANUAL_CPC |
בידינג ידני המבוסס על קליקים, שבו המשתמש משלם לפי קליק. |
MANUAL_CPM |
בידינג ידני המבוסס על חשיפות, שבו המשתמש משלם על אלף חשיפות. |
MANUAL_CPV |
שיטת בידינג שמשלמת סכום שניתן להגדרה לכל צפייה בסרטון. |
MAXIMIZE_CONVERSIONS |
שיטת בידינג שממקסמת באופן אוטומטי את מספר ההמרות לפי תקציב יומי. |
MAXIMIZE_CONVERSION_VALUE |
'מקסימום הכנסות' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות במסגרת התקציב. |
PAGE_ONE_PROMOTED |
סכמת בידינג מסוג 'קידום בדף הראשון', שמגדירה הצעות מחיר מקסימליות לקליק כדי לטרגט חשיפות במשבצת הראשונה לדף הראשון או בדף הראשון ב-google.com. הערך הזה הוצא משימוש. |
PERCENT_CPC |
'אחוז עלות לקליק' היא שיטת בידינג שבה הצעות המחיר הן חלק מהמחיר שפורסם למוצר או לשירות מסוימים. |
TARGET_CPA |
'יעד עלות להמרה' היא שיטת בידינג אוטומטית. כשמשתמשים בה, המערכת מגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שאתם מגדירים. |
TARGET_CPM |
'יעד עלות לאלף חשיפות' היא שיטת בידינג אוטומטית. כאשר משתמשים בשיטה הזו, המערכת מגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר חשיפות במסגרת יעד העלות לאלף חשיפות (CPM) שהגדרתם. |
TARGET_IMPRESSION_SHARE |
שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים מהמודעות לרשת החיפוש יוצגו בחלק העליון של הדף הראשון (או מיקום אחר מטורגט). |
TARGET_OUTRANK_SHARE |
'יעד נתח הובלה בדירוג' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר על סמך נתח היעד במכרזים שבהם המפרסם צריך לקבל דירוג גבוה יותר ממתחרה ספציפי. ערך ה-enum הזה הוצא משימוש. |
TARGET_ROAS |
'יעד החזר על הוצאות פרסום' היא שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות, תוך עמידה בערך ספציפי של יעד החזר על הוצאות פרסום (ROAS). |
TARGET_SPEND |
'יעד הוצאות' היא שיטת בידינג אוטומטית. כאשר משתמשים בשיטה הזו, המערכת מגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
EnhancedCpc
אין שדות בסוג הזה.
זוהי שיטת בידינג אוטומטית שמגדילה את הצעות המחיר לקליקים שצפויים יותר להוביל להמרה, ומקטינה את הצעות המחיר לקליקים במקרים שבהם יש סבירות נמוכה יותר שיובילו להמרה.
שיטת הבידינג הזו הוצאה משימוש ולא ניתן ליצור אותה יותר. עבור פונקציונליות מקבילה, משתמשים ב-ManualCpc עם הגדרה של EnhancedCpcEnabled כ-True.
MaximizeConversionValue
שיטת בידינג אוטומטית שעוזרת לקבל את ערך ההמרות הגבוה ביותר בקמפיינים במסגרת התקציב.
ייצוג JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
שדות | |
---|---|
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. ניתן לשינוי רק לגבי שיטות בידינג כוללות. |
cpcBidFloorMicros |
סף מינימלי להצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. ניתן לשינוי רק לגבי שיטות בידינג כוללות. |
targetRoas |
האפשרות של יעד החזר על הוצאות פרסום. אם היא מוגדרת, שיטת הבידינג תמקסם את ההכנסות תוך עמידה בערך הממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, ייתכן ששיטת הבידינג לא תוכל לנצל את התקציב במלואו. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הגבוה ביותר על הוצאות הפרסום במסגרת התקציב. |
MaximizeConversions
שיטת בידינג אוטומטית שעוזרת לקבל כמה שיותר המרות בקמפיינים במסגרת התקציב.
ייצוג JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
שדות | |
---|---|
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. ניתן לשינוי רק לגבי שיטות בידינג כוללות. |
cpcBidFloorMicros |
סף מינימלי להצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. ניתן לשינוי רק לגבי שיטות בידינג כוללות. |
targetCpaMicros |
האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שרוצים להוציא לכל פעולת המרה, שצוין ביחידות המיקרו של המטבע של שיטת הבידינג. אם היא מוגדרת, שיטת הבידינג תניב כמה שיותר המרות, בלי לחרוג מיעד העלות להמרה (CPA). אם לא תגדירו יעד עלות להמרה, שיטת הבידינג תנסה להשיג את העלות הנמוכה ביותר להמרה במסגרת התקציב. |
TargetCpa
זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר באופן שיעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שקבעתם.
ייצוג JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
שדות | |
---|---|
targetCpaMicros |
יעד העלות הממוצעת להמרה. היעד הזה צריך להיות גדול מהיחידה המינימלית לחיוב או שווה לו, בהתאם למטבע שמוגדר בחשבון. |
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. צריך להגדיר את האפשרות הזו רק לשיטות בידינג כוללות. |
cpcBidFloorMicros |
סף מינימלי להצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. צריך להגדיר את האפשרות הזו רק לשיטות בידינג כוללות. |
TargetRoas
שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך הממוצע של יעד החזר על הוצאות פרסום (ROAS).
ייצוג JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
שדות | |
---|---|
targetRoas |
חובה. ההכנסה שנבחרה (על סמך נתוני המרות) לכל יחידת הוצאה. הערך חייב להיות בין 0.01 ל-1000.0, כולל. |
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. צריך להגדיר את האפשרות הזו רק לשיטות בידינג כוללות. |
cpcBidFloorMicros |
סף מינימלי להצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. צריך להגדיר את האפשרות הזו רק לשיטות בידינג כוללות. |
TargetSpend
'מקסימום קליקים' היא שיטת בידינג אוטומטית שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.
ייצוג JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
שדות | |
---|---|
targetSpendMicros |
יעד ההוצאות שבו יש לקבל מקסימום קליקים. מגיש הצעות מחיר מסוג TargetSpend ינסה להוציא את הסכום הקטן יותר מהערך הזה או את סכום ההוצאות הטבעי של ויסות נתונים. אם לא מגדירים תקציב, היעד ישמש כיעד להוצאות. השדה הזה הוצא משימוש ולא ניתן להשתמש בו יותר. אפשר לקרוא פרטים נוספים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. |
CampaignBudget
תקציב של קמפיין.
ייצוג JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של תקציב הקמפיין. שמות המשאבים של תקציב הקמפיין הם בפורמט הבא:
|
deliveryMethod |
שיטת הצגת המודעות שקובעת את שיעור ניצול התקציב של הקמפיין. ברירת המחדל היא 'רגיל' אם לא צוין בפעולת יצירה. |
period |
התקופה שבמהלכה ינוצל התקציב. אם לא מגדירים ערך לפרמטר הזה, ערך ברירת המחדל הוא DAILY. |
amountMicros |
סכום התקציב, במטבע המקומי של החשבון. הסכום מצוין ביחידות מיקרו, כאשר מיליון שווה ליחידת מטבע אחת. ההוצאה החודשית מוגבלת לפי 30.4 מסכום זה. |
BudgetDeliveryMethod
שיטות הצגה אפשריות של תקציב.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
STANDARD |
שרת התקציב יווסת את הצגת המודעות באופן שווה לאורך כל תקופת הזמן. |
ACCELERATED |
שרת התקציב לא יווסת את הצגת המודעות, והמודעות יוצגו במהירות האפשרית. |
BudgetPeriod
תקופה אפשרית של תקציב.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
DAILY |
תקציב יומי. |
FIXED_DAILY |
תקציב יומי קבוע. |
CUSTOM_PERIOD |
ניתן להשתמש בתקציב מותאם אישית עם total_amount כדי לציין מגבלת תקציב לכל משך החיים. |
עדיפות
קמפיין.
ייצוג JSON |
---|
{ "resourceName": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הקמפיין. השמות של משאבי הקמפיין הם בפורמט הבא:
|
status |
הסטטוס של הקמפיין. כשמוסיפים קמפיין חדש, כברירת מחדל הסטטוס הוא 'מופעל'. |
servingStatus |
סטטוס הצגת המודעות של הקמפיין. |
biddingStrategySystemStatus |
סטטוס המערכת של שיטת הבידינג בקמפיין. |
adServingOptimizationStatus |
סטטוס האופטימיזציה של הצגת המודעות בקמפיין. |
advertisingChannelType |
יעד ההצגה העיקרי של מודעות בתוך הקמפיין. אפשר לצמצם את אפשרויות הטירגוט ב זהו שדה חובה ולא יכול להיות ריק כשיוצרים קמפיינים חדשים. אפשר להגדיר אותן רק כשיוצרים קמפיינים. אי אפשר לשנות את השדה אחרי שהקמפיין נוצר. |
advertisingChannelSubType |
מיקוד אופציונלי ל- אפשר להגדיר אותן רק כשיוצרים קמפיינים. אי אפשר לשנות את השדה אחרי יצירת הקמפיין. |
urlCustomParameters[] |
רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב- |
realTimeBiddingSetting |
הגדרות של 'בידינג בזמן אמת', תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange. |
networkSettings |
הגדרות הרשת של הקמפיין. |
dynamicSearchAdsSetting |
ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA). |
shoppingSetting |
ההגדרה לשליטה בקמפיינים של שופינג. |
geoTargetTypeSetting |
ההגדרה לטירגוט גיאוגרפי של מודעות. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקמפיין הזה. |
biddingStrategyType |
הסוג של שיטת הבידינג. כדי ליצור שיטת בידינג אפשר להגדיר את סכמת הבידינג ליצירה של שיטת בידינג רגילה, או את השדה השדה הזה הוא לקריאה בלבד. |
accessibleBiddingStrategy |
שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים הלא מוגבלים של שיטת הבידינג הכוללת המצורפת, שזוהו על ידי 'biddingStrategy'. ריק, אם לא הוגדרה שיטה כוללת לקמפיין. מאפייני שיטה ללא הגבלה זמינים לכל הלקוחות שאיתם השיטה משותפת, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח שמוגדר כבעלים של האסטרטגיה ולמנהלים שלו. ניתן לקרוא מאפיינים מוגבלים רק מהמשאב Biddingאסטרטגיה. |
frequencyCaps[] |
רשימה שמגבילה את התדירות שבה כל משתמש יראה את המודעות של הקמפיין. |
selectiveOptimization |
הגדרת אופטימיזציה סלקטיבית של הקמפיין הזה, שכוללת קבוצה של פעולות המרה שישמשו לאופטימיזציה של הקמפיין. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שנעשה בהם שימוש ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType. |
optimizationGoalSetting |
הגדרה של יעד אופטימיזציה לקמפיין הזה, שכוללת קבוצת סוגים של יעדי אופטימיזציה. |
trackingSetting |
הגדרות של פרטי מעקב ברמת הקמפיין. |
engineId |
המזהה של הקמפיין בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד לחשבון שאינו של Google Ads בלבד. לדוגמה, Yahoo Japan , Microsoft , Baidu וכו'. לישות ב-Google Ads, צריך להשתמש בשדה 'campaign.id' במקום זאת. |
excludedParentAssetFieldTypes[] |
סוגי השדות של הנכסים שצריך להחריג מהקמפיין הזה. קישורי נכסים עם סוגי השדות האלה לא יעברו בירושה לקמפיין הזה מהרמה העליונה. |
createTime |
חותמת הזמן של מועד יצירת הקמפיין. חותמת הזמן נמצאת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. createTime יצאה משימוש בגרסה 1. במקום זאת, צריך להשתמש ב-createTime. |
creationTime |
חותמת הזמן של מועד יצירת הקמפיין. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
lastModifiedTime |
התאריך והשעה שבהם הקמפיין הזה השתנה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
id |
המזהה של הקמפיין. |
name |
השם של מסע הפרסום. זהו שדה חובה ולא יכול להיות ריק כשיוצרים קמפיינים חדשים. היא לא יכולה להכיל תווים מסוג null (נקודת קוד 0x0), פיד שורה של NL (נקודת קוד 0xA) או תווים של חזרה לתחילת השורה (נקודת קוד 0xD). |
trackingUrlTemplate |
התבנית של כתובת ה-URL ליצירת כתובת URL למעקב. |
campaignBudget |
התקציב של הקמפיין. |
startDate |
התאריך שבו הקמפיין התחיל להציג מודעות באזור הזמן של הלקוח בפורמט YYYY-MM-DD. |
endDate |
היום האחרון של הקמפיין להצגת אזור הזמן של הלקוח בפורמט YYYY-MM-DD. במועד היצירה, ברירת המחדל היא 2037-12-30, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים כך שיפעל ללא הגבלת זמן, צריך להגדיר את השדה הזה כ-30.12.2037. |
finalUrlSuffix |
סיומת שמשמשת לצירוף פרמטרים של שאילתות לדפי נחיתה שמוצגים עם מעקב מקביל. |
urlExpansionOptOut |
מייצג את ביטול ההסכמה להתאמת כתובות URL לכתובות URL מטורגטות יותר. אם המדיניות לא מוגדרת (true), מטורגטים רק כתובות ה-URL הסופיות בקבוצת הנכסים, או כתובות ה-URL שצוינו בפיד Google Merchant Center או בפידים של פרטי העסק של המפרסם. אם תביעו הסכמה (False), כל הדומיין יטורגט. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום ביצועים, שבהם ערך ברירת המחדל הוא False. |
שדה איחוד שיטת הבידינג הכוללת צריכה להיות שיטת בידינג כוללת (נוצרה באמצעות שירות Biddingאסטרטגיה) או רגילה, שמוטמעת בקמפיין. |
|
biddingStrategy |
שיטת הבידינג הכוללת שמוגדרת בקמפיין. |
manualCpa |
שיטה רגילה של בידינג ידני לפי עלות להמרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לפי פעולה שהמפרסם הגדיר. הפרמטר הזה נתמך רק בקמפיינים של 'Google בעלי מקצוע'. |
manualCpc |
השיטה הרגילה של בידינג ידני לפי עלות לקליק. בידינג ידני המבוסס על קליקים, שבו המשתמש משלם לפי קליק. |
manualCpm |
שיטת בידינג רגילה של עלות ידנית לאלף חשיפות. בידינג ידני המבוסס על חשיפות, שבו המשתמש משלם על אלף חשיפות. |
maximizeConversions |
שיטת הבידינג הרגילה 'מקסימום המרות' שממקסמת באופן אוטומטי את מספר ההמרות במסגרת התקציב. |
maximizeConversionValue |
כשמשתמשים בשיטת הבידינג הרגילה 'מקסימום ערך המרות', המערכת מגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות במסגרת התקציב. |
targetCpa |
כשמשתמשים בשיטה רגילה של בידינג לפי יעד עלות להמרה, המערכת מגדירה הצעות מחיר באופן אוטומטי כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה שהגדרתם. |
targetImpressionShare |
שיטת הבידינג 'יעד נתח חשיפות'. שיטת בידינג אוטומטית שמגדירה הצעות מחיר במטרה להשיג את האחוז הנבחר של חשיפות. |
targetRoas |
שיטת בידינג רגילה לפי יעד החזר על הוצאות הפרסום שממקסמת באופן אוטומטי את ההכנסות תוך עמידה בערך הממוצע של יעד החזר על הוצאות פרסום (ROAS). |
targetSpend |
שיטת בידינג רגילה לפי יעד הוצאה: המערכת מגדירה את הצעות המחיר באופן אוטומטי כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
percentCpc |
שיטת הבידינג הרגילה לפי אחוז מהמחיר לקליק, שבה הצעות המחיר הן חלק מהמחיר שפורסם במודעה למוצר או לשירות מסוימים. |
targetCpm |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לאלף חשיפות. |
CampaignStatus
סטטוסים אפשריים של קמפיין.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
הקמפיין פעיל ויכול להציג מודעות. |
PAUSED |
הקמפיין הושהה על ידי המשתמש. |
REMOVED |
הקמפיין הוסר. |
CampaignServingStatus
סטטוסים אפשריים של הצגה של קמפיין.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
SERVING |
מוצג. |
NONE |
ללא. |
ENDED |
הסתיים. |
PENDING |
בהמתנה. |
SUSPENDED |
מושעה. |
BiddingStrategySystemStatus
הסטטוסים האפשריים של המערכת של שיטת בידינג.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
סימנים לכך שאירעה שגיאה בלתי צפויה, למשל, לא נמצא סוג של שיטת בידינג או שלא נמצאו פרטי סטטוס. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
אסטרטגיית הצעת המחיר פעילה, ו-AdWords אינו מוצא בעיות ספציפיות באסטרטגיה. |
LEARNING_NEW |
שיטת הבידינג במצב למידה כי היא נוצרה לאחרונה או הופעלה מחדש לאחרונה. |
LEARNING_SETTING_CHANGE |
שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה. |
LEARNING_BUDGET_CHANGE |
שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה בתקציב. |
LEARNING_COMPOSITION_CHANGE |
שיטת הבידינג במצב למידה בגלל שינוי שבוצע לאחרונה במספר הקמפיינים, קבוצות המודעות או מילות המפתח שמצורפים אליה. |
LEARNING_CONVERSION_TYPE_CHANGE |
שיטת הבידינג תלויה בדיווח על ההמרות, והלקוח שינה לאחרונה סוגי המרות שהיו רלוונטיים לשיטת הבידינג. |
LEARNING_CONVERSION_SETTING_CHANGE |
שיטת הבידינג תלויה בדיווח על ההמרות, והלקוח שינה לאחרונה את הגדרות ההמרות שלו. |
LIMITED_BY_CPC_BID_CEILING |
שיטת הבידינג מוגבלת על ידי תקרת הצעת המחיר שלה. |
LIMITED_BY_CPC_BID_FLOOR |
הסף המינימלי להצעות המחיר מגביל את שיטת הבידינג. |
LIMITED_BY_DATA |
שיטת הבידינג מוגבלת מפני שלא הייתה מספיק תנועת המרות במהלך השבועות האחרונים. |
LIMITED_BY_BUDGET |
חלק משמעותי ממילות המפתח בשיטת הבידינג הזו מוגבל על-ידי התקציב. |
LIMITED_BY_LOW_PRIORITY_SPEND |
שיטת הבידינג לא יכולה להגיע ליעד ההוצאות שלה מפני שהעדיפות של ההוצאה שלה בוטלה. |
LIMITED_BY_LOW_QUALITY |
לחלק משמעותי ממילות המפתח בשיטת הבידינג הזו יש ציון איכות נמוך. |
LIMITED_BY_INVENTORY |
בגלל טירגוט מצומצם, שיטת הבידינג לא יכולה למצות את התקציב במלואו. |
MISCONFIGURED_ZERO_ELIGIBILITY |
חסרים מעקב המרות (לא קיימים פינגים) ו/או רשימות רימרקטינג לקמפיין שופינג חכם (SSC). |
MISCONFIGURED_CONVERSION_TYPES |
שיטת הבידינג תלויה בדיווח על המרות, וללקוח חסרים סוגי המרות שייתכן שידווחו בהשוואה לשיטה הזו. |
MISCONFIGURED_CONVERSION_SETTINGS |
שיטת הבידינג תלויה בדיווח על ההמרות, והגדרות ההמרות של הלקוח נקבעות באופן שגוי. |
MISCONFIGURED_SHARED_BUDGET |
יש קמפיינים מחוץ לשיטת הבידינג שחולקים תקציבים עם קמפיינים שנכללים בשיטה. |
MISCONFIGURED_STRATEGY_TYPE |
סוג השיטה של הקמפיין לא חוקי ולכן הוא לא מציג מודעות. |
PAUSED |
שיטת הבידינג אינה פעילה. לא מצורפים לשיטת הבידינג מילות מפתח, קבוצות מודעות או קמפיינים פעילים. לחלופין, אין תקציבים פעילים שמקושרים לשיטת הבידינג. |
UNAVAILABLE |
שיטת הבידינג הזו לא תומכת כרגע בדיווח על סטטוס. |
MULTIPLE_LEARNING |
במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת LEARNING_* עבור שיטת הבידינג הזו. |
MULTIPLE_LIMITED |
במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת LIMITED_* לשיטת בידינג זו. |
MULTIPLE_MISCONFIGURED |
במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת MISCONFIGURED_* עבור שיטת הבידינג הזו. |
MULTIPLE |
במהלך התקופה הרלוונטית, היו כמה סטטוסים של מערכת לשיטת הבידינג הזו. |
AdServingOptimizationStatus
טיפוסים בני מנייה (enum) שמתאר סטטוסים אפשריים של הצגת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
OPTIMIZE |
הצגת המודעות עוברת אופטימיזציה על סמך שיעור הקליקים של הקמפיין. |
CONVERSION_OPTIMIZE |
אופטימיזציה של הצגת המודעות מבוססת על שיעור הקליקים * ההמרה של הקמפיין. אם הקמפיין לא נכלל בשיטת הבידינג של כלי אופטימיזציית ההמרות, ברירת המחדל תהיה 'אופטימיזציה'. |
ROTATE |
המודעות מוצגות בסבב באופן שווה במשך 90 יום, ולאחר מכן מתבצעת אופטימיזציה לקבלת יותר קליקים. |
ROTATE_INDEFINITELY |
הצגת מודעות שרמת הביצועים שלהן נמוכה יותר באופן שווה יותר למודעות שרמת הביצועים שלהן גבוהה יותר, בלי לבצע אופטימיזציה. |
UNAVAILABLE |
סטטוס האופטימיזציה של הצגת המודעות לא זמין. |
AdvertisingChannelType
טיפוסים בני מנייה (enum) שמתארים את הסוגים השונים של ערוצי הפרסום.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SEARCH |
רשת החיפוש. כולל קמפיינים לרשת המדיה, קמפיינים לרשת החיפוש וקמפיינים של +Search. |
DISPLAY |
רשת המדיה של Google בלבד. |
SHOPPING |
קמפיינים של שופינג מציגים מודעות בנכס השופינג ובתוצאות החיפוש ב-google.com. |
HOTEL |
קמפיינים לקידום מלונות. |
VIDEO |
קמפיינים של מודעות וידאו. |
MULTI_CHANNEL |
קמפיינים לקידום אפליקציות וקמפיינים לעידוד השימוש באפליקציות, שמוצגים בכמה ערוצים. |
LOCAL |
קמפיינים מקומיים. |
SMART |
קמפיינים חכמים. |
PERFORMANCE_MAX |
קמפיינים למיקסום ביצועים. |
LOCAL_SERVICES |
קמפיינים של 'Google בעלי מקצוע'. |
DISCOVERY |
קמפיינים מסוג Discovery. |
TRAVEL |
קמפיינים ל-Google נסיעות. |
AdvertisingChannelSubType
דוגמאות לסוגי משנה של ערוצים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש כערך מוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SEARCH_MOBILE_APP |
קמפיינים לקידום אפליקציות לנייד. |
DISPLAY_MOBILE_APP |
קמפיינים לקידום אפליקציות לנייד לרשת המדיה. |
SEARCH_EXPRESS |
קמפיינים של AdWords Express לרשת החיפוש. |
DISPLAY_EXPRESS |
קמפיינים של AdWords Express לרשת המדיה. |
SHOPPING_SMART_ADS |
קמפיינים חכמים לשופינג. |
DISPLAY_GMAIL_AD |
קמפיינים של מודעות Gmail. |
DISPLAY_SMART_CAMPAIGN |
קמפיינים חכמים לרשת המדיה. אי אפשר ליצור קמפיינים חדשים מסוג המשנה הזה. |
VIDEO_OUTSTREAM |
קמפיינים של מודעות וידאו Outstream. |
VIDEO_ACTION |
קמפיינים של מודעות וידאו מסוג TrueView עם קריאה לפעולה. |
VIDEO_NON_SKIPPABLE |
קמפיינים של מודעות וידאו עם מודעות וידאו שלא ניתן לדלג עליהן. |
APP_CAMPAIGN |
קמפיין לקידום אפליקציה שמאפשר לכם לקדם בקלות את האפליקציה שלכם ל-Android או ל-iOS בנכסים המובילים של Google, כולל חיפוש Google, Play, YouTube ורשת המדיה של Google. |
APP_CAMPAIGN_FOR_ENGAGEMENT |
קמפיין לעידוד השימוש באפליקציה. היעד הזה מתמקד בעידוד לאינטראקציה חוזרת עם האפליקציה בכמה מהנכסים המובילים של Google, כולל חיפוש Google , YouTube ורשת המדיה של Google. |
LOCAL_CAMPAIGN |
קמפיינים שמתמחים בפרסום מקומי. |
SHOPPING_COMPARISON_LISTING_ADS |
קמפיינים של השוואת מחירים. |
SMART_CAMPAIGN |
קמפיינים חכמים רגילים |
VIDEO_SEQUENCE |
קמפיינים של מודעות וידאו עם מודעות וידאו בהמשכים. |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
קמפיין להרשמה לקראת השקת אפליקציה שמיועד להרשמה מראש לאפליקציה לנייד, והוא מטרגט כמה ערוצי פרסום ב-Google Play, ב-YouTube וברשת המדיה. |
VIDEO_REACH_TARGET_FREQUENCY |
קמפיין וידאו להגדלת פוטנציאל החשיפה עם שיטת בידינג לפי תדירות טירגוט. |
TRAVEL_ACTIVITIES |
קמפיינים לעידוד פעילויות ב-Google נסיעות. |
CustomParameter
מיפוי שיכול לשמש תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate
, finalUrls
או mobile_final_urls
.
ייצוג JSON |
---|
{ "key": string, "value": string } |
שדות | |
---|---|
key |
המפתח שתואם לשם של תג הפרמטר. |
value |
הערך להחלפה. |
RealTimeBiddingSetting
הגדרות של 'בידינג בזמן אמת', תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange.
ייצוג JSON |
---|
{ "optIn": boolean } |
שדות | |
---|---|
optIn |
האם הקמפיין מצורף לבידינג בזמן אמת. |
NetworkSettings
הגדרות הרשת של הקמפיין.
ייצוג JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
שדות | |
---|---|
targetGoogleSearch |
האם המודעות יוצגו עם תוצאות חיפוש ב-google.com. |
targetSearchNetwork |
אם המודעות יוצגו באתרי שותפים ברשת החיפוש של Google (לשם כך צריך להיות |
targetContentNetwork |
האם המודעות יוצגו במיקומים שצוינו ברשת המדיה של Google. המיקומים מצוינים באמצעות קריטריון המיקום. |
targetPartnerSearchNetwork |
האם המודעות יוצגו ברשת השותפים של Google. האפשרות הזו זמינה רק בחלק מחשבונות השותפים של Google. |
DynamicSearchAdsSetting
ההגדרה לשליטה במודעות דינמיות לרשת החיפוש (DSA).
ייצוג JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
שדות | |
---|---|
domainName |
חובה. שם הדומיין באינטרנט שההגדרה הזו מייצגת, לדוגמה, google.com או www.google.com. |
languageCode |
חובה. קוד השפה שמציין את שפת הדומיין, לדוגמה 'en'. |
useSuppliedUrlsOnly |
האם הקמפיין משתמש אך ורק בכתובות URL שסופקו על ידי המפרסם. |
ShoppingSetting
ההגדרה לקמפיינים של שופינג. מגדיר את מגוון המוצרים שניתן לפרסם באמצעות הקמפיין, ואת האינטראקציה של הקמפיין עם קמפיינים אחרים של שופינג.
ייצוג JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
שדות | |
---|---|
feedLabel |
תווית פיד של מוצרים שייכללו בקמפיין. ניתן להגדיר רק ערך אחד של feedLabel או salesCountry. אם משתמשים במקום ב-salesCountry, בשדה feedLabel מקבלים קודי מדינות באותו פורמט, לדוגמה: 'XX'. אחרת, אפשר להשתמש בכל מחרוזת שמשמשת כתווית פיד ב-Google Merchant Center. |
useVehicleInventory |
האם לטרגט למלאי שטחי פרסום של רכבים. |
merchantId |
מספר החשבון ב-Merchant Center. השדה הזה נדרש כדי ליצור פעולות. אי אפשר לשנות את השדה הזה בקמפיינים של שופינג. |
salesCountry |
מדינת המכירות של המוצרים שרוצים לכלול בקמפיין. |
campaignPriority |
עדיפות הקמפיין. קמפיינים עם עדיפות מספרית גבוהה יותר מקבלים קדימות על פני קמפיינים עם עדיפות נמוכה יותר. השדה הזה נדרש לקמפיינים של שופינג, עם ערכים בין 0 ל-2, כולל. השדה הזה אופציונלי בקמפיינים חכמים לשופינג, אבל אם מגדירים אותו, השדה הזה חייב להיות שווה ל-3. |
enableLocal |
האם לכלול מוצרים בחנויות מקומיות. |
GeoTargetTypeSetting
מייצג אוסף של הגדרות שקשורות לטירגוט הגיאוגרפי של המודעות.
ייצוג JSON |
---|
{ "positiveGeoTargetType": enum ( |
שדות | |
---|---|
positiveGeoTargetType |
ההגדרה שמשמשת לטירגוט גיאוגרפי חיובי בקמפיין הספציפי הזה. |
negativeGeoTargetType |
ההגדרה שמשמשת לטירגוט גיאוגרפי שלילי בקמפיין הספציפי הזה. |
PositiveGeoTargetType
הסוגים האפשריים של טירגוט גיאוגרפי חיובי.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
PRESENCE_OR_INTEREST |
מציינת שמודעה מופעלת אם משתמש נמצא במיקומים הגיאוגרפיים המטורגטים של המפרסם, או מביע בהם עניין. |
SEARCH_INTEREST |
מציינת שמודעה מופעלת אם המשתמש מחפש את המיקומים הגיאוגרפיים המטורגטים של המפרסם. אפשר להשתמש במאפיין הזה רק בקמפיינים לרשת החיפוש ובקמפיינים רגילים לשופינג. |
PRESENCE |
מציינת שמודעה מופעלת אם המשתמש נמצא במיקומים הגיאוגרפיים המטורגטים של המפרסם או מגיע אליהם באופן קבוע. |
NegativeGeoTargetType
הסוגים האפשריים של טירגוט גיאוגרפי שלילי.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
PRESENCE_OR_INTEREST |
מציינת שהמשתמש לא יכול לראות את המודעה אם הוא נמצא במיקומים המוחרגים של המפרסם, או אם הוא מביע בהם עניין. |
PRESENCE |
מציינת שמשתמש לא יכול לראות את המודעה אם הוא נמצא במיקומים המוחרגים של המפרסם. |
FrequencyCapEntry
אין שדות בסוג הזה.
כלל שמציין את המספר המקסימלי של פעמים שבהן מודעה (או קבוצה כלשהי של מודעות) יכולה להופיע בפני משתמש במהלך תקופת זמן מסוימת.
SelectiveOptimization
הגדרת אופטימיזציה סלקטיבית של הקמפיין הזה, שכוללת קבוצה של פעולות המרה שישמשו לאופטימיזציה של הקמפיין. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שנעשה בהם שימוש ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType.
ייצוג JSON |
---|
{ "conversionActions": [ string ] } |
שדות | |
---|---|
conversionActions[] |
הקבוצה שנבחרה של פעולות המרה לאופטימיזציה של הקמפיין הזה. |
OptimizationGoalSetting
הגדרה של יעד אופטימיזציה לקמפיין הזה, שכוללת קבוצת סוגים של יעדי אופטימיזציה.
ייצוג JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
שדות | |
---|---|
optimizationGoalTypes[] |
רשימת הסוגים של יעדי האופטימיזציה. |
OptimizationGoalType
הסוג של יעד האופטימיזציה
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש כערך מוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
CALL_CLICKS |
אופטימיזציה לקבלת יותר קליקים לשיחה. המרות מסוג קליקים לשיחה הן הפעמים שבהן אנשים בחרו באפשרות 'התקשרות' כדי ליצור קשר עם חנות לאחר צפייה במודעה. |
DRIVING_DIRECTIONS |
בצע אופטימיזציה למסלולי נסיעה. המרות מסוג 'מסלול נסיעה' הן הפעמים שבהן אנשים בחרו באפשרות 'קבלת מסלול' כדי לנווט לחנות לאחר צפייה במודעה. |
APP_PRE_REGISTRATION |
אופטימיזציה לרישום מראש. המרות מסוג 'אפליקציה – רישום מראש' הן מספר ההרשמות מראש שקיבלו הודעה כשהאפליקציה תושק. |
TrackingSetting
הגדרות של פרטי מעקב ברמת הקמפיין.
ייצוג JSON |
---|
{ "trackingUrl": string } |
שדות | |
---|---|
trackingUrl |
כתובת ה-URL שמשמשת למעקב דינמי. |
ManualCpa
אין שדות בסוג הזה.
שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לפי פעולה שהמפרסם הגדיר.
ManualCpc
בידינג ידני המבוסס על קליקים, שבו המשתמש משלם לפי קליק.
ייצוג JSON |
---|
{ "enhancedCpcEnabled": boolean } |
שדות | |
---|---|
enhancedCpcEnabled |
האם יש לשפר את הצעות המחיר על סמך נתונים של כלי אופטימיזציית ההמרות. |
ManualCpm
אין שדות בסוג הזה.
בידינג ידני המבוסס על חשיפות, שבו המשתמש משלם על אלף חשיפות.
PercentCpc
שיטת בידינג שבה הצעות המחיר הן חלק מהמחיר שפורסם עבור מוצר או שירות כלשהו.
ייצוג JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
שדות | |
---|---|
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. זהו שדה אופציונלי שהמפרסם מזין ומצוין ב-micros מקומיים. הערה: המערכת מפרשת את ערך האפס באותו אופן כמו שערך הצעת מחיר מסוג bid_תקרות לא מוגדר. |
enhancedCpcEnabled |
מתאימה את הצעת המחיר בכל מכרז, כלפי מעלה או כלפי מטה, בהתאם לסבירות להמרה. הצעות מחיר בודדות עשויות לחרוג מ-cpcBidCeilingMicros, אך סכום הצעת המחיר הממוצע עבור קמפיין לא אמור לחרוג מכך. |
TargetCpm
אין שדות בסוג הזה.
'יעד עלות לאלף חשיפות' היא שיטת בידינג אוטומטית. כשמשתמשים בה, המערכת מגדירה הצעות מחיר כדי לבצע אופטימיזציה של הביצועים בהתאם ליעד העלות לאלף חשיפות שהגדרתם.
CampaignAsset
קישור בין קמפיין לנכס.
ייצוג JSON |
---|
{
"resourceName": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הנכס בקמפיין. שמות המשאבים של CampaignAsset הם בפורמט הבא:
|
status |
הסטטוס של הנכס בקמפיין. |
campaign |
הקמפיין שאליו הנכס מקושר. |
asset |
הנכס שמקושר לקמפיין. |
CampaignAssetSet
CampaignAssetSet הוא הקישור בין קמפיין לקבוצת נכסים. הוספה של CampaignAssetSet מקשרת קבוצת נכסים לקמפיין.
ייצוג JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוצת הנכסים בקמפיין. שמות המשאבים של קבוצת הנכסים מופיעים בפורמט הבא:
|
campaign |
הקמפיין שאליו קבוצת הנכסים הזו מקושרת. |
assetSet |
קבוצת הנכסים שמקושרת לקמפיין. |
status |
הסטטוס של נכס קבוצת הנכסים בקמפיין. קריאה בלבד. |
CampaignAudienceView
תצוגת קהל של קמפיין. כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג עבור מודעות ברשת המדיה וברשת YouTube, ורשימות רימרקטינג עבור מודעות לרשת החיפוש (RLSA), שנצברים לפי קריטריון של קמפיין וקהל. התצוגה הזו כוללת רק קהלים שצורפו ברמת הקמפיין.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת הקהל של הקמפיין. שמות המשאבים לתצוגת קהל של הקמפיין הם בפורמט הבא:
|
CampaignCriterion
קריטריון של קמפיין.
ייצוג JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קריטריון הקמפיין. שמות המשאבים של קריטריון של קמפיינים מופיעים בפורמט הבא:
|
displayName |
השם המוצג של הקריטריון. השינויים בשדה הזה לא נלקחים בחשבון. |
type |
סוג הקריטריון. |
status |
הסטטוס של הקריטריון. |
lastModifiedTime |
התאריך והשעה שבהם קריטריון הקמפיין הזה השתנה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
criterionId |
מזהה הקריטריון. המערכת מתעלמת משדה זה במהלך שינוי. |
bidModifier |
ערך ההתאמה של הצעות המחיר כאשר הקריטריון תואם. ערך ההתאמה חייב להיות בטווח: 0.1 - 10.0. רוב סוגי הקריטריונים שניתן לטרגט תומכים במגבילי התאמה. כדי לבטל את ההסכמה לסוג מכשיר מסוים, צריך להקיש על 0. |
negative |
האם לטרגט ( |
שדה איחוד יש להגדיר בדיוק ערך אחד. |
|
keyword |
מילת מפתח. |
location |
מיקום. |
device |
מכשיר. |
ageRange |
טווח גילאים. |
gender |
מגדר. |
userList |
רשימת משתמשים. |
language |
שפה. |
webpage |
דף אינטרנט. |
locationGroup |
קבוצה לפי מיקום |
CampaignCriterionStatus
הסטטוסים האפשריים של CampaignCriterion.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קריטריון של קמפיין מופעל. |
PAUSED |
קריטריון הקמפיין מושהה. |
REMOVED |
קריטריון הקמפיין הוסר. |
LanguageInfo
קריטריון שפה.
ייצוג JSON |
---|
{ "languageConstant": string } |
שדות | |
---|---|
languageConstant |
שם המשאב של קבוע השפה. |
LocationGroupInfo
רדיוס סביב רשימת מיקומים שצוינו בפיד.
ייצוג JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
שדות | |
---|---|
geoTargetConstants[] |
קבועים לטירגוט גיאוגרפי שמגביל את היקף האזור הגיאוגרפי בפיד. בשלב זה יכול להיות רק קבוע אחד של מיקוד גיאוגרפי. |
radiusUnits |
יחידת הרדיוס. מיילים ומטרים נתמכים בקבועים של טירגוט גיאוגרפי. קבוצות של פריטי פיד נתמכים במיילים ובמטרים. זהו שדה חובה וצריך להגדיר אותו בפעולות CREATE. |
feedItemSets[] |
FeedItemSets שה-FeedItems שלו מטורגטים. אם מציינים כמה מזהים, המערכת מטורגטת לכל הפריטים שמופיעים בקבוצה אחת לפחות. לא ניתן להשתמש בשדה הזה עם geoTargetConstants. הפעולה הזו היא אופציונלית ואפשר להגדיר אותה רק בפעולות CREATE. |
radius |
המרחק ביחידות שמציין את הרדיוס סביב מיקומים גיאוגרפיים מטורגטים. זהו שדה חובה וצריך להגדיר אותו בפעולות CREATE. |
LocationGroupRadiusUnits
יחידת המרחק ברדיוס בקבוצת המיקומים (לדוגמה, MILES)
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
METERS |
מטרים |
MILES |
מיילים |
MILLI_MILES |
מילי מייל |
CampaignLabel
מייצג קשר בין קמפיין לתווית.
ייצוג JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
שדות | |
---|---|
resourceName |
שם המשאב. שמות המשאבים של תוויות הקמפיין מופיעים בפורמט הבא: |
campaign |
הקמפיין שאליו מצורפת התווית. |
label |
התווית שהוקצתה לקמפיין. |
CartDataSalesView
תצוגת מכירות של נתוני עגלות הקניות.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב בתצוגה 'מכירות של נתוני עגלות הקניות'. שמות המשאבים בתצוגת המכירות של נתוני עגלות הקניות מופיעים בצורה הבאה: |
קהל
קהל הוא אפשרות יעילה לטירגוט שמאפשרת ליצור חפיפה בין מאפייני פילוח שונים, כמו מידע דמוגרפי מפורט וקהלים עם תחום עניין משותף, כדי ליצור קהלים שמייצגים קטעים של פלחי היעד.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
שדות | |
---|---|
resourceName |
שם המשאב של הקהל. שמות הקהלים מופיעים בפורמט הבא:
|
id |
המזהה של הקהל. |
name |
חובה. שם הקהל. השם צריך להיות ייחודי וייחודי לכל הקהלים. האורך המינימלי צריך להיות 1 והאורך המקסימלי הוא 255. |
description |
תיאור הקהל הזה. |
ConversionAction
פעולת המרה.
ייצוג JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של פעולת ההמרה. שמות המשאבים של פעולות המרה מופיעים בפורמט הבא:
|
creationTime |
חותמת הזמן של יצירת הפעילות ב-Floodlight, בפורמט ISO 8601. |
status |
הסטטוס של פעולת ההמרה הזו לצבירת אירועי המרה. |
type |
הסוג של פעולת ההמרה הזו. |
category |
קטגוריית ההמרות המדווחות עבור פעולת ההמרה הזו. |
valueSettings |
הגדרות שקשורות לערך של אירועי ההמרה שמשויכים לפעולת ההמרה הזו. |
attributionModelSettings |
הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו. |
floodlightSettings |
הגדרות Floodlight לסוגי המרות של Floodlight. |
id |
המזהה של פעולת ההמרה. |
name |
השם של פעולת ההמרה. זהו שדה חובה ולא יכול להיות ריק כשיוצרים פעולות המרה חדשות. |
primaryForGoal |
אם הביט הראשיForGoal של פעולת ההמרה מוגדר כ-False, לא ניתן להגיש הצעות מחיר לפעולת ההמרה בכל הקמפיינים, ללא קשר ליעד ההמרה של הלקוח או ליעד ההמרה שהוגדר לקמפיין. עם זאת, יעדי המרה מותאמים אישית לא מכבדים את primaryForGoal, כך שאם לקמפיין יש יעד המרה מותאם אישית שהוגדר עם פעולת המרה primaryForGoal = false, עדיין אפשר להגיש הצעת מחיר על פעולת ההמרה הזו. כברירת מחדל, הערך primaryForGoal יהיה TRUE אם הוא לא מוגדר. בגרסה 9, ניתן להגדיר את primaryForGoal כ-false רק לאחר יצירה באמצעות פעולת 'עדכון', מפני שהוא לא מוצהר כאופציונלי. |
ownerCustomer |
שם המשאב של הלקוח שמוגדר כבעלים של פעולת ההמרה. שם המשאב הוא null אם זו פעולת המרה בהגדרת המערכת. |
includeInClientAccountConversionsMetric |
האם צריך לכלול את פעולת ההמרה הזו במדד clientAccountConversions. |
includeInConversionsMetric |
אם צריך לכלול את פעולת ההמרה הזו במדד 'המרות'. |
clickThroughLookbackWindowDays |
המספר המקסימלי של ימים שעשויים לעבור בין אינטראקציה (למשל, קליק) לבין אירוע המרה. |
appId |
מזהה האפליקציה שמשויך לפעולת המרה באפליקציה. |
ConversionActionStatus
סטטוסים אפשריים של פעולת המרה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
ההמרות יתועדו. |
REMOVED |
ההמרות לא יתועדו. |
HIDDEN |
ההמרות לא יתועדו ופעולת ההמרה לא תופיע בממשק המשתמש. |
ConversionActionType
סוגים אפשריים של פעולת המרה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
AD_CALL |
המרות מתרחשות כשמשתמשים לוחצים על תוסף שיחה של מודעה. |
CLICK_TO_CALL |
המרות שמתרחשות כשמשתמשים לוחצים על מספר טלפון בנייד. |
GOOGLE_PLAY_DOWNLOAD |
המרות שמתרחשות כשמשתמש מוריד אפליקציה לנייד מחנות Google Play. |
GOOGLE_PLAY_IN_APP_PURCHASE |
המרות שמתרחשות כשמשתמש מבצע רכישה באפליקציה באמצעות חיוב ב-Android. |
UPLOAD_CALLS |
המרות מסוג שיחה שהמפרסם עוקב אחריהן ושהועלו. |
UPLOAD_CLICKS |
המרות שהמפרסם עוקב אחריהן והועלו עם קליקים משויכים. |
WEBPAGE |
המרות שמתרחשות בדף אינטרנט. |
WEBSITE_CALL |
המרות שמתרחשות כשמשתמש מתקשר למספר טלפון שנוצר באופן דינמי מאתר של מפרסם. |
STORE_SALES_DIRECT_UPLOAD |
המרות למכירה בחנות הפיזית על סמך העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי. רק לקוחות שנמצאים ברשימת ההיתרים יכולים להשתמש בהעלאה ישירה מסוג 'מכירות בחנות הפיזית'. |
STORE_SALES |
המרות למכירות בחנות הפיזית על סמך העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי, או מרכישות בחנות הפיזית באמצעות כרטיסים מרשתות תשלומים. רק לקוחות שנמצאים ברשימת ההיתרים יכולים להשתמש בסוגי המכירות בחנות הפיזית. לקריאה בלבד. |
FIREBASE_ANDROID_FIRST_OPEN |
המרות מסוג פתיחה ראשונה באפליקציה ל-Android נמצאות במעקב דרך Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
המרות מסוג רכישה באפליקציה ל-Android שהמעקב אחריהן מתבצע דרך Firebase. |
FIREBASE_ANDROID_CUSTOM |
מעקב אחר המרות מותאמות אישית באפליקציות ל-Android באמצעות Firebase. |
FIREBASE_IOS_FIRST_OPEN |
המרות מסוג פתיחה ראשונה באפליקציה ל-iOS נמצאות במעקב דרך Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
אפליקציה ל-iOS בהמרות מסוג רכישה באפליקציה שהמעקב אחרי ההמרות מתבצע דרך Firebase. |
FIREBASE_IOS_CUSTOM |
המעקב אחר המרות מותאמות אישית באפליקציות ל-iOS מתבצע דרך Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
המרות בפתיחת אפליקציה ל-Android שהמעקב אחריהן מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
מעקב אחר המרות מסוג רכישה באפליקציה ל-Android באמצעות ניתוח נתוני אפליקציות של צד שלישי. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
המעקב אחר המרות מותאמות אישית באפליקציות ל-Android מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
המרות מסוג 'פתיחה ראשונה באפליקציה' ל-iOS מתועדות באמצעות ניתוח נתוני אפליקציות של צד שלישי. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
המרות מסוג רכישה באפליקציה ל-iOS שהמעקב אחריהן מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי. |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
המעקב אחר המרות מותאמות אישית באפליקציות ל-iOS מתבצע באמצעות ניתוח נתוני אפליקציות של צד שלישי. |
ANDROID_APP_PRE_REGISTRATION |
המרות שמתרחשות כאשר משתמש רושם מראש אפליקציה לנייד מחנות Google Play. לקריאה בלבד. |
ANDROID_INSTALLS_ALL_OTHER_APPS |
המרות שעוקבות אחר כל ההורדות מ-Google Play שלא מתבצע אחריהן מעקב לפי סוג ספציפי לאפליקציה. לקריאה בלבד. |
FLOODLIGHT_ACTION |
פעילות ב-Floodlight שסופרת את מספר הפעמים שמשתמשים ביקרו בדף אינטרנט מסוים אחרי שהם ראו מודעה של מפרסם או לחצו עליה. לקריאה בלבד. |
FLOODLIGHT_TRANSACTION |
פעילות ב-Floodlight שעוקבת אחרי מספר המכירות או מספר הפריטים שנרכשו. יכול גם לשקף את הערך הכולל של כל מכירה. לקריאה בלבד. |
GOOGLE_HOSTED |
המרות שמשמשות למעקב אחרי פעולות מקומיות מהמוצרים ומהשירותים של Google אחרי אינטראקציה עם מודעה. לקריאה בלבד. |
LEAD_FORM_SUBMIT |
ההמרות מדווחות כשמשתמש שולח טופס להשארת פרטים. לקריאה בלבד. |
SALESFORCE |
המרות שמגיעות מ-Salesforce. לקריאה בלבד. |
SEARCH_ADS_360 |
המרות שיובאו מנתוני Floodlight ב-Search Ads 360. לקריאה בלבד. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
המרות לשיחות מתרחשות במודעות של קמפיין חכם בלי להגדיר מעקב אחר שיחות, באמצעות קריטריונים מותאמים אישית של קמפיין חכם. לקריאה בלבד. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
המשתמש לוחץ על רכיב שיחה במפות Google. קמפיינים חכמים בלבד. לקריאה בלבד. |
SMART_CAMPAIGN_MAP_DIRECTIONS |
המשתמש מבקש מסלול למיקום של עסק במפות Google. קמפיינים חכמים בלבד. לקריאה בלבד. |
SMART_CAMPAIGN_TRACKED_CALLS |
המרות לשיחות שמתרחשות במודעות של קמפיין חכם עם הגדרת מעקב אחר שיחות, באמצעות קריטריונים מותאמים אישית של קמפיין חכם. לקריאה בלבד. |
STORE_VISITS |
המרות שמתרחשות כשמשתמש מבקר בחנות קמעונאית של מפרסם. לקריאה בלבד. |
WEBPAGE_CODELESS |
המרות שנוצרו מאירועים באתר (כמו שליחות של טפסים או טעינות דפים), שלא נעשה בהן שימוש בקטעי קוד של אירועים עם קוד נפרד. לקריאה בלבד. |
UNIVERSAL_ANALYTICS_GOAL |
המרות שמגיעות ממטרות עסקיות מקושרות ב-Universal Analytics. |
UNIVERSAL_ANALYTICS_TRANSACTION |
המרות שמגיעות מעסקאות מקושרות ב-Universal Analytics. |
GOOGLE_ANALYTICS_4_CUSTOM |
המרות שמגיעות מהמרות מקושרות באירועים מותאמים אישית ב-Google Analytics 4. |
GOOGLE_ANALYTICS_4_PURCHASE |
המרות שמגיעות מהמרות מקושרות מסוג רכישה ב-Google Analytics 4. |
ConversionActionCategory
הקטגוריה של ההמרות המשויכות ל-ConversionAction.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
DEFAULT |
קטגוריית ברירת המחדל. |
PAGE_VIEW |
משתמש מבקר בדף. |
PURCHASE |
רכישה, מכירות או אירוע "ההזמנה בוצעה". |
SIGNUP |
פעולת משתמש בהרשמה. |
LEAD |
פעולה ליצירת לידים. |
DOWNLOAD |
פעולת הורדת תוכנה (למשל, אפליקציה). |
ADD_TO_CART |
הוספת פריטים לעגלת קניות או לסל קניות באתר של מפרסם. |
BEGIN_CHECKOUT |
כשמשתמש מתחיל בתהליך התשלום באתר של מפרסם. |
SUBSCRIBE_PAID |
התחלת המינוי בתשלום למוצר או לשירות. |
PHONE_CALL_LEAD |
קריאה לרמוז על עניין במוצר של מפרסם. |
IMPORTED_LEAD |
המרת ליד שיובאה ממקור חיצוני אל Google Ads. |
SUBMIT_LEAD_FORM |
שליחת טופס באתר של מפרסם שמצביע על עניין עסקי. |
BOOK_APPOINTMENT |
קביעת פגישה עם עסק של מפרסם. |
REQUEST_QUOTE |
בקשה להצעת מחיר או הערכת מחיר. |
GET_DIRECTIONS |
חיפוש מיקום העסק של המפרסם במטרה לבקר בו. |
OUTBOUND_CLICK |
קליק למעבר אל אתר של מפרסם. |
CONTACT |
שיחה, SMS, אימייל, צ'אט או יצירת קשר מסוג אחר למפרסם. |
ENGAGEMENT |
אירוע של מעורבות באתר, כמו זמן ארוך באתר או יעד חכם ב-Google Analytics (GA). מיועד לשימוש לצורך ייבוא מטרות עסקיות מ-Google Analytics, מ-Firebase ומ-GA ברמת זהב. |
STORE_VISIT |
ביקור במיקום של חנות פיזית. |
STORE_SALE |
מבצע שמתרחש בחנות פיזית. |
QUALIFIED_LEAD |
המרת ליד שיובאה ממקור חיצוני אל Google Ads, שקיבלה אישור נוסף על ידי המפרסם (צוות השיווק/המכירות). בתהליך מהליד ועד המכירה, המפרסמים מקבלים לידים, ואז פונים לצרכן כדי לפעול לפיהם. אם הצרכן מעוניין ובסופו של דבר יקנה את המוצר שלו, המפרסם מסמן לידים כאלה כ "לידים כשירים". |
CONVERTED_LEAD |
המרה מסוג ליד שיובאה ממקור חיצוני אל Google Ads, שהשלימה עוד שלב שנבחר, כפי שהוגדר על ידי המפרסם ליצירת לידים. |
ValueSettings
הגדרות שקשורות לערך של אירועי ההמרה שמשויכים לפעולת ההמרה הזו.
ייצוג JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
שדות | |
---|---|
defaultValue |
הערך שאפשר להשתמש בו כאשר אירועי המרה עבור פעולת ההמרה הזו נשלחים עם ערך לא חוקי, אסור או חסר, או כאשר פעולת ההמרה הזו מוגדרת לשימוש תמיד בערך ברירת המחדל. |
defaultCurrencyCode |
קוד המטבע לשימוש כאשר אירועי המרה עבור פעולת ההמרה הזו נשלחים עם קוד מטבע לא חוקי או חסר, או כאשר פעולת ההמרה הזו מוגדרת לשימוש תמיד בערך ברירת המחדל. |
alwaysUseDefaultValue |
המדיניות הזו קובעת אם ערך ברירת המחדל וקוד המטבע שמוגדר כברירת מחדל ישמשו במקום קוד הערך וקוד המטבע שצוינו באירועי ההמרה עבור פעולת ההמרה הזאת. |
AttributionModelSettings
הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.
ייצוג JSON |
---|
{ "attributionModel": enum ( |
שדות | |
---|---|
attributionModel |
סוג מודל השיוך (Attribution) של פעולת ההמרה הזו. |
dataDrivenModelStatus |
הסטטוס של מודל השיוך מבוסס-הנתונים של פעולת ההמרה. |
AttributionModel
מודל השיוך שמתאר איך לחלק את הקרדיט על המרה מסוימת בין אינטראקציות קודמות רבות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
EXTERNAL |
נעשה שימוש בשיוך (Attribution) חיצוני. |
GOOGLE_ADS_LAST_CLICK |
המערכת משייכת את כל הקרדיט על ההמרה לקליק האחרון שלה. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
המערכת משייכת את כל הקרדיט על ההמרה לקליק הראשון על ההמרה באמצעות שיוך (Attribution) בחיפוש Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
המערכת משייכת את הקרדיט על ההמרה באופן שווה לכל הקליקים שלה באמצעות שיוך (Attribution) בחיפוש Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
המערכת משייכת קרדיט גבוה יותר על המרה לקליקים שהתקבלו בתקופה האחרונה באמצעות שיוך בחיפוש Google (מחצית משך החיים הוא שבוע אחד). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
המערכת משייכת 40% מהקרדיט על ההמרה לקליק הראשון ולקליק האחרון שלה. 20% הנותרים יחולקו באופן שווה בין כל שאר הקליקים. נעשה שימוש בשיוך (Attribution) של חיפוש Google. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
מודל גמיש שמשתמש בלמידת מכונה כדי לקבוע את החלוקה המתאימה של הקרדיט בין קליקים, באמצעות שיוך בחיפוש Google. |
DataDrivenModelStatus
מניית סטטוסים של מודל מבוסס-נתונים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
AVAILABLE |
המודל מבוסס-הנתונים זמין. |
STALE |
המודל מבוסס-הנתונים לא פעיל. לא עודכנו 7 ימים לפחות. המידע עדיין בשימוש, אבל התוקף שלו יפוג אם הוא לא יעודכן במשך 30 יום. |
EXPIRED |
פג התוקף של המודל מבוסס-הנתונים. אמצעי התשלום לא עודכן במשך 30 יום לפחות, ולכן אי אפשר להשתמש בו. בדרך כלל הסיבה לכך היא שלא היה מספר האירועים הנדרש בתקופה של 30 הימים האחרונים. |
NEVER_GENERATED |
המודל מבוסס-הנתונים מעולם לא נוצר. בדרך כלל הסיבה לכך היא שאף פעם לא היה המספר הנדרש של אירועים בתקופה של 30 ימים. |
FloodlightSettings
הגדרות שקשורות לפעולת המרה ב-Floodlight.
ייצוג JSON |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
שדות | |
---|---|
activityGroupTag |
מחרוזת שמשמשת לזיהוי קבוצת פעילות ב-Floodlight במהלך דיווח על המרות. |
activityTag |
מחרוזת שמשמשת לזיהוי פעילות ב-Floodlight במהלך דיווח על המרות. |
activityId |
מזהה של הפעילות ב-Floodlight ב-DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
משתנה המרה מותאם אישית. מידע נוסף על מדדים ומימדים של Floodlight בממשק החדש של Search Ads 360 זמין במאמר https://support.google.com/sa360/answer/13567857
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של המשתנה המותאם אישית של ההמרה. שמות המשאבים של משתנים מותאמים אישית בהמרה הם בפורמט הבא:
|
id |
המזהה של המשתנה המותאם אישית של ההמרה. |
name |
חובה. השם של המשתנה המותאם אישית של ההמרה. השם צריך להיות ייחודי. האורך המקסימלי של השם הוא 100 תווים. אין להוסיף רווחים לפני ואחרי. |
tag |
חובה. התג של המשתנה המותאם אישית של ההמרה. התג צריך להיות ייחודי ולהכיל את התו 'u' ואחריו ישירות מספר שקטן מ-100 או שווה ל-100. לדוגמה: "u4". |
status |
הסטטוס של המשתנה המותאם אישית של ההמרה לצבירת אירועי המרה. |
ownerCustomer |
שם המשאב של הלקוח שהוא הבעלים של המשתנה המותאם אישית של ההמרה. |
family |
המשפחה של המשתנה המותאם אישית של ההמרה. |
cardinality |
העוצמה של המשתנה המותאם אישית של ההמרה. |
floodlightConversionCustomVariableInfo |
שדות של משתני המרה מותאמים אישית של Floodlight ב-Search Ads 360. |
customColumnIds[] |
המזהים של עמודות בהתאמה אישית שנעשה בהן שימוש במשתנה המותאם אישית של ההמרה. |
ConversionCustomVariableStatus
סטטוסים אפשריים של משתנה מותאם אישית של המרה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ACTIVATION_NEEDED |
המשתנה המותאם אישית של ההמרה ממתין להפעלה ולא יצבור נתונים סטטיסטיים עד שהוא יוגדר ל'מופעל'. לא ניתן להשתמש בסטטוס הזה בבקשות CREATE [יצירה] ו-UPDATE [עדכון]. |
ENABLED |
המשתנה המותאם אישית של ההמרה מופעל ויצבור נתונים סטטיסטיים. |
PAUSED |
המשתנה המותאם אישית של ההמרה מושהה ולא יצבור נתונים סטטיסטיים עד שהוא יוגדר שוב ל'מופעל'. |
ConversionCustomVariableFamily
משפחה של משתנה המרה מותאם אישית.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
STANDARD |
המשתנה המותאם אישית של ההמרה הרגילה. הלקוחות נדרשים להפעיל לפני השימוש. |
FLOODLIGHT |
משתנה ההמרה המותאם אישית שיובא ממשתנה מותאם אישית של Floodlight. |
ConversionCustomVariableCardinality
העוצמה של משתנה מותאם אישית של המרה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
BELOW_ALL_LIMITS |
העוצמה של המשתנה המותאם אישית של ההמרה נמוכה מכל המגבלות. המשתנה יכול לשמש לפילוח, והנתונים הסטטיסטיים עשויים להצטבר לערכים חדשים אם המשתנה מופעל. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
למשתנה המותאם אישית של ההמרה יש עוצמה (cardinality) שחורגת ממגבלת הפילוח, אבל אינה חורגת ממגבלת הנתונים הסטטיסטיים. הפילוח יושבת, אבל ייתכן שנתונים סטטיסטיים יצטברו לערכים חדשים אם המשתנה מופעל. |
APPROACHES_STATS_LIMIT |
המשתנה המותאם אישית של ההמרה חרג ממגבלות הפילוח, והוא מתקרב למגבלות הנתונים הסטטיסטיים (יותר מ-90%). הפילוח יושבת, אבל ייתכן שנתונים סטטיסטיים יצטברו לערכים חדשים אם המשתנה מופעל. |
EXCEEDS_STATS_LIMIT |
המשתנה המותאם אישית של ההמרה חרג ממגבלות הפילוח וגם ממגבלות הנתונים הסטטיסטיים. הפילוח יושבת, והנתונים הסטטיסטיים של משתנים פעילים יכולים להצטבר רק אם הערכים הקיימים לא יגדילו עוד יותר את העוצמה של המשתנה. |
FloodlightConversionCustomVariableInfo
מידע על משתנים מותאמים אישית של המרות Floodlight ב-Search Ads 360.
ייצוג JSON |
---|
{ "floodlightVariableType": enum ( |
שדות | |
---|---|
floodlightVariableType |
סוג המשתנה של Floodlight שמוגדר ב-Search Ads 360. |
floodlightVariableDataType |
סוג הנתונים של משתנה Floodlight שמוגדר ב-Search Ads 360. |
FloodlightVariableType
סוג המשתנה של Floodlight, כפי שמוגדר ב-Search Ads 360. מידע נוסף זמין בכתובת https://support.google.com/searchads/answer/4397154?hl=en.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
DIMENSION |
מאפיין סוג משתנה של Floodlight. |
METRIC |
סוג משתנה של מדד Floodlight. |
UNSET |
לא הוגדר סוג משתנה של Floodlight. |
FloodlightVariableDataType
סוג הנתונים של משתנה Floodlight, כפי שמוגדר ב-Search Ads 360. מידע נוסף זמין בכתובת https://support.google.com/searchads/answer/4397154?hl=en.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
NUMBER |
מייצג משתנה Floodlight מסוג "Number". אפשר להקצות את המשתנה הזה למשתני זרקור מסוג 'מאפיין' או 'METRIC'. |
STRING |
מייצג משתנה Floodlight מסוג "מחרוזת". ניתן להקצות את המשתנה הזה למשתני Floodlight מסוג 'מאפיין'. |
לקוח/ה
לקוח.
ייצוג JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
שדות | |
---|---|
resourceName |
שם המשאב של הלקוח. השמות של משאבי הלקוחות הם בפורמט הבא:
|
conversionTrackingSetting |
הגדרה של מעקב המרות ללקוח. |
accountType |
הסוג של חשבון מנוע החיפוש, למשל: Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Engine Track וכו'. |
doubleClickCampaignManagerSetting |
הגדרת DoubleClick Campaign Manager (DCM) ללקוח ניהול. |
accountStatus |
סטטוס החשבון, למשל, 'מופעל', 'מושהה', 'הוסר' וכו'. |
lastModifiedTime |
התאריך והשעה שבהם הלקוח הזה השתנה לאחרונה. התאריך והשעה מופיעים באזור הזמן של הלקוח ובפורמט "yyyy-MM-dd HH:mm:ss.sssss". |
engineId |
המזהה של החשבון בחשבון מנוע החיפוש החיצוני. |
status |
הסטטוס של הלקוח. |
creationTime |
חותמת הזמן של מועד יצירת הלקוח. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
id |
המזהה של הלקוח. |
descriptiveName |
שם תיאורי אופציונלי של הלקוח. |
currencyCode |
המטבע שבו החשבון פועל. יש תמיכה בקבוצת משנה של קודי מטבע בתקן ISO 4217. |
timeZone |
מזהה אזור הזמן המקומי של הלקוח. |
trackingUrlTemplate |
התבנית של כתובת ה-URL ליצירת כתובת URL למעקב מפרמטרים. |
finalUrlSuffix |
התבנית של כתובת ה-URL לצירוף פרמטרים לכתובת ה-URL הסופית. |
autoTaggingEnabled |
האם תיוג אוטומטי הופעל עבור הלקוח. |
manager |
האם הלקוח הוא מנהל. |
ConversionTrackingSetting
אוסף של הגדרות ברמת הלקוח שקשורות למעקב המרות ב-Search Ads 360.
ייצוג JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
שדות | |
---|---|
acceptedCustomerDataTerms |
האם הלקוח אישר את התנאים בנוגע לנתונים של לקוחות. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהמנהל. השדה הזה הוא לקריאה בלבד. מידע נוסף זמין בכתובת https://support.google.com/adspolicy/answer/7475709. |
conversionTrackingStatus |
הסטטוס של מעקב ההמרות. מציין אם הלקוח משתמש במעקב המרות, ומיהו הבעלים של מעקב ההמרות של הלקוח. אם הלקוח הזה משתמש במעקב המרות ברמת חשבון ניהול, הערך שיוחזר ישתנה בהתאם ל |
enhancedConversionsForLeadsEnabled |
האם הלקוח הביע הסכמה לשימוש בהמרות משופרות לצורך שיוך ללידים. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהמנהל. השדה הזה הוא לקריאה בלבד. |
googleAdsConversionCustomer |
שם המשאב של הלקוח שבו נוצרות ומנוהלות המרות. השדה הזה הוא לקריאה בלבד. |
conversionTrackingId |
המזהה לצורכי מעקב המרות שנעשה בו שימוש בחשבון הזה. המזהה הזה לא מציין אם הלקוח משתמש במעקב המרות (conversionTrackingStatus כן). השדה הזה הוא לקריאה בלבד. |
googleAdsCrossAccountConversionTrackingId |
המזהה לצורכי מעקב המרות של מנהל הלקוח. המצב הזה מוגדר כאשר הלקוח מפעיל מעקב המרות, והוא מבטל את conversionTrackingId. ניתן לנהל את השדה הזה רק דרך ממשק המשתמש של Google Ads. השדה הזה הוא לקריאה בלבד. |
crossAccountConversionTrackingId |
המזהה לצורכי מעקב המרות של מנהל הלקוח. המצב הזה מוגדר כאשר הלקוח מופעל במעקב המרות ברמת חשבון ניהול, והוא מבטל את conversionTrackingId. |
ConversionTrackingStatus
סטטוס מעקב ההמרות של הלקוח.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
NOT_CONVERSION_TRACKED |
הלקוח לא משתמש במעקב המרות. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
הלקוח הזה יוצר ומנוהל את פעולות ההמרה. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
כל פעולות ההמרה נוצרות ומנוהלות על ידי המנהל שצוין בlogin-customer-id של הבקשה. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
את פעולות ההמרה יוצר ומנוהל על ידי מנהל שאינו הלקוח או המנהל שצוין ב-login-customer-id של הבקשה. |
AccountType
סוגים אפשריים של חשבונות מנוע חיפוש.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
BAIDU |
חשבון Baidu. |
ENGINE_TRACK |
חשבון Engine Track. |
FACEBOOK |
חשבון Facebook. |
FACEBOOK_GATEWAY |
חשבון Facebook שמנוהל באמצעות השער. |
GOOGLE_ADS |
חשבון Google Ads. |
MICROSOFT |
חשבון Microsoft Advertising. |
SEARCH_ADS_360 |
חשבון ניהול ב-Search Ads 360. |
YAHOO_JAPAN |
Yahoo Japan. |
DoubleClickCampaignManagerSetting
הגדרת DoubleClick Campaign Manager (DCM) ללקוח ניהול.
ייצוג JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
שדות | |
---|---|
advertiserId |
המזהה של המפרסם ב-Campaign Manager המשויך ללקוח הזה. |
networkId |
המזהה של רשת Campaign Manager שמשויכת ללקוח הזה. |
timeZone |
אזור הזמן ברשת Campaign Manager שמשויכת ללקוח הזה בפורמט מסד נתונים IANA Time Zone, למשל America/New_York. |
AccountStatus
סטטוסים אפשריים של חשבון.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
ערך ברירת המחדל. |
UNKNOWN |
ערך לא ידוע. |
ENABLED |
החשבון יכול להציג מודעות. |
PAUSED |
החשבון הושבת על ידי המשתמש. |
SUSPENDED |
החשבון מושבת באמצעות תהליך פנימי. |
REMOVED |
החשבון מושבת באופן בלתי הפיך. |
DRAFT |
החשבון עדיין בתהליך הגדרה ועדיין לא מופעל. |
CustomerStatus
סטטוסים אפשריים של לקוח.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
מציין חשבון פעיל שיכול להציג מודעות. |
CANCELED |
הסמל מציין שהחשבון שבוטל לא יכול להציג מודעות. ניתנת להפעלה מחדש על ידי משתמש עם הרשאת אדמין. |
SUSPENDED |
אי אפשר להציג מודעות בחשבון מושעה. יכול להיות מופעל רק על ידי התמיכה של Google. |
CLOSED |
הסמל מציין חשבון סגור שלא יכול להציג מודעות. הסטטוס של חשבון הבדיקה יהיה גם 'סגור'. הסטטוס הוא קבוע ולא ניתן לפתוח אותו מחדש. |
CustomerAsset
קישור בין לקוח לנכס.
ייצוג JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של נכס הלקוח. שמות המשאבים של CustomerAsset בפורמט הבא:
|
asset |
חובה. הנכס שמקושר ללקוח. |
status |
הסטטוס של נכס הלקוח. |
CustomerAssetSet
CustomerAssetSet הוא הקישור בין לקוח לקבוצת נכסים. הוספה של CustomerAssetSet מקשרת קבוצת נכסים ללקוח.
ייצוג JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוצת הנכסים של הלקוח. שמות המשאבים של קבוצת הנכסים מופיעים בפורמט הבא:
|
assetSet |
קבוצת הנכסים שמקושרת ללקוח. |
customer |
הלקוח שאליו קבוצת הנכסים הזו מקושרת. |
status |
הסטטוס של קבוצת הנכסים של הלקוח. קריאה בלבד. |
AccessibleBiddingStrategy
מייצג תצוגה של שיטות בידינג בבעלות הלקוח ובשיתוף עם הלקוח.
בניגוד לשיטת הבידינג, המשאב הזה כולל אסטרטגיות בבעלות מנהלי הלקוח והמשותפים עם הלקוח הזה – בנוסף לאסטרטגיות שבבעלות הלקוח. המשאב הזה לא מספק מדדים וחושף רק קבוצת משנה מוגבלת של מאפייני שיטת הבידינג.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של שיטת הבידינג הנגישה. שמות המשאבים של AccessibleBiddingStrategy בנויים בצורה הבאה:
|
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. |
type |
הסוג של שיטת הבידינג. |
ownerCustomerId |
מספר הלקוח ששיטת הבידינג בבעלותו. |
ownerDescriptiveName |
DescriptionName (שם תיאורי) של הלקוח שבבעלותו שיטת הבידינג. |
שדה איחוד אפשר להגדיר רק ערך אחד. |
|
maximizeConversionValue |
שיטת בידינג אוטומטית שעוזרת לקבל את ערך ההמרות הגבוה ביותר בקמפיינים במסגרת התקציב. |
maximizeConversions |
שיטת בידינג אוטומטית שעוזרת לקבל כמה שיותר המרות בקמפיינים במסגרת התקציב. |
targetCpa |
שיטת בידינג שמגדירה הצעות מחיר באופן שיעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שקבעתם. |
targetImpressionShare |
שיטת בידינג שמבצעת אופטימיזציה באופן אוטומטי כדי לעזור לכם להשיג אחוז מסוים של חשיפות. |
targetRoas |
שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך הממוצע של יעד החזר על הוצאות פרסום (ROAS). |
targetSpend |
שיטת בידינג שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
MaximizeConversionValue
שיטת בידינג אוטומטית שעוזרת לקבל את ערך ההמרות הגבוה ביותר בקמפיינים במסגרת התקציב.
ייצוג JSON |
---|
{ "targetRoas": number } |
שדות | |
---|---|
targetRoas |
האפשרות של יעד החזר על הוצאות פרסום. אם היא מוגדרת, שיטת הבידינג תמקסם את ההכנסות תוך עמידה בערך הממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, ייתכן ששיטת הבידינג לא תוכל לנצל את התקציב במלואו. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הגבוה ביותר על הוצאות הפרסום במסגרת התקציב. |
MaximizeConversions
שיטת בידינג אוטומטית שעוזרת לקבל כמה שיותר המרות בקמפיינים במסגרת התקציב.
ייצוג JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
שדות | |
---|---|
targetCpa |
האפשרות של יעד עלות להמרה (CPA). זהו הסכום הממוצע שברצונך להוציא לכל רכישה. |
targetCpaMicros |
האפשרות של יעד עלות להמרה (CPA). זהו הסכום הממוצע שברצונך להוציא לכל רכישה. |
TargetCpa
זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר באופן שיעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שקבעתם.
ייצוג JSON |
---|
{ "targetCpaMicros": string } |
שדות | |
---|---|
targetCpaMicros |
יעד העלות הממוצעת להמרה. היעד הזה צריך להיות גדול מהיחידה המינימלית לחיוב או שווה לו, בהתאם למטבע שמוגדר בחשבון. |
TargetRoas
שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך הממוצע של יעד החזר על הוצאות פרסום (ROAS).
ייצוג JSON |
---|
{ "targetRoas": number } |
שדות | |
---|---|
targetRoas |
ההכנסה שנבחרה (על סמך נתוני המרות) לכל יחידת הוצאה. |
TargetSpend
'מקסימום קליקים' היא שיטת בידינג אוטומטית שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.
ייצוג JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
שדות | |
---|---|
targetSpendMicros |
יעד ההוצאות שבו יש לקבל מקסימום קליקים. מגיש הצעות מחיר מסוג TargetSpend ינסה להוציא את הסכום הקטן יותר מהערך הזה או את סכום ההוצאות הטבעי של ויסות נתונים. אם לא מגדירים תקציב, היעד ישמש כיעד להוצאות. השדה הזה הוצא משימוש ולא ניתן להשתמש בו יותר. אפשר לקרוא פרטים נוספים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
תקרת הצעות המחיר ששיטת הבידינג יכולה להגדיר. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי האסטרטגיה. |
CustomerManagerLink
מייצג את הקשר בין לקוח למנהל.
ייצוג JSON |
---|
{
"resourceName": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב. שמות המשאבים של CustomerManagerLink מופיעים בתבנית: |
status |
סטטוס הקישור בין הלקוח לחשבון הניהול. |
managerCustomer |
לקוח הניהול שמקושר ללקוח. |
managerLinkId |
המזהה של הקישור לחשבון ניהול לקוח. השדה הזה הוא לקריאה בלבד. |
ManagerLinkStatus
סטטוסים אפשריים של קישור.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ACTIVE |
מציין את הקשר האפקטיבי הנוכחי |
INACTIVE |
מציין קשר שהסתיים |
PENDING |
מצביע על כך שהמנהל ביקש לקשר, אבל הלקוח עדיין לא אישר. |
REFUSED |
המנהל ביקש ליצור קשר, אבל הלקוח סירב. |
CANCELED |
מצביע על כך שהמנהל ביקש ליצור קשר, אבל המנהל ביטל אותה. |
CustomerClient
קישור בין הלקוח הנתון ללקוח. לקוחות של לקוחות קיימים רק עבור לקוחות ניהול. כל לקוחות הלקוח הישירים והעקיפים נכללים, וכן המנהל עצמו.
ייצוג JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הלקוח של הלקוח. שמות משאבי הלקוח של הלקוח מופיעים בתבנית הבאה: |
appliedLabels[] |
שמות המשאבים של התוויות שבבעלות הלקוח המבקש שהוחלו על הלקוח. שמות המשאבים של תוויות מופיעים בצורה הבאה:
|
status |
הסטטוס של הלקוח. לקריאה בלבד. |
clientCustomer |
שם המשאב של לקוח-לקוח שמקושר ללקוח הנתון. לקריאה בלבד. |
level |
המרחק בין הלקוח הנתון ללקוח. אם אתם משתמשים בקישור עצמי, ערך הרמה יהיה 0. לקריאה בלבד. |
timeZone |
ייצוג של מחרוזת נתוני Locale Data Repository (CLDR) של אזור הזמן של הלקוח, לדוגמה, America/Los_Angeles. לקריאה בלבד. |
testAccount |
מזהה אם הלקוח הוא חשבון בדיקה. לקריאה בלבד. |
manager |
מזהה אם הלקוח הוא מנהל. לקריאה בלבד. |
descriptiveName |
שם תיאורי ללקוח. לקריאה בלבד. |
currencyCode |
קוד המטבע של הלקוח (לדוגמה, 'USD', 'EUR'). לקריאה בלבד. |
id |
המזהה של לקוח הלקוח. לקריאה בלבד. |
DynamicSearchAdsSearchTermView
תצוגת מונחי חיפוש של מודעות דינמיות לרשת החיפוש.
ייצוג JSON |
---|
{ "resourceName": string, "landingPage": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש. מודעות דינמיות לרשת החיפוש – שמות המשאבים של תצוגת מונחי החיפוש הם בצורה הבאה:
|
landingPage |
כתובת דף הנחיתה של החשיפה שנבחרה באופן דינמי. השדה הזה הוא לקריאה בלבד. |
GenderView
תצוגה מפורטת לפי מגדר. המשאב מגדרView משקף את מצב ההצגה בפועל, ולא את הקריטריונים שנוספו. קבוצת מודעות ללא קריטריונים של מגדר כברירת מחדל מוצגת לכל המגדרים, לכן כל המגדרים מופיעים ב-GenderView עם נתונים סטטיסטיים.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת המגדר. שמות המשאבים בתצוגת המגדר מופיעים בצורה הבאה:
|
GeoTargetConstant
קבוע טירגוט גיאוגרפי.
ייצוג JSON |
---|
{
"resourceName": string,
"status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קבוע היעד הגיאוגרפי. שמות משאבים קבועים של טירגוט גיאוגרפי הם בצורה הבאה:
|
status |
טירגוט גיאוגרפי קבוע. |
id |
המזהה של קבוע היעד הגיאוגרפי. |
name |
שם קבוע באנגלית של טירגוט גיאוגרפי. |
countryCode |
קוד המדינה בפורמט ISO-3166-1 alpha-2 שמשויך ליעד. |
targetType |
סוג יעד קבוע של טירגוט גיאוגרפי. |
canonicalName |
השם המלא באנגלית, הכולל את שם היעד ואת שם ההורה והמדינה שלו. |
parentGeoTarget |
שם המשאב של קבוע היעד הגיאוגרפי של ההורה. שמות משאבים קבועים של טירגוט גיאוגרפי הם בצורה הבאה:
|
GeoTargetConstantStatus
הסטטוסים האפשריים של קבוע יעד גיאוגרפי.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קבוע היעד הגיאוגרפי הוא חוקי. |
REMOVAL_PLANNED |
קבוע המיקוד הגיאוגרפי מיושן ויוסר. |
KeywordView
תצוגה מפורטת של מילת מפתח.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת מילות המפתח. שמות המשאבים בתצוגת מילות מפתח מופיעים בפורמט הבא:
|
לייבל
תווית.
ייצוג JSON |
---|
{ "resourceName": string, "status": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב. שמות המשאבים של תוויות מופיעים בצורה הבאה: |
status |
הסטטוס של התווית. לקריאה בלבד. |
textLabel |
סוג של תווית שמציגה טקסט על רקע צבעוני. |
id |
המזהה של התווית. לקריאה בלבד. |
name |
שם התווית. שדה זה הוא חובה ולא יכול להיות ריק כשיוצרים תווית חדשה. המחרוזת הזו צריכה להיות בין 1 ל-80, כולל. |
LabelStatus
סטטוסים אפשריים של תווית.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
התווית מופעלת. |
REMOVED |
התווית הוסרה. |
TextLabel
סוג של תווית שמציגה טקסט על רקע צבעוני.
ייצוג JSON |
---|
{ "backgroundColor": string, "description": string } |
שדות | |
---|---|
backgroundColor |
צבע הרקע של התווית בפורמט RGB. המחרוזת הזו חייבת להתאים לביטוי הרגולרי '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. הערה: ייתכן שצבע הרקע לא יהיה גלוי בחשבונות ניהול. |
description |
תיאור קצר של התווית. האורך לא יכול לחרוג מ-200 תווים. |
LanguageConstant
שפה.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
שדות | |
---|---|
resourceName |
שם המשאב של קבוע השפה. שמות המשאבים של קבוע השפה הם בצורה הבאה:
|
id |
המזהה של קבוע השפה. |
code |
קוד השפה, לדוגמה, "en_US" , "en_AU" , "es" , "fr" וכו'. |
name |
השם המלא של השפה באנגלית, לדוגמה, "אנגלית (ארה"ב)", "ספרדית" וכו'. |
targetable |
האם ניתן לטרגט את השפה. |
LocationView
תצוגת מיקום מסכמת את הביצועים של קמפיינים לפי קריטריון מיקום.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת המיקום. שמות המשאבים של תצוגת המיקום מופיעים בצורה הבאה:
|
ProductBiddingCategoryConstant
קטגוריה של בידינג על מוצר.
ייצוג JSON |
---|
{ "resourceName": string, "level": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של קטגוריית הבידינג למוצר. שמות המשאבים בקטגוריה 'בידינג לפי מוצר' מופיעים בפורמט הבא:
|
level |
הרמה של קטגוריית הבידינג למוצר. |
status |
הסטטוס של קטגוריית הבידינג למוצר. |
id |
המזהה של קטגוריית הבידינג על המוצר. המזהה הזה זהה למזהה של google_product_category, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436. |
countryCode |
קוד מדינה בן שתי אותיות רישיות של קטגוריית הצעת המחיר של המוצר. |
productBiddingCategoryConstantParent |
שם המשאב של קטגוריית ההורה של המוצר. |
languageCode |
קוד השפה של קטגוריית הבידינג למוצר. |
localizedName |
הצג את הערך של קטגוריית הבידינג למוצר המותאם לשוק המקומי לפי languageCode. |
ProductBiddingCategoryLevel
ערכים מספריים המתארים את הרמה של קטגוריית הצעות המחיר של המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
LEVEL1 |
רמה 1. |
LEVEL2 |
רמה 2. |
LEVEL3 |
רמה 3. |
LEVEL4 |
רמה 4. |
LEVEL5 |
רמה 5. |
ProductBiddingCategoryStatus
ערכים מספריים המתארים את הסטטוס של קטגוריית הצעות המחיר של המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ACTIVE |
הקטגוריה פעילה וניתן להשתמש בה לצורכי בידינג. |
OBSOLETE |
הקטגוריה מיושנת. משמש רק למטרות דיווח. |
ProductGroupView
תצוגה של קבוצת מוצרים.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת קבוצת המוצרים. שמות המשאבים של תצוגת קבוצת המוצרים מופיעים בצורה הבאה:
|
ShoppingPerformanceView
תצוגת ביצועים של שופינג. מספק נתונים סטטיסטיים מצטברים לגבי קמפיינים של שופינג בכמה רמות של מאפייני מוצרים. ערכים של מאפייני מוצר מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב המוצר וסוג המוצר, משקפים את המצב של כל מאפיין נכון לתאריך ולשעה שבהם האירוע המתאים תועד.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת הביצועים של שופינג. שמות המשאבים לתצוגת הביצועים של שופינג הם בפורמט הבא: |
UserList
רשימת משתמשים. זוהי רשימה של משתמשים שהלקוח עשוי לטרגט.
ייצוג JSON |
---|
{
"resourceName": string,
"type": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות משתמשים מופיעים בצורה הבאה:
|
type |
סוג הרשימה הזו. השדה הזה הוא לקריאה בלבד. |
id |
המזהה של רשימת המשתמשים. |
name |
השם של רשימת המשתמשים הזו. בהתאם ל-access_reason שלו, ייתכן ששם רשימת המשתמשים לא יהיה ייחודי (לדוגמה, אם access_reason=SHARED) |
UserListType
טיפוסים בני מנייה (enum) הכוללים סוגים אפשריים של רשימות משתמשים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
REMARKETING |
רשימת המשתמשים מיוצגת כאוסף של סוגי המרות. |
LOGICAL |
רשימת משתמשים מיוצגת כשילוב של רשימות/תחומי עניין אחרים של משתמשים. |
EXTERNAL_REMARKETING |
רשימת המשתמשים נוצרה בפלטפורמת Google Ad Manager. |
RULE_BASED |
רשימת משתמשים שמשויכת לכלל. |
SIMILAR |
רשימת משתמשים עם משתמשים שדומים למשתמשים ברשימת משתמשים אחרת. |
CRM_BASED |
רשימת משתמשים של נתונים מאינטראקציה ישירה במערכת לניהול קשרי לקוחות (CRM) שסופקו על ידי המפרסם, בצורה של אימיילים או בפורמטים אחרים. |
WebpageView
תצוגה של דף אינטרנט.
ייצוג JSON |
---|
{ "resourceName": string } |
שדות | |
---|---|
resourceName |
שם המשאב של תצוגת דף האינטרנט. שמות המשאבים של תצוגות דפי אינטרנט הם בפורמט הבא:
|
כניסה
ביקור.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של הביקור. שמות משאב של ביקורים מופיעים בתבנית הבאה:
|
id |
מזהה הביקור. |
criterionId |
מזהה מילת מפתח ב-Search Ads 360. הערך 0 מציין שמילת המפתח לא משויכת. |
merchantId |
מספר חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שעליו לחץ המשתמש. מערכת Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-Search Ads 360. |
adId |
מזהה המודעה. הערך 0 מציין שהמודעה ללא שיוך. |
clickId |
מחרוזת ייחודית לכל ביקור, שמועברת לדף הנחיתה בתור פרמטר של כתובת ה-URL של מזהה הקליק. |
visitDateTime |
חותמת הזמן של אירוע הביקור. חותמת הזמן מצוינת באזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. |
productId |
המזהה של המוצר שעליו לחץ המשתמש. |
productChannel |
ערוץ המכירות של המוצר שעליו לחץ המשתמש: 'אונליין' או 'מקומי'. |
productLanguageCode |
השפה (ISO-639-1) שהוגדרה עבור הפיד ב-Merchant Center שמכיל נתונים לגבי המוצר. |
productStoreId |
החנות במודעת המלאי של החנות המקומית שלחצו עליה. הערך הזה צריך להיות זהה למזהי החנויות שמופיעים בפיד המוצרים של החנויות המקומיות. |
productCountryCode |
המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לוחצים. |
assetId |
מזהה הנכס שאיתה הייתה אינטראקציה במהלך אירוע הביקור. |
assetFieldType |
סוג שדה הנכס של אירוע הביקור. |
ProductChannel
ערכים מספריים המתארים את הרשות המוניציפאלית של מוצר מסוים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ONLINE |
הפריט נמכר באינטרנט. |
LOCAL |
הפריט נמכר בחנויות מקומיות. |
המרה
המרה.
ייצוג JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
שדות | |
---|---|
resourceName |
שם המשאב של ההמרה. השמות של משאבי ההמרות הם בפורמט הבא:
|
id |
המזהה של ההמרה |
criterionId |
מזהה קריטריון ב-Search Ads 360. ערך של 0 מציין שאין שיוך לקריטריון. |
merchantId |
מספר חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שעליו לחץ המשתמש. מערכת Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי ב-Search Ads 360. |
adId |
מזהה המודעה. הערך 0 מציין שהמודעה ללא שיוך. |
clickId |
מחרוזת ייחודית, עבור הביקור שאליו משויכת ההמרה, מועברת לדף הנחיתה כפרמטר של כתובת אתר של מזהה קליק. |
visitId |
מזהה הביקור ב-Search Ads 360 שאליו ההמרה משויכת. |
advertiserConversionId |
כשמדובר בהמרות אופליין, זהו המזהה שמפרסמים סיפקו. אם מפרסם לא מציין מזהה כזה, מערכת Search Ads 360 יוצרת מזהה. בהמרות אונליין, הערך הזה שווה לעמודה id או לעמודה FloodlightOrderId, בהתאם להוראות לדיווח על פעילות מ-Floodlight של המפרסם. |
productId |
המזהה של המוצר שעליו לחץ המשתמש. |
productChannel |
ערוץ המכירות של המוצר שעליו לחץ המשתמש: 'אונליין' או 'מקומי'. |
productLanguageCode |
השפה (ISO-639-1) שהוגדרה עבור הפיד ב-Merchant Center שמכיל נתונים לגבי המוצר. |
productStoreId |
החנות במודעת המלאי של החנות המקומית שלחצו עליה. הערך הזה צריך להיות זהה למזהי החנויות שמופיעים בפיד המוצרים של החנויות המקומיות. |
productCountryCode |
המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לוחצים. |
attributionType |
למה ההמרה משויכת: 'ביקור' או 'מילת מפתח+מודעה'. |
conversionDateTime |
חותמת הזמן של אירוע ההמרה. |
conversionLastModifiedDateTime |
חותמת הזמן של הפעם האחרונה שבה בוצע שינוי בהמרה. |
conversionVisitDateTime |
חותמת הזמן של הביקור שאליו ההמרה משויכת. |
conversionQuantity |
כמות הפריטים שתועדה על ידי ההמרה, כפי שנקבעת באמצעות הפרמטר qty url. המפרסם אחראי לאכלוס דינמי של הפרמטר (למשל, מספר הפריטים שנמכרו בהמרה), אחרת ברירת המחדל שלו היא 1. |
conversionRevenueMicros |
ההכנסה המתואמת לאירוע ההמרה במיליוניות השנייה. הערך הזה תמיד יהיה במטבע של החשבון להצגת מודעות. |
floodlightOriginalRevenue |
ההכנסה המקורית שלא שונתה, שמשויכת לאירוע Floodlight (במטבע של הדוח הנוכחי), לפני שינויים בהוראות המטבע ב-Floodlight. |
floodlightOrderId |
מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם להמרה. |
status |
הסטטוס של ההמרה, 'מופעלת' או 'הוסרה'. |
assetId |
המזהה של הנכס שאיתה הייתה אינטראקציה במהלך אירוע ההמרה. |
assetFieldType |
סוג שדה הנכס של אירוע ההמרה. |
AttributionType
סוג השיוך (Attribution) ההמרה ב-Search Ads360
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
VISIT |
ההמרה משויכת לביקור. |
CRITERION_AD |
ההמרה משויכת לקריטריון ולצמד מודעות. |
ConversionStatus
סטטוסים אפשריים של המרה.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
ההמרה מופעלת. |
REMOVED |
ההמרה הוסרה. |
מדדים
נתוני מדדים.
ייצוג JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
שדות | |
---|---|
allConversionsValueByConversionDate |
הערך של כל ההמרות. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' הם תאריך ההמרה. פרטים לגבי העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611. |
allConversionsByConversionDate |
המספר הכולל של המרות. הייבוא הזה כולל את כל ההמרות, ללא קשר לערך של IncludeInConversionsMetric. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' הם תאריך ההמרה. פרטים לגבי העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611. |
conversionCustomMetrics[] |
המדדים המותאמים אישית של ההמרות. |
conversionsValueByConversionDate |
ערך ההמרות שניתן להגיש עליהן הצעות מחיר לפי תאריך ההמרה. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' הם תאריך ההמרה. |
conversionsByConversionDate |
סכום ההמרות לפי תאריך ההמרה לסוגי המרות שאפשר להגיש עליהם הצעות מחיר. יכולים להיות חלקיים בגלל יצירת מודלים של שיוך (Attribution). כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' הם תאריך ההמרה. |
historicalCreativeQualityScore |
ציון האיכות ההיסטורי של הקריאייטיב. |
historicalLandingPageQualityScore |
האיכות של חוויית המשתמש ההיסטורית בדף הנחיתה. |
historicalSearchPredictedCtr |
שיעור הקליקים הצפוי (CTR) ההיסטורי בחיפוש. |
interactionEventTypes[] |
סוגי האינטראקציות בתשלום והאינטראקציות בחינם. |
rawEventConversionMetrics[] |
מדדי ההמרות הגולמיים של אירועים. |
absoluteTopImpressionPercentage |
נתח החשיפות במיקום הבולט ביותר בחיפוש הוא אחוז החשיפות של המודעות לרשת החיפוש שהופיעו במיקום הבולט ביותר בחיפוש Google. |
allConversionsFromInteractionsRate |
כל ההמרות מאינטראקציות (בניגוד להמרות בעקבות צפייה) חלקי מספר האינטראקציות עם המודעה. |
allConversionsValue |
הערך של כל ההמרות. |
allConversions |
המספר הכולל של המרות. הייבוא הזה כולל את כל ההמרות, ללא קשר לערך של IncludeInConversionsMetric. |
allConversionsValuePerCost |
הערך של כל ההמרות חלקי העלות הכוללת של אינטראקציות עם מודעות (למשל, קליקים על מודעות טקסט או צפיות במודעות וידאו). |
allConversionsFromClickToCall |
מספר הפעמים שאנשים לחצו על הלחצן "שיחה" כדי להתקשר לחנות במהלך הלחיצה על המודעה או לאחר מכן. המספר הזה כולל גם שיחות שלא הועברו, ואין בחישוב של המדד הזה התייחסות למשך השיחה. המדד הזה רלוונטי רק לפריטים בפיד. |
allConversionsFromDirections |
מספר הפעמים שבהן אנשים לחצו על הלחצן 'מסלול הגעה' כדי לנווט לחנות אחרי לחיצה על מודעה. המדד הזה רלוונטי רק לפריטים בפיד. |
allConversionsFromInteractionsValuePerInteraction |
הערך של כל ההמרות מאינטראקציות חלקי המספר הכולל של אינטראקציות. |
allConversionsFromMenu |
מספר הפעמים שאנשים לחצו על קישור כדי לצפות בתפריט של החנות לאחר לחיצה על מודעה. המדד הזה רלוונטי רק לפריטים בפיד. |
allConversionsFromOrder |
מספר הפעמים שאנשים ביצעו הזמנה בחנות לאחר לחיצה על מודעה. המדד הזה רלוונטי רק לפריטים בפיד. |
allConversionsFromOtherEngagement |
מספר ההמרות האחרות (למשל, פרסום ביקורת או שמירת מיקום החנות) שאירעו לאחר שאנשים לחצו על מודעה. המדד הזה רלוונטי רק לפריטים בפיד. |
allConversionsFromStoreVisit |
מספר הפעמים המשוער שאנשים ביקרו בחנות לאחר לחיצה על מודעה. המדד הזה רלוונטי רק לפריטים בפיד. |
visits |
קליקים שתועדו ב-Search Ads 360 והועברו לדף הנחיתה של המפרסם. |
allConversionsFromStoreWebsite |
מספר הפעמים שאנשים הועברו אל כתובת URL של חנות לאחר לחיצה על מודעה. המדד הזה רלוונטי רק לפריטים בפיד. |
averageCost |
הסכום הממוצע שאתם משלמים על כל אינטראקציה. סכום זה מייצג את העלות הכוללת של המודעות לחלק למספר הכולל של האינטראקציות. |
averageCpc |
העלות הכוללת של כל הקליקים חלקי המספר הכולל של הקליקים שהתקבלו. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
averageCpm |
עלות ממוצעת לאלף חשיפות (CPM). המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clicks |
מספר הקליקים. |
contentBudgetLostImpressionShare |
האחוז המשוער של הפעמים שבהן המודעה שלך הייתה כשירה להופיע ברשת המדיה, אך לא הוצגה כי התקציב שלך היה נמוך מדי. הערה: נתח החשיפות שהוחמצו בתקציב תוכן מדווח בטווח של 0 עד 0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
contentImpressionShare |
מספר החשיפות שקיבלתם ברשת המדיה חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות ברשת התוכן מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999. |
contentRankLostImpressionShare |
האחוז המשוער של חשיפות שהמודעות שלכם לא קיבלו ברשת המדיה בגלל דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו דירוג תוכן מדווח בטווח שבין 0 ל-0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
conversionsFromInteractionsRate |
ממוצע המרות שניתן להגיש עליהן הצעות מחיר (מאינטראקציה) לכל אינטראקציה כשירה להמרה. התדירות הממוצעת שבה אינטראקציה עם מודעה מובילה להמרה שניתן להגיש עליה הצעות מחיר. |
clientAccountConversionsValue |
הערך של המרות בחשבון הלקוח. הערך הזה כולל רק פעולות המרה שבהן המאפיין IncludeInClientAccountConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה. |
conversionsValuePerCost |
הערך של המרה שניתן להגיש עליה הצעות מחיר חלקי העלות הכוללת של אינטראקציות כשירות להמרה. |
conversionsFromInteractionsValuePerInteraction |
הערך של ההמרות מאינטראקציות חלקי מספר האינטראקציות עם המודעה. הערך הזה כולל רק פעולות המרה שבהן המאפיין IncludeInConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה. |
clientAccountConversions |
מספר ההמרות בחשבון הלקוח. הערך הזה כולל רק פעולות המרה שבהן המאפיין IncludeInClientAccountConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה. |
costMicros |
סכום העלויות של העלות לקליק (CPC) והעלות לאלף חשיפות (CPM) בתקופה הזו. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
costPerAllConversions |
העלות של אינטראקציות עם המודעה חלקי כל ההמרות. |
costPerConversion |
עלות ממוצעת של המרה שעומדת בדרישות לכל המרה שניתן להגיש עליה הצעות מחיר. |
costPerCurrentModelAttributedConversion |
עלות האינטראקציות עם המודעה חלקי ההמרות המשויכות למודל הנוכחי. הערך הזה כולל רק פעולות המרה שבהן המאפיין IncludeInConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה. |
crossDeviceConversions |
המרות שהתרחשו במקרים שבהם לקוח לוחץ על מודעה במכשיר אחד, ואז משלים המרה במכשיר או בדפדפן אחר. המרות חוצות-מכשירים כבר נכללות בכל ההמרות. |
crossDeviceConversionsValue |
סכום הערך של המרות חוצות-מכשירים. |
ctr |
מספר הקליקים שהמודעה מקבלת (קליקים) חלקי מספר הפעמים שהמודעה מוצגת (חשיפות). |
conversions |
מספר ההמרות. הערך הזה כולל רק פעולות המרה שבהן המאפיין IncludeInConversionsMetric מוגדר כ-True. אם אתם משתמשים בבידינג מבוסס המרות, שיטות הבידינג יבצעו אופטימיזציה להשגת ההמרות האלה. |
conversionsValue |
סכום ערכי ההמרות של ההמרות שנכללות בשדה 'המרות'. המדד הזה מועיל רק אם הזנת ערך לפעולות ההמרה. |
historicalQualityScore |
ציון האיכות ההיסטורי. |
impressions |
ספירת התדירות שבה המודעה שלך הופיעה בדף תוצאות חיפוש או באתר ברשת Google. |
interactionRate |
התדירות שבה אנשים יוצרים אינטראקציה עם המודעה אחרי שהיא מוצגת להם. זהו מספר האינטראקציות חלקי מספר הפעמים שהמודעה שלך הוצגה. |
interactions |
מספר האינטראקציות. אינטראקציה היא הפעולה העיקרית של המשתמש המשויכת לקליקים על פורמטים של מודעה, במקרה של מודעות טקסט ושופינג, צפיות במקרה של מודעות וידאו וכן הלאה. |
invalidClickRate |
אחוז הקליקים שסוננו ממספר הקליקים הכולל (קליקים שסוננו + לא שסוננו) במהלך תקופת הדיווח. |
invalidClicks |
מספר הקליקים ש-Google מחשיבה כלא חוקיים ולא תחייב אותך בגינם. |
mobileFriendlyClicksPercentage |
אחוז הקליקים בניידים שמעבירים את המשתמשים לדף שמתאים לניידים. |
searchAbsoluteTopImpressionShare |
אחוז החשיפות של מודעות שופינג או מודעות לרשת החיפוש של הלקוח שהוצגו במיקום הבולט ביותר בקמפיין שופינג. פרטים נוספים זמינים בכתובת https://support.google.com/sa360/answer/9566729. כל ערך נמוך מ-0.1 ידווח כ-0.0999. |
searchBudgetLostAbsoluteTopImpressionShare |
המספר המשוער של התדירות שבה המודעה שלכם לא הייתה המודעה הראשונה בין המודעות המובילות בתוצאות החיפוש, עקב תקציב נמוך. הערה: נתח החשיפות במיקום הראשון שהוחמצו בתקציב לרשת החיפוש מדווח בטווח של 0 עד 0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
searchBudgetLostImpressionShare |
האחוז המשוער של הפעמים שבהן המודעה שלך הייתה כשירה להופיע ברשת החיפוש, אבל לא הוצגה כי התקציב היה נמוך מדי. הערה: נתח החשיפות שהוחמצו עקב תקציב חיפוש מדווח בטווח של 0 עד 0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
searchBudgetLostTopImpressionShare |
המספר שמוצג בהערכה של התדירות שבה המודעה שלכם לא הוצגה לצד תוצאות החיפוש האורגניות המובילות עקב תקציב נמוך. הערה: נתח החשיפות בראש הדף שהוחמצו בתקציב לרשת החיפוש מדווח בטווח של 0 עד 0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
searchClickShare |
מספר הקליקים שקיבלתם ברשת החיפוש חלקי המספר המשוער של הקליקים שהייתם יכולים לקבל. הערה: נתח הקליקים בחיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999. |
searchExactMatchImpressionShare |
מספר החשיפות שקיבלתם חלקי המספר המשוער של חשיפות שהייתם יכולים לקבל ברשת החיפוש, עבור מונחי חיפוש שתאמו בדיוק למילות המפתח שלכם (או שהיו גרסאות קרובות של מילת המפתח), בלי קשר לסוגי ההתאמה של מילות המפתח שלכם. הערה: נתח החשיפות בהתאמה מדויקת בחיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999. |
searchImpressionShare |
מספר החשיפות שקיבלתם ברשת החיפוש חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות בחיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999. |
searchRankLostAbsoluteTopImpressionShare |
המספר המשוער של התדירות שבה המודעה שלכם לא הייתה המודעה הראשונה בין המודעות המובילות בתוצאות החיפוש, עקב דירוג מודעה נמוך. הערה: נתח החשיפות במיקום הראשון שהוחמצו בדירוג חיפוש מדווח בטווח שבין 0 ל-0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
searchRankLostImpressionShare |
האחוז המשוער של החשיפות שהמודעות שלכם לא קיבלו בגלל דירוג מודעה נמוך ברשת החיפוש. הערה: נתח החשיפות שהוחמצו בדירוג חיפוש מדווח בטווח שבין 0 ל-0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
searchRankLostTopImpressionShare |
המספר שמוצג בהערכה של התדירות שבה המודעה שלכם לא הוצגה בצמוד לתוצאות החיפוש האורגניות המובילות כתוצאה מדירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו במיקום בולט בדירוג חיפוש מדווח בטווח שבין 0 ל-0.9. כל ערך גבוה מ-0.9 ידווח כ-0.9001. |
searchTopImpressionShare |
מספר החשיפות שקיבלתם בין המודעות המובילות, בהשוואה למספר המשוער של החשיפות שהייתם יכולים לקבל בין המודעות המובילות. הערה: נתח החשיפות בראש הדף בחיפוש מדווח בטווח של 0.1 עד 1. כל ערך נמוך מ-0.1 ידווח כ-0.0999. מודעות עליונות בדרך כלל מופיעות מעל התוצאות הרגילות העליונות, אבל בשאילתות חיפוש מסוימות, המודעות האלה יכולות להופיע גם מתחת להן. |
topImpressionPercentage |
אחוז החשיפות של מודעות שמוצגות לצד תוצאות החיפוש האורגניות המובילות. |
valuePerAllConversions |
הערך של כל ההמרות חלקי המספר של כל ההמרות. |
valuePerAllConversionsByConversionDate |
הערך של כל ההמרות חלקי המספר של כל ההמרות. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' הם תאריך ההמרה. פרטים לגבי העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611. |
valuePerConversion |
הערך של ההמרה שניתן להגיש עליה הצעות מחיר חלקי מספר ההמרות שניתן להגיש עליהן הצעות מחיר. מראה את השווי הממוצע של כל המרה שניתן להגיש עליה הצעות מחיר. |
valuePerConversionsByConversionDate |
ערך ההמרות שניתן להגיש עליהן הצעות מחיר לפי תאריך ההמרה חלקי מספר ההמרות שניתן להגיש עליהן הצעות מחיר לפי תאריך ההמרה. מראה את השווי הממוצע של כל המרה שניתן להגיש עליה הצעות מחיר (לפי תאריך המרה). כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודה 'תאריך' הם תאריך ההמרה. |
clientAccountViewThroughConversions |
המספר הכולל של המרות בעקבות צפייה. המרות כאלו מתרחשות כאשר לקוח רואה מודעת תמונה או מודעת מדיה עשירה, ולאחר מכן משלים המרה באתר שלך מבלי ליצור אינטראקציה עם מודעה אחרת (לדוגמה, ללחוץ על המודעה). |
clientAccountCrossSellCostOfGoodsSoldMicros |
עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) בחשבון הלקוח היא העלות הכוללת של מוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellCostOfGoodsSoldMicros |
המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellGrossProfitMicros |
המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellGrossProfitMicros |
המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellRevenueMicros |
המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' בחשבון הלקוח מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
crossSellRevenueMicros |
המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountCrossSellUnitsSold |
המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' בחשבון הלקוח מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
crossSellUnitsSold |
המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
clientAccountLeadCostOfGoodsSoldMicros |
עלות המכר בעקבות לידים בחשבון הלקוח היא העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם המודעה שאיתה הלקוח יצר אינטראקציה הציגה מוצר משויך (למידע נוסף כדאי לקרוא על מודעות שופינג), המוצר הזה נחשב למוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadCostOfGoodsSoldMicros |
המדד 'עלות המכר בעקבות לידים' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם המודעה שאיתה הלקוח יצר אינטראקציה הציגה מוצר משויך (למידע נוסף כדאי לקרוא על מודעות שופינג), המוצר הזה נחשב למוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadGrossProfitMicros |
רווח ברוטו מלידים בחשבון הלקוח הוא הרווח שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותו מוצר, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadGrossProfitMicros |
המדד 'רווח ברוטו מלידים' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadRevenueMicros |
המדד 'הכנסה מלידים בחשבון הלקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
leadRevenueMicros |
המדד 'הכנסה מלידים' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי שמוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause |
clientAccountLeadUnitsSold |
המדד 'יחידות לידים – נמכר' בחשבון הלקוח מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
leadUnitsSold |
המדד 'יחידות לידים – נמכר' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר שלכם. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
ערך
מאגר נתונים כללי.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד value . ערך. value יכול להיות רק אחד מהבאים: |
|
booleanValue |
ערך בוליאני. |
int64Value |
ו-int64. |
floatValue |
ציפה. |
doubleValue |
דאבל. |
stringValue |
מחרוזת. |
QualityScoreBucket
רשימה של הקטגוריות האפשריות של ציון האיכות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
BELOW_AVERAGE |
איכות הקריאייטיב נמוכה מהממוצע. |
AVERAGE |
איכות הקריאייטיב היא ממוצעת. |
ABOVE_AVERAGE |
איכות הקריאייטיב גבוהה מהממוצע. |
InteractionEventType
דוגמאות לאינטראקציות בחינם ובתשלום.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
CLICK |
לוחצים כדי לעבור לאתר. ברוב המקרים, האינטראקציה הזו מנווטת למיקום חיצוני, בדרך כלל לדף הנחיתה של המפרסם. זהו גם ברירת המחדל של InteractionEventType לאירועי קליק. |
ENGAGEMENT |
כוונת המשתמש המפורשת ליצור אינטראקציה עם המודעה במקום. |
VIDEO_VIEW |
משתמש צפה במודעת וידאו. |
NONE |
ברירת המחדל של InteractionEventType לאירועי המרה עם מודעה. משתמשים באפשרות הזאת כאשר שורה של המרות ממודעות לא מציינת שצריך 'לקדם' את האינטראקציות בחינם (למשל, ההמרות ממודעות) ולדווח עליהן כחלק מהמדדים העיקריים. אלה פשוט המרות אחרות (ממודעה). |
פלחים
פילוח של השדות בלבד.
ייצוג JSON |
---|
{ "adNetworkType": enum ( |
שדות | |
---|---|
adNetworkType |
סוג רשת המודעות. |
conversionActionCategory |
קטגוריית פעולת ההמרה. |
conversionCustomDimensions[] |
המאפיינים המותאמים אישית של ההמרות. |
dayOfWeek |
יום בשבוע, למשל MONDAY. |
device |
המכשיר שעליו חלים המדדים. |
keyword |
קריטריון של מילת מפתח. |
productChannel |
הערוץ של המוצר. |
productChannelExclusivity |
בלעדיות של המוצר בערוץ. |
productCondition |
מצב המוצר. |
productSoldCondition |
מצב המוצר שנמכר. |
rawEventConversionDimensions[] |
מאפייני ההמרות הגולמיים של אירועים. |
conversionAction |
שם המשאב של פעולת ההמרה. |
conversionActionName |
שם פעולת ההמרה. |
date |
התאריך שעליו חלים המדדים. פורמט yyyy-MM-dd, לדוגמה, 2018-04-17. |
month |
חודש מיוצג על ידי התאריך של היום הראשון בחודש. בפורמט yyyy-MM-dd. |
productBiddingCategoryLevel1 |
קטגוריית הבידינג (רמה 1) של המוצר. |
productBiddingCategoryLevel2 |
קטגוריית הבידינג (רמה 2) של המוצר. |
productBiddingCategoryLevel3 |
קטגוריית הבידינג (רמה 3) של המוצר. |
productBiddingCategoryLevel4 |
קטגוריית הבידינג (רמה 4) של המוצר. |
productBiddingCategoryLevel5 |
קטגוריית הבידינג (רמה 5) של המוצר. |
productBrand |
המותג של המוצר. |
productCountry |
שם המשאב של קבוע היעד הגיאוגרפי עבור מדינת המכירה של המוצר. |
productCustomAttribute0 |
מאפיין מותאם אישית 0 של המוצר. |
productCustomAttribute1 |
מאפיין מותאם אישית 1 של המוצר. |
productCustomAttribute2 |
מאפיין מותאם אישית 2 של המוצר. |
productCustomAttribute3 |
מאפיין מותאם אישית 3 של המוצר. |
productCustomAttribute4 |
מאפיין מותאם אישית 4 של המוצר. |
productItemId |
מזהה הפריט של המוצר. |
productLanguage |
שם המשאב של קבוע השפה עבור שפת המוצר. |
productSoldBiddingCategoryLevel1 |
קטגוריית הבידינג (רמה 1) של המוצר שנמכר. |
productSoldBiddingCategoryLevel2 |
קטגוריית הבידינג (רמה 2) של המוצר שנמכר. |
productSoldBiddingCategoryLevel3 |
קטגוריית הבידינג (רמה 3) של המוצר שנמכר. |
productSoldBiddingCategoryLevel4 |
קטגוריית הבידינג (רמה 4) של המוצר שנמכר. |
productSoldBiddingCategoryLevel5 |
קטגוריית הבידינג (רמה 5) של המוצר שנמכר. |
productSoldBrand |
המותג של המוצר שנמכר. |
productSoldCustomAttribute0 |
מאפיין מותאם אישית 0 של המוצר שנמכר. |
productSoldCustomAttribute1 |
מאפיין מותאם אישית 1 של המוצר שנמכר. |
productSoldCustomAttribute2 |
מאפיין מותאם אישית 2 של המוצר שנמכר. |
productSoldCustomAttribute3 |
מאפיין מותאם אישית 3 של המוצר שנמכר. |
productSoldCustomAttribute4 |
מאפיין מותאם אישית 4 של המוצר שנמכר. |
productSoldItemId |
מזהה הפריט של המוצר שנמכר. |
productSoldTitle |
שם המוצר שנמכר. |
productSoldTypeL1 |
הסוג (רמה 1) של המוצר שנמכר. |
productSoldTypeL2 |
הסוג (רמה 2) של המוצר שנמכר. |
productSoldTypeL3 |
הסוג (רמה 3) של המוצר שנמכר. |
productSoldTypeL4 |
הסוג (רמה 4) של המוצר שנמכר. |
productSoldTypeL5 |
הסוג (רמה 5) של המוצר שנמכר. |
productStoreId |
מזהה החנות של המוצר. |
productTitle |
שם המוצר. |
productTypeL1 |
סוג המוצר (רמה 1). |
productTypeL2 |
סוג המוצר (רמה 2). |
productTypeL3 |
הסוג (רמה 3) של המוצר. |
productTypeL4 |
סוג המוצר (רמה 4). |
productTypeL5 |
סוג המוצר (רמה 5). |
quarter |
רבעון מיוצג על ידי התאריך של היום הראשון של רבעון. משתמשת בשנה הקלנדרית לרבעונים. לדוגמה, הרבעון השני של 2018 מתחיל ב-1 באפריל 2018. בפורמט yyyy-MM-dd. |
week |
שבוע כפי שמוגדר בימים שני עד ראשון, ומיוצג על ידי התאריך של יום שני. בפורמט yyyy-MM-dd. |
year |
שנה, בפורמט yyyy. |
assetInteractionTarget |
בשימוש רק עם המדדים CustomerAsset, CampaignAsset ו-GroupAsset. שדה זה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת. אינטראקציות (לדוגמה, קליקים) נספרות בכל החלקים של המודעה שהוצגה (לדוגמה, המודעה עצמה ורכיבים אחרים כמו קישורי Sitelink) כשהן מוצגות יחד. כשהערך של InterThisAsset הוא TRUE, האינטראקציות הן בנכס הספציפי הזה. כאשר engagementOnThisAsset הוא FALSE, המשמעות היא שהאינטראקציות לא נכללות בנכס הספציפי הזה, אלא בחלקים אחרים של המודעה המוצגת שהנכס הזה מוצג איתה. |
AdNetworkType
פירוט של סוגי הרשתות ב-Google Ads.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
SEARCH |
חיפוש Google. |
SEARCH_PARTNERS |
שותפי חיפוש. |
CONTENT |
רשת המדיה. |
YOUTUBE_SEARCH |
חיפוש ב-YouTube. |
YOUTUBE_WATCH |
סרטונים ב-YouTube |
MIXED |
ברשת אחרת. |
מילת מפתח
פלח של קריטריון של מילת מפתח.
ייצוג JSON |
---|
{
"info": {
object ( |
שדות | |
---|---|
info |
מידע על מילת מפתח. |
adGroupCriterion |
שם המשאב של GroupCriterion. |
ProductChannelExclusivity
מספרים לציון הזמינות של מוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SINGLE_CHANNEL |
הפריט נמכר דרך ערוץ אחד בלבד, בחנויות מקומיות או באינטרנט, כפי שמצוין ב-ProductChannel שלו. |
MULTI_CHANNEL |
הפריט תואם למקביל שלו בחנות הווירטואלית או בחנויות המקומיות, מה שמצביע על כך שהוא זמין לרכישה בשני הערוצים ShoppingProductChannel. |
ProductCondition
ערכים מספריים המתארים את מצב המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
OLD |
מצב המוצר ישן. |
NEW |
מצב המוצר חדש. |
REFURBISHED |
מצב המוצר מחודש. |
USED |
צוין מצב המוצר. |
AssetInteractionTarget
פלח AssetInteractionTarget.
ייצוג JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
שדות | |
---|---|
asset |
השם של משאב הנכס. |
interactionOnThisAsset |
בשימוש רק עם המדדים CustomerAsset, CampaignAsset ו-GroupAsset. שדה זה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת. |