- ייצוג ב-JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- מודעה
- FinalAppUrl
- AppUrlOperatingSystemType
- AdType
- SyntheticContentInfo
- SyntheticContentAttestation
- SyntheticContentAttestationStatus
- SyntheticContentSource
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdEffectiveLabel
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- מכשיר
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- CustomParameter
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionEffectiveLabel
- AdGroupCriterionLabel
- AdGroupEffectiveLabel
- 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
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- AssetSetType
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignEffectiveLabel
- CampaignLabel
- CartDataSalesView
- קהל
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- לקוח
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- AccountLevelType
- 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
- UserLocationView
- WebpageView
- ביקור
- ProductChannel
- המרות
- AttributionType
- ConversionStatus
- מדדים
- ערך
- QualityScoreBucket
- InteractionEventType
- פלחים
- AdFormatType
- AdNetworkType
- מילת מפתח
- ProductChannelExclusivity
- ProductCondition
- VerticalAdsItemVerticalType
- AssetInteractionTarget
שורה שהוחזרה מהשאילתה.
| ייצוג JSON |
|---|
{ "adGroup": { object ( |
| שדות | |
|---|---|
adGroup |
קבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupAd |
המודעה שאליה מתייחסת השאילתה. |
adGroupAdEffectiveLabel |
התווית האפקטיבית של המודעה בקבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupAdLabel |
תווית המודעה בקבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupAsset |
הנכס של קבוצת המודעות שאליו מתייחסת השאילתה. |
adGroupAssetSet |
קבוצת הנכסים של קבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupAudienceView |
תצוגת הקהל של קבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupBidModifier |
התאמת הצעת המחיר שאליה מתייחסת השאילתה. |
adGroupCriterion |
הקריטריון שאליו מתייחסת השאילתה. |
adGroupCriterionEffectiveLabel |
התווית האפקטיבית של קריטריון קבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupCriterionLabel |
תווית הקריטריון של קבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupEffectiveLabel |
התווית האפקטיבית של קבוצת המודעות שאליה מתייחסת השאילתה. |
adGroupLabel |
התווית של קבוצת המודעות שאליה מתייחסת השאילתה. |
ageRangeView |
התצוגה של טווח הגילאים שאליה מתייחסת השאילתה. |
asset |
הנכס שאליו מתייחסת השאילתה. |
assetGroupAsset |
הנכס בקבוצת הנכסים שאליו מתייחסת השאילתה. |
assetGroupSignal |
האות של קבוצת הנכסים שאליו מתייחסת השאילתה. |
assetGroupListingGroupFilter |
מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים שאליו מתייחסת השאילתה. |
assetGroupTopCombinationView |
התצוגה של השילוב המוביל של קבוצת הנכסים שאליה מתייחסת השאילתה. |
assetGroup |
קבוצת הנכסים שאליה מתייחסת השאילתה. |
assetSetAsset |
קבוצת הנכסים שאליה מתייחסת השאילתה. |
assetSet |
קבוצת הנכסים שאליה מתייחסת השאילתה. |
biddingStrategy |
שיטת הבידינג שאליה מתייחסת השאילתה. |
campaignBudget |
תקציב הקמפיין שאליו מתייחסת השאילתה. |
campaign |
הקמפיין שאליו מתייחסת השאילתה. |
campaignAsset |
הנכס של הקמפיין שאליו מתייחסת השאילתה. |
campaignAssetSet |
קבוצת הנכסים של הקמפיין שאליה מתייחסת השאילתה. |
campaignAudienceView |
תצוגת הקהל של הקמפיין שאליה מתייחסת השאילתה. |
campaignCriterion |
קריטריון הקמפיין שאליו מתייחסת השאילתה. |
campaignEffectiveLabel |
התווית האפקטיבית של הקמפיין שאליה מתייחסת השאילתה. |
campaignLabel |
תווית הקמפיין שאליה מתייחסת השאילתה. |
cartDataSalesView |
תצוגת המכירות של נתוני עגלות הקניות שאליה מתייחסת השאילתה. |
audience |
הקהל שאליו מתייחסת השאילתה. |
conversionAction |
פעולת ההמרה שאליה מתייחסת השאילתה. |
conversionCustomVariable |
משתנה ההמרה המותאם אישית שאליו מתייחסת השאילתה. |
customer |
הלקוח שאליו מתייחסת השאילתה. |
customerAsset |
הנכס הדיגיטלי של הלקוח שאליו מתייחסת השאילתה. |
customerAssetSet |
קבוצת הנכסים של הלקוח שאליה מתייחסת השאילתה. |
accessibleBiddingStrategy |
שיטת הבידינג שאפשר לגשת אליה, שאליה מתייחסת השאילתה. |
customerManagerLink |
הקישור לניהול לקוחות שאליו מתייחסת השאילתה. |
customerClient |
הלקוח שאליו מתייחסת השאילתה. |
dynamicSearchAdsSearchTermView |
תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש שאליה מתייחסת השאילתה. |
genderView |
התצוגה לפי מגדר שאליה מתייחסת השאילתה. |
geoTargetConstant |
הקבוע של המיקוד הגיאוגרפי שאליו מתייחסת השאילתה. |
keywordView |
התצוגה של מילות המפתח שאליה מתייחסת השאילתה. |
label |
התווית שאליה מתייחסת השאילתה. |
languageConstant |
קבוע השפה שאליו מתייחסת השאילתה. |
locationView |
תצוגת המיקום שאליה מתייחסת השאילתה. |
productBiddingCategoryConstant |
קטגוריית הבידינג על המוצר שאליה מתייחסת השאילתה. |
productGroupView |
התצוגה של קבוצת המוצרים שאליה מתייחסת השאילתה. |
shoppingPerformanceView |
תצוגת הביצועים בשופינג שאליה מתייחסת השאילתה. |
userList |
רשימת המשתמשים שאליה מתייחסת השאילתה. |
userLocationView |
תצוגת המיקום של המשתמש שאליה מתייחסת השאילתה. |
webpageView |
התצוגה של דף האינטרנט שאליה מתייחסת השאילתה. |
visit |
הביקור ברמת האירוע שאליו מתייחסת השאילתה. |
conversion |
ההמרה ברמת האירוע שאליה מתייחסת השאילתה. |
metrics |
המדדים. |
segments |
הפלחים. |
customColumns[] |
העמודות בהתאמה אישית. |
קבוצת מודעות
קבוצת מודעות.
| ייצוג JSON |
|---|
{ "resourceName": string, "status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של קבוצת המודעות. הפורמט של שמות המשאבים של קבוצות המודעות הוא:
|
status |
הסטטוס של קבוצת המודעות. |
type |
הסוג של קבוצת המודעות. |
adRotationMode |
המצב של סבב המודעות בקבוצת המודעות. |
creationTime |
חותמת הזמן שבה נוצרה קבוצת המודעות הזו. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
targetingSetting |
הגדרה לטירגוט תכונות קשורות. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקבוצת המודעות הזו. |
effectiveLabels[] |
שמות המשאבים של תוויות יעילות שמצורפות לקבוצת המודעות הזו. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקבוצת המודעות הזו. |
engineId |
המזהה של קבוצת המודעות בחשבון החיצוני של מנוע החיפוש. השדה הזה מיועד רק לחשבונות שאינם חשבונות Google Ads, למשל Yahoo Japan, Microsoft, Baidu וכו'. לגבי ישות של Google Ads, צריך להשתמש במקום זאת ב-adGroup.id. |
startDate |
התאריך שבו קבוצת המודעות הזו מתחילה להציג מודעות. כברירת מחדל, קבוצת המודעות מתחילה לפעול עכשיו או בתאריך ההתחלה שהוגדר לה, לפי המאוחר מביניהם. אם השדה הזה מוגדר, קבוצת המודעות מתחילה לפעול בתחילת התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ו-Facebook. פורמט: YYYY-MM-DD דוגמה: 2019-03-14 |
endDate |
התאריך שבו הצגת המודעות בקבוצת המודעות מסתיימת. כברירת מחדל, קבוצת המודעות מסתיימת בתאריך הסיום של קבוצת המודעות. אם השדה הזה מוגדר, קבוצת המודעות מסתיימת בסוף התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ו-Facebook. פורמט: 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.ssssss. |
id |
המזהה של קבוצת המודעות. |
name |
השם של קבוצת המודעות. חובה למלא את השדה הזה כשיוצרים קבוצות מודעות חדשות. הוא צריך להכיל פחות מ-255 תווים ברוחב מלא בתקן UTF-8. הוא לא יכול להכיל תווי null (מיקום תו 0x0), מעבר שורה NL (מיקום תו 0xA) או חזרה לתחילת השורה (מיקום תו 0xD). |
trackingUrlTemplate |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
cpcBidMicros |
הצעת המחיר המקסימלית לקליק (CPC). השדה הזה משמש כשיטת הבידינג האפקטיבית של קבוצת המודעות היא עלות ידנית לקליק. השדה הזה לא רלוונטי ויתעלמו ממנו אם בקמפיין של קבוצת המודעות מוגדרת שיטת בידינג כוללת. |
engineStatus |
הסטטוס של קבוצת המודעות במנוע. |
finalUrlSuffix |
תבנית של כתובת URL להוספת פרמטרים לכתובת URL סופית. |
AdGroupStatus
הסטטוסים האפשריים של קבוצת מודעות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין סטטוס. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קבוצת המודעות מופעלת. |
PAUSED |
קבוצת המודעות מושהית. |
REMOVED |
קבוצת המודעות מוסרת. |
AdGroupType
רשימת enum של הסוגים האפשריים של קבוצת מודעות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין סוג. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
SEARCH_STANDARD |
סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת החיפוש. |
DISPLAY_STANDARD |
סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת המדיה. |
SHOPPING_PRODUCT_ADS |
סוג קבוצת המודעות בקמפיינים לשופינג שבהם מוצגות מודעות לפרסום מוצרים רגילות. |
HOTEL_ADS |
סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לקידום מלונות. |
SHOPPING_SMART_ADS |
הסוג של קבוצות מודעות בקמפיינים חכמים לשופינג. |
VIDEO_BUMPER |
מודעות וידאו קצרות In-stream שלא ניתן לדלג עליהן. |
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
מצבי סבב המודעות האפשריים של קבוצת מודעות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין המצב של סבב המודעות. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
OPTIMIZE |
אופטימיזציה של המודעות בקבוצת המודעות על סמך קליקים או המרות. |
ROTATE_FOREVER |
הצגה בסבב באופן שווה ללא הגבלת זמן. |
AdGroupEngineStatus
הסטטוס של מנוע קבוצת המודעות.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
סוג enum שמתאר את מאפייני הטירגוט האפשריים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
KEYWORD |
קריטריונים של מילות מפתח, לדוגמה, 'שייט למאדים'. אפשר להשתמש במילת המפתח כמאפיין מותאם אישית של הצעת מחיר. מילות מפתח הן תמיד מאפיין טירגוט, ולכן אי אפשר להגדיר אותן כמאפיין טירגוט מסוג TargetRestriction עם הערך 'ALL'. |
AUDIENCE |
קריטריונים לקהל, כולל רשימת משתמשים, תחומי עניין של משתמשים, קהלים בהתאמה אישית עם תחום עניין משותף וקהלים בהתאמה אישית עם כוונת רכישה. |
TOPIC |
קריטריונים של נושאים לטירגוט קטגוריות של תוכן, לדוגמה, 'category::Animals>Pets'. משמש לטירגוט לרשת המדיה ולווידאו. |
GENDER |
קריטריונים לטירגוט לפי מגדר. |
AGE_RANGE |
קריטריונים לטירגוט טווחי גילאים. |
PLACEMENT |
קריטריונים למיקומי מודעות, שכוללים אתרים כמו 'www.flowers4sale.com', וגם אפליקציות לנייד, קטגוריות של אפליקציות לנייד, סרטונים ב-YouTube וערוצים ב-YouTube. |
PARENTAL_STATUS |
קריטריונים לטירגוט לפי סטטוס הורה. |
INCOME_RANGE |
קריטריונים לטירגוט לפי טווח הכנסה. |
AdGroupAd
מודעה בקבוצת מודעות.
| ייצוג JSON |
|---|
{ "resourceName": string, "status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של המודעה. הפורמט של שמות משאבים של מודעות בקבוצת מודעות הוא:
|
status |
הסטטוס של המודעה. |
ad |
המודעה. |
creationTime |
חותמת הזמן שבה נוצרה המודעה הזו בקבוצת המודעות. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss. |
labels[] |
שמות המשאבים של התוויות שמצורפות למודעה בקבוצת המודעות הזו. |
effectiveLabels[] |
שמות המשאבים של התוויות האפקטיביות שמצורפות למודעה הזו. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות למודעה הזו. |
engineId |
המזהה של המודעה בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות Search Ads 360, למשל Yahoo Japan, Microsoft, Baidu וכו'. לגבי ישויות שאינן Search Ads 360, צריך להשתמש במקום זאת ב-adGroupAd.ad.id. |
engineStatus |
סטטוס נוסף של המודעה בחשבון מנוע החיפוש החיצוני. סטטוסים אפשריים (בהתאם לסוג החשבון החיצוני) כוללים את האפשרויות "פעיל", "כשיר", "בהמתנה לבדיקה" וכו'. |
lastModifiedTime |
התאריך והשעה שבהם בוצע השינוי האחרון במודעה הזו בקבוצת המודעות. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss. |
AdGroupAdStatus
אלו הסטטוסים האפשריים של AdGroupAd.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
המודעה בקבוצת המודעות מופעלת. |
PAUSED |
המודעה בקבוצת המודעות מושהית. |
REMOVED |
מודעה בקבוצת המודעות הוסרה. |
מודעה
מודעה.
| ייצוג JSON |
|---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של המודעה. שמות המשאבים של המודעות מופיעים בפורמט:
|
finalUrls[] |
רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים של המודעה. |
finalAppUrls[] |
רשימה של כתובות URL סופיות של אפליקציות שישמשו בנייד אם האפליקציה הספציפית מותקנת אצל המשתמש. |
finalMobileUrls[] |
רשימת כתובות הדפים הסופיות בנייד האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים עבור המודעה. |
type |
סוג המודעה. |
syntheticContentInfo |
מידע על תוכן סינתטי במודעה. רק מודעות עם סוגי מודעות ספציפיים עומדות בדרישות לעדכונים באמצעות השדה הערכים המותרים של |
id |
המזהה של המודעה. |
trackingUrlTemplate |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
finalUrlSuffix |
הסיומת שבה משתמשים כשיוצרים כתובת URL סופית. |
displayUrl |
כתובת ה-URL שמופיעה בתיאור המודעה בפורמטים מסוימים של מודעות. |
name |
שם המודעה. הוא משמש רק לזיהוי המודעה. השם לא צריך להיות ייחודי והוא לא משפיע על המודעה שמוצגת. |
שדה איחוד ad_data. פרטים שרלוונטיים לסוג המודעה. חובה להגדיר בדיוק ערך אחד. הערך ad_data יכול להיות רק אחד מהבאים: |
|
textAd |
פרטים שקשורים למודעת טקסט. |
expandedTextAd |
פרטים שקשורים למודעת טקסט מורחבת. מודעות טקסט מורחבות הוצאו משימוש. במקום זאת, אתם צריכים להשתמש ב- |
responsiveSearchAd |
פרטים שקשורים למודעה רספונסיבית לרשת החיפוש. |
productAd |
פרטים שקשורים למודעת מוצר. |
expandedDynamicSearchAd |
פרטים שקשורים למודעה דינמית מורחבת לרשת החיפוש. |
FinalAppUrl
כתובת URL לקישור עומק לאפליקציה עבור מערכת ההפעלה הנתונה.
| ייצוג JSON |
|---|
{
"osType": enum ( |
| שדות | |
|---|---|
osType |
מערכת ההפעלה שמטורגטת על ידי כתובת ה-URL הזו. חובה. |
url |
כתובת ה-URL של קישור העומק לאפליקציה. קישורי עומק מציינים את המיקום באפליקציה שבו נמצא התוכן שאליו רוצים להעביר את המשתמשים, והם צריכים להיות במבנה {scheme}://{host_path}. הסכמה מזהה את האפליקציה שצריך לפתוח. כשמגדירים סכמה, אפשר להשתמש בסכמה מותאמת אישית שמתחילה בשם של האפליקציה. המארח והנתיב מציינים את המיקום הייחודי באפליקציה שבו נמצא התוכן. לדוגמה: exampleapp://productid_1234. חובה. |
AppUrlOperatingSystemType
מערכת הפעלה
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
IOS |
מערכת ההפעלה Apple IOS. |
ANDROID |
מערכת ההפעלה Android. |
AdType
הסוגים האפשריים של מודעה.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
TEXT_AD |
המודעה היא מודעת טקסט. |
EXPANDED_TEXT_AD |
המדובר במודעת טקסט מורחבת. מודעות טקסט מורחבות הוצאו משימוש. |
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 |
המדובר במודעה רספונסיבית לרשת המדיה. |
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 |
מודעה לרישום מראש בקמפיין אוניברסלי לקידום אפליקציה. |
TRAVEL_AD |
מודעת קידום נסיעות. |
MULTIMEDIA_AD |
מודעת מולטימדיה. |
SyntheticContentInfo
מאגר של אישורים לגבי תוכן סינתטי ממקורות שונים, כמו המפרסם ומערכות Google.
| ייצוג JSON |
|---|
{ "advertiserAttestation": { object ( |
| שדות | |
|---|---|
advertiserAttestation |
קלט שסופק על ידי המפרסם. |
systemAttestation |
מידע על תוכן סינתטי שנוצר על ידי המערכות של Google. |
SyntheticContentAttestation
ייצוג של אישור לגבי תוכן סינתטי ממקור יחיד.
| ייצוג JSON |
|---|
{ "status": enum ( |
| שדות | |
|---|---|
status |
מציין אם המקור הזה מחשיב את התוכן כתוכן סינתטי. |
source |
המקור של אישור התוכן הסינתטי. |
SyntheticContentAttestationStatus
סטטוס האישור של תוכן סינתטי.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש רק לערכי החזרה. מייצג ערך לא ידוע בגרסה הזו. |
NOT_SYNTHETIC |
התוכן מאומת כלא סינתטי. |
IS_SYNTHETIC |
התוכן מסומן כתוכן סינתטי. |
SyntheticContentSource
המקור של הסימון של תוכן סינתטי.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש רק לערכי החזרה. מייצג ערך לא ידוע בגרסה הזו. |
ADVERTISER_ATTESTED |
אימות (attestation) שסופק על ידי המפרסם. |
GOOGLE_GENERATED_ADVERTISER_REVIEWED |
תוכן שנוצר על ידי Google ועבר בדיקה או שולבו בו נתונים של מפרסמים. |
GOOGLE_GENERATED_FULLY_AUTOMATED |
תוכן שנוצר באופן אוטומטי על ידי Google ללא בדיקה של המפרסם. |
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. מודעות טקסט מורחבות הוצאו משימוש. במקום זאת, צריך להשתמש ב-SearchAds360ResponsiveSearchAd.
| ייצוג 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 |
|---|
{ "headlines": [ { object ( |
| שדות | |
|---|---|
headlines[] |
רשימה של נכסי טקסט לכותרות. כשהמודעה תוצג, הכותרות ייבחרו מתוך הרשימה הזו. |
descriptions[] |
רשימה של נכסי טקסט לתיאורים. כשהמודעה תוצג, התיאורים ייבחרו מתוך הרשימה הזו. |
path1 |
טקסט שמצורף לכתובת ה-URL הגלויה שנוצרת באופן אוטומטי, עם תו מפריד. |
path2 |
טקסט שנוסף לנתיב1 עם תו מפריד. |
adTrackingId |
מזהה המודעה לצורכי מעקב. |
AdTextAsset
נכס טקסט שמשמש בתוך מודעה.
| ייצוג JSON |
|---|
{ "text": string } |
| שדות | |
|---|---|
text |
טקסט של נכס. |
SearchAds360ProductAdInfo
בסוג הזה אין שדות.
מודעת מוצר ב-Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
מודעה דינמית מורחבת לרשת החיפוש.
| ייצוג JSON |
|---|
{ "description1": string, "description2": string, "adTrackingId": string } |
| שדות | |
|---|---|
description1 |
השורה הראשונה בתיאור המודעה. |
description2 |
השורה השנייה של תיאור המודעה. |
adTrackingId |
מזהה המודעה לצורכי מעקב. |
AdGroupAdEngineStatus
מפרט את הסטטוסים של מודעות בקבוצות מודעות במנוע.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
הקריאייטיב הושהה כי קבוצת המודעות הושהתה. |
AdGroupAdEffectiveLabel
קשר בין מודעה בקבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות למודעה הזו בקבוצת המודעות.
| ייצוג JSON |
|---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של התווית האפקטיבית של מודעה בקבוצת מודעות. שמות המשאבים של התוויות האפקטיביות של מודעות בקבוצת מודעות הם מהצורה: |
adGroupAd |
מודעה בקבוצת מודעות שהתווית האפקטיבית מצורפת אליה. |
label |
התווית האפקטיבית שהוקצתה למודעה בקבוצת המודעות. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית. |
AdGroupAdLabel
קשר בין מודעה בקבוצת מודעות לבין תווית.
| ייצוג JSON |
|---|
{ "resourceName": string, "adGroupAd": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תווית המודעה בקבוצת המודעות. שמות המשאבים של תוויות המודעות ברמת קבוצת המודעות הם מהצורה: |
adGroupAd |
מודעה בקבוצת מודעות שהתווית מצורפת אליה. |
label |
התווית שהוקצתה למודעה בקבוצת המודעות. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית. |
AdGroupAsset
קישור בין קבוצת מודעות לבין נכס.
| ייצוג JSON |
|---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של נכס קבוצת המודעות. שמות המשאבים של AdGroupAsset הם בפורמט:
|
adGroup |
חובה. קבוצת המודעות שהנכס מקושר אליה. |
asset |
חובה. הנכס שמקושר לקבוצת המודעות. |
status |
הסטטוס של הנכס ברמת קבוצת המודעות. |
AssetLinkStatus
סוג enum שמתאר את הסטטוסים של קישור לנכס.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
התכונה 'קישור נכסים' מופעלת. |
REMOVED |
הקישור לנכס הוסר. |
PAUSED |
הקישור לנכס מושהה. |
AdGroupAssetSet
AdGroupAssetSet הוא הקישור בין קבוצת מודעות לבין קבוצת נכסים. יצירת קישורים מסוג AdGroupAssetSet מקשרת בין קבוצת נכסים לבין קבוצת מודעות.
| ייצוג JSON |
|---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של קבוצת נכסי קבוצת המודעות. שמות המשאבים של קבוצות נכסים של קבוצות מודעות הם מהצורה:
|
adGroup |
קבוצת המודעות שאליה מקושרת קבוצת הנכסים הזו. |
assetSet |
קבוצת הנכסים שמקושרת לקבוצת המודעות. |
status |
הסטטוס של קבוצת הנכסים ברמת קבוצת המודעות. קריאה בלבד. |
AssetSetLinkStatus
הסטטוסים האפשריים של הקישור בין קבוצת נכסים לבין מאגר הנכסים שלה.
| טיפוסים בני מנייה (enum) | |
|---|---|
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. כדי לבטל את ההסכמה לסוג מכשיר מסוים, משתמשים בערך 0. |
שדה איחוד חובה בפעולות יצירה החל מגרסה 5. הערך |
|
device |
קריטריון למכשיר. |
DeviceInfo
קריטריון למכשיר.
| ייצוג JSON |
|---|
{
"type": enum ( |
| שדות | |
|---|---|
type |
סוג המכשיר. |
מכשיר
הפונקציה מחזירה רשימה של מכשירים ב-Google Ads שזמינים לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
הסטטוס של הקריטריון. הסטטוס של הישות ad group criterion, שהוגדר על ידי הלקוח. הערה: דוחות ממשק המשתמש עשויים לכלול מידע נוסף שמשפיע על הזכאות של קריטריון להפעלה. במקרים מסוימים, קריטריון שהוסר ב-API עדיין יכול להופיע כקריטריון שמופעל בממשק המשתמש. לדוגמה, כברירת מחדל, הקמפיינים מוצגים למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש יוצג כל טווח גילאים כ'מופעל', כי המשתמשים בטווחים האלה עומדים בדרישות לצפייה במודעות. אבל ב-AdGroupCriterion.status יוצג הערך 'הוסר', כי לא נוסף קריטריון חיובי. |
qualityInfo |
מידע לגבי איכות הקריטריון. |
type |
סוג הקריטריון. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקריטריון הזה של קבוצת המודעות. |
effectiveLabels[] |
השמות של המשאבים של התוויות האפקטיביות שמצורפות לקריטריון הזה של קבוצת המודעות. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקריטריון הזה של קבוצת המודעות. |
positionEstimates |
הערכות לגבי הצעות מחיר לקריטריונים במיקומים שונים. |
finalUrls[] |
רשימת כתובות ה-URL הסופיות האפשריות אחרי כל ההפניות האוטומטיות בין דומיינים של המודעה. |
finalMobileUrls[] |
רשימת כתובות ה-URL הסופיות לניידים שאליהן יכולה להוביל ההפניה האוטומטית אחרי כל ההפניות האוטומטיות דרך דומיין אחר. |
urlCustomParameters[] |
רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב- |
engineId |
המזהה של קריטריון לקבוצת מודעות בחשבון החיצוני של מנוע החיפוש. השדה הזה מיועד רק לחשבונות שאינם חשבונות Google Ads, למשל Yahoo Japan, Microsoft, Baidu וכו'. לגבי ישות של Google Ads, צריך להשתמש במקום זאת ב-adGroupCriterion.criterion_id. |
lastModifiedTime |
התאריך והשעה שבהם הקריטריון הזה של קבוצת המודעות שונה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss. |
criterionId |
המזהה של הקריטריון. |
adGroup |
קבוצת המודעות שאליה משתייך הקריטריון. |
negative |
האם לטרגט ( אי אפשר לשנות את השדה הזה. כדי להפוך קריטריון מחיובי לשלילי, צריך להסיר אותו ואז להוסיף אותו מחדש. |
bidModifier |
המשנה של הצעת המחיר כשהקריטריון תואם. המשנה חייב להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשינויים. |
cpcBidMicros |
הצעת המחיר לקליק (CPC). |
effectiveCpcBidMicros |
הצעת המחיר בפועל לקליק (CPC). |
engineStatus |
הסטטוס במנוע החיפוש של קריטריון לקבוצת מודעות. |
finalUrlSuffix |
תבנית של כתובת URL להוספת פרמטרים לכתובת ה-URL הסופית. |
trackingUrlTemplate |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
שדה איחוד חובה להגדיר בדיוק אחד מהם. הערך |
|
keyword |
מילת מפתח. |
listingGroup |
קבוצה של כרטיסי מוצר. |
ageRange |
טווח גילאים. |
gender |
מגדר. |
userList |
רשימת משתמשים. |
webpage |
דף אינטרנט |
location |
מיקום. |
AdGroupCriterionStatus
הסטטוסים האפשריים של AdGroupCriterion.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הקריטריון של קבוצת המודעות מופעל. |
PAUSED |
הקריטריון של קבוצת המודעות מושהה. |
REMOVED |
הקריטריון של קבוצת המודעות הוסר. |
QualityInfo
מאגר לפרטי האיכות של קריטריון של קבוצת מודעות.
| ייצוג JSON |
|---|
{ "qualityScore": integer } |
| שדות | |
|---|---|
qualityScore |
ציון האיכות. יכול להיות שהשדה הזה לא יאוכלס אם ל-Google אין מספיק מידע כדי לקבוע ערך. |
CriterionType
סוג קריטריון אפשרי.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
מפרט את סטטוסי המנוע של קריטריון לקבוצת מודעות.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 : Criterion pending review |
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 |
הקריטריון מושהה כי החשבון מושהה. |
CustomParameter
מיפוי שאפשר להשתמש בו בתגים של פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.
| ייצוג JSON |
|---|
{ "key": string, "value": string } |
| שדות | |
|---|---|
key |
המפתח שתואם לשם התג של הפרמטר. |
value |
הערך שיוחלף. |
KeywordInfo
קריטריון של מילת מפתח.
| ייצוג JSON |
|---|
{
"matchType": enum ( |
| שדות | |
|---|---|
matchType |
סוג ההתאמה של מילת המפתח. |
text |
הטקסט של מילת המפתח (עד 80 תווים ו-10 מילים). |
KeywordMatchType
סוגי התאמה אפשריים למילות מפתח.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
EXACT |
התאמה מדויקת. |
PHRASE |
התאמה לביטוי. |
BROAD |
התאמה רחבה. |
ListingGroupInfo
קריטריון של קבוצה של כרטיסי מוצר.
| ייצוג JSON |
|---|
{
"type": enum ( |
| שדות | |
|---|---|
type |
הסוג של קבוצת כרטיסי המוצר. |
ListingGroupType
הסוג של קבוצת כרטיסי המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
SUBDIVISION |
חלוקת משנה של מוצרים לפי מאפיין כרטיס מוצר מסוים. הצמתים האלה לא משמשים להצגת רשומות של כרטיסי מוצר, אלא רק להגדרת המבנה של העץ. |
UNIT |
יחידה של קבוצה של כרטיסי מוצר שמגדירה הצעת מחיר. |
AgeRangeInfo
קריטריון של טווח גילאים.
| ייצוג JSON |
|---|
{
"type": enum ( |
| שדות | |
|---|---|
type |
סוג טווח הגילאים. |
AgeRangeType
סוג טווחי הגילאים הדמוגרפיים (לדוגמה, בין 18 ל-24).
| טיפוסים בני מנייה (enum) | |
|---|---|
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
סוג המגדר הדמוגרפי (לדוגמה, נקבה).
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
MALE |
זכר. |
FEMALE |
נקבה. |
UNDETERMINED |
מגדר לא ידוע. |
UserListInfo
קריטריון של רשימת משתמשים. מייצג רשימת משתמשים שהוגדרה על ידי המפרסם לצורך טירגוט.
| ייצוג JSON |
|---|
{ "userList": string } |
| שדות | |
|---|---|
userList |
שם המשאב של רשימת המשתמשים. |
WebpageInfo
מייצג קריטריון לטירגוט דפי אינטרנט באתר של מפרסם.
| ייצוג JSON |
|---|
{
"conditions": [
{
object ( |
| שדות | |
|---|---|
conditions[] |
תנאים, או ביטויים לוגיים, לטירגוט דפי אינטרנט. רשימת התנאים לטירגוט דפי אינטרנט מחוברת באמצעות AND כשמבצעים הערכה לצורך טירגוט. רשימה ריקה של תנאים מציינת שכל הדפים באתר של הקמפיין הם טירגוט. השדה הזה נדרש לפעולות CREATE ואסור בפעולות UPDATE. |
coveragePercentage |
אחוז הכיסוי של קריטריונים באתר. זהו אחוז הכיסוי של האתר שמחושב על סמך היעד לאתר, היעד השלילי לאתר ומילות המפתח השליליות בקבוצת המודעות ובקמפיין. לדוגמה, אם ערך הכיסוי הוא 1, המשמעות היא כיסוי של 100%. השדה הזה הוא לקריאה בלבד. |
criterionName |
שם הקריטריון שמוגדר על ידי הפרמטר הזה. ערך השם ישמש לזיהוי, למיון ולסינון של קריטריונים עם פרמטרים מהסוג הזה. השדה הזה נדרש לפעולות CREATE ואסור בפעולות UPDATE. |
WebpageConditionInfo
ביטוי לוגי לטירגוט דפי אינטרנט באתר של מפרסם.
| ייצוג JSON |
|---|
{ "operand": enum ( |
| שדות | |
|---|---|
operand |
אופרנד של תנאי טירגוט לדף אינטרנט. |
operator |
אופרטור של תנאי טירגוט לדף אינטרנט. |
argument |
ארגומנט של תנאי טירגוט לדף אינטרנט. |
WebpageConditionOperand
אופרנד התנאי של דף האינטרנט בקריטריון של דף האינטרנט.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
URL |
אופרנד שמציין תנאי טירגוט URL של דף אינטרנט. |
CATEGORY |
אופרנד שמציין תנאי טירגוט של קטגוריה של דף אינטרנט. |
PAGE_TITLE |
אופרנד שמציין תנאי טירגוט של כותרת דף אינטרנט. |
PAGE_CONTENT |
אופרנד שמציין תנאי לטירגוט לפי תוכן בדף אינטרנט. |
CUSTOM_LABEL |
אופרנד שמציין תנאי טירגוט של תווית מותאמת אישית של דף אינטרנט. |
WebpageConditionOperator
אופרטור התנאי של דף האינטרנט בקריטריון של דף האינטרנט.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
EQUALS |
התנאי של האתר שמועבר כארגומנט שווה לתנאי של האתר שמשווים אליו. |
CONTAINS |
הארגומנט web condition הוא חלק מהתנאי web condition שמשווים. |
LocationInfo
קריטריון מיקום.
| ייצוג JSON |
|---|
{ "geoTargetConstant": string } |
| שדות | |
|---|---|
geoTargetConstant |
שם המשאב של הקבוע לטירגוט גיאוגרפי. |
AdGroupCriterionEffectiveLabel
קשר בין קריטריון של קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקריטריון הזה של קבוצת המודעות.
| ייצוג JSON |
|---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של התווית האפקטיבית של קריטריון לקבוצת מודעות. שמות המשאבים של התוויות האפקטיביות של קריטריון של קבוצת מודעות הם מהצורה: |
adGroupCriterion |
הקריטריון של קבוצת המודעות שאליו מצורפת התווית האפקטיבית. |
label |
התווית האפקטיבית שהוקצתה לקריטריון של קבוצת המודעות. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית. |
AdGroupCriterionLabel
קשר בין קריטריון של קבוצת מודעות לבין תווית.
| ייצוג JSON |
|---|
{ "resourceName": string, "adGroupCriterion": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של התווית של קריטריון קבוצת המודעות. שמות המשאבים של תוויות של קריטריונים של קבוצות מודעות הם מהצורה: |
adGroupCriterion |
הקריטריון של קבוצת המודעות שאליו מצורפת התווית. |
label |
התווית שהוקצתה לקריטריון של קבוצת המודעות. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית. |
AdGroupEffectiveLabel
קשר בין קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או שהוקצתה ישירות לקבוצת המודעות הזו.
| ייצוג JSON |
|---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של התווית האפקטיבית של קבוצת המודעות. שמות המשאבים של התוויות האפקטיביות של קבוצות המודעות הם מהצורה: |
adGroup |
קבוצת המודעות שאליה מצורפת התווית האפקטיבית. |
label |
התווית האפקטיבית שהוקצתה לקבוצת המודעות. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית. |
AdGroupLabel
קשר בין קבוצת מודעות לתווית.
| ייצוג JSON |
|---|
{ "resourceName": string, "adGroup": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תווית קבוצת המודעות. שמות המשאבים של תוויות קבוצות המודעות הם מהצורה: |
adGroup |
קבוצת המודעות שאליה מצורפת התווית. |
label |
התווית שהוקצתה לקבוצת המודעות. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית. |
AgeRangeView
תצוגה של טווח גילאים.
המדד הזה מייצג את התצוגה של מדדי הביצועים של לקוח (כמו חשיפות וקליקים) שמצטברים לפי טווח גילאים. כל הנתונים הסטטיסטיים נצברים ברמת קבוצת המודעות.
הערה: אפשר לפלח מדדים לפי טווח גילאים באמצעות ageRangeView או לפי מגדר באמצעות genderView, אבל Search Ads 360 API לא תומך בפילוח מדדים לפי טווח גילאים ומגדר בו-זמנית בשאילתה אחת. אין תמיכה בניתוח הביצועים בשילוב של שני המאפיינים ב-Search Ads 360 API.
| ייצוג JSON |
|---|
{ "resourceName": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת טווח הגילאים. שמות המשאבים של תצוגת טווח הגילאים הם מהצורה:
|
נכס
נכס הוא חלק ממודעה שאפשר לשתף בכמה מודעות. יכול להיות שמדובר בתמונה (ImageAsset), בסרטון (YoutubeVideoAsset) וכו'. אי אפשר לשנות נכסים דיגיטליים או להסיר אותם. כדי להפסיק את הצגת הנכס, מסירים אותו מהישות שמשתמשת בו.
| ייצוג JSON |
|---|
{ "resourceName": string, "type": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של הנכס. שמות המשאבים של הנכסים הם מהצורה:
|
type |
סוג הנכס. |
finalUrls[] |
רשימה של כתובות URL סופיות אפשריות אחרי כל ההפניות האוטומטיות דרך דומיין אחר. |
finalMobileUrls[] |
רשימה של כתובות URL סופיות אפשריות לנייד אחרי כל ההפניות האוטומטיות בין דומיינים. |
urlCustomParameters[] |
רשימת מיפויים שתשמש להחלפת תגי פרמטרים מותאמים אישית של כתובות URL ב-trackingUrlTemplate, ב-finalUrls או ב-finalMobileUrls. |
status |
הסטטוס של הנכס. |
creationTime |
חותמת הזמן שבה נוצר הנכס הזה. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
lastModifiedTime |
התאריך והשעה שבהם הנכס הזה השתנה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss. |
syntheticContentInfo |
מידע על תוכן סינתטי בנכס. אפשר לעדכן באמצעות השדה הערכים המותרים של |
id |
מזהה הנכס. |
name |
שם אופציונלי של הנכס. |
trackingUrlTemplate |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
finalUrlSuffix |
תבנית של כתובת URL להוספת פרמטרים לכתובות של דפי נחיתה שמוצגים עם מעקב מקביל. |
engineStatus |
סטטוס המנוע של נכס. |
שדה איחוד asset_data. הסוג הספציפי של הנכס. הערך asset_data יכול להיות רק אחד מהבאים: |
|
youtubeVideoAsset |
נכס וידאו ב-YouTube. |
imageAsset |
נכס תמונות. |
textAsset |
נכס טקסט. |
calloutAsset |
נכס יתרונות מרכזיים מאוחד. |
sitelinkAsset |
נכס Sitelink מאוחד. |
pageFeedAsset |
נכס מאוחד של פיד דפי נחיתה. |
mobileAppAsset |
נכס אפליקציה לנייד. |
callAsset |
נכס התקשרות מאוחד. |
callToActionAsset |
נכס קריאה לפעולה. |
locationAsset |
נכס מיקום מאוחד. |
AssetType
סוגי הנכסים האפשריים.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
הסטטוסים האפשריים של נכס.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין סטטוס. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הנכס מופעל. |
REMOVED |
הנכס יוסר. |
ARCHIVED |
הנכס הועבר לארכיון. |
PENDING_SYSTEM_GENERATED |
הנכס נוצר על ידי המערכת וממתין לבדיקה על ידי המשתמש. |
AssetEngineStatus
סוג enum שמתאר את הסטטוסים האפשריים של מנוע הנכסים.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין סוג ה-MIME. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
IMAGE_JPEG |
סוג ה-MIME של image/jpeg. |
IMAGE_GIF |
סוג MIME של image/gif. |
IMAGE_PNG |
סוג MIME של image/png. |
FLASH |
סוג ה-MIME של application/x-shockwave-flash. |
TEXT_HTML |
סוג MIME של text/html. |
PDF |
סוג MIME של application/pdf. |
MSWORD |
סוג MIME של application/msword. |
MSEXCEL |
סוג ה-MIME של application/vnd.ms-excel. |
RTF |
סוג MIME של application/rtf. |
AUDIO_WAV |
סוג MIME של audio/wav. |
AUDIO_MP3 |
סוג MIME של audio/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
מייצג קריטריון של תזמון הצגת מודעות.
התזמון של המודעות מוגדר לפי היום בשבוע ומרווח הזמן שבו המודעות יוצגו.
אפשר להוסיף עד שש תזמונים להצגת מודעות לאותו יום.
| ייצוג 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"
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
ZERO |
אפס דקות אחרי שעה עגולה. |
FIFTEEN |
רבע שעה אחרי שעה עגולה. |
THIRTY |
30 דקות אחרי שעה עגולה. |
FORTY_FIVE |
45 דקות אחרי שעה עגולה. |
DayOfWeek
מפרט את ימי השבוע, למשל, 'יום שני'.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 תווים, כולל, וצריך להגדיר גם את description2. |
description2 |
השורה השנייה של התיאור של ה-Sitelink. אם מגדירים את השדה הזה, האורך שלו צריך להיות בין 1 ל-35 תווים, כולל, וצריך להגדיר גם את description1. |
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
סוג הספק של האפליקציה לנייד
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
APPLE_APP_STORE |
הספק של האפליקציה לנייד ב-Apple App Store. |
GOOGLE_APP_STORE |
הספק של האפליקציה לנייד בחנות האפליקציות של Google. |
UnifiedCallAsset
נכס התקשרות מאוחד.
| ייצוג JSON |
|---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
| שדות | |
|---|---|
countryCode |
קוד המדינה בן 2 האותיות של מספר הטלפון. דוגמאות: 'US', 'us'. |
phoneNumber |
מספר הטלפון של המפרסם. דוגמאות: '1234567890', '(123)456-7890' |
callConversionReportingState |
מציין אם נכס השיחה הזה צריך להשתמש בהגדרת ההמרה מסוג שיחה משלו, לפעול לפי ההגדרה ברמת החשבון או להשבית את ההמרה מסוג שיחה. |
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
סוגי הנתונים האפשריים של מצב פעולת המרה מסוג שיחה.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
DISABLED |
פעולת ההמרה מסוג שיחה מושבתת. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
פעולת המרה מסוג שיחה תשתמש בסוג ההמרה לשיחה שהוגדר ברמת החשבון. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
פעולת ההמרה מסוג שיחה תשתמש בסוג ההמרה מסוג שיחה שהוגדר ברמת המשאב (מודעות לשיחות בלבד או תוספים לשיחה). |
CallToActionAsset
נכס קריאה לפעולה.
| ייצוג JSON |
|---|
{
"callToAction": enum ( |
| שדות | |
|---|---|
callToAction |
קריאה לפעולה. |
CallToActionType
טיפוסים בני מנייה (enum) שמתארים סוגים אפשריים של קריאה לפעולה.
| טיפוסים בני מנייה (enum) | |
|---|---|
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[] |
רשימת מיקומי העסק של הלקוח. הערך הזה יוחזר רק אם נכס המיקום מסונכרן מחשבון פרופיל העסק. יכול להיות שיהיו לכם כמה כרטיסי מידע של פרופיל העסק באותו חשבון שמפנים לאותו מזהה מקום. |
locationOwnershipType |
סוג הבעלות על המיקום. אם הסוג הוא BUSINESS_OWNER, הוא יוצג כתוסף מיקום. אם הסוג הוא AFFILIATE, המיקום יוצג כמיקום של מפיץ. |
BusinessProfileLocation
נתוני המיקום מפרופיל העסק מסונכרנים מחשבון פרופיל העסק המקושר.
| ייצוג JSON |
|---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
| שדות | |
|---|---|
labels[] |
תווית שהמפרסם הגדיר למיקום בחשבון בפרופיל העסק. המידע הזה מסונכרן מחשבון פרופיל העסק. |
storeCode |
קוד החנות של המיקום הזה בפרופיל העסק. המידע הזה מסונכרן מחשבון פרופיל העסק. |
listingId |
מזהה הדף העסקי של המיקום הזה בפרופיל העסק. השם מסונכרן מחשבון 'פרופיל העסק ב-Google' המקושר. |
LocationOwnershipType
סוגי הבעלות האפשריים על מיקום.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 שמתאר את המיקומים האפשריים של נכס.
| טיפוסים בני מנייה (enum) | |
|---|---|
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. |
LONG_DESCRIPTION |
הנכס מקושר לשימוש כתיאור ארוך. |
CALL_TO_ACTION |
הנכס מקושר לשימוש כקריאה לפעולה. |
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
סוג המסנן של קבוצת כרטיסי המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
SUBDIVISION |
חלוקת משנה של מוצרים לפי כמה מאפיינים של כרטיסי מוצר. |
UNIT_INCLUDED |
צומת עלה של מסנן קבוצות של כרטיסי מוצר שנכלל. |
UNIT_EXCLUDED |
צומת עלה של מסנן קבוצות של כרטיסי מוצר שהוחרג. |
ListingGroupFilterVertical
סוג המסנן של קבוצת כרטיסי המוצר לפי קטגוריה.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
SHOPPING |
המונח מתייחס לקטגוריית הישויות 'קניות'. אפשר להשתמש בקטגוריית ישויות (vertical) רק בקמפיינים למיקסום ביצועים של מוצרי קמעונאות. |
ListingGroupFilterDimension
מאפייני כרטיסי מוצר למסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים.
| ייצוג JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד dimension. תמיד מופיע מימד מאחד מהסוגים הבאים. הערך dimension יכול להיות רק אחד מהבאים: |
|
productBiddingCategory |
קטגוריית הבידינג של מוצר. |
productBrand |
המותג של המוצר. |
productChannel |
המיקום של מוצר למכירה. |
productCondition |
מצב המוצר בהצעה. |
productCustomAttribute |
מאפיין מותאם אישית של מוצר במבצע. |
productItemId |
מזהה הפריט של מוצר במבצע. |
productType |
סוג מבצע על מוצר. |
ProductBiddingCategory
רכיב אחד של קטגוריית בידינג ברמה מסוימת. קטגוריות ברמה העליונה הן ברמה 1, קטגוריות המשנה שלהן ברמה 2 וכן הלאה. בשלב הזה אנחנו תומכים בעד 5 רמות. המשתמש צריך לציין סוג מאפיין שמציין את רמת הקטגוריה. כל המקרים של אותה חלוקת משנה חייבים להיות מאותו סוג מאפיין (רמת הקטגוריה).
| ייצוג JSON |
|---|
{
"level": enum ( |
| שדות | |
|---|---|
level |
מציין את הרמה של הקטגוריה בטקסונומיה. |
id |
המזהה של קטגוריית הבידינג על המוצר. המזהה הזה שווה למזהה של מאפיין קטגוריית המוצר ב-Google, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436 |
ListingGroupFilterBiddingCategoryLevel
הרמה של קטגוריית הבידינג של מסנן הקבוצות של כרטיסי המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
LEVEL1 |
רמה 1. |
LEVEL2 |
רמה 2. |
LEVEL3 |
רמה 3. |
LEVEL4 |
רמה 4. |
LEVEL5 |
רמה 5. |
ProductBrand
המותג של המוצר.
| ייצוג JSON |
|---|
{ "value": string } |
| שדות | |
|---|---|
value |
ערך המחרוזת של מותג המוצר. |
ProductChannel
המיקום של מוצר למכירה.
| ייצוג JSON |
|---|
{
"channel": enum ( |
| שדות | |
|---|---|
channel |
ערך המיקום. |
ListingGroupFilterProductChannel
סוג Enum שמתאר את המיקום של מוצר למכירה.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ONLINE |
הפריט הזה נמכר אונליין. |
LOCAL |
הפריט נמכר בחנויות מקומיות. |
ProductCondition
מצב המוצר בהצעה.
| ייצוג JSON |
|---|
{
"condition": enum ( |
| שדות | |
|---|---|
condition |
ערך התנאי. |
ListingGroupFilterProductCondition
סוג Enum שמתאר את מצב המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
NEW |
מצב המוצר הוא חדש. |
REFURBISHED |
מצב המוצר הוא מחודש. |
USED |
מצב המוצר הוא משומש. |
ProductCustomAttribute
מאפיין מותאם אישית של מוצר במבצע.
| ייצוג JSON |
|---|
{
"index": enum ( |
| שדות | |
|---|---|
index |
מציין את האינדקס של המאפיין המותאם אישית. |
value |
ערך המחרוזת של מאפיין מותאם אישית של המוצר. |
ListingGroupFilterCustomAttributeIndex
האינדקס של מאפייני הלקוח.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
INDEX0 |
מאפיין מותאם אישית ראשון של מסנן קבוצות של כרטיסי מוצר. |
INDEX1 |
מאפיין מותאם אישית שני של מסנן קבוצות של כרטיסי מוצר. |
INDEX2 |
מאפיין מותאם אישית שלישי של מסנן קבוצות של כרטיסי מוצר. |
INDEX3 |
מאפיין מותאם אישית רביעי של מסנן קבוצות של כרטיסי מוצר. |
INDEX4 |
המאפיין המותאם אישית החמישי של מסנן קבוצות של כרטיסי מוצר. |
ProductItemId
מזהה הפריט של מוצר במבצע.
| ייצוג JSON |
|---|
{ "value": string } |
| שדות | |
|---|---|
value |
הערך של המזהה. |
ProductType
סוג מבצע על מוצר.
| ייצוג JSON |
|---|
{
"level": enum ( |
| שדות | |
|---|---|
level |
הרמה של הסוג. |
value |
הערך של הסוג. |
ListingGroupFilterProductTypeLevel
סוג enum שמתאר את הרמה של סוג מבצע על מוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
LEVEL1 |
רמה 1. |
LEVEL2 |
רמה 2. |
LEVEL3 |
רמה 3. |
LEVEL4 |
רמה 4. |
LEVEL5 |
רמה 5. |
ListingGroupFilterDimensionPath
הנתיב להגדרת מאפיינים שמגדירים מסנן של קבוצה של כרטיסי מוצר.
| ייצוג JSON |
|---|
{
"dimensions": [
{
object ( |
| שדות | |
|---|---|
dimensions[] |
הנתיב המלא של המימדים דרך היררכיית הסינון של קבוצה של כרטיסי מוצר (לא כולל צומת הבסיס) אל מסנן קבוצה של כרטיסי מוצר זה. |
AssetGroupTopCombinationView
תצוגה של שילובי הנכסים המובילים בקבוצת הנכסים.
| ייצוג JSON |
|---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת השילובים המובילים של קבוצת הנכסים. שמות המשאבים של תצוגת השילובים המובילים של קבוצת נכסים הם מהצורה: `"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}" |
assetGroupTopCombinations[] |
השילובים המובילים של נכסים שהוצגו יחד. |
AssetGroupAssetCombinationData
נתונים על שילובים של נכסים בקבוצת נכסים
| ייצוג JSON |
|---|
{
"assetCombinationServedAssets": [
{
object ( |
| שדות | |
|---|---|
assetCombinationServedAssets[] |
נכסים שמוצגים. |
AssetUsage
מכיל את נתוני השימוש בנכס.
| ייצוג JSON |
|---|
{
"asset": string,
"servedAssetFieldType": enum ( |
| שדות | |
|---|---|
asset |
שם המשאב של הנכס. |
servedAssetFieldType |
סוג השדה של הנכס שמוצג. |
ServedAssetFieldType
סוגי השדות האפשריים של נכסים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
HEADLINE_1 |
הנכס משמש ככותרת 1. |
HEADLINE_2 |
הנכס משמש ככותרת 2. |
HEADLINE_3 |
הנכס משמש ככותרת 3. |
DESCRIPTION_1 |
הנכס משמש בתיאור 1. |
DESCRIPTION_2 |
הנכס משמש כתיאור 2. |
HEADLINE |
הנכס שימש בכותרת. משתמשים במאפיין הזה רק אם יש רק כותרת אחת במודעה. אחרת, משתמשים בערכי ה-enum HEADLINE_1, HEADLINE_2 או HEADLINE_3. |
HEADLINE_IN_PORTRAIT |
הנכס שימש ככותרת בתמונה לאורך. |
LONG_HEADLINE |
הנכס שימש בכותרת ארוכה (במודעה רספונסיבית לרשת המדיה מרובת נכסים). |
DESCRIPTION |
הנכס שימש לתיאור. השימוש במאפיין הזה מותר רק אם יש רק תיאור אחד במודעה. אחרת, משתמשים בערכי ה-enum 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 |
הנכס משמש כלוגו של העסק. |
DESCRIPTION_PREFIX |
הנכס משמש כקידומת לתיאור. |
HEADLINE_AS_SITELINK_POSITION_ONE |
נכס כותרת שמשמש כ-Sitelink במיקום 1. |
HEADLINE_AS_SITELINK_POSITION_TWO |
נכס כותרת שמשמש כ-Sitelink במיקום 2. |
DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE |
נכס של שורת תיאור שמשמש כקישור Sitelink במיקום 1. |
DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO |
נכס מסוג שורת תיאור שמשמש כקישור Sitelink במיקום 2. |
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 סופיות לניידים אחרי כל ההפניות האוטומטיות בין דומיינים. בקמפיינים למיקסום הביצועים, כתובות ה-URL כשירות להרחבה כברירת מחדל, אלא אם משביתים את האפשרות הזו. |
status |
הסטטוס של קבוצת הנכסים. |
path1 |
החלק הראשון של הטקסט שעשוי להופיע כתוספת לכתובת ה-URL שמוצגת במודעה. |
path2 |
החלק השני של הטקסט שעשוי להופיע כתוספת לכתובת ה-URL שמוצגת במודעה. אפשר להגדיר את השדה הזה רק אם השדה path1 מוגדר. |
adStrength |
חוזק המודעה הכולל של קבוצת הנכסים הזו. |
AssetGroupStatus
הסטטוסים האפשריים של קבוצת נכסים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין סטטוס. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. |
ENABLED |
קבוצת הנכסים מופעלת. |
PAUSED |
קבוצת הנכסים מושהית. |
REMOVED |
קבוצת הנכסים מוסרת. |
AdStrength
רשימת enum שמפרטת את חוזקות המודעות האפשריות.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
הסטטוסים האפשריים של נכס בקבוצת נכסים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין סטטוס. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קבוצת הנכסים מופעלת. |
REMOVED |
הנכס הוסר מקבוצת הנכסים. |
AssetSet
קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.
| ייצוג JSON |
|---|
{ "id": string, "resourceName": string } |
| שדות | |
|---|---|
id |
המזהה של קבוצת הנכסים. |
resourceName |
שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצות הנכסים הם מהצורה:
|
BiddingStrategy
שיטת בידינג.
| ייצוג JSON |
|---|
{ "resourceName": string, "status": enum ( |
| שדות | |
|---|---|
resourceName |
השם של משאב שיטת הבידינג. שמות המשאבים של שיטות הבידינג הם מהצורה:
|
status |
הסטטוס של שיטת הבידינג. השדה הזה הוא לקריאה בלבד. |
type |
הסוג של שיטת הבידינג. יוצרים שיטת בידינג על ידי הגדרת תוכנית הבידינג. השדה הזה הוא לקריאה בלבד. |
currencyCode |
המטבע שבו משתמשים בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217). בשיטות בידינג בחשבונות ניהול, אפשר להגדיר את המטבע הזה בזמן היצירה. ברירת המחדל היא המטבע של חשבון הניהול. אי אפשר להגדיר את השדה הזה כשמציגים מודעות ללקוחות. כל שיטות הבידינג בחשבון להצגת מודעות משתמשות במטבע של החשבון הזה. בכל המקרים, השדה effectiveCurrencyCode מחזיר את המטבע שבו נעשה שימוש בשיטה. |
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. לכל שיטות הבידינג בחשבון צריך להיות שם ייחודי. אורך המחרוזת הזו צריך להיות בין 1 ל-255, כולל, בבייטים של UTF-8 (אחרי חיתוך רווחים). |
effectiveCurrencyCode |
המטבע שבו משתמשים בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217). בשיטות בידינג בחשבונות לקוח ניהוליים, זהו המטבע שהמפרסם הגדיר כשנוצרה שיטת הבידינג. לצורך הצגת מודעות ללקוחות, זהו קוד המטבע של הלקוח. המדדים של שיטת הבידינג מדווחים במטבע הזה. השדה הזה הוא לקריאה בלבד. |
campaignCount |
מספר הקמפיינים שמשויכים לשיטת הבידינג הזו. השדה הזה הוא לקריאה בלבד. |
nonRemovedCampaignCount |
מספר הקמפיינים שלא הוסרו שמשויכים לשיטת הבידינג הזו. השדה הזה הוא לקריאה בלבד. |
שדה איחוד אפשר להגדיר רק אחד. הערך |
|
enhancedCpc |
שיטת בידינג שמעלה את הצעות המחיר על קליקים שיש סיכוי גבוה יותר שיובילו להמרה ומורידה את הצעות המחיר על קליקים שיש סיכוי נמוך יותר שיובילו להמרה. |
maximizeConversionValue |
שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב. |
maximizeConversions |
שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב. |
targetCpa |
שיטת בידינג שבה המערכת מגדירה הצעות מחיר במטרה להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם. |
targetImpressionShare |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית כדי להשיג אחוז מסוים של חשיפות. |
targetOutrankShare |
שיטת בידינג שמגדירה הצעות מחיר על סמך החלק היחסי של מכרזים שבהם המפרסם צריך להיות מדורג מעל מתחרה ספציפי. השדה הזה הוצא משימוש. יצירת שיטת בידינג חדשה באמצעות השדה הזה או צירוף שיטות בידינג לקמפיין באמצעות השדה הזה ייכשלו. מותר לבצע שינויים בשיטות בידינג שכבר יש בהן נתונים של התוכנית הזו. |
targetRoas |
שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד החזר על הוצאות פרסום (ROAS) שהגדרתם. |
targetSpend |
שיטת בידינג שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
BiddingStrategyStatus
הסטטוסים האפשריים של BiddingStrategy.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
שיטת הבידינג מופעלת. |
REMOVED |
שיטת הבידינג מוסרת. |
BiddingStrategyType
סוגים אפשריים של שיטות בידינג.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
COMMISSION |
עמלה היא שיטת בידינג אוטומטית שבה המפרסם משלם חלק מסוים מערך ההמרה. |
ENHANCED_CPC |
אופטימיזציית עלות לקליק (eCPC) היא שיטת בידינג שבה המערכת מעלה את הצעות המחיר על קליקים שיש סיכוי גבוה יותר שיובילו להמרה, ומורידה את הצעות המחיר על קליקים שיש סיכוי נמוך יותר שיובילו להמרה. |
INVALID |
הפרמטר הזה משמש רק לערך ההחזרה. מציין שלקמפיין לא הוגדרה שיטת בידינג. כתוצאה מכך, לא ניתן להציג מודעות מהקמפיין. לדוגמה, יכול להיות שקמפיין מסוים משויך לשיטת בידינג כוללת בחשבון ניהול, ואז חשבון הצגת המודעות מנותק מחשבון הניהול. במקרה כזה, הקמפיין ינותק אוטומטית משיטת הבידינג ברמת חשבון הניהול, שאי אפשר לגשת אליה יותר, ויעבור לסוג שיטת הבידינג INVALID. |
MANUAL_CPA |
שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שהמפרסם מציין. |
MANUAL_CPC |
בידינג ידני מבוסס-קליקים שבו המשתמש משלם על כל קליק. |
MANUAL_CPM |
הגשת הצעות מחיר ידנית על בסיס חשיפות, שבה המשתמש משלם על כל אלף חשיפות. |
MANUAL_CPV |
שיטת בידינג שבה משלמים סכום שניתן להגדרה על כל צפייה בסרטון. |
MAXIMIZE_CONVERSIONS |
שיטת בידינג שממקסמת באופן אוטומטי את מספר ההמרות במסגרת תקציב יומי. |
MAXIMIZE_CONVERSION_VALUE |
שיטת בידינג אוטומטית שמגדירה הצעות מחיר באופן אוטומטי במטרה להגדיל את ההכנסות במסגרת התקציב. |
PAGE_ONE_PROMOTED |
תוכנית לקידום הצעות מחיר בדף הראשון, שמגדירה הצעות מחיר מקסימליות לקליק במטרה להשיג חשיפות בדף הראשון או במשבצות המקודמות בדף הראשון ב-google.com. ערך ה-enum הזה הוצא משימוש. |
PERCENT_CPC |
בידינג לפי אחוז מהמחיר לקליק הוא שיטת בידינג שבה הצעות המחיר הן חלק ממחיר הפרסום של מוצר או שירות מסוימים. |
TARGET_CPA |
'יעד עלות להמרה' היא שיטת בידינג אוטומטית שבה המערכת מגדירה הצעות מחיר במטרה להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם. |
TARGET_CPM |
יעד עלות לאלף חשיפות היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר חשיפות במסגרת יעד העלות לאלף חשיפות (CPM) שהגדרתם. |
TARGET_IMPRESSION_SHARE |
שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של מודעות לרשת החיפוש יוצגו בראש הדף הראשון (או במיקום אחר שמטרגטים). |
TARGET_OUTRANK_SHARE |
שיטת הבידינג 'מיקוד לפי נתח הובלה בדירוג' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר על סמך היעד של חלק המכירות הפומביות שבהן המפרסם צריך לעקוף מתחרה ספציפי. ערך ה-enum הזה הוצא משימוש. |
TARGET_ROAS |
יעד החזר על הוצאות פרסום (ROAS) היא שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך שמירה על יעד ספציפי של החזר ממוצע על הוצאות הפרסום. |
TARGET_SPEND |
'יעד הוצאות' היא שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
EnhancedCpc
בסוג הזה אין שדות.
שיטת בידינג אוטומטית שמגדילה את הצעות המחיר על קליקים שיש סבירות גבוהה יותר שיובילו להמרה, ומקטינה את הצעות המחיר על קליקים שיש סבירות נמוכה יותר שיובילו להמרה.
שיטת הבידינג הזו הוצאה משימוש ואי אפשר ליצור אותה יותר. כדי לקבל פונקציונליות שוות ערך, צריך להשתמש בשיטת הבידינג ManualCpc עם הערך true של המאפיין enhancedCpcEnabled.
MaximizeConversionValue
שיטת בידינג אוטומטית שעוזרת להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים במסגרת התקציב.
| ייצוג JSON |
|---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
| שדות | |
|---|---|
cpcBidCeilingMicros |
תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. אפשר לשנות רק שיטות בידינג כוללות. |
cpcBidFloorMicros |
הסף המינימלי להצעות המחיר שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. אפשר לשנות רק שיטות בידינג כוללות. |
targetRoas |
האפשרות 'יעד החזר על הוצאות פרסום'. אם מגדירים יעד החזר על הוצאות פרסום, שיטת הבידינג תמקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל לנצל את כל התקציב. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הכי גבוה על הוצאות הפרסום במסגרת התקציב. |
MaximizeConversions
שיטת בידינג אוטומטית שעוזרת לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.
| ייצוג JSON |
|---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
| שדות | |
|---|---|
cpcBidCeilingMicros |
תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. אפשר לשנות רק שיטות בידינג כוללות. |
cpcBidFloorMicros |
הסף המינימלי להצעות המחיר שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. אפשר לשנות רק שיטות בידינג כוללות. |
targetCpaMicros |
האפשרות 'יעד עלות להמרה'. זהו הסכום הממוצע שאתם רוצים להוציא על כל פעולת המרה שצוינה במיקרו-יחידות של המטבע שמוגדר בשיטת הבידינג. אם תגדירו יעד עלות להמרה, שיטת הבידינג תנסה להשיג כמה שיותר המרות בלי לחרוג מיעד העלות להמרה. אם לא מגדירים יעד עלות להמרה, שיטת הבידינג תנסה להשיג את העלות הכי נמוכה להמרה במסגרת התקציב. |
TargetCpa
זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
| ייצוג JSON |
|---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
| שדות | |
|---|---|
targetCpaMicros |
יעד עלות ממוצעת להמרה. היעד הזה צריך להיות גדול מהיחידה המינימלית לחיוב או שווה לה, בהתאם למטבע שמוגדר בחשבון. |
cpcBidCeilingMicros |
תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. ההגדרה הזו צריכה להיות מוגדרת רק לשיטות בידינג כוללות. |
cpcBidFloorMicros |
הסף המינימלי להצעות המחיר שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. ההגדרה הזו צריכה להיות מוגדרת רק לשיטות בידינג כוללות. |
TargetRoas
שיטת בידינג אוטומטית שעוזרת למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד החזר על הוצאות פרסום (ROAS) שהגדרתם.
| ייצוג JSON |
|---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
| שדות | |
|---|---|
targetRoas |
חובה. ההכנסה שנבחרה (על סמך נתוני ההמרות) לכל יחידת הוצאה. הערך צריך להיות בין 0.01 ל-1,000.0, כולל. |
cpcBidCeilingMicros |
תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. ההגדרה הזו צריכה להיות מוגדרת רק לשיטות בידינג כוללות. |
cpcBidFloorMicros |
הסף המינימלי להצעות המחיר שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. ההגדרה הזו צריכה להיות מוגדרת רק לשיטות בידינג כוללות. |
TargetSpend
שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.
| ייצוג JSON |
|---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
| שדות | |
|---|---|
targetSpendMicros |
הוצאה משימוש: יעד ההוצאות שרוצים להשיג מקסימום קליקים במסגרתו. מגיש הצעות מחיר לפי יעד הוצאות ינסה להוציא את הסכום הנמוך מבין שני הערכים האלה: הערך הזה או סכום ההוצאות שמוגבל באופן טבעי. אם לא מציינים יעד הוצאות, המערכת משתמשת בתקציב כהוצאה היעד. השדה הזה הוצא משימוש ואין להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpcBidCeilingMicros |
תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי שיטת הבידינג. |
CampaignBudget
תקציב הקמפיין.
| ייצוג JSON |
|---|
{ "resourceName": string, "deliveryMethod": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של תקציב הקמפיין. שמות המשאבים של תקציבי הקמפיינים הם מהצורה:
|
deliveryMethod |
שיטת הצגת המודעות שקובעת את קצב ניצול התקציב של הקמפיין. אם לא מציינים ערך בפעולת יצירה, ברירת המחדל היא STANDARD. |
period |
התקופה שבמהלכה התקציב ינוצל. אם לא מציינים ערך, ברירת המחדל היא DAILY. |
amountMicros |
הסכום היומי הממוצע שהקמפיין יוציא. השדה הזה משמש כשהתקציב של הקמפיין הסכום מצוין במיליוניות במטבע המקומי של החשבון. מיליון מיקרו שווה ליחידת מטבע אחת. ההוצאה החודשית בפועל מוגבלת לסכום היומי הזה כפול 30.4. השדה הזה בלעדי לשדה totalAmountMicros. צריך להגדיר רק אחד מהמאפיינים amountMicros או totalAmountMicros. |
BudgetDeliveryMethod
שיטות אפשריות להצגת מודעות לפי תקציב.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
STANDARD |
שרת התקציב יגביל את הצגת המודעות באופן שווה לאורך כל תקופת הזמן. |
ACCELERATED |
שרת התקציב לא יגביל את הצגת המודעות, והמודעות יוצגו במהירות האפשרית. |
BudgetPeriod
תקופה אפשרית של תקציב.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
ההגדרה של טירגוט גיאוגרפי של מודעות. |
effectiveLabels[] |
שמות המשאבים של תוויות אפקטיביות שמצורפות לקמפיין הזה. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות לקמפיין הזה. |
labels[] |
שמות המשאבים של התוויות שמצורפות לקמפיין הזה. |
biddingStrategyType |
הסוג של שיטת הבידינג. אפשר ליצור שיטת בידינג על ידי הגדרת תוכנית הבידינג ליצירת שיטת בידינג רגילה, או על ידי הגדרת השדה השדה הזה הוא לקריאה בלבד. |
accessibleBiddingStrategy |
שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים הלא מוגבלים של שיטת הבידינג הכוללת המצורפת, שמזוהה על ידי 'biddingStrategy'. הערך ריק אם הקמפיין לא משתמש בשיטה משותפת. מאפיינים של אסטרטגיה ללא הגבלות זמינים לכל הלקוחות שאיתם משתפים את האסטרטגיה, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח הבעלים של האסטרטגיה ולמנהלים שלו. אפשר לקרוא מאפיינים מוגבלים רק מהמשאב BiddingStrategy. |
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. במקומו, צריך להשתמש ב-creationTime. |
creationTime |
חותמת הזמן שבה הקמפיין הזה נוצר. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
lastModifiedTime |
התאריך והשעה שבהם הקמפיין הזה השתנה לאחרונה. התאריך והשעה הם באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss.ssssss. |
feedTypes[] |
סוגי הפידים שמצורפים ישירות לקמפיין הזה. |
id |
מזהה הקמפיין. |
name |
השם של מסע הפרסום. חובה למלא את השדה הזה כשיוצרים קמפיינים חדשים. הוא לא יכול להכיל תווי null (מיקום תו 0x0), מעבר שורה NL (מיקום תו 0xA) או חזרה לתחילת השורה (מיקום תו 0xD). |
trackingUrlTemplate |
תבנית של כתובת URL ליצירת כתובת URL למעקב. |
campaignBudget |
שם המשאב של תקציב הקמפיין. |
startDate |
התאריך שבו הקמפיין התחיל להציג מודעות באזור הזמן של הלקוח, בפורמט YYYY-MM-DD. |
endDate |
היום האחרון של הקמפיין באזור הזמן של הלקוח שמציג את המודעות, בפורמט YYYY-MM-DD. בזמן היצירה, ברירת המחדל היא 2037-12-30, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעול ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-2037-12-30. |
finalUrlSuffix |
סיומת שמשמשת לצירוף פרמטרים של שאילתה לדפי נחיתה שמוצגים עם מעקב מקביל. |
urlExpansionOptOut |
הערך true מציין שהמשתמש ביטל את ההסכמה להרחבת כתובות ה-URL לכתובות URL ממוקדות יותר. אם ההסכמה בוטלה (true), המערכת תטרגט רק את כתובות ה-URL הסופיות בקבוצת הנכסים או את כתובות ה-URL שצוינו בפידים של פרטי העסק או ב-Google Merchant Center של המפרסם. אם בוחרים באפשרות הזו (false), הטירגוט יתבצע לדומיין כולו. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום ביצועים, שבהם ערך ברירת המחדל הוא false. |
שדה איחוד השיטה צריכה להיות שיטת בידינג כוללת (שנוצרה באמצעות השירות BiddingStrategy) או שיטה רגילה שמוטמעת בקמפיין. הערך |
|
biddingStrategy |
שם המשאב של שיטת הבידינג הכוללת שבה נעשה שימוש בקמפיין. |
manualCpa |
שיטת בידינג רגילה של בידינג לפי עלות המרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שהמפרסם מציין. התמיכה זמינה רק לקמפיינים של Google בעלי מקצוע. |
manualCpc |
שיטת בידינג רגילה של בידינג ידני לפי עלות לקליק. בידינג ידני מבוסס-קליקים שבו המשתמש משלם על כל קליק. |
manualCpm |
שיטת בידינג רגילה של עלות ידנית לאלף חשיפות. הגשת הצעות מחיר ידנית על בסיס חשיפות, שבה המשתמש משלם על כל אלף חשיפות. |
maximizeConversions |
שיטת בידינג רגילה לפי מקסימום המרות, שבה המערכת מגדירה הצעות מחיר באופן אוטומטי כדי להשיג כמה שיותר המרות במסגרת התקציב. |
maximizeConversionValue |
אסטרטגיית בידינג רגילה לפי מקסימום ערך המרות, שמגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות במסגרת התקציב. |
targetCpa |
שיטת בידינג רגילה לפי יעד עלות להמרה (CPA), שבה המערכת מגדירה הצעות מחיר באופן אוטומטי כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה שהגדרתם. |
targetImpressionShare |
בידינג לפי יעד נתח חשיפות שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי להשיג אחוז חשיפות נבחר. |
targetRoas |
שיטת בידינג לפי יעד החזר על הוצאות הפרסום (ROAS) שממקסמת באופן אוטומטי את ההכנסות תוך שמירה על יעד ספציפי של החזר על הוצאות פרסום (ROAS). |
targetSpend |
שיטת בידינג רגילה לפי יעד הוצאות שמגדירה באופן אוטומטי את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב. |
percentCpc |
שיטת בידינג רגילה לפי אחוז מהעלות לקליק, שבה הצעות המחיר הן חלק קטן מהמחיר המפורסם של מוצר או שירות מסוימים. |
targetCpm |
שיטת בידינג שמבצעת אופטימיזציה אוטומטית של העלות לאלף חשיפות. |
CampaignStatus
הסטטוסים האפשריים של קמפיין.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
הקמפיין פעיל והמודעות שכלולות בו יכולות להופיע. |
PAUSED |
הקמפיין הושהה על ידי המשתמש. |
REMOVED |
הקמפיין הוסר. |
CampaignServingStatus
סטטוסי הצגה אפשריים של קמפיין.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
SERVING |
הצגת מודעות. |
NONE |
ללא. |
ENDED |
הסתיים. |
PENDING |
בהמתנה. |
SUSPENDED |
המשחק הושעה. |
BiddingStrategySystemStatus
הסטטוסים האפשריים של שיטת בידינג במערכת.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
אין מעקב המרות (לא מוצגים פינגים) ו/או רשימות רימרקטינג בקמפיין שופינג חכם. |
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 שמתאר את סטטוסי ההצגה האפשריים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
OPTIMIZE |
הצגת המודעות עוברת אופטימיזציה על סמך שיעור הקליקים (CTR) בקמפיין. |
CONVERSION_OPTIMIZE |
האופטימיזציה של הצגת המודעות מתבצעת על סמך שיעור הקליקים (CTR) * ההמרה בקמפיין. אם הקמפיין לא מוגדר לשיטת הבידינג 'אופטימיזציית המרות', ברירת המחדל תהיה OPTIMIZED. |
ROTATE |
המערכת תציג את המודעות בצורה שווה במשך 90 יום, ואז תבצע אופטימיזציה לקליקים. |
ROTATE_INDEFINITELY |
הצגת מודעות עם ביצועים נמוכים יותר בפריסה שווה יותר עם מודעות עם ביצועים גבוהים יותר, ללא אופטימיזציה. |
UNAVAILABLE |
סטטוס האופטימיזציה של הצגת המודעות לא זמין. |
AdvertisingChannelType
סוג enum שמתאר את הסוגים השונים של ערוצי פרסום.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
SEARCH |
רשת החיפוש. כולל קמפיינים לרשת המדיה בחבילה וקמפיינים לרשת החיפוש ולרשת המדיה. |
DISPLAY |
רשת המדיה של Google בלבד. |
SHOPPING |
מודעות בקמפיינים של שופינג מוצגות בנכס שופינג ובתוצאות החיפוש ב-google.com. |
HOTEL |
קמפיינים של מודעות להזמנת חדרים. |
VIDEO |
קמפיינים של מודעות וידאו. |
MULTI_CHANNEL |
קמפיינים לקידום אפליקציות וקמפיינים לעידוד השימוש באפליקציות שפועלים בכמה ערוצים. |
LOCAL |
קמפיינים של מודעות מקומיות. |
SMART |
קמפיינים חכמים. |
PERFORMANCE_MAX |
קמפיינים למיקסום ביצועים. |
LOCAL_SERVICES |
קמפיינים לקידום עסקים מקומיים. |
DISCOVERY |
קמפיינים מסוג Discovery. |
TRAVEL |
קמפיינים ל-Google נסיעות. |
SOCIAL |
קמפיינים ברשתות חברתיות. |
AdvertisingChannelSubType
סוג enum שמתאר את סוגי המשנה השונים של הערוצים.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
קמפיינים לקידום פעילויות בענף התיירות והאירוח. |
SOCIAL_FACEBOOK_TRACKING_ONLY |
מעקב בפייסבוק מתבצע רק בקמפיינים ברשתות החברתיות. |
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. כדי לעשות זאת, צריך להשתמש בהגדרה |
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 |
תווית הפיד של המוצרים שרוצים לכלול בקמפיין. תוויות פיד תקינות יכולות להכיל עד 20 תווים, כולל אותיות רישיות, מספרים, מקפים וקווים תחתונים. אם השתמשתם בעבר בפורמט המופסק |
useVehicleInventory |
האם לטרגט מלאי של מודעות למכירת רכבים. |
merchantId |
מספר החשבון ב-Merchant Center. חובה למלא את השדה הזה כשיוצרים פעולות. השדה הזה הוא קבוע בקמפיינים של שופינג. |
salesCountry |
מדינת המכירה של המוצרים שרוצים לכלול בקמפיין. |
campaignPriority |
העדיפות של הקמפיין. לקמפיינים עם עדיפות גבוהה יותר (מספר נמוך יותר) יש עדיפות על פני קמפיינים עם עדיפות נמוכה יותר. השדה הזה נדרש לקמפיינים של שופינג, והערכים האפשריים בו הם בין 0 ל-2, כולל. השדה הזה הוא אופציונלי בקמפיינים חכמים לשופינג, אבל אם מגדירים אותו, הערך שלו חייב להיות 3. |
enableLocal |
האם לכלול מוצרים בחנויות מקומיות. |
GeoTargetTypeSetting
מייצג אוסף של הגדרות שקשורות לטירגוט גיאוגרפי של מודעות.
| ייצוג JSON |
|---|
{ "positiveGeoTargetType": enum ( |
| שדות | |
|---|---|
positiveGeoTargetType |
ההגדרה שמשמשת לטירגוט גיאוגרפי חיובי בקמפיין הספציפי הזה. |
negativeGeoTargetType |
ההגדרה שמשמשת לטירגוט גיאוגרפי שלילי בקמפיין הספציפי הזה. |
PositiveGeoTargetType
סוגי המיקומים הגיאוגרפיים החיוביים לטירגוט.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
PRESENCE_OR_INTEREST |
הגדרה שמציינת שהמודעה מופעלת אם המשתמש נמצא במיקומים המטורגטים של המפרסם או מביע בהם עניין. |
SEARCH_INTEREST |
התג הזה מציין שמודעה מופעלת אם המשתמש מחפש מיקומים מטורגטים של המפרסם. אפשר להשתמש בשיטה הזו רק בקמפיינים לרשת החיפוש ובקמפיינים רגילים לשופינג. |
PRESENCE |
הגדרה שמציינת שמודעה תופעל אם המשתמש נמצא במיקומים הגיאוגרפיים לטירגוט שהמפרסם הגדיר, או שהוא מבקר בהם באופן קבוע. |
NegativeGeoTargetType
סוגי הטירגוט הגיאוגרפי השלילי האפשריים.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
סוג יעד האופטימיזציה
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
המאפיין הזה משמש רק כערך החזרה. מייצג ערך לא ידוע בגרסה הזו. |
CALL_CLICKS |
אופטימיזציה לקבלת יותר קליקים על לחצן ההתקשרות. המרות מקליק לשיחה מייצגות את מספר הפעמים שאנשים בחרו באפשרות 'שיחה' כדי ליצור קשר עם חנות אחרי צפייה במודעה. |
DRIVING_DIRECTIONS |
אופטימיזציה לקבלת מסלול נסיעה. המרות מסוג 'מסלול הגעה' הן מספר הפעמים שאנשים בחרו באפשרות 'קבלת מסלול' כדי לנווט לחנות אחרי צפייה במודעה. |
APP_PRE_REGISTRATION |
אופטימיזציה לרישום מראש. המרות של רישום מראש הן מספר ההרשמות מראש לקבלת התראה כשהאפליקציה תושק. |
TrackingSetting
הגדרות ברמת הקמפיין למעקב אחר מידע.
| ייצוג JSON |
|---|
{ "trackingUrl": string } |
| שדות | |
|---|---|
trackingUrl |
כתובת ה-URL שמשמשת למעקב דינמי. |
AssetSetType
סוגים אפשריים של קבוצת נכסים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
PAGE_FEED |
קבוצת נכסים של דפים. |
DYNAMIC_EDUCATION |
קבוצת נכסים דינמיים לפרסום שקשור ללימודים. |
MERCHANT_CENTER_FEED |
קבוצת נכסים ב-Google Merchant Center. |
DYNAMIC_REAL_ESTATE |
קבוצת נכסים דינמיים של נדל"ן. |
DYNAMIC_CUSTOM |
קבוצת נכסים דינמיים בהתאמה אישית. |
DYNAMIC_HOTELS_AND_RENTALS |
קבוצת נכסים דינמיים של מלונות ויחידות נופש להשכרה. |
DYNAMIC_FLIGHTS |
קבוצת נכסים דינמיים של טיסות. |
DYNAMIC_TRAVEL |
קבוצת נכסים דינמיים של נתוני נסיעות. |
DYNAMIC_LOCAL |
קבוצת נכסים מקומיים דינמיים. |
DYNAMIC_JOBS |
קבוצת נכסים דינמיים של משרות. |
LOCATION_SYNC |
קבוצת נכסי מיקום ברמת סנכרון המיקום. |
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP |
קבוצת נכסים של קבוצה לפי מיקום בפרופיל העסק. |
CHAIN_DYNAMIC_LOCATION_GROUP |
קבוצת נכסים של מיקומי סניפים של רשת, שאפשר להשתמש בה גם למיקומים בבעלות וגם למיקומי מפיצים. |
STATIC_LOCATION_GROUP |
קבוצה סטטית של נכסי מיקום שאפשר להשתמש בה גם למיקומים בבעלות וגם למיקומים של מפיצים. |
HOTEL_PROPERTY |
קבוצת נכסים של מלונות, שמשמשת לקישור פיד של מלונות לקמפיינים למיקסום הביצועים לענף התיירות והאירוח. |
TRAVEL_FEED |
סוג קבוצת נכסים בפיד נסיעות. יכול לייצג פיד של בתי מלון או פיד של דברים שאפשר לעשות. |
ManualCpa
בסוג הזה אין שדות.
שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שהמפרסם מציין.
ManualCpc
בידינג ידני מבוסס-קליקים שבו המשתמש משלם על כל קליק.
| ייצוג JSON |
|---|
{ "enhancedCpcEnabled": boolean } |
| שדות | |
|---|---|
enhancedCpcEnabled |
האם לשפר את הצעות המחיר על סמך נתונים של כלי אופטימיזציית ההמרות. |
ManualCpm
בסוג הזה אין שדות.
הגשת הצעות מחיר ידנית על בסיס חשיפות, שבה המשתמש משלם על כל אלף חשיפות.
PercentCpc
שיטת בידינג שבה הצעות המחיר הן חלק קטן מהמחיר המפורסם של מוצר או שירות מסוים.
| ייצוג JSON |
|---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
| שדות | |
|---|---|
cpcBidCeilingMicros |
תקרת הצעות המחיר שניתן להגדיר בשיטת הבידינג. זהו שדה אופציונלי שהמפרסם מזין ומצוין במיקרו-מודעות מקומיות. הערה: ערך אפס מתפרש באותו אופן כמו ערך לא מוגדר של bid_ceiling. |
enhancedCpcEnabled |
השיטה מגדילה או מקטינה את הצעת המחיר בכל מכרז, בהתאם לסבירות להמרה. הצעות מחיר ספציפיות עשויות להיות גבוהות מהערך של cpcBidCeilingMicros, אבל סכום הצעת המחיר הממוצע לקמפיין לא אמור להיות גבוה ממנו. |
TargetCpm
בסוג הזה אין שדות.
יעד עלות לאלף חשיפות (tCPM) היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לבצע אופטימיזציה של הביצועים בהתאם ליעד העלות לאלף חשיפות שהגדרתם.
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.ssssss. |
criterionId |
המזהה של הקריטריון. המערכת מתעלמת מהשדה הזה במהלך שינוי. |
bidModifier |
המשנה של הצעות המחיר כשהקריטריון תואם. המשנה חייב להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשינויים. כדי לבטל את ההסכמה לסוג מכשיר מסוים, משתמשים בערך 0. |
negative |
האם לטרגט ( |
שדה איחוד חובה להגדיר בדיוק אחד מהם. הערך |
|
keyword |
מילת מפתח. |
location |
מיקום. |
device |
מכשיר. |
ageRange |
טווח גילאים. |
gender |
מגדר. |
userList |
רשימת משתמשים. |
language |
שפה. |
webpage |
דף אינטרנט. |
locationGroup |
קבוצה לפי מיקום |
CampaignCriterionStatus
הסטטוסים האפשריים של CampaignCriterion.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הקריטריון של הקמפיין מופעל. |
PAUSED |
קריטריון הקמפיין מושהה. |
REMOVED |
קריטריון הקמפיין מוסר. |
LanguageInfo
קריטריון שפה.
| ייצוג JSON |
|---|
{ "languageConstant": string } |
| שדות | |
|---|---|
languageConstant |
שם המשאב של קבוע השפה. |
LocationGroupInfo
רדיוס סביב רשימת מיקומים שצוינו באמצעות פיד.
| ייצוג JSON |
|---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
| שדות | |
|---|---|
geoTargetConstants[] |
קבועים של טירגוט גיאוגרפי שמגבילים את היקף האזור הגיאוגרפי בפיד. בשלב הזה, אפשר להשתמש רק בקבוע אחד של מיקום גיאוגרפי לטירגוט. |
radiusUnits |
יחידת הרדיוס. מיילים ומטרים נתמכים בקבועים של מיקוד גיאוגרפי. יש תמיכה במיילים ובמטרים בפריטים של פידים. השדה הזה נדרש וצריך להגדיר אותו בפעולות CREATE. |
feedItemSets[] |
קבוצות של פריטים בפיד שהפריטים שלהן מטורגטים. אם מציינים כמה מזהים, המערכת מטרגטת את כל הפריטים שמופיעים לפחות באחת מהקבוצות. אי אפשר להשתמש בשדה הזה עם geoTargetConstants. השדה הזה הוא אופציונלי ואפשר להגדיר אותו רק בפעולות CREATE. |
radius |
המרחק ביחידות שמציינות את הרדיוס סביב המיקומים הגיאוגרפיים המטורגטים. השדה הזה נדרש וצריך להגדיר אותו בפעולות CREATE. |
LocationGroupRadiusUnits
יחידת המרחק של הרדיוס בקבוצה לפי מיקום (לדוגמה, מיילים)
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
METERS |
מטרים |
MILES |
מיילים |
MILLI_MILES |
מיילים |
CampaignEffectiveLabel
מייצג קשר בין קמפיין לבין תווית יעילה. תווית אפקטיבית היא תווית שעברה בירושה או שהוקצתה ישירות לקמפיין הזה.
| ייצוג JSON |
|---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב. שמות המשאבים של CampaignEffectivelabel הם מהצורה: |
campaign |
הקמפיין שאליו מצורפת התווית הפעילה. |
label |
התווית האפקטיבית שהוקצתה לקמפיין. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית האפקטיבית. |
CampaignLabel
מייצג קשר בין קמפיין לתווית.
| ייצוג JSON |
|---|
{ "resourceName": string, "campaign": string, "label": string, "ownerCustomerId": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב. שמות המשאבים של תוויות הקמפיינים הם מהצורה: |
campaign |
הקמפיין שאליו התווית מצורפת. |
label |
התווית שהוקצתה לקמפיין. |
ownerCustomerId |
המזהה של הלקוח שהוא הבעלים של התווית. |
CartDataSalesView
תצוגת מכירות לפי נתוני עגלות קניות.
אם מטמיעים את התכונה 'המרות עם נתונים מעגלות קניות', המערכת מספקת מידע על המוצרים שנרכשו. מדדי ביצועים כמו הכנסות, רווח ברוטו, מדדי לידים/מכירות צולבות וכו', ומאפיינים של Merchant Center כמו מותג, קטגוריה וכו', זמינים למוצרים שמוגדרים בפיד מלאי ונמכרים כתוצאה ממודעות Google. לרכישות שמשויכות לקליקים על מודעות שופינג, אפשר לראות יחד את המאפיינים של המוצרים שעליהם לחצו ושל המוצרים שנמכרו.
| ייצוג 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 |
אם הביט primaryForGoal של פעולת המרה הוא FALSE, פעולת ההמרה הזו שלא ניתן להגיש עליה הצעות מחיר בכל הקמפיינים, בלי קשר ליעד ההמרה של הלקוח או ליעד ההמרה של הקמפיין. עם זאת, יעדי המרה מותאמים אישית לא מתייחסים לערך primaryForGoal, ולכן אם בקמפיין מוגדר יעד המרה מותאם אישית עם פעולת המרה שבה primaryForGoal = false, עדיין אפשר להגיש הצעות מחיר על פעולת ההמרה הזו. כברירת מחדל, הערך של primaryForGoal יהיה true אם לא הוגדר. בגרסה 9, אפשר להגדיר את primaryForGoal כ-false רק אחרי היצירה באמצעות פעולת update, כי היא לא מוצהרת כאופציונלית. |
ownerCustomer |
שם המשאב של הלקוח שהוא הבעלים של פעולת ההמרה, או null אם זו פעולת המרה שהוגדרה על ידי המערכת. |
includeInClientAccountConversionsMetric |
האם פעולת ההמרה הזו צריכה להיכלל במדד clientAccountConversions. |
includeInConversionsMetric |
האם פעולת ההמרה הזו צריכה להיכלל במדד 'המרות'. |
clickThroughLookbackWindowDays |
מספר הימים המקסימלי שיכול לחלוף בין אינטראקציה (לדוגמה, קליק) לבין אירוע המרה. |
appId |
מזהה האפליקציה של פעולת המרה באפליקציה. |
ConversionActionStatus
הסטטוסים האפשריים של פעולת המרה.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
ההמרות יתועדו. |
REMOVED |
ההמרות לא יתועדו. |
HIDDEN |
המערכת לא תתעד המרות ופעולת ההמרה לא תופיע בממשק המשתמש. |
ConversionActionType
סוגים אפשריים של פעולת המרה.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
המרות למכירה בחנות פיזית מבוססות על העלאות של נתוני מוכרים מאינטראקציה ישירה (First-Party) או מצד שלישי, ו/או על רכישות בחנות באמצעות כרטיסים מחברות אשראי. רק לקוחות שנמצאים ברשימת ההיתרים יכולים להשתמש בסוגי מכירות בחנות הפיזית. קריאה בלבד. |
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 הסתיים ב-31 במאי 2025. שאלות נפוצות על שדרוג השילוב הקודם עם 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.
| טיפוסים בני מנייה (enum) | |
|---|---|
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). מיועד לשימוש בייבוא יעדים של GA, Firebase ו-GA Gold. |
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 |
סוג מודל השיוך של פעולת ההמרה הזו. |
dataDrivenModelStatus |
הסטטוס של מודל השיוך מבוסס-הנתונים לפעולת ההמרה. |
AttributionModel
מודל השיוך שמתאר איך לחלק את הקרדיט על המרה מסוימת בין הרבה אינטראקציות קודמות פוטנציאליות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
EXTERNAL |
משתמשת בשיוך חיצוני. |
GOOGLE_ADS_LAST_CLICK |
המערכת משייכת את כל הקרדיט על ההמרה לקליק האחרון. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
המערכת משייכת את כל הקרדיט על ההמרה לקליק הראשון באמצעות שיוך בחיפוש Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
המערכת משייכת קרדיט על המרה באופן שווה לכל הקליקים שהובילו אליה באמצעות ייחוס בחיפוש Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
המערכת משייכת באופן אקספוננציאלי יותר קרדיט על המרה לקליקים האחרונים יותר שלה באמצעות שיוך בחיפוש Google (נקודת החצי היא שבוע). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
המערכת משייכת 40% מהקרדיט על ההמרה לקליק הראשון והאחרון. 20% הנותרים מחולקים באופן שווה בין כל שאר הקליקים. השיטה הזו מתבססת על שיוך לרשת החיפוש של Google. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
מודל גמיש שמבוסס על למידת מכונה כדי לקבוע את חלוקת הקרדיט המתאימה בין הקליקים באמצעות שיוך לחיפוש Google. |
DataDrivenModelStatus
מפרט את הסטטוסים של מודל מבוסס-נתונים.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 או פחות. לדוגמה: "u4". |
status |
הסטטוס של המשתנה המותאם אישית להמרות לצורך צבירה של אירועי המרה. |
ownerCustomer |
שם המשאב של הלקוח שבבעלותו המשתנה המותאם אישית של ההמרה. |
family |
המשפחה של משתנה ההמרה המותאם אישית. |
cardinality |
העוצמה של משתנה ההמרה המותאם אישית. |
floodlightConversionCustomVariableInfo |
שדות למשתנים מותאמים אישית של המרות Floodlight ב-Search Ads 360. |
customColumnIds[] |
מזהי העמודות בהתאמה אישית שמשתמשות במשתנה המותאם אישית הזה של ההמרה. |
ConversionCustomVariableStatus
הסטטוסים האפשריים של משתנה המרה מותאם אישית.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ACTIVATION_NEEDED |
המשתנה המותאם אישית של ההמרה ממתין להפעלה, ולא יצטברו נתונים לגביו עד שהוא יוגדר למצב ENABLED. אי אפשר להשתמש בסטטוס הזה בבקשות CREATE ו-UPDATE. |
ENABLED |
משתנה ההמרה המותאם אישית מופעל ויצטברו בו נתונים סטטיסטיים. |
PAUSED |
המשתנה המותאם אישית של ההמרה מושהה ולא יצטברו נתונים לגביו עד שהוא יוגדר שוב למצב ENABLED. |
ConversionCustomVariableFamily
המשפחה של משתנה המרה מותאם אישית.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
STANDARD |
משתנה ההמרה המותאם אישית הרגיל. הלקוחות נדרשים להפעיל את המכשיר לפני השימוש. |
FLOODLIGHT |
משתנה ההמרה המותאם אישית שיובא ממשתנה מותאם אישית ב-Floodlight. |
ConversionCustomVariableCardinality
העוצמה של משתנה מותאם אישית להמרות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
BELOW_ALL_LIMITS |
העוצמה של המשתנה המותאם אישית להמרה נמוכה מכל המגבלות. אפשר להשתמש במשתנה לפילוח, ואם המשתנה מופעל, המערכת יכולה לצבור נתונים סטטיסטיים לערכים חדשים. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
למשתנה המותאם אישית של ההמרה יש מספר ערכים ייחודיים שחורג מהמגבלה של הפילוח, אבל לא מהמגבלה של הנתונים הסטטיסטיים. הפילוח יושבת, אבל אם המשתנה מופעל, אפשר לצבור נתונים לערכים חדשים. |
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.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
DIMENSION |
סוג משתנה Floodlight של מימד. |
METRIC |
סוג המשתנה של מדד Floodlight. |
UNSET |
סוג המשתנה ב-Floodlight לא מוגדר. |
FloodlightVariableDataType
סוג הנתונים של משתנה Floodlight, כפי שהוגדר ב-Search Ads 360. מידע נוסף זמין בכתובת https://support.google.com/searchads/answer/4397154?hl=en.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
NUMBER |
מייצג משתנה Floodlight מסוג 'מספר'. אפשר להקצות את המשתנה הזה למשתני Floodlight מסוג DIMENSION או METRIC. |
STRING |
מייצג משתנה Floodlight מסוג String. אפשר להקצות את המשתנה הזה למשתני Floodlight מסוג DIMENSION. |
לקוח
לקוח.
| ייצוג 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.ssssss. |
engineId |
המזהה של החשבון בחשבון המנוע החיצוני. |
status |
הסטטוס של הלקוח. |
creationTime |
חותמת הזמן שבה הלקוח הזה נוצר. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
managerId |
מספר הלקוח של חשבון הניהול. הערך 0 מציין שללקוח אין חשבון ניהול ב-SA360. |
managerDescriptiveName |
השם התיאורי של חשבון הניהול. |
subManagerId |
מספר הלקוח של חשבון הניהול המשני. ערך של 0 מציין שללקוח אין חשבון ניהול משני ב-SA360. |
subManagerDescriptiveName |
השם התיאורי של חשבון הניהול המשני. |
associateManagerId |
מספר הלקוח של חשבון ניהול משני לשותפים. ערך של 0 מציין שללקוח אין חשבון ניהול משני לשותפים ב-SA360. |
associateManagerDescriptiveName |
השם התיאורי של חשבון ניהול משני לשותפים. |
accountLevel |
רמת החשבון של הלקוח: חשבון ניהול, חשבון ניהול משני, חשבון ניהול משני לשותפים, חשבון שירות. |
id |
מזהה הלקוח. |
descriptiveName |
שם תיאורי אופציונלי של הלקוח, לא ייחודי. |
currencyCode |
המטבע שבו מתנהלת הפעילות בחשבון. מערכת Google תומכת בחלק מקודי המטבע בתקן 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
סטטוס מעקב ההמרות של הלקוח.
| טיפוסים בני מנייה (enum) | |
|---|---|
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
סוגי חשבונות מנוע אפשריים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
BAIDU |
חשבון Baidu. |
ENGINE_TRACK |
חשבון Engine Track. |
FACEBOOK |
חשבון פייסבוק. |
FACEBOOK_GATEWAY |
חשבון פייסבוק שמנוהל דרך שער. |
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, כמו America/New_York. |
AccountStatus
הסטטוסים האפשריים של חשבון.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
ערך ברירת המחדל. |
UNKNOWN |
ערך לא ידוע. |
ENABLED |
אפשר להציג מודעות בחשבון. |
PAUSED |
המשתמש השבית את החשבון. |
SUSPENDED |
החשבון מושבת בתהליך פנימי. |
REMOVED |
החשבון מושבת באופן סופי. |
DRAFT |
החשבון עדיין בתהליך הגדרה, והוא עדיין לא הופעל. |
CustomerStatus
הסטטוסים האפשריים של לקוח.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
מציין חשבון פעיל שיכול להציג מודעות. |
CANCELED |
מציין חשבון שבוטל ואי אפשר להציג בו מודעות. משתמש עם הרשאת אדמין יכול להפעיל מחדש את החשבון. |
SUSPENDED |
מציין חשבון מושעה שלא ניתן להציג בו מודעות. אפשר להפעיל את התכונה רק דרך התמיכה של Google. |
CLOSED |
מציין חשבון סגור שלא ניתן להציג בו מודעות. גם חשבון הבדיקה יהיה בסטטוס CLOSED. הסטטוס הוא קבוע ואי אפשר לפתוח מחדש את הבקשה. |
AccountLevelType
סוג enum שמתאר את רמות החשבון האפשריות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
CLIENT_ACCOUNT_FACEBOOK |
חשבון לקוח (פייסבוק) |
CLIENT_ACCOUNT_GOOGLE_ADS |
חשבון לקוח (Google Ads) |
CLIENT_ACCOUNT_MICROSOFT |
חשבון לקוח (Microsoft) |
CLIENT_ACCOUNT_YAHOO_JAPAN |
חשבון לקוח (Yahoo Japan) |
CLIENT_ACCOUNT_ENGINE_TRACK |
חשבון לקוח (Engine Track) |
MANAGER |
חשבון ניהול ברמה העליונה. |
SUB_MANAGER |
חשבון ניהול משני. |
ASSOCIATE_MANAGER |
חשבון ניהול משני לשותפים. |
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
מייצג תצוגה של אסטרטגיות בידינג שנמצאות בבעלות הלקוח ומשותפות איתו.
בניגוד ל-BiddingStrategy, המשאב הזה כולל אסטרטגיות שנמצאות בבעלות של חשבונות ניהול של הלקוח ומשותפות עם הלקוח הזה, בנוסף לאסטרטגיות שנמצאות בבעלות של הלקוח הזה. המשאב הזה לא מספק מדדים, והוא חושף רק קבוצת משנה מוגבלת של מאפייני BiddingStrategy.
| ייצוג JSON |
|---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של שיטת הבידינג שאפשר לגשת אליה. שמות המשאבים של AccessibleBiddingStrategy הם בפורמט:
|
id |
המזהה של שיטת הבידינג. |
name |
השם של שיטת הבידינג. |
type |
הסוג של שיטת הבידינג. |
ownerCustomerId |
המזהה של הלקוח שבבעלותו אסטרטגיית הבידינג. |
ownerDescriptiveName |
שם תיאורי של הלקוח שבבעלותו שיטת הבידינג. |
שדה איחוד אפשר להגדיר רק אחד. הערך |
|
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 |
יעד ההוצאות שבו רוצים להשיג מקסימום קליקים. מגיש הצעות מחיר לפי יעד הוצאות ינסה להוציא את הסכום הנמוך מבין שני הערכים האלה: הערך הזה או סכום ההוצאות שמוגבל באופן טבעי. אם לא מציינים יעד הוצאות, המערכת משתמשת בתקציב כהוצאה היעד. השדה הזה הוצא משימוש ואין להשתמש בו יותר. פרטים נוספים זמינים בכתובת 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 |
המזהה של הקישור בין חשבון הלקוח לחשבון הניהול. השדה הזה הוא לקריאה בלבד. |
startTime |
חותמת הזמן שבה נוצר הקישור CustomerManagerLink. חותמת הזמן היא באזור הזמן של הלקוח ובפורמט yyyy-MM-dd HH:mm:ss. |
ManagerLinkStatus
הסטטוסים האפשריים של קישור.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ACTIVE |
מציין את הקשר הנוכחי בתוקף |
INACTIVE |
ציון של קשר שהסתיים |
PENDING |
מציין שהמנהל ביקש ליצור קשר, אבל הלקוח עדיין לא אישר את הבקשה. |
REFUSED |
הקשר נוצר על ידי חשבון הניהול, אבל הלקוח סירב. |
CANCELED |
מציין שחשבון הניהול ביקש ליצור קשר, אבל ביטל את הבקשה. |
CustomerClient
קישור בין הלקוח שצוין לבין לקוח אחר. האובייקט CustomerClients קיים רק עבור לקוחות ניהול. כל הלקוחות הישירים והעקיפים כלולים, וגם חשבון הניהול עצמו.
| ייצוג JSON |
|---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של לקוח הלקוח. שמות המשאבים של CustomerClient הם בפורמט: |
appliedLabels[] |
שמות המשאבים של התוויות שבבעלות הלקוח ששולח את הבקשה, שמוחלות על לקוח הקמפיין. שמות המשאבים של התוויות הם מהצורה:
|
status |
הסטטוס של הלקוח. קריאה בלבד. |
clientCustomer |
שם המשאב של לקוח שמקושר ללקוח הנתון. קריאה בלבד. |
level |
המרחק בין הלקוח לבין הלקוח שצוין. בקישור עצמי, ערך הרמה יהיה 0. קריאה בלבד. |
timeZone |
ייצוג מחרוזת של אזור הזמן של הלקוח במאגר CLDR (Common Locale Data Repository). לדוגמה, America/Los_Angeles. קריאה בלבד. |
testAccount |
העמודה מציינת אם חשבון הלקוח הוא חשבון בדיקה. קריאה בלבד. |
manager |
מציין אם חשבון הלקוח הוא חשבון ניהול. קריאה בלבד. |
descriptiveName |
שם תיאורי של הלקוח. קריאה בלבד. |
currencyCode |
קוד המטבע (לדוגמה, USD, EUR) של הלקוח. קריאה בלבד. |
id |
המזהה של הלקוח. קריאה בלבד. |
DynamicSearchAdsSearchTermView
תצוגה של מונחי חיפוש של מודעות דינמיות לרשת החיפוש.
| ייצוג JSON |
|---|
{ "resourceName": string, "landingPage": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש. שמות המשאבים של תצוגת מונחי החיפוש של מודעות דינמיות לרשת החיפוש הם מהצורה:
|
landingPage |
כתובת דף הנחיתה שנבחרה באופן דינמי לחשיפה. השדה הזה הוא לקריאה בלבד. |
GenderView
משאב של תצוגת מגדר. המדד הזה מייצג את מדדי הביצועים של לקוח שמצטברים לפי מגדר. כל הנתונים הסטטיסטיים נצברים ברמת קבוצת המודעות.
הערה: אפשר לפלח מדדים לפי טווח גילאים באמצעות ageRangeView או לפי מגדר באמצעות genderView, אבל Search Ads 360 API לא תומך בפילוח מדדים לפי טווח גילאים ומגדר בו-זמנית בשאילתה אחת. אין תמיכה בניתוח הביצועים בשילוב של שני המאפיינים ב-Search Ads 360 API.
| ייצוג JSON |
|---|
{ "resourceName": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת המגדר. שמות המשאבים של תצוגת המגדר הם מהצורה:
|
GeoTargetConstant
קבוע של מיקוד גיאוגרפי.
| ייצוג JSON |
|---|
{
"resourceName": string,
"status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של קבוע היעד הגיאוגרפי. שמות המשאבים של קבועי מיקום גיאוגרפי לטירגוט הם מהצורה:
|
status |
הסטטוס של קבוע המיקוד הגיאוגרפי. |
id |
המזהה של הקבוע של הטירגוט הגיאוגרפי. |
name |
שם קבוע של מיקוד גיאוגרפי באנגלית. |
countryCode |
קוד המדינה בפורמט ISO-3166-1 alpha-2 שמשויך ליעד. |
targetType |
סוג הטירגוט הקבוע של המיקוד הגיאוגרפי. |
canonicalName |
השם המלא באנגלית, שכולל את שם היעד, שם ההורה והמדינה. |
parentGeoTarget |
שם המשאב של קבוע היעד הגיאוגרפי של ההורה. שמות המשאבים של קבועי מיקום גיאוגרפי לטירגוט הם מהצורה:
|
GeoTargetConstantStatus
הסטטוסים האפשריים של קבוע לטירגוט גיאוגרפי.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא מוכר בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
הקבוע של המיקוד הגיאוגרפי תקין. |
REMOVAL_PLANNED |
הקבוע של מיקוד גיאוגרפי יצא משימוש ויוסר. |
KeywordView
תצוגת מילות מפתח.
| ייצוג JSON |
|---|
{ "resourceName": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת מילות המפתח. שמות המשאבים של תצוגת מילות המפתח הם מהצורה:
|
תווית
תווית.
| ייצוג JSON |
|---|
{ "resourceName": string, "status": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב. שמות המשאבים של התוויות הם מהצורה: |
status |
הסטטוס של התווית. קריאה בלבד. |
textLabel |
סוג של תווית שבה מוצג טקסט על רקע צבעוני. |
id |
המזהה של התווית. קריאה בלבד. |
name |
שם התווית. כשיוצרים תווית חדשה, חובה למלא את השדה הזה. אורך המחרוזת צריך להיות בין 1 ל-80, כולל. |
LabelStatus
הסטטוסים האפשריים של תוויות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
התווית מופעלת. |
REMOVED |
התווית מוסרת. |
TextLabel
סוג של תווית שבה מוצג טקסט על רקע צבעוני.
| ייצוג JSON |
|---|
{ "backgroundColor": string, "description": string } |
| שדות | |
|---|---|
backgroundColor |
צבע הרקע של התווית בפורמט הקסדצימלי. המחרוזת הזו צריכה להתאים לביטוי הרגולרי '^#([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 |
השם המלא של השפה באנגלית, לדוגמה, 'English (US)', 'Spanish' וכו'. |
targetable |
האם אפשר לטרגט את השפה. |
LocationView
בתצוגת מיקום מוצג סיכום של ביצועי הקמפיינים לפי קריטריון מיקום.
| ייצוג JSON |
|---|
{ "resourceName": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת המיקום. שמות המשאבים של תצוגת המיקום הם מהצורה:
|
ProductBiddingCategoryConstant
קטגוריית בידינג על מוצר.
| ייצוג JSON |
|---|
{ "resourceName": string, "level": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של קטגוריית הבידינג על המוצר. שמות המשאבים של קטגוריות הבידינג על מוצרים הם מהצורה:
|
level |
הרמה של קטגוריית הבידינג על המוצר. |
status |
הסטטוס של קטגוריית הבידינג על המוצר. |
id |
המזהה של קטגוריית הבידינג על המוצר. המזהה הזה מקביל למזהה של מאפיין קטגוריית המוצר ב-Google, כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436. |
countryCode |
קוד מדינה בן 2 אותיות רישיות של קטגוריית הבידינג על המוצר. |
productBiddingCategoryConstantParent |
שם המשאב של קטגוריית הבידינג של מוצר האב. |
languageCode |
קוד השפה של קטגוריית הבידינג על המוצר. |
localizedName |
הצגת הערך של קטגוריית הבידינג של המוצר, שעבר לוקליזציה בהתאם ל-languageCode. |
ProductBiddingCategoryLevel
סוג Enum שמתאר את הרמה של קטגוריית הבידינג על המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
LEVEL1 |
רמה 1. |
LEVEL2 |
רמה 2. |
LEVEL3 |
רמה 3. |
LEVEL4 |
רמה 4. |
LEVEL5 |
רמה 5. |
ProductBiddingCategoryStatus
סוג Enum שמתאר את הסטטוס של קטגוריית הבידינג על המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ACTIVE |
הקטגוריה פעילה ואפשר להשתמש בה לבידינג. |
OBSOLETE |
הקטגוריה מיושנת. משמש רק למטרות דיווח. |
ProductGroupView
תצוגה של קבוצת מוצרים.
| ייצוג JSON |
|---|
{ "resourceName": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של התצוגה של קבוצת המוצרים. שמות המשאבים של תצוגת קבוצת מוצרים הם מהצורה:
|
ShoppingPerformanceView
תצוגת ביצועים בקניות.
הדוח מספק נתונים סטטיסטיים מצטברים של קמפיינים לשופינג וקמפיינים למיקסום הביצועים בכמה רמות של מאפייני מוצרים. הערכים של מאפייני המוצרים מ-Merchant Center, כמו מותג, קטגוריה, מאפיינים מותאמים אישית, מצב מוצר וסוג מוצר, ישקפו את המצב של כל מאפיין נכון לתאריך ולשעה שבהם האירוע המתאים נרשם.
יכול להיות שמספר החשיפות והקליקים שshoppingPerformanceView מחזיר לגביהם נתונים סטטיסטיים יהיה שונה מהמספרים בדוחות הקמפיין. shoppingPerformanceView מציג חשיפות וקליקים על מוצרים שמופיעים במודעות, בעוד שדוחות הקמפיין מציגים חשיפות וקליקים על המודעות עצמן. בהתאם לפורמט, במודעה יכולים להופיע אפס עד כמה מוצרים, ולכן יכול להיות שהמספרים לא יהיו זהים.
בממשק המשתמש של Search Ads 360, אפשר לשלוח שאילתות לגבי חשיפות וקליקים של מוצרים שמופיעים במודעות על ידי בחירת עמודה מתוך 'מאפייני מוצר' בכלי הדוחות. לדוגמה, בחירה בעמודה 'מותג' שקולה לבחירה באפשרות segments.product_brand.
| ייצוג JSON |
|---|
{ "resourceName": string } |
| שדות | |
|---|---|
resourceName |
שם המשאב של תצוגת הביצועים בקניות. הפורמט של שמות המשאבים של תצוגת הביצועים בקניות הוא: |
UserList
רשימת משתמשים. זוהי רשימה של משתמשים שלקוח יכול לטרגט. המפתח הייחודי של רשימת משתמשים מורכב מהשדות הבאים: id. שימו לב שגם הערך של name צריך להיות ייחודי לרשימות משתמשים שבבעלות לקוח מסוים, למעט במקרים מסוימים שבהם הערך של accessReason מוגדר כ-SHARED. אם השם לא ייחודי, תופיע השגיאה: UserListError.INVALID_NAME.
| ייצוג JSON |
|---|
{
"resourceName": string,
"type": enum ( |
| שדות | |
|---|---|
resourceName |
שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות המשתמשים הם מהצורה:
|
type |
סוג הרשימה. השדה הזה הוא לקריאה בלבד. |
id |
המזהה של רשימת המשתמשים. |
name |
השם של רשימת המשתמשים הזו. ייחודי לכל רשימת משתמשים, למעט במקרים מסוימים שבהם רשימת משתמשים עם אותו שם מוגדרת עם |
UserListType
טיפוסים בני מנייה (enum) שמכילים סוגים אפשריים של רשימות משתמשים.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
REMARKETING |
רשימת משתמשים שמיוצגת כאוסף של סוגי המרות. |
LOGICAL |
רשימת משתמשים שמייצגת שילוב של רשימות משתמשים או תחומי עניין אחרים. |
EXTERNAL_REMARKETING |
רשימת משתמשים שנוצרה בפלטפורמת Google Ad Manager. |
RULE_BASED |
רשימת משתמשים שמשויכת לכלל. |
SIMILAR |
רשימת משתמשים עם משתמשים שדומים למשתמשים ברשימת משתמשים אחרת. |
CRM_BASED |
רשימת משתמשים של נתוני CRM מאינטראקציה ישירה שסופקו על ידי המפרסם בפורמט של כתובות אימייל או בפורמטים אחרים. |
UserLocationView
תצוגת מיקום משתמש.
התצוגה 'מיקום המשתמש' כוללת את כל המדדים שמצטברים ברמת המדינה, שורה אחת לכל מדינה. בעמודה הזו מוצגים מדדי הביצועים במיקום הפיזי בפועל של המשתמש, לפי מיקום גיאוגרפי מטורגט או לא מטורגט. אם נעשה שימוש בשדות אחרים של פלחים, יכול להיות שתקבלו יותר משורה אחת לכל מדינה.
| ייצוג JSON |
|---|
{ "resourceName": string, "countryCriterionId": string, "targetingLocation": boolean } |
| שדות | |
|---|---|
resourceName |
שם המשאב של התצוגה 'מיקום המשתמש'. שמות המשאבים של התצוגה המפורטת UserLocation הם מהצורה:
|
countryCriterionId |
מזהה הקריטריון של המדינה. |
targetingLocation |
מציין אם המיקום היה מיקום גיאוגרפי למיקוד או לא. |
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
סוג Enum שמתאר את המיקום של מוצר למכירה.
| טיפוסים בני מנייה (enum) | |
|---|---|
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 |
מחרוזת ייחודית של הביקור שההמרה משויכת אליו, שמועברת לדף הנחיתה כפרמטר של כתובת ה-URL של מזהה הקליק. |
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 |
כמות הפריטים שתועדה בהמרה, כפי שנקבעה על ידי פרמטר כתובת ה-URL qty. המפרסם אחראי לאכלוס הפרמטר באופן דינמי (למשל מספר הפריטים שנמכרו בהמרה), אחרת ערך ברירת המחדל הוא 1. |
conversionRevenueMicros |
ההכנסה המותאמת במיקרו לאירוע ההמרה. המטבע הזה יהיה תמיד המטבע של חשבון להצגת מודעות. |
floodlightOriginalRevenue |
ההכנסה המקורית שלא השתנתה שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight. |
floodlightOrderId |
מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם להמרה. |
status |
הסטטוס של ההמרה, ENABLED או REMOVED. |
assetId |
המזהה של הנכס שהייתה איתו אינטראקציה במהלך אירוע ההמרה. |
assetFieldType |
סוג השדה של נכס באירוע ההמרה. |
AttributionType
סוג השיוך (Attribution) של המרות ב-SearchAds360
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
VISIT |
ההמרה משויכת לביקור. |
CRITERION_AD |
ההמרה משויכת לצמד של קריטריון ומודעה. |
ConversionStatus
הסטטוסים האפשריים של המרה.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
ENABLED |
ההמרה מופעלת. |
REMOVED |
ההמרה הוסרה. |
מדדים
נתוני מדדים.
| ייצוג JSON |
|---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
| שדות | |
|---|---|
allConversionsValueByConversionDate |
הערך של כל ההמרות. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות |
allConversionsByConversionDate |
המספר הכולל של המרות. הייבוא הזה כולל את כל ההמרות, בלי קשר לערך של includeInConversionsMetric. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות |
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 |
העלות הכוללת של כל הקליקים חלקי המספר הכולל של הקליקים שהתקבלו. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
averageCpm |
עלות ממוצעת לאלף חשיפות (CPM). המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
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 |
ערך ההמרות בחשבון הלקוח. הערך הזה כולל רק פעולות המרה שהמאפיין |
conversionsValuePerCost |
ערך ההמרה מפרסום בתשלום חלקי העלות הכוללת של האינטראקציות שעומדות בדרישות להמרות. |
conversionsFromInteractionsValuePerInteraction |
ערך ההמרות מאינטראקציות חלקי מספר האינטראקציות עם המודעה. הערך הזה כולל רק פעולות המרה שהמאפיין |
clientAccountConversions |
מספר ההמרות בחשבון הלקוח. הערך הזה כולל רק פעולות המרה שהמאפיין |
costMicros |
הסכום של העלויות לקליק (CPC) והעלויות לאלף חשיפות (CPM) בתקופה הזו. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. פרטים נוספים זמינים בפרמטר |
costPerAllConversions |
העלות של האינטראקציות עם המודעות חלקי מספר ההמרות הכולל. |
costPerConversion |
העלות הממוצעת להמרה מפרסום בתשלום שניתן להגיש עליה הצעת מחיר. |
costPerCurrentModelAttributedConversion |
העלות של האינטראקציות עם המודעות חלקי ההמרות שמשויכות למודל הנוכחי. הערך הזה כולל רק פעולות המרה שהמאפיין |
crossDeviceConversions |
המרות שמתרחשות כשלקוח לוחץ על מודעה במכשיר אחד ואז משלים המרה במכשיר או בדפדפן אחר. המרות חוצות-מכשירים כבר נכללות ב |
crossDeviceConversionsByConversionDate |
מספר ההמרות חוצות-המכשירים לפי תאריך ההמרה. פרטים על העמודות |
crossDeviceConversionsValue |
סכום הערך של המרות חוצות-מכשירים. |
crossDeviceConversionsValueByConversionDate |
סכום הערכים של המרות חוצות-מכשירים לפי תאריך ההמרה. פרטים על העמודות |
ctr |
מספר הקליקים שהמודעה קיבלה (קליקים) חלקי מספר הפעמים שהמודעה הוצגה (חשיפות). |
conversions |
מספר ההמרות. הערך הזה כולל רק פעולות המרה שהמאפיין includeInConversionsMetric שלהן מוגדר כ-true. אם משתמשים בבידינג מבוסס-המרות, שיטות הבידינג שלכם יבצעו אופטימיזציה כדי להשיג המרות כאלה. |
conversionsValue |
סכום ערכי ההמרות של ההמרות שנכללות בשדה 'המרות'. המדד הזה מועיל רק אם הזנת ערך לפעולות ההמרה. |
averageQualityScore |
ציון האיכות הממוצע. |
historicalQualityScore |
ציון האיכות בעבר. |
impressions |
מספר הפעמים שהמודעה הופיעה בדף תוצאות חיפוש או באתר ברשת Google. |
interactionRate |
התדירות שבה אנשים מקיימים אינטראקציה עם המודעה אחרי שהיא מוצגת להם. מספר האינטראקציות חלקי מספר הפעמים שהמודעה הוצגה. |
interactions |
מספר האינטראקציות. אינטראקציה היא הפעולה העיקרית של המשתמש שמשויכת לפורמט המודעה – קליקים במקרה של מודעות טקסט ומודעות שופינג, צפיות במקרה של מודעות וידאו וכן הלאה. |
invalidClickRate |
אחוז הקליקים שסוננו מתוך המספר הכולל של הקליקים (קליקים מסוננים + קליקים לא מסוננים) במהלך תקופת הדיווח. |
invalidClicks |
מספר הקליקים ש-Google מחשיבה כלא לגיטימיים ולא מחייבת אתכם עליהם. |
generalInvalidClickRate |
אחוז הקליקים שסוננו מתוך כלל הקליקים (קליקים מסוננים + קליקים לא מסוננים) כי הם קליקים פסולים כלליים. אלה קליקים ש-Google מחשיבה כפסולים, והם מזוהים בעזרת אמצעי סינון שגרתיים (כלומר תנועה פסולה ידועה ממרכזי נתונים, בוטים וספיידרים או סורקים אחרים, דפוסים חריגים וכו'). לא נגבה ממך תשלום עליהם, והם לא משפיעים על הסטטיסטיקה של החשבון. אפשר לעיין במאמר בנושא סינון תנועה פסולה כדי להבטיח איכות. |
generalInvalidClicks |
מספר הקליקים הפסולים הכלליים. אלה קליקים פסולים שזוהו באמצעות אמצעי סינון שגרתיים (למשל תנועה פסולה ידועה ממרכזי נתונים, בוטים וספיידרים או סורקים אחרים, דפוסים חריגים וכו'). לא נגבה ממך תשלום עליהם, והם לא משפיעים על הסטטיסטיקה של החשבון. אפשר לעיין במאמר בנושא סינון תנועה פסולה כדי להבטיח איכות. |
mobileFriendlyClicksPercentage |
אחוז הקליקים בניידים שמובילים לדף שמותאם לניידים. |
searchAbsoluteTopImpressionShare |
אחוז החשיפות של מודעות שופינג או מודעות לרשת החיפוש של הלקוח שהופיעו במיקום הבולט ביותר בחיפוש Google. פרטים נוספים זמינים במאמר מידע על מדדי החשיפה בראש הדף ובמיקום הראשון. כל ערך שקטן מ-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 |
ערך כל ההמרות חלקי מספר כל ההמרות. כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות |
valuePerConversion |
ערך ההמרה מפרסום בתשלום חלקי מספר ההמרות מפרסום בתשלום. העמודה הזו מראה את הערך הממוצע של כל אחת מההמרות שניתן להגיש עליהן הצעות מחיר. |
valuePerConversionsByConversionDate |
ערך ההמרות שניתן להגיש עליהן הצעות מחיר לפי תאריך ההמרה חלקי מספר ההמרות שניתן להגיש עליהן הצעות מחיר לפי תאריך ההמרה. בעמודה הזו מוצג הערך הממוצע של כל אחת מההמרות שניתן להגיש עליהן הצעות מחיר (לפי תאריך ההמרה). כשבוחרים בעמודה הזו עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. |
clientAccountViewThroughConversions |
מספר ההמרות בעקבות צפייה הכולל. הן מתרחשות כשלקוח רואה מודעה עם תמונה או מודעת מדיה עשירה, ואז משלים המרה באתר בלי ליצור אינטראקציה עם מודעה אחרת (למשל, לחיצה על מודעה אחרת). |
orders |
המדד "הזמנות" מייצג את המספר הכולל של המרות מסוג רכישה שקיבלתם ושמשויכות למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם המרה משויכת לאינטראקציות קודמות עם המודעות שלכם (קליקים על מודעות טקסט או מודעות שופינג, צפיות במודעות וידאו וכו') היא נספרת כהזמנה. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה בהזמנה מהאתר שלכם. גם אם נרכשו 2 מוצרים, הדבר ייחשב להזמנה אחת. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
averageOrderValueMicros |
המדד "ערך הזמנה ממוצע" מייצג את ההכנסה הממוצעת מכל הזמנה שמשויכת למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. ערך ההזמנה הממוצע הוא ההכנסה הכוללת מההזמנות שלכם חלקי המספר הכולל של ההזמנות. דוגמה: קיבלתם 3 הזמנות שהניבו הכנסה בשווי $10, $15 ו-$20. ערך ההזמנה הממוצע הוא $15 = ($10 + $15 + $20)/3. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
averageCartSize |
המדד 'גודל ממוצע של עגלת קניות' מייצג את מספר המוצרים הממוצע בכל הזמנה שמשויכת למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. הגודל הממוצע של עגלת הקניות הוא המספר הכולל של המוצרים שנמכרו חלקי המספר הכולל של ההזמנות שקיבלתם. דוגמה: קיבלתם 2 הזמנות, הראשונה כללה 3 מוצרים והשנייה כללה 2. הגודל הממוצע של עגלת הקניות הוא 2.5 מוצרים = (3 ועוד 2) חלקי 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
costOfGoodsSoldMicros |
עלות המכר (COGS) היא העלות הכוללת של המוצרים שמכרתם בהזמנות שמשויכות למודעות שלכם. איך זה עובד: אתם יכולים להוסיף ערך של עלות מכר לכל מוצר ב-Merchant Center. אם תדווחו על המרות עם נתונים מעגלות קניות (CwCD), המערכת תשייך את המוצרים שמכרתם לערך עלות המכר שלהם, ותוכלו לחשב את סכום הרווח ברוטו מכל הזמנה. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. עלות המכר בהזמנה הזו היא 8$ = 3$ ועוד 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
grossProfitMicros |
המדד "רווח ברוטו" מייצג את הרווח מהזמנות שמשויכות למודעות שלכם, בניכוי עלות המכר (COGS). איך זה עובד: הרווח ברוטו הוא ההכנסה ממכירות שמשויכות למודעות שלכם, בניכוי עלות המכר. בחישוב של הרווח ברוטו נכללים רק מוצרים שיש להם ערך עלות מכר ב-Merchant Center. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה בהזמנה מהאתר. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ערך עלות המכר של הכובע הוא 3$, אבל לחולצה אין ערך עלות מכר. רק הכובע ייכלל בחישוב של הרווח ברוטו של ההזמנה הזו. לכן, הרווח ברוטו הוא 7 $= (10 $פחות 3$). המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
grossProfitMargin |
המדד "שולי רווח ברוטו" מייצג את אחוז הרווח ברוטו מהזמנות שמשויכות למודעות שלכם, בניכוי עלות המכר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. כך מחשבים את שולי הרווח הגולמי: הרווח הגולמי חלקי ההכנסה הכוללת כפול 100%. בחישוב של שולי הרווח הגולמי נכללים רק מוצרים שיש להם ערך עלות מכר ב-Merchant Center. דוגמה: משתמש קנה כובע וחולצה בהזמנה באתר. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. מחיר החולצה הוא 80 ש"ח, אבל אין לה ערך עלות מכר. רק הכובע ייכלל בחישוב שולי הרווח ברוטו של ההזמנה הזו, כי לכובע יש ערך עלות מכר. לכן, מדד שולי הרווח ברוטו הוא 70% = ($10 פחות $3) חלקי $10 כפול 100%. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
revenueMicros |
המדד "הכנסה" מייצג את הסכום הכולל שהרווחתם מהזמנות שמשויכות למודעות שלכם. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. ההכנסה מייצגת את הערך הכולל של כל ההזמנות שמשויכות למודעות שלכם, בניכוי כל ההנחות. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה בהזמנה מהאתר. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. הנחה של 20 ש"ח חלה על ההזמנה כולה. ההכנסה מההזמנה הזו היא 100 ש"ח = (40 ש"ח ועוד 80 ש"ח) פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
unitsSold |
המדד 'יחידות שנמכרו' מייצג את המספר הכולל של המוצרים שנמכרו בהזמנות שמשויכות למודעות שלך. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. המדד 'יחידות שנמכרו' מייצג את המספר הכולל של המוצרים שנמכרו בכל ההזמנות שמשויכות למודעות שלך. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו בהזמנה הזו הוא 3. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
clientAccountCrossSellCostOfGoodsSoldMicros |
המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח' מייצג את העלות הכוללת של מוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. ערך עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
crossSellCostOfGoodsSoldMicros |
המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. ערך עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
clientAccountCrossSellGrossProfitMicros |
המדד "רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח" מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
crossSellGrossProfitMicros |
המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. פרטים על הפרמטר |
clientAccountCrossSellRevenueMicros |
המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 20$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
crossSellRevenueMicros |
המדד "הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)" מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 20$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
clientAccountCrossSellUnitsSold |
המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell) בחשבון לקוח' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
crossSellUnitsSold |
המדד "מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)" מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
clientAccountLeadCostOfGoodsSoldMicros |
עלות המכר בעקבות לידים (COGS) בחשבון לקוח היא העלות הכוללת של מוצרים שנמכרו כתוצאה מפרסום של אותו מוצר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר משויך (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. עלות המכר בעקבות לידים בהזמנה הזו היא 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
leadCostOfGoodsSoldMicros |
המדד "עלות המכר בעקבות לידים" מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר משויך (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא $3 וערך עלות המכר של החולצה הוא $5. עלות המכר בעקבות לידים בהזמנה הזו היא 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. פרטים על הפרמטר |
clientAccountLeadGrossProfitMicros |
המדד 'רווח ברוטו מלידים בחשבון לקוח' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 10$ וערך עלות המכר שלו הוא 3$. הרווח ברוטו מלידים בהזמנה הזו הוא 7$ = 10$ פחות 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
leadGrossProfitMicros |
המדד 'רווח ברוטו מלידים' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 10$ וערך עלות המכר שלו הוא 3$. הרווח ברוטו מלידים בהזמנה הזו הוא 7$ = 10$ פחות 3$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. פרטים על הפרמטר |
clientAccountLeadRevenueMicros |
המדד 'הכנסה מלידים בחשבון לקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 10$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
leadRevenueMicros |
המדד "הכנסה מלידים" מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מהפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג שמפרסמת כובע, ואז קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 10$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי ומוחזר במטבע של הלקוח כברירת מחדל. מידע על הפרמטר |
clientAccountLeadUnitsSold |
המדד 'יחידות שנמכרו בעקבות לידים' בחשבון לקוח מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
leadUnitsSold |
המדד 'יחידות לידים – נמכר' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שהושלמו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. |
uniqueUsers |
מספר המשתמשים הייחודיים שראו את המודעה במהלך תקופת הזמן המבוקשת. אי אפשר לצבור את המדד הזה, ואפשר לבקש אותו רק לטווח תאריכים של 92 ימים או פחות. המדד הזה זמין בסוגי הקמפיינים הבאים: קמפיינים לרשת המדיה, קמפיינים של מודעות וידאו, קמפיינים מסוג Discovery וקמפיינים לקידום אפליקציות. |
averageImpressionFrequencyPerUser |
מספר הפעמים הממוצע שמשתמש ייחודי ראה את המודעה במהלך תקופת הזמן המבוקשת. אי אפשר לצבור את המדד הזה, ואפשר לבקש אותו רק לטווח תאריכים של 92 ימים או פחות. המדד הזה זמין בסוגי הקמפיינים הבאים: קמפיינים לרשת המדיה, קמפיינים של מודעות וידאו, קמפיינים מסוג Discovery וקמפיינים לקידום אפליקציות. |
ערך
מאגר נתונים גנרי.
| ייצוג JSON |
|---|
{ // Union field |
| שדות | |
|---|---|
שדה איחוד value. ערך. הערך value יכול להיות רק אחד מהבאים: |
|
booleanValue |
ערך בוליאני. |
int64Value |
int64. |
floatValue |
מספר ממשי (float). |
doubleValue |
כפיל. |
stringValue |
מחרוזת. |
QualityScoreBucket
רשימת טיפוסים בני מנייה (enum) של משבצות ציון האיכות האפשריות.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
BELOW_AVERAGE |
איכות הקריאייטיב נמוכה מהממוצע. |
AVERAGE |
איכות הקריאייטיב היא ממוצעת. |
ABOVE_AVERAGE |
איכות הקריאייטיב גבוהה מהממוצע. |
InteractionEventType
סוגי האינטראקציות האפשריים בתשלום ובחינם.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
CLICK |
לוחצים על 'מעבר לאתר'. ברוב המקרים, האינטראקציה הזו מובילה למיקום חיצוני, בדרך כלל לדף הנחיתה של המפרסם. זו גם ברירת המחדל של InteractionEventType לאירועים מסוג קליק. |
ENGAGEMENT |
ההפניה לחיפושים עם מודעות שהמשתמש הביע לגביה כוונה ליצור אינטראקציה עם המודעה במקום. |
VIDEO_VIEW |
משתמש צפה במודעת וידאו. |
NONE |
ברירת המחדל של InteractionEventType לאירועי המרה ממודעות. השימוש בערך הזה מתבצע כששורה של המרה ממודעה לא מציינת שצריך 'לקדם' אינטראקציות חינמיות (לדוגמה, המרות ממודעות) ולדווח עליהן כחלק ממדדי הליבה. אלה פשוט המרות אחרות (שקשורות למודעות). |
פלחים
שדות של פלח בלבד.
| ייצוג JSON |
|---|
{ "adFormatType": enum ( |
| שדות | |
|---|---|
adFormatType |
סוג פורמט המודעה. |
adNetworkType |
סוג רשת המודעות. |
conversionActionCategory |
קטגוריית פעולת ההמרה. |
conversionCustomDimensions[] |
מאפיינים מותאמים אישית של המרות. |
dayOfWeek |
היום בשבוע, למשל, MONDAY. |
device |
המכשיר שאליו מתייחסים המדדים. |
keyword |
קריטריון מילות מפתח. |
productChannel |
הערוץ של המוצר. |
productChannelExclusivity |
בלעדיות בערוץ של המוצר. |
productCondition |
מצב המוצר. |
productSoldCondition |
מצב המוצר שנמכר. |
rawEventConversionDimensions[] |
מאפייני ההמרה הגולמיים ברמת האירוע. |
conversionAction |
שם המשאב של פעולת ההמרה. |
conversionActionName |
שם פעולת ההמרה. |
date |
התאריך שאליו מתייחסים המדדים. הפורמט הוא yyyy-MM-dd, לדוגמה, 2018-04-17. |
geoTargetCity |
שם המשאב של הקבוע הגיאוגרפי שמייצג עיר. |
geoTargetCountry |
שם המשאב של קבוע המיקום הגיאוגרפי שמייצג מדינה. |
geoTargetMetro |
שם המשאב של קבוע היעד הגיאוגרפי שמייצג אזור מטרופוליני. |
geoTargetPostalCode |
שם המשאב של הקבוע לטירגוט גיאוגרפי שמייצג מיקוד. |
geoTargetRegion |
שם המשאב של קבוע היעד הגיאוגרפי שמייצג אזור. |
hour |
השעה ביום כמספר בין 0 ל-23, כולל. |
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 מתחיל ב-2018-04-01. הפורמט הוא yyyy-MM-dd. |
verticalAdsEventParticipantDisplayNames |
השמות המוצגים של המשתתפים בפרטי האירוע, כמו מבצעים, דוברים או קבוצות. |
verticalAdsHotelClass |
הדירוג של המלון. בדרך כלל הדירוג הוא בין כוכב אחד ל-5 כוכבים, אבל אפשר להתאים אותו אישית בפיד המלונות. |
verticalAdsListing |
הכרטיס שמשויך לחשיפה, לקליק או להמרה של כרטיס מוצר. |
verticalAdsListingBrand |
המותג שמשויך לכרטיס מוצר ספציפי בהקשר של מודעות בענפים מסוימים, למשל המותג של השכרת רכב, בית נופש או אירוע. |
verticalAdsListingCity |
העיר שבה נמצאת כרטיסיית המוצר של המודעות לענף. |
verticalAdsListingCountry |
המדינה שבה נמצאת רשימת המוצרים בענף. |
verticalAdsListingRegion |
האזור שבו נמצאת רשימת המודעות לקידום מכירות לענף הזה. |
verticalAdsPartnerAccount |
חשבון שותף ספציפי ב-Partner Center (לדוגמה, Hotel Center) שמספק נתוני פיד של מלאי שטחי פרסום לפרסום אנכי. |
verticalAdsVertical |
סוג המודעה לתחום מסוים, כמו מודעות להשכרת נופש, להשכרת רכב או לאירועים, שמשמש לסיווג ולפילוח של נתונים בהקשר של מודעות לתחומים מסוימים. |
week |
שבוע מוגדר כשני עד ראשון, ומיוצג על ידי התאריך של יום שני. הפורמט הוא yyyy-MM-dd. |
year |
השנה, בפורמט yyyy. |
assetInteractionTarget |
המאפיין הזה משמש רק עם מדדים של CustomerAsset, CampaignAsset ו-AdGroupAsset. השדה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעה אחרת. אינטראקציות (למשל, קליקים) נספרות בכל חלקי המודעה שמוצגת (למשל, המודעה עצמה ורכיבים אחרים כמו נכסי Sitelink) כשהם מוצגים יחד. כשהערך של interactionOnThisAsset הוא true, המשמעות היא שהאינטראקציות מתרחשות בנכס הספציפי הזה. כשהערך הוא false, המשמעות היא שהאינטראקציות לא מתרחשות בנכס הספציפי הזה אלא בחלקים אחרים של המודעה שהנכס הזה מוצג בה. |
AdFormatType
מפרט את סוגי הפורמטים של Google Ads.
חשוב לזכור שהפילוח הזה זמין רק בקמפיינים בווידאו ובקמפיינים ליצירת ביקוש. במקרה של נכסים, יש תמיכה רק בנכסי וידאו.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
VERTICAL_ADS_PROMOTION |
פורמט מודעה שמקדם ישות ספציפית בתחום מסוים, למשל מודעה לקידום מלון בתחום הנסיעות בחיפוש Google. |
VERTICAL_ADS_BOOKING_LINK |
פורמט מודעה של קריאה לפעולה עם קישור להזמנה במודעה אנכית, לדוגמה, קישור 'להזמנה' במודעה של מלון. |
TEXT |
פורמט מודעת טקסט רגילה. ההגדרה הזו משמשת כרגע רק למודעות ברשת החיפוש. |
AdNetworkType
מפרט את סוגי הרשתות ב-Google Ads.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
SEARCH |
חיפוש Google. |
SEARCH_PARTNERS |
שותפי חיפוש. |
CONTENT |
רשת המדיה. |
YOUTUBE_SEARCH |
חיפוש ב-YouTube. |
YOUTUBE_WATCH |
סרטונים ב-YouTube |
MIXED |
ברשת אחרת. |
מילת מפתח
פלח של קריטריון מילת מפתח.
| ייצוג JSON |
|---|
{
"info": {
object ( |
| שדות | |
|---|---|
info |
פרטי מילת מפתח. |
adGroupCriterion |
שם המשאב AdGroupCriterion. |
ProductChannelExclusivity
סוג Enum שמתאר את הזמינות של מוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
SINGLE_CHANNEL |
הפריט נמכר רק בערוץ אחד, בחנויות מקומיות או אונליין, כפי שמצוין בערך של מאפיין ערוץ המוצר. |
MULTI_CHANNEL |
הפריט תואם לפריט המקביל בחנויות המקומיות או באינטרנט, מה שמצביע על כך שהוא זמין לרכישה בשני ערוצי המוצרים בשופינג. |
ProductCondition
סוג Enum שמתאר את מצב המוצר.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
OLD |
מצב המוצר הוא ישן. |
NEW |
מצב המוצר הוא חדש. |
REFURBISHED |
מצב המוצר הוא מחודש. |
USED |
מצב המוצר הוא משומש. |
VerticalAdsItemVerticalType
סוג Enum שמתאר את סוג הפריט של מודעות בפורמט אנכי עבור SharedSet מסוג VERTICAL_ADS_ITEM_GROUP_RULE_LIST.
| טיפוסים בני מנייה (enum) | |
|---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הפרמטר הזה משמש רק לערך ההחזרה. מייצג ערך לא ידוע בגרסה הזו. |
HOTELS |
בתי מלון בתחום הנסיעות. |
VACATION_RENTALS |
יחידות אירוח להשכרה בענף התיירות. |
RENTAL_CARS |
הנישה 'מכוניות להשכרה' בענף התיירות. |
EVENTS |
אירועים בתחום הנסיעות. |
THINGS_TO_DO |
דברים שאפשר לעשות בתחום הנסיעות. |
FLIGHTS |
טיסות בענף התיירות. |
AssetInteractionTarget
פלח של יעד אינטראקציה עם נכס.
| ייצוג JSON |
|---|
{ "asset": string, "interactionOnThisAsset": boolean } |
| שדות | |
|---|---|
asset |
שם המשאב של הנכס. |
interactionOnThisAsset |
המאפיין הזה משמש רק עם מדדים של CustomerAsset, CampaignAsset ו-AdGroupAsset. השדה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעה אחרת. |