SearchAds360Row

שורה שהוחזרה מהשאילתה.

ייצוג ב-JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
שדות
adGroup

object (AdGroup)

קבוצת המודעות שצוינה בשאילתה.
adGroupAd

object (AdGroupAd)

המודעה שצוינה בשאילתה.
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

התווית של מודעות קבוצת המודעות שצוינה בשאילתה.
adGroupAdLabel

object (AdGroupAdLabel)

תווית המודעה של קבוצת המודעות שצוינה בשאילתה.
adGroupAsset

object (AdGroupAsset)

הנכס של קבוצת המודעות שאליו מתייחסת השאילתה.
adGroupAssetSet

object (AdGroupAssetSet)

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

object (AdGroupAudienceView)

תצוגת הקהל של קבוצת המודעות שצוינה בשאילתה.
adGroupBidModifier

object (AdGroupBidModifier)

רכיב ההתאמה של הצעת המחיר שמוזכר בשאילתה.
adGroupCriterion

object (AdGroupCriterion)

הקריטריון שאליו מתייחסת השאילתה.
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

התווית היעילה של קריטריון קבוצת המודעות שצוינה בשאילתה.
adGroupCriterionLabel

object (AdGroupCriterionLabel)

התווית של קריטריון קבוצת המודעות שצוינה בשאילתה.
adGroupEffectiveLabel

object (AdGroupEffectiveLabel)

התווית היעילה של קבוצת המודעות שצוינה בשאילתה.
adGroupLabel

object (AdGroupLabel)

התווית של קבוצת המודעות שצוינה בשאילתה.
ageRangeView

object (AgeRangeView)

תצוגת טווח הגילאים שצוינה בשאילתה.
asset

object (Asset)

הנכס שאליו מתייחסת השאילתה.
assetGroupAsset

object (AssetGroupAsset)

הנכס בקבוצת הנכסים שמצוין בשאילתה.
assetGroupSignal

object (AssetGroupSignal)

האות של קבוצת הנכסים שצוין בשאילתה.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים שצוין בשאילתה.
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

תצוגת שילובי הנכסים המובילים בקבוצת הנכסים שצוינה בשאילתה.
assetGroup

object (AssetGroup)

קבוצת הנכסים שצוינה בשאילתה.
assetSetAsset

object (AssetSetAsset)

הנכס בקבוצת הנכסים שצוין בשאילתה.
assetSet

object (AssetSet)

קבוצת הנכסים שצוינה בשאילתה.
biddingStrategy

object (BiddingStrategy)

שיטת הבידינג שצוינה בשאילתה.
campaignBudget

object (CampaignBudget)

תקציב הקמפיין שאליו מתייחס השאילתה.
campaign

object (Campaign)

הקמפיין שאליו מתייחסת השאילתה.
campaignAsset

object (CampaignAsset)

נכס הקמפיין שאליו מתייחסת השאילתה.
campaignAssetSet

object (CampaignAssetSet)

קבוצת הנכסים של הקמפיין שצוינה בשאילתה.
campaignAudienceView

object (CampaignAudienceView)

תצוגת הקהל של הקמפיין שצוינה בשאילתה.
campaignCriterion

object (CampaignCriterion)

קריטריון הקמפיין שאליו מתייחסת השאילתה.
campaignEffectiveLabel

object (CampaignEffectiveLabel)

התווית של סטטוס הקמפיין שצוינה בשאילתה.
campaignLabel

object (CampaignLabel)

תווית הקמפיין שצוינה בשאילתה.
cartDataSalesView

object (CartDataSalesView)

תצוגת המכירות של נתוני עגלות הקניות שצוינה בשאילתה.
audience

object (Audience)

הקהל שאליו מתייחסת השאילתה.
conversionAction

object (ConversionAction)

פעולת ההמרה שצוינה בשאילתה.
conversionCustomVariable

object (ConversionCustomVariable)

משתנה ההמרה המותאם אישית שאליו מתייחסת השאילתה.
customer

object (Customer)

הלקוח שצוין בשאילתה.
customerAsset

object (CustomerAsset)

נכס הלקוח שאליו מתייחסת השאילתה.
customerAssetSet

object (CustomerAssetSet)

קבוצת הנכסים של הלקוח שצוינה בשאילתה.
accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

שיטת הבידינג שאפשר לגשת אליה ושצוינה בשאילתה.
customerClient

object (CustomerClient)

הלקוח CustomerClient שצוין בשאילתה.
dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

תצוגת מונחי החיפוש של המודעות הדינמיות לרשת החיפוש שצוינה בשאילתה.
genderView

object (GenderView)

תצוגת המגדר שצוינה בשאילתה.
geoTargetConstant

object (GeoTargetConstant)

הקבוע של הטירגוט הגיאוגרפי שאליו מתייחסת השאילתה.
keywordView

object (KeywordView)

תצוגת מילות המפתח שצוינה בשאילתה.
label

object (Label)

התווית שצוינה בשאילתה.
languageConstant

object (LanguageConstant)

קבוע השפה שאליו מפנה השאילתה.
locationView

object (LocationView)

תצוגת המיקום שצוינה בשאילתה.
productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

קטגוריית הבידינג של המוצר שצוינה בשאילתה.
productGroupView

object (ProductGroupView)

תצוגת קבוצת המוצרים שצוינה בשאילתה.
shoppingPerformanceView

object (ShoppingPerformanceView)

תצוגת הביצועים של שופינג שצוינה בשאילתה.
userList

object (UserList)

רשימת המשתמשים שצוינה בשאילתה.
userLocationView

object (UserLocationView)

תצוגת המיקום של המשתמש שצוינה בשאילתה.
webpageView

object (WebpageView)

תצוגת דף האינטרנט שצוינה בשאילתה.
visit

object (Visit)

הביקור ברמת האירוע שצוין בשאילתה.
conversion

object (Conversion)

ההמרה ברמת האירוע שצוינה בשאילתה.
metrics

object (Metrics)

המדדים.
segments

object (Segments)

הפלחים.
customColumns[]

object (Value)

העמודות בהתאמה אישית.

קבוצת מודעות

קבוצת מודעות.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
שדות
resourceName

string

שם המשאב של קבוצת המודעות. שמות המשאבים של קבוצות המודעות בפורמט:

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

הסטטוס של קבוצת המודעות.
type

enum (AdGroupType)

הסוג של קבוצת המודעות.
adRotationMode

enum (AdGroupAdRotationMode)

המצב של סבב המודעות בקבוצת המודעות.
creationTime

string

חותמת הזמן שבה קבוצת המודעות הזו נוצרה. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
targetingSetting

object (TargetingSetting)

הגדרה לתכונות שקשורות לטירגוט.
labels[]

string

שמות המשאבים של התוויות שמצורפות לקבוצת המודעות הזו.
effectiveLabels[]

string

שמות המשאבים של תוויות יעילות שמצורפות לקבוצת המודעות הזו. תווית יעילה היא תווית שעברה בירושה לקבוצת המודעות הזו או שהוקצה לה ישירות.
engineId

string

המזהה של קבוצת המודעות בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם של Google Ads, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. עבור ישות של Google Ads, צריך להשתמש במקום זאת ב-'adGroup.id'.
startDate

string

התאריך שבו קבוצת המודעות הזו תתחיל להציג מודעות. כברירת מחדל, קבוצת המודעות מתחילה לפעול עכשיו או בתאריך ההתחלה של קבוצת המודעות, המאוחר מביניהם. אם השדה הזה מוגדר, קבוצת המודעות תתחיל לפעול בתחילת התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ושל Facebook.

פורמט: YYYY-MM-DD דוגמה: 2019-03-14
endDate

string

התאריך שבו הצגת המודעות בקבוצת המודעות תסתיים. כברירת מחדל, קבוצת המודעות מסתיימת בתאריך הסיום שלה. אם השדה הזה מוגדר, קבוצת המודעות תסתיים בסוף התאריך שצוין באזור הזמן של הלקוח. השדה הזה זמין רק לחשבונות שער של Microsoft Advertising ושל Facebook.

פורמט: YYYY-MM-DD דוגמה: 2019-03-14
languageCode

string

השפה של המודעות ומילות המפתח בקבוצת מודעות. השדה הזה זמין רק לחשבונות Microsoft Advertising. פרטים נוספים: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage
lastModifiedTime

string

תאריך ושעה של השינוי האחרון בקבוצת המודעות הזו. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
id

string (int64 format)

המזהה של קבוצת המודעות.
name

string

השם של קבוצת המודעות.

השדה הזה נדרש ואסור שיהיה ריק כשיוצרים קבוצות מודעות חדשות.

השם חייב להכיל פחות מ-255 תווים בתקן UTF-8 ברוחב מלא.

אסור לכלול תווים של null (נקודת קוד 0x0), פיד שורה NL (נקודת קוד 0xA) או תו חזרה לתחילת השורה (נקודת קוד 0xD).
cpcBidMicros

string (int64 format)

הצעת המחיר המקסימלית לקליק (CPC).
engineStatus

enum (AdGroupEngineStatus)

סטטוס המנוע של קבוצת המודעות.

AdGroupStatus

הסטטוסים האפשריים של קבוצת מודעות.

טיפוסים בני מנייה (enum)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED קבוצת המודעות מופעלת.
PAUSED קבוצת המודעות מושהית.
REMOVED קבוצת המודעות תוסר.

AdGroupType

Enum שמפרט את הסוגים האפשריים של קבוצת מודעות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין סוג.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
SEARCH_STANDARD סוג קבוצת המודעות שמוגדר כברירת מחדל בקמפיינים לרשת החיפוש.
DISPLAY_STANDARD סוג ברירת המחדל של קבוצת מודעות בקמפיינים לרשת המדיה.
SHOPPING_PRODUCT_ADS סוג קבוצת המודעות בקמפיינים של שופינג שמוצגות בהם מודעות רגילות של מוצרים.
SHOPPING_SHOWCASE_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 (TargetRestriction)
    }
  ]
}
שדות
targetRestrictions[]

object (TargetRestriction)

ההגדרה 'לכל מאפיין טירגוט', שמאפשרת להגביל את פוטנציאל החשיפה של הקמפיין או של קבוצת המודעות.

TargetRestriction

רשימת הגדרות הטירגוט לכל מאפיין טירגוט.

ייצוג ב-JSON 
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
שדות
targetingDimension

enum (TargetingDimension)

מימד הטירגוט שאליו חלות ההגדרות האלה.
bidOnly

boolean

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

TargetingDimension

Enum שמתאר מאפייני טירגוט אפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
KEYWORD קריטריונים של מילות מפתח, לדוגמה, 'שייט למאדים'. אפשר להשתמש במאפיין KEYWORD כמאפיין בידינג בהתאמה אישית. מילות מפתח הן תמיד מאפיין טירגוט, ולכן לא ניתן להגדיר אותן כמאפיין היעד 'הכול' באמצעות TargetRestriction.
AUDIENCE קריטריונים של קהלים, כולל רשימת משתמשים, תחומי עניין של משתמשים, קהלים בהתאמה אישית עם תחום עניין משותף וקהלים בהתאמה אישית עם כוונת רכישה.
TOPIC קריטריונים של נושאים לטירגוט קטגוריות של תוכן, לדוגמה, 'category::Animals>Pets'. הקריטריונים האלה משמשים לטירגוט לרשת המדיה ולווידאו.
GENDER הקריטריונים לטירגוט לפי מגדר.
AGE_RANGE קריטריונים לטירגוט לפי טווחי גיל.
PLACEMENT קריטריונים למיקומי מודעות, שכוללים אתרים כמו 'www.flowers4sale.com', וגם אפליקציות לנייד, קטגוריות של אפליקציות לנייד, סרטוני YouTube וערוצי YouTube.
PARENTAL_STATUS הקריטריונים לטירגוט לפי סטטוס הורה.
INCOME_RANGE קריטריונים לטירגוט לפי טווח הכנסה.

AdGroupAd

מודעה בקבוצת מודעות.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
שדות
resourceName

string

שם המשאב של המודעה. שמות המשאבים של המודעות בקבוצת המודעות הם בפורמט:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}
status

enum (AdGroupAdStatus)

הסטטוס של המודעה.
ad

object (Ad)

המודעה.
creationTime

string

חותמת הזמן שבה adGroupAd הזה נוצר. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
labels[]

string

שמות המשאבים של התוויות שמצורפות למודעה בקבוצת המודעות הזו.
effectiveLabels[]

string

שמות המשאבים של התוויות הפעילות שמצורפות למודעה הזו. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות למודעה הזו.
engineId

string

המזהה של המודעה בחשבון מנוע החיפוש החיצוני. השדה הזה מיועד לחשבון Search Ads 360 בלבד, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. עבור ישות שאינה חשבון Search Ads 360, צריך להשתמש במקום זאת ב-'adGroupAd.ad.id'.
engineStatus

enum (AdGroupAdEngineStatus)

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

string

תאריך ושעה של השינוי האחרון במודעה בקבוצת המודעות הזו. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.

AdGroupAdStatus

הסטטוסים האפשריים של AdGroupAd.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED המודעה בקבוצת המודעות מופעלת.
PAUSED המודעה בקבוצת המודעות מושהית.
REMOVED המודעה בקבוצת המודעות תוסר.

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 מודעה לרישום מראש בקמפיין אוניברסלי לאפליקציה.
DISCOVERY_MULTI_ASSET_AD מודעת Discovery עם כמה נכסים.
TRAVEL_AD מודעת נסיעות.
DISCOVERY_VIDEO_RESPONSIVE_AD מודעת וידאו רספונסיבית מסוג Discovery.
MULTIMEDIA_AD מודעת מולטימדיה.

SearchAds360TextAdInfo

מודעת טקסט ב-Search Ads 360.

ייצוג ב-JSON 
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
שדות
headline

string

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

string

השורה הראשונה בתיאור המודעה.
description2

string

השורה השנייה בתיאור המודעה.
displayUrl

string

כתובת ה-URL שמוצגת במודעה.
displayMobileUrl

string

כתובת ה-URL לנייד שמוצגת במודעה.
adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

SearchAds360ExpandedTextAdInfo

מודעת טקסט מורחבת ב-Search Ads 360.

ייצוג ב-JSON 
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
שדות
headline

string

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

string

הכותרת השנייה של המודעה.
headline3

string

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

string

השורה הראשונה בתיאור המודעה.
description2

string

השורה השנייה בתיאור המודעה.
path1

string

טקסט שמצורף לכתובת ה-URL הגלויה שנוצרה באופן אוטומטי באמצעות תו מפריד.
path2

string

טקסט שמצורף ל-path1 באמצעות תו מפריד.
adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

SearchAds360ResponsiveSearchAdInfo

מודעה רספונסיבית לרשת החיפוש ב-Search Ads 360.

ייצוג ב-JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
שדות
headlines[]

object (AdTextAsset)

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

object (AdTextAsset)

רשימת נכסי טקסט לתיאורים. כשהמודעה תוצג, התיאורים ייבחרו מהרשימה הזו.
path1

string

טקסט שמצורף לכתובת ה-URL הגלויה שנוצרה באופן אוטומטי באמצעות תו מפריד.
path2

string

טקסט שמצורף ל-path1 באמצעות תו מפריד.
adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

AdTextAsset

נכס טקסט שמשמש במודעה.

ייצוג ב-JSON 
{
  "text": string
}
שדות
text

string

טקסט של נכס.

SearchAds360ProductAdInfo

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

מודעה של מוצר ב-Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

מודעת חיפוש דינמית ומורחבת.

ייצוג ב-JSON 
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
שדות
description1

string

השורה הראשונה בתיאור המודעה.
description2

string

השורה השנייה בתיאור המודעה.
adTrackingId

string (int64 format)

מזהה המעקב של המודעה.

AdGroupAdEngineStatus

מציג את הסטטוסים של מנועי AdGroupAd.

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

string

שם המשאב של התווית 'מודעה יעילה' של קבוצת המודעות. שמות המשאבים של תוויות יעילות של מודעות בקבוצת מודעות הם בפורמט: customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

המודעה בקבוצת המודעות שאליה מצורפת התווית היעילה.
label

string

התווית היעילה שהוקצתה למודעה בקבוצת המודעות.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית היעילה.

AdGroupAdLabel

קשר בין מודעה בקבוצת מודעות לבין תווית.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב של תווית המודעות של קבוצת המודעות. שמות המשאבים של תוויות המודעות של קבוצות המודעות הם בפורמט: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}
adGroupAd

string

מודעת קבוצת המודעות שאליה מצורפת התווית.
label

string

התווית שמוקצית למודעה בקבוצת המודעות.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית.

AdGroupAsset

קישור בין קבוצת מודעות לבין נכס.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
שדות
resourceName

string

שם המשאב של נכס קבוצת המודעות. שמות המשאבים מסוג AdGroupAsset הם בפורמט:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}
adGroup

string

חובה. קבוצת המודעות שאליה הנכס מקושר.
asset

string

חובה. הנכס שמקושר לקבוצת המודעות.
status

enum (AssetLinkStatus)

הסטטוס של הנכס הדיגיטלי של קבוצת המודעות.

AssetLinkStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ENABLED קישור הנכס מופעל.
REMOVED הקישור לנכס הוסר.
PAUSED קישור הנכס מושהה.

AdGroupAssetSet

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

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
שדות
resourceName

string

שם המשאב של קבוצת הנכסים של קבוצת המודעות. שמות המשאבים של קבוצת הנכסים של קבוצת המודעות הם בפורמט:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}
adGroup

string

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

string

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

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

הסטטוסים האפשריים של הקישור בין קבוצת הנכסים לבין המאגר שלה.

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

AdGroupAudienceView

תצוגה של קהל קבוצת מודעות. הדוח כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג למודעות ברשת המדיה וב-YouTube Network, ורשימות רימרקטינג למודעות לרשת החיפוש (RLSA), שמצטברים ברמת הקהל.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

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

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

מייצג מגביל של הצעת מחיר לקבוצת מודעות.

ייצוג ב-JSON 
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

שם המשאב של מגביל הצעת המחיר של קבוצת המודעות. שמות המשאבים של מגבילי הצעות המחיר של קבוצות המודעות הם בפורמט:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}
bidModifier

number

המכפיל של הצעת המחיר כשהקריטריון תואם. הערך של המשתנה המשנה צריך להיות בטווח: 0.1 עד 10.0. הטווח של PreferredContent הוא 1.0 עד 6.0. כדי לבטל את ההסכמה לשימוש בסוג מכשיר מסוים, מזינים 0.

שדה האיחוד criterion. הקריטריון של מגביל הצעת המחיר הזה של קבוצת המודעות.

חובה בפעולות יצירה החל מגרסה 5. הערך של criterion יכול להיות רק אחת מהאפשרויות הבאות:
device

object (DeviceInfo)

קריטריון למכשיר.

DeviceInfo

קריטריון למכשיר.

ייצוג ב-JSON 
{
  "type": enum (Device)
}
שדות
type

enum (Device)

סוג המכשיר.

מכשיר

מציג פירוט של המכשירים ב-Google Ads שזמינים לטירגוט.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
MOBILE מכשירים ניידים עם דפדפני אינטרנט מלאים.
TABLET טאבלטים עם דפדפנים מלאים.
DESKTOP מחשבים.
CONNECTED_TV טלוויזיות חכמות וקונסולות משחקים.
OTHER סוגי מכשירים אחרים.

AdGroupCriterion

קריטריון של קבוצת מודעות. הדוח adGroupCriterion מחזיר רק קריטריונים שנוספו במפורש לקבוצת המודעות.

ייצוג ב-JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "effectiveLabels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

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

customers/{customerId}/adGroupCriteria/{ad_group_id}~{criterionId}
creationTime

string

חותמת הזמן שבה נוצר קריטריון קבוצת המודעות הזה. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
status

enum (AdGroupCriterionStatus)

הסטטוס של הקריטריון.

זהו הסטטוס של הישות של קריטריון קבוצת המודעות, שהוגדר על ידי הלקוח. הערה: דוחות ממשק המשתמש עשויים לכלול מידע נוסף שמשפיע על האפשרות להפעיל קריטריון. במקרים מסוימים, קריטריון שהוסרה ב-API עדיין יכול להופיע כמופעל בממשק המשתמש. לדוגמה, כברירת מחדל, הקמפיינים מוצגים למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש יופיע כל טווח גילאים כ'מופעל', כי הוא עומד בדרישות להצגת המודעות. אבל ב-AdGroupCriterion.status יופיע הערך 'הוסר', כי לא נוסף קריטריון חיובי.
qualityInfo

object (QualityInfo)

מידע על איכות הקריטריון.
type

enum (CriterionType)

סוג הקריטריון.
labels[]

string

שמות המשאבים של התוויות שמצורפות לקריטריון הזה של קבוצת המודעות.
effectiveLabels[]

string

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

object (PositionEstimates)

אומדנים של הצעות מחיר לפי קריטריונים במיקומים שונים.
finalUrls[]

string

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

string

המזהה של קריטריון קבוצת המודעות בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם של Google Ads, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. עבור ישות של Google Ads, צריך להשתמש במקום זאת ב-'adGroupCriterion.criterion_id'.
lastModifiedTime

string

תאריך ושעה של השינוי האחרון בקריטריון של קבוצת המודעות. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
criterionId

string (int64 format)

המזהה של הקריטריון.
adGroup

string

קבוצת המודעות שאליה שייך הקריטריון.
negative

boolean

אם לטרגט (false) או להחריג (true) את הקריטריון.

השדה הזה לא ניתן לשינוי. כדי להפוך קריטריון מחיובי לשלילי, צריך להסיר אותו ואז להוסיף אותו מחדש.
bidModifier

number

המכפיל של הצעת המחיר כשהקריטריון תואם. הערך של המשתנה המשנה צריך להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשימוש בגורמים משנים.
cpcBidMicros

string (int64 format)

הצעת המחיר לקליק (CPC).
effectiveCpcBidMicros

string (int64 format)

הצעת המחיר בפועל לקליק (CPC).
engineStatus

enum (AdGroupCriterionEngineStatus)

סטטוס המנוע של קריטריון קבוצת המודעות.
finalUrlSuffix

string

תבנית של כתובת URL להוספת פרמטרים לכתובת ה-URL הסופית.
trackingUrlTemplate

string

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

שדה האיחוד criterion. הקריטריון של קבוצת המודעות.

צריך להגדיר רק ערך אחד. הערך של criterion יכול להיות רק אחת מהאפשרויות הבאות:
keyword

object (KeywordInfo)

מילת מפתח.
listingGroup

object (ListingGroupInfo)

קבוצת כרטיסי מוצר.
ageRange

object (AgeRangeInfo)

טווח הגילאים.
gender

object (GenderInfo)

מגדר.
userList

object (UserListInfo)

רשימת משתמשים.
webpage

object (WebpageInfo)

דף אינטרנט
location

object (LocationInfo)

מיקום.

AdGroupCriterionStatus

הסטטוסים האפשריים של AdGroupCriterion.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED הקריטריון של קבוצת המודעות מופעל.
PAUSED הקריטריון של קבוצת המודעות מושהה.
REMOVED הקריטריון של קבוצת המודעות יוסר.

QualityInfo

מאגר של מידע על איכות הקריטריונים של קבוצת המודעות.

ייצוג ב-JSON 
{
  "qualityScore": integer
}
שדות
qualityScore

integer

ציון האיכות.

יכול להיות שהשדה הזה לא יאוכלס אם ל-Google אין מספיק מידע כדי לקבוע ערך.

CriterionType

Enum שמתאר את סוגי הקריטריונים האפשריים.

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

string (int64 format)

ההערכה של הצעת המחיר לקליק (CPC) שנדרשת כדי שהמודעה תוצג בחלק העליון של הדף הראשון של תוצאות החיפוש.

AdGroupCriterionEngineStatus

מציגה את מצבי המנוע של AdGroupCriterion.

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

הוצא משימוש. אין להשתמש בו.
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN 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 הקריטריון הושעה כי החשבון מושהה.

KeywordInfo

קריטריון של מילת מפתח.

ייצוג ב-JSON 
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
שדות
matchType

enum (KeywordMatchType)

סוג ההתאמה של מילת המפתח.
text

string

הטקסט של מילת המפתח (עד 80 תווים ו-10 מילים).

KeywordMatchType

סוגי ההתאמה האפשריים למילות מפתח.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
EXACT התאמה מדויקת.
PHRASE התאמה לביטוי.
BROAD התאמה רחבה.

ListingGroupInfo

קריטריון של קבוצת כרטיסי מוצר.

ייצוג ב-JSON 
{
  "type": enum (ListingGroupType)
}
שדות
type

enum (ListingGroupType)

הסוג של קבוצת כרטיסי המוצר.

ListingGroupType

הסוג של קבוצת כרטיסי המוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SUBDIVISION חלוקה של מוצרים לפי מאפיין כלשהו של כרטיס מוצר. הצמתים האלה לא משמשים את המערכת להצגת מודעות לטירגוט רשומות של כרטיסי מוצר, אלא רק להגדרת המבנה של העץ.
UNIT יחידה של קבוצת כרטיסי מוצר שמגדירה הצעת מחיר.

AgeRangeInfo

קריטריון לטווח גילאים.

ייצוג ב-JSON 
{
  "type": enum (AgeRangeType)
}
שדות
type

enum (AgeRangeType)

הסוג של טווח הגילאים.

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 (GenderType)
}
שדות
type

enum (GenderType)

סוג המגדר.

GenderType

סוג המגדר הדמוגרפי (לדוגמה, נקבה).

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
MALE זכר.
FEMALE נקבה.
UNDETERMINED מגדר לא ידוע.

UserListInfo

קריטריון של רשימת משתמשים. מייצג רשימת משתמשים שהמפרסם הגדיר לצורכי טירגוט.

ייצוג ב-JSON 
{
  "userList": string
}
שדות
userList

string

שם המשאב של רשימת המשתמשים.

WebpageInfo

מייצג קריטריון לטירגוט דפי אינטרנט באתר של המפרסם.

ייצוג ב-JSON 
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
שדות
conditions[]

object (WebpageConditionInfo)

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

השדה הזה נדרש לפעולות CREATE ואסור לפעולות UPDATE.
coveragePercentage

number

אחוז הכיסוי של הקריטריונים לאתרים. זהו האחוז המחושב של הכיסוי של האתר על סמך יעד האתר, יעד האתר השלילי ומילות המפתח השליליות בקבוצת המודעות ובקמפיין. לדוגמה, אם הערך של הכיסוי הוא 1, המשמעות היא שיש כיסוי של 100%. השדה הזה הוא לקריאה בלבד.
criterionName

string

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

השדה הזה נדרש לפעולות CREATE ואסור לפעולות UPDATE.

WebpageConditionInfo

ביטוי לוגי לטירגוט דפי אינטרנט באתר של המפרסם.

ייצוג ב-JSON 
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
שדות
operand

enum (WebpageConditionOperand)

אופרנד של תנאי טירגוט לדף אינטרנט.
operator

enum (WebpageConditionOperator)

האופרטור של תנאי הטירגוט לדף אינטרנט.
argument

string

ארגומנט של תנאי טירגוט לדף אינטרנט.

WebpageConditionOperand

המשתנה של תנאי דף האינטרנט בקריטריון דף האינטרנט.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
URL אופרטנד שמציין תנאי טירגוט של כתובת URL של דף אינטרנט.
CATEGORY אופרטור שמציין תנאי טירגוט של קטגוריית דף אינטרנט.
PAGE_TITLE אופרטנד שמציין תנאי טירגוט של כותרת דף אינטרנט.
PAGE_CONTENT אופרטור שמציין תנאי טירגוט לפי תוכן בדף אינטרנט.
CUSTOM_LABEL אופרטנד שמציין תנאי טירגוט של תווית מותאמת אישית בדף אינטרנט.

WebpageConditionOperator

אופרטור התנאי של דף האינטרנט בקריטריון לדף אינטרנט.

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

LocationInfo

קריטריון מיקום.

ייצוג ב-JSON 
{
  "geoTargetConstant": string
}
שדות
geoTargetConstant

string

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

AdGroupCriterionEffectiveLabel

קשר בין קריטריון של קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקריטריון הזה של קבוצת המודעות.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב של התווית היעילה של קריטריון קבוצת המודעות. שמות המשאבים של תוויות יעילות של קריטריונים של קבוצות מודעות הם בפורמט: customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

קריטריון קבוצת המודעות שאליו מצורפת התווית היעילה.
label

string

התווית בפועל שהוקצתה לקריטריון של קבוצת המודעות.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית היעילה.

AdGroupCriterionLabel

קשר בין קריטריון של קבוצת מודעות לבין תווית.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב של תווית הקריטריון של קבוצת המודעות. שמות המשאבים של תוויות של קריטריונים של קבוצות מודעות הם בפורמט: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}
adGroupCriterion

string

קריטריון קבוצת המודעות שאליו מצורפת התווית.
label

string

התווית שהוקצה לקריטריון של קבוצת המודעות.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית.

AdGroupEffectiveLabel

קשר בין קבוצת מודעות לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה לקבוצת המודעות הזו או שהוקצה לה ישירות.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב של התווית היעילה של קבוצת המודעות. שמות המשאבים של תוויות יעילות של קבוצות מודעות הם בפורמט: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}
adGroup

string

קבוצת המודעות שאליה מצורפת התווית היעילה.
label

string

התווית בפועל שהוקצתה לקבוצת המודעות.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית היעילה.

AdGroupLabel

קשר בין קבוצת מודעות לבין תווית.

ייצוג ב-JSON 
{
  "resourceName": string,
  "adGroup": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב של תווית קבוצת המודעות. שמות המשאבים של תיאורי המקומות של קבוצות המודעות הם בפורמט: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}
adGroup

string

קבוצת המודעות שאליה מצורפת התווית.
label

string

התווית שמוקצית לקבוצת המודעות.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית.

AgeRangeView

תצוגה של טווח גילאים.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

שם המשאב של תצוגת טווח הגילאים. שמות המשאבים של תצוגת טווח הגילאים הם בפורמט:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

נכס

נכס הוא חלק ממודעה שאפשר לשתף בין כמה מודעות. הנכס יכול להיות תמונה (ImageAsset), סרטון (YoutubeVideoAsset) וכו'. אי אפשר לשנות את הנכסים או להסיר אותם. כדי להפסיק את הצגת נכס, מסירים אותו מהישות שמשתמשת בו.

ייצוג ב-JSON 
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
שדות
resourceName

string

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

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

סוג הנכס.
finalUrls[]

string

רשימה של כתובות URL סופיות אפשריות אחרי כל ההפניות האוטומטיות בין דומיינים.
status

enum (AssetStatus)

הסטטוס של הנכס.
creationTime

string

חותמת הזמן שבה נוצר הנכס. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
lastModifiedTime

string

תאריך ושעה של השינוי האחרון בנכס. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
id

string (int64 format)

מזהה הנכס.
name

string

שם אופציונלי של הנכס.
trackingUrlTemplate

string

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

enum (AssetEngineStatus)

סטטוס המנוע של נכס.
שדה האיחוד asset_data. הסוג הספציפי של הנכס. הערך של asset_data יכול להיות רק אחת מהאפשרויות הבאות:
youtubeVideoAsset

object (YoutubeVideoAsset)

נכס וידאו ב-YouTube.
imageAsset

object (ImageAsset)

נכס תמונות.
textAsset

object (TextAsset)

נכס טקסט.
calloutAsset

object (UnifiedCalloutAsset)

נכס יתרונות מרכזיים מאוחד.
pageFeedAsset

object (UnifiedPageFeedAsset)

נכס מאוחד של פיד דפי נחיתה.
mobileAppAsset

object (MobileAppAsset)

נכס אפליקציה לנייד.
callAsset

object (UnifiedCallAsset)

נכס התקשרות מאוחד.
callToActionAsset

object (CallToActionAsset)

נכס קריאה לפעולה.
locationAsset

object (UnifiedLocationAsset)

נכס מיקום מאוחד.

AssetType

Enum שמתאר את סוגי הנכסים האפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
YOUTUBE_VIDEO נכס וידאו ב-YouTube.
MEDIA_BUNDLE נכס חבילת מדיה.
IMAGE נכס תמונות.
TEXT נכס טקסט.
LEAD_FORM נכס השארת פרטים.
BOOK_ON_GOOGLE נכס הזמנה ב-Google.
PROMOTION נכס קידום מכירות.
CALLOUT נכס יתרונות מרכזיים.
STRUCTURED_SNIPPET נכס מידע מובנה.
PAGE_FEED נכס של פיד דפי נחיתה.
DYNAMIC_EDUCATION נכס דינמי שקשור ללימודים.
MOBILE_APP נכס אפליקציה לנייד.
HOTEL_CALLOUT נכס של יתרונות מרכזיים של מלון.
CALL נכס התקשרות.
PRICE נכס מחיר.
CALL_TO_ACTION נכס קריאה לפעולה.
DYNAMIC_REAL_ESTATE נכס אתר נדל"ן דינמי.
DYNAMIC_CUSTOM נכס דיגיטלי דינמי בהתאמה אישית.
DYNAMIC_HOTELS_AND_RENTALS נכס דיגיטלי דינמי שקשור למלונות וליחידות נופש להשכרה.
DYNAMIC_FLIGHTS נכס טיסות דינמי.
DYNAMIC_TRAVEL נכס נסיעות דינמי.
DYNAMIC_LOCAL נכס מקומי דינמי.
DYNAMIC_JOBS נכס דינמי במודעת דרושים.
LOCATION נכס מיקום.
HOTEL_PROPERTY נכס של מאפיין מלון.

AssetStatus

אלו הסטטוסים האפשריים של נכס.

טיפוסים בני מנייה (enum)
UNSPECIFIED הסטטוס לא צוין.
UNKNOWN הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד.
ENABLED הנכס מופעל.
REMOVED הנכס יוסר.
ARCHIVED הנכס הועבר לארכיון.
PENDING_SYSTEM_GENERATED הנכס נוצר על ידי המערכת בהמתנה לבדיקה על ידי משתמשים.

AssetEngineStatus

המזהה הבא = 11

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SERVING הנכס פעיל.
SERVING_LIMITED הנכס פעיל ומוגבל.
DISAPPROVED הנכס נדחה (לא עומד בדרישות).
DISABLED הנכס לא פעיל (בהמתנה).
REMOVED הנכס הוסר.

YoutubeVideoAsset

נכס ב-YouTube.

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

string

שם הסרטון ב-YouTube.
youtubeVideoId

string

מזהה סרטון ב-YouTube. זהו ערך המחרוזת בן 11 התווים שמופיע בכתובת ה-URL של הסרטון ב-YouTube.

ImageAsset

נכס תמונות.

ייצוג ב-JSON 
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
שדות
mimeType

enum (MimeType)

סוג ה-MIME של נכס התמונות.
fullSize

object (ImageDimension)

המטא-נתונים של התמונה הזו בגודל המקורי שלה.
fileSize

string (int64 format)

גודל הקובץ של נכס התמונה, בבייט.

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 של קובץ האודיו/mp3.
HTML5_AD_ZIP סוג ה-MIME של application/x-html5-ad-zip.

ImageDimension

מטא-נתונים של תמונה בגודל מסוים, המקורי או גודל ששונה.

ייצוג ב-JSON 
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
שדות
heightPixels

string (int64 format)

גובה התמונה.
widthPixels

string (int64 format)

רוחב התמונה.
url

string

כתובת URL שמציגה את התמונה בגובה וברוחב האלה.

TextAsset

נכס טקסט.

ייצוג ב-JSON 
{
  "text": string
}
שדות
text

string

תוכן הטקסט של נכס הטקסט.

UnifiedCalloutAsset

נכס יתרונות מרכזיים מאוחד.

ייצוג ב-JSON 
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
שדות
calloutText

string

הטקסט של תוסף היתרונות המרכזיים. אורך המחרוזת צריך להיות בין 1 ל-25, כולל.
startDate

string

תאריך ההתחלה שבו הנכס הזה בתוקף ואפשר להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה היה בתוקף ועדיין הוצג, בפורמט yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים לא חופפים שמציינים את כל פרקי הזמן שבהם הנכס יכול להופיע. אפשר להגדיר עד 6 תזמונים ליום, 42 בסך הכול.
useSearcherTimeZone

boolean

האם להציג את הנכס באזור הזמן של משתמש החיפוש. המידע רלוונטי ל-Microsoft Ads.

AdScheduleInfo

מייצג קריטריון של AdSchedule.

AdSchedule מצוין כיום בשבוע ומרווחי זמן שבהם המודעות יוצגו.

לא ניתן להוסיף יותר משישה לוחות זמנים לפרסום באותו יום.

ייצוג ב-JSON 
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
שדות
startMinute

enum (MinuteOfHour)

דקות אחרי שעת ההתחלה שבה מתחיל לוח הזמנים הזה.

השדה הזה נדרש לפעולות CREATE ואסור לפעולות UPDATE.
endMinute

enum (MinuteOfHour)

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

השדה הזה נדרש לפעולות CREATE ואסור לפעולות UPDATE.
dayOfWeek

enum (DayOfWeek)

היום בשבוע שבו לוח הזמנים רלוונטי.

השדה הזה נדרש לפעולות CREATE ואסור לפעולות UPDATE.
startHour

integer

שעת ההתחלה בפורמט 24 שעות. הערך בשדה הזה חייב להיות בין 0 ל-23, כולל.

השדה הזה נדרש לפעולות CREATE ואסור לפעולות UPDATE.
endHour

integer

שעת הסיום בפורמט 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 (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
שדות
linkText

string

טקסט להצגה של כתובת ה-URL ב-Sitelink. אורך המחרוזת צריך להיות בין 1 ל-25, כולל.
description1

string

השורה הראשונה של התיאור של ה-Sitelink. אם מגדירים את השדה, האורך שלו צריך להיות בין 1 ל-35 תווים, כולל, וגם צריך להגדיר את description2.
description2

string

השורה השנייה של התיאור של ה-Sitelink. אם מגדירים את השדה, האורך שלו צריך להיות בין 1 ל-35 תווים, כולל, וגם צריך להגדיר את description1.
startDate

string

תאריך ההתחלה שבו הנכס הזה בתוקף ואפשר להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה היה בתוקף ועדיין הוצג, בפורמט yyyy-MM-dd.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים לא חופפים שמציינים את כל פרקי הזמן שבהם הנכס יכול להופיע. אפשר להגדיר עד 6 תזמונים ליום, 42 בסך הכול.
trackingId

string (int64 format)

המזהה המשמש למעקב אחר קליקים בנכס ה-Sitelink. זהו חשבון Yahoo!‎ שדה ביפן בלבד.
useSearcherTimeZone

boolean

האם להציג את נכס ה-Sitelink באזור הזמן של משתמש החיפוש. המידע רלוונטי ל-Microsoft Ads.
mobilePreferred

boolean

אם הנכס מוצג במכשירים ניידים. המידע רלוונטי ל-Microsoft Ads.

UnifiedPageFeedAsset

נכס של פיד דפי נחיתה מאוחד.

ייצוג ב-JSON 
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
שדות
pageUrl

string

דף האינטרנט שהמפרסמים רוצים לטרגט.
labels[]

string

תוויות שמשמשות לקבץ את כתובות ה-URL של הדפים.

MobileAppAsset

נכס שמייצג אפליקציה לנייד.

ייצוג ב-JSON 
{
  "appId": string,
  "appStore": enum (MobileAppVendor)
}
שדות
appId

string

חובה. מחרוזת שמזהה באופן ייחודי אפליקציה לנייד. הוא צריך לכלול רק את המזהה המקורי של הפלטפורמה, כמו 'com.android.ebay' ל-Android או '12345689' ל-iOS.
appStore

enum (MobileAppVendor)

חובה. חנות האפליקציות שמפיצה את האפליקציה הספציפית הזו.

MobileAppVendor

סוג הספק של האפליקציה לנייד

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

UnifiedCallAsset

נכס התקשרות מאוחד.

ייצוג ב-JSON 
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
שדות
countryCode

string

קידומת המדינה של מספר הטלפון, שכוללת שתי אותיות. דוגמאות: 'US',‏ 'us'.
phoneNumber

string

מספר הטלפון של המפרסם ללא תווים נוספים. דוגמאות: '1234567890', '‎(123)456-7890'
callConversionReportingState

enum (CallConversionReportingState)

מציין אם CallAsset הזה צריך להשתמש בהגדרה משלו של המרה מסוג שיחה, לפעול לפי ההגדרה ברמת החשבון או להשבית את ההמרה מסוג שיחה.
callConversionAction

string

פעולת ההמרה שאליה רוצים לשייך המרה מסוג שיחה. אם לא מגדירים את המדיניות, המערכת תשתמש בפעולת ההמרה שמוגדרת כברירת מחדל. השדה הזה משפיע רק אם הערך של callConversionReportingState מוגדר כ-USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.
adScheduleTargets[]

object (AdScheduleInfo)

רשימה של לוחות זמנים לא חופפים שמציינים את כל פרקי הזמן שבהם הנכס יכול להופיע. אפשר להגדיר עד 6 תזמונים ליום, 42 בסך הכול.
callOnly

boolean

אם במודעה לשיחות בלבד מוצג רק מספר הטלפון בלי קישור לאתר. המידע רלוונטי ל-Microsoft Ads.
callTrackingEnabled

boolean

האם להפעיל את השיחה במעקב אחר שיחות. המידע רלוונטי ל-Microsoft Ads.
useSearcherTimeZone

boolean

האם להציג את תוסף השיחה באזור הזמן של משתמש החיפוש. המידע רלוונטי ל-Microsoft Ads.
startDate

string

תאריך ההתחלה שבו הנכס הזה בתוקף ואפשר להתחיל להציג אותו, בפורמט yyyy-MM-dd.
endDate

string

התאריך האחרון שבו הנכס הזה היה בתוקף ועדיין הוצג, בפורמט yyyy-MM-dd.

CallConversionReportingState

סוגי הנתונים האפשריים למצב של פעולת המרה מסוג שיחה.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DISABLED פעולת ההמרה מסוג שיחה מושבתת.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION פעולת ההמרה מסוג שיחה תשתמש בסוג ההמרה מסוג שיחה שהוגדר ברמת החשבון.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION פעולת ההמרה מסוג שיחה תשתמש בסוג ההמרה מסוג שיחה שהוגדר ברמת המשאב (מודעות לשיחות בלבד/תוספי שיחה).

CallToActionAsset

נכס קריאה לפעולה.

ייצוג ב-JSON 
{
  "callToAction": enum (CallToActionType)
}
שדות
callToAction

enum (CallToActionType)

קריאה לפעולה.

CallToActionType

טיפוס מנייה (enum) שמתאר את סוגי הקריאות לפעולה האפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LEARN_MORE סוג הקריאה לפעולה הוא 'מידע נוסף'.
GET_QUOTE סוג הקריאה לפעולה הוא 'קבלת הצעת מחיר'.
APPLY_NOW סוג הקריאה לפעולה הוא 'שליחה של בקשה'.
SIGN_UP סוג הקריאה לפעולה הוא הרשמה.
CONTACT_US סוג הקריאה לפעולה הוא 'יצירת קשר'.
SUBSCRIBE סוג הקריאה לפעולה הוא 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 (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
שדות
placeId

string

המזהה הייחודי של מקום במסד הנתונים של 'מקומות Google' ובמפות Google. השדה הזה הוא ייחודי למזהה לקוח וסוג נכס נתונים. מידע נוסף על מזהי מקומות זמין בכתובת https://developers.google.com/places/web-service/place-id.
businessProfileLocations[]

object (BusinessProfileLocation)

רשימת מיקומי העסק של הלקוח. הערך הזה יופיע רק אם נכס המיקום מסתנכרן מהחשבון בפרופיל העסק. אפשר ליצור כמה כרטיסי מוצר בפרופיל העסק באותו חשבון שמפנים לאותו מזהה מקום.
locationOwnershipType

enum (LocationOwnershipType)

סוג הבעלות על המיקום. אם הסוג הוא BUSINESS_OWNER, הוא יוצג כתוספי מיקום. אם הסוג הוא AFFILIATE, הוא יוצג כמיקום של מפיץ.

BusinessProfileLocation

נתוני המיקום של פרופיל העסק מסונכרנים מהחשבון המקושר של פרופיל העסק.

ייצוג ב-JSON 
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
שדות
labels[]

string

תווית שצוינה על ידי המפרסם למיקום בחשבון 'פרופיל העסק ב-Google'. הנתונים מסונכרנים מהחשבון של 'פרופיל העסק ב-Google'.
storeCode

string

קוד החנות בפרופיל העסק של המיקום הזה. הנתונים מסונכרנים מהחשבון של 'פרופיל העסק ב-Google'.
listingId

string (int64 format)

מזהה כרטיס המוצר של המיקום הזה בפרופיל העסק. הנתונים מסונכרנים מהחשבון המקושר של 'פרופיל העסק ב-Google'.

LocationOwnershipType

סוגי הבעלות האפשריים על מיקום.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
BUSINESS_OWNER בעלי העסק של המיקום(תוסף מיקום מדור קודם – LE).
AFFILIATE מיקום של שותף עצמאי(תוסף מיקום של צד שלישי – ALE).

AssetGroupAsset

AssetGroupAsset הוא הקישור בין נכס לקבוצת נכסים. הוספת AssetGroupAsset מקשרת נכס לקבוצת נכסים.

ייצוג ב-JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
שדות
resourceName

string

שם המשאב של נכס קבוצת הנכסים. שם המשאב של נכס בקבוצת נכסים הוא בצורה הבאה:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}
assetGroup

string

קבוצת הנכסים שאליה הנכס הזה בקבוצת הנכסים מקשר.
asset

string

הנכס שאליו הנכס בקבוצת הנכסים הזו מקושר.
fieldType

enum (AssetFieldType)

התיאור של מיקום הנכס בקבוצת הנכסים. לדוגמה: HEADLINE, ‏ YOUTUBE_VIDEO וכו'
status

enum (AssetLinkStatus)

הסטטוס של הקישור בין נכס לבין קבוצת נכסים.

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 הנכס מקושר לשימוש בתור תוסף מידע מובנה.
MOBILE_APP הנכס מקושר לשימוש בתור תוסף אפליקציה לנייד.
HOTEL_CALLOUT הנכס מקושר לשימוש בתור תוסף יתרונות מרכזיים של מלון.
CALL הנכס מקושר לשימוש בתור תוסף שיחה.
PRICE הנכס מקושר לשימוש בתור תוסף מחיר.
LONG_HEADLINE הנכס מקושר לשימוש ככותרת ארוכה.
BUSINESS_NAME הנכס מקושר לשימוש כשם עסק.
SQUARE_MARKETING_IMAGE הנכס מקושר לשימוש כתמונה שיווקית ריבועית.
PORTRAIT_MARKETING_IMAGE הנכס מקושר לשימוש כתמונה שיווקית לאורך.
VIDEO הנכס מקושר לשימוש כלוגו שאינו של YouTube.
CALL_TO_ACTION_SELECTION הנכס מקושר לשימוש לבחירת קריאה לפעולה.
AD_IMAGE הנכס מקושר לשימוש כדי לבחור תמונה של מודעה.
HOTEL_PROPERTY הנכס מקושר לשימוש כמלון בקמפיין למיקסום הביצועים לענף התיירות והאירוח.

AssetGroupSignal

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

ייצוג ב-JSON 
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
שדות
resourceName

string

שם המשאב של האות של קבוצת הנכסים. שם המשאב של האות לזיהוי קהלים בקבוצת נכסים הוא בצורה הבאה:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}
assetGroup

string

קבוצת הנכסים שאליה שייך האות הזה של קבוצת הנכסים.
שדה האיחוד signal. האות של קבוצת הנכסים. הערך של signal יכול להיות רק אחת מהאפשרויות הבאות:
audience

object (AudienceInfo)

האות לזיהוי הקהל שמשמש את הקמפיין למיקסום הביצועים.

AudienceInfo

קריטריון לקהל.

ייצוג ב-JSON 
{
  "audience": string
}
שדות
audience

string

השם של משאב הקהל.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter מייצג צומת של עץ מסנן של קבוצת כרטיסי מוצר בקבוצת נכסים.

ייצוג ב-JSON 
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
שדות
resourceName

string

שם המשאב של מסנן הקבוצות של כרטיסי המוצר בנכסים הדיגיטליים. שם המשאב של מסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים הוא בצורה הבאה:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
assetGroup

string

קבוצת הנכסים שאליה שייך מסנן הקבוצות של כרטיסי המוצר בנכסים הדיגיטליים.
id

string (int64 format)

המזהה של ListingGroupFilter.
type

enum (ListingGroupFilterType)

הסוג של צומת מסנן של קבוצת כרטיסי מוצר.
vertical

enum (ListingGroupFilterVertical)

הציר האנכי שמייצג את עץ הצמתים הנוכחי. כל הצמתים באותו עץ חייבים להיות שייכים לאותו תחום עסקי.
caseValue

object (ListingGroupFilterDimension)

ערך המאפיין שבו קבוצת כרטיסי המוצר הזו מחדדת את ההורה שלה. לא מוגדר לקבוצת הבסיס.
parentListingGroupFilter

string

שם המשאב של חלוקת המשנה של קבוצת כרטיסי המוצר הראשית. Null לצומת המסנן של קבוצת כרטיסי המוצר ברמה הבסיסית.
path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

הסוג של מסנן הקבוצה של כרטיסי המוצר.

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

ListingGroupFilterVertical

הסוג של קטגוריית המסנן של קבוצת כרטיסי המוצר.

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

ListingGroupFilterDimension

מאפייני כרטיסי מוצר במסנן קבוצות של כרטיסי מוצר בנכסים דיגיטליים.

ייצוג ב-JSON 
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
שדות
שדה האיחוד dimension. תמיד מופיע מימד מאחד מהסוגים הבאים. הערך של dimension יכול להיות רק אחת מהאפשרויות הבאות:
productBiddingCategory

object (ProductBiddingCategory)

קטגוריית הבידינג של מוצר.
productBrand

object (ProductBrand)

המותג של מוצר.
productChannel

object (ProductChannel)

המיקום של מוצר.
productCondition

object (ProductCondition)

מצב של מבצע על מוצר.
productCustomAttribute

object (ProductCustomAttribute)

מאפיין מותאם אישית של מוצר.
productItemId

object (ProductItemId)

מזהה הפריט של מבצע על מוצר.
productType

object (ProductType)

סוג המבצע על המוצר.

ProductBiddingCategory

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

ייצוג ב-JSON 
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
שדות
level

enum (ListingGroupFilterBiddingCategoryLevel)

רמת הקטגוריה בטקסונומיה.
id

string (int64 format)

המזהה של קטגוריית הבידינג של המוצר.

המזהה הזה זהה למזהה google_product_category כפי שמתואר במאמר הזה: 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

string

ערך המחרוזת של מותג המוצר.

ProductChannel

המיקום של מוצר.

ייצוג ב-JSON 
{
  "channel": enum (ListingGroupFilterProductChannel)
}
שדות
channel

enum (ListingGroupFilterProductChannel)

הערך של מקום האירוע.

ListingGroupFilterProductChannel

קבוצת ערכים שמתארת את המיקום של מוצר.

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

ProductCondition

מצב של מבצע על מוצר.

ייצוג ב-JSON 
{
  "condition": enum (ListingGroupFilterProductCondition)
}
שדות
condition

enum (ListingGroupFilterProductCondition)

הערך של התנאי.

ListingGroupFilterProductCondition

מאפיין enum שמתאר את התנאי של מוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
NEW מצב המוצר הוא חדש.
REFURBISHED מצב המוצר הוא מחודש.
USED מוצג מצב המוצר.

ProductCustomAttribute

מאפיין מותאם אישית של מוצר.

ייצוג ב-JSON 
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
שדות
index

enum (ListingGroupFilterCustomAttributeIndex)

האינדקס של המאפיין המותאם אישית.
value

string

ערך המחרוזת של המאפיין המותאם אישית של המוצר.

ListingGroupFilterCustomAttributeIndex

האינדקס של מאפייני הלקוח.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
INDEX0 המאפיין המותאם אישית הראשון של מסנן קבוצת כרטיסי המוצר.
INDEX1 מאפיין מותאם אישית שני של מסנן קבוצות של כרטיסי מוצר.
INDEX2 מאפיין מותאם אישית של מסנן שלישי של קבוצת כרטיסי מוצר.
INDEX3 המאפיין המותאם אישית הרביעי של מסנן קבוצות של כרטיסי מוצר.
INDEX4 המאפיין המותאם אישית החמישי של מסנן קבוצות של כרטיסי מוצר.

ProductItemId

מזהה הפריט של מבצע על מוצר.

ייצוג ב-JSON 
{
  "value": string
}
שדות
value

string

הערך של המזהה.

ProductType

סוג המבצע על המוצר.

ייצוג ב-JSON 
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
שדות
level

enum (ListingGroupFilterProductTypeLevel)

רמת הסוג.
value

string

הערך של הסוג.

ListingGroupFilterProductTypeLevel

מאפיין enum שמתאר את רמת הסוג של מוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
LEVEL1 רמה 1.
LEVEL2 רמה 2.
LEVEL3 רמה 3.
LEVEL4 רמה 4.
LEVEL5 רמה 5.

ListingGroupFilterDimensionPath

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

ייצוג ב-JSON 
{
  "dimensions": [
    {
      object (ListingGroupFilterDimension)
    }
  ]
}
שדות
dimensions[]

object (ListingGroupFilterDimension)

הנתיב המלא של המאפיינים דרך היררכיית המסננים של קבוצות כרטיסי המוצר (לא כולל צומת הבסיס) אל מסנן קבוצות כרטיסי המוצר הזה.

AssetGroupTopCombinationView

תצוגה של השימוש בשילובי הנכסים המובילים בקבוצת הנכסים.

ייצוג ב-JSON 
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
שדות
resourceName

string

שם המשאב בתצוגה של שילובי הנכסים המובילים בקבוצת הנכסים. שמות המשאבים של תצוגת AssetGroup Top Combination הם בפורמט: ‎"customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}"‎
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

השילובים המובילים של נכסים שמוצגים יחד.

AssetGroupAssetCombinationData

נתונים על שילובי נכסים בקבוצת נכסים

ייצוג ב-JSON 
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
שדות
assetCombinationServedAssets[]

object (AssetUsage)

נכסים שמוצגים.

AssetUsage

מכיל את נתוני השימוש בנכס.

ייצוג ב-JSON 
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
שדות
asset

string

שם המשאב של הנכס.
servedAssetFieldType

enum (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 הנכס שימש בתיאור. יש להשתמש בשדה הזה רק אם יש תיאור אחד בלבד במודעה. אחרת, צריך להשתמש במאפייני המנייה DESCRIPTION_1 או DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT הנכס שימש כתיאור בתמונה לאורך.
BUSINESS_NAME_IN_PORTRAIT הנכס שימש כשם העסק בתמונה בפורמט לאורך.
BUSINESS_NAME הנכס שימש כשם העסק.
MARKETING_IMAGE הנכס שימש כתמונה שיווקית.
MARKETING_IMAGE_IN_PORTRAIT הנכס שימש כתמונה שיווקית בתצוגה לאורך.
SQUARE_MARKETING_IMAGE הנכס שימש כתמונה שיווקית ריבועית.
PORTRAIT_MARKETING_IMAGE הנכס שימש כתמונה שיווקית בפורמט לאורך.
CALL_TO_ACTION הנכס שימש כקריאה לפעולה.
YOU_TUBE_VIDEO הנכס שימש כסרטון ב-YouTube.
CALL הנכס הזה משמש כקריאה.
MOBILE_APP הנכס הזה משמש כאפליקציה לנייד.
CALLOUT הנכס הזה משמש כיתרון מרכזי.
STRUCTURED_SNIPPET הנכס הזה משמש כקטע מידע מובנה.
PRICE הנכס הזה משמש כמחיר.
PROMOTION הנכס הזה משמש כמבצע.
AD_IMAGE הנכס הזה משמש כתמונה.
LEAD_FORM הנכס משמש כנכס להשארת פרטים.

AssetGroup

קבוצת נכסים. השדה AssetGroupAsset משמש לקישור נכס לקבוצת הנכסים. הנכס AssetGroupSignal משמש לשיוך אות לקבוצת נכסים.

ייצוג ב-JSON 
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
שדות
resourceName

string

שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצת הנכסים מופיעים בתבנית:

customers/{customerId}/assetGroups/{asset_group_id}
id

string (int64 format)

המזהה של קבוצת הנכסים.
campaign

string

הקמפיין שאליו משויך קבוצת הנכסים הזו. הנכס שמקושר לקבוצת הנכסים.
name

string

חובה. השם של קבוצת הנכסים. חובה. האורך המינימלי של השם הוא 1 והאורך המקסימלי הוא 128. השם חייב להיות ייחודי בקמפיין.
finalUrls[]

string

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

string

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

enum (AssetGroupStatus)

הסטטוס של קבוצת הנכסים.
path1

string

החלק הראשון של הטקסט שעשוי להופיע כתוספי לכתובת ה-URL שמוצגת במודעה.
path2

string

החלק השני של הטקסט שעשוי להופיע כתווספת לכתובת ה-URL שמוצגת במודעה. אפשר להגדיר את השדה הזה רק כשהשדה path1 מוגדר.
adStrength

enum (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 (AssetSetAssetStatus)
}
שדות
resourceName

string

שם המשאב של הנכס שהוגדר על ידי נכס. שמות המשאבים של נכסי קבוצת הנכסים הם בפורמט:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}
assetSet

string

קבוצת הנכסים שאליה הנכס הזה שמוגדר על ידי נכס מקשר.
asset

string

הנכס שאליו הנכס שהוגדר על ידי נכס מסוים מקושר.
status

enum (AssetSetAssetStatus)

הסטטוס של הנכס שהוגדר על ידי נכס. קריאה בלבד.

AssetSetAssetStatus

הסטטוסים האפשריים של נכס שהוגדר על ידי נכס.

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

AssetSet

קבוצת נכסים שמייצגת אוסף של נכסים. משתמשים ב-AssetSetAsset כדי לקשר נכס לקבוצת הנכסים.

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

string (int64 format)

המזהה של קבוצת הנכסים.
resourceName

string

שם המשאב של קבוצת הנכסים. שמות המשאבים של קבוצת הנכסים הם בפורמט:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

שיטת בידינג.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
שדות
resourceName

string

שם המשאב של שיטת הבידינג. שמות המשאבים של שיטות הבידינג בפורמט:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}
status

enum (BiddingStrategyStatus)

הסטטוס של שיטת הבידינג.

השדה הזה הוא לקריאה בלבד.
type

enum (BiddingStrategyType)

הסוג של שיטת הבידינג. יוצרים שיטת בידינג על ידי הגדרת תוכנית הבידינג.

השדה הזה הוא לקריאה בלבד.
currencyCode

string

המטבע שבו נעשה שימוש בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217).

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

string (int64 format)

המזהה של שיטת הבידינג.
name

string

השם של שיטת הבידינג. לכל שיטות הבידינג בחשבון צריך להיות שם ייחודי.

אורך המחרוזת הזו צריך להיות בין 1 ל-255, כולל, בייטים של UTF-8 (אחרי חיתוך).
effectiveCurrencyCode

string

המטבע שבו נעשה שימוש בשיטת הבידינג (קוד מטבע בן 3 אותיות לפי תקן ISO 4217).

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

המדדים של שיטת הבידינג מדווחים במטבע הזה.

השדה הזה הוא לקריאה בלבד.
campaignCount

string (int64 format)

מספר הקמפיינים שמשויכים לשיטת הבידינג הזו.

השדה הזה הוא לקריאה בלבד.
nonRemovedCampaignCount

string (int64 format)

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

השדה הזה הוא לקריאה בלבד.

שדה האיחוד scheme. תוכנית הבידינג.

אפשר להגדיר רק אחד. הערך של scheme יכול להיות רק אחת מהאפשרויות הבאות:
enhancedCpc

object (EnhancedCpc)

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

object (MaximizeConversionValue)

שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב.
maximizeConversions

object (MaximizeConversions)

שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.
targetCpa

object (TargetCpa)

שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
targetImpressionShare

object (TargetImpressionShare)

שיטת בידינג שמבצעת אופטימיזציה אוטומטית להשגת אחוז מסוים של חשיפות.
targetOutrankShare

object (TargetOutrankShare)

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

object (TargetRoas)

שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד ספציפי של החזר על הוצאות פרסום (ROAS).
targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

הסטטוסים האפשריים של BiddingStrategy.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED שיטת הבידינג מופעלת.
REMOVED שיטת הבידינג תוסר.

BiddingStrategyType

Enum שמתאר את הסוגים האפשריים של שיטות בידינג.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
COMMISSION 'עמלה' היא שיטת בידינג אוטומטית שבה המפרסם משלם חלק מסוים מערך ההמרה.
ENHANCED_CPC אופטימיזציית עלות לקליק (eCPC) היא שיטת בידינג שמגדילה את הצעות המחיר על קליקים שיש סיכוי גבוה יותר שיובילו להמרה ומקטינה אותן על קליקים שיש סיכוי נמוך יותר שיובילו להמרה.
INVALID משמש רק לערך המוחזר. המשמעות היא שלקמפיין לא הוגדרה שיטת בידינג. כתוצאה מכך, לא ניתן להציג מודעות מהקמפיין. לדוגמה, יכול להיות שקמפיין ישויך לשיטת בידינג של חשבון ניהול, ולאחר מכן הקישור של חשבון הצגת המודעות לחשבון הניהול יבוטל. במקרה כזה, הקמפיין ינותק באופן אוטומטי משיטת הבידינג ברמת החשבון הניהול שאי אפשר לגשת אליה, ויעבור לסוג 'שיטת בידינג לא חוקית'.
MANUAL_CPA שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שצוינה על ידו.
MANUAL_CPC בידינג ידני מבוסס-קליקים שבו המשתמש משלם לכל קליק.
MANUAL_CPM בידינג ידני מבוסס-חשיפות שבו המשתמש משלם על כל אלף חשיפות.
MANUAL_CPV שיטת בידינג שבה משלמים סכום שניתן להגדרה לכל צפייה בסרטון.
MAXIMIZE_CONVERSIONS שיטת בידינג שממקסמת באופן אוטומטי את מספר ההמרות במסגרת תקציב יומי.
MAXIMIZE_CONVERSION_VALUE שיטת בידינג אוטומטית שמגדירה הצעות מחיר באופן אוטומטי במטרה למקסם את ההכנסות תוך ניצול התקציב.
PAGE_ONE_PROMOTED שיטת בידינג של מודעות לקידום בדף הראשון, שמגדירה הצעות מחיר מקסימליות לקליק כדי לטרגט חשיפות בדף הראשון או במיקומי מודעות לקידום בדף הראשון ב-google.com. ערך המניין הזה הוצא משימוש.
PERCENT_CPC 'עלות להמרה באחוזים' היא שיטת בידינג שבה הצעות המחיר הן חלק מהמחיר המפורסם של מוצר או שירות כלשהו.
TARGET_CPA 'יעד עלות להמרה' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
TARGET_CPM יעד העלות לאלף חשיפות היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר חשיפות במסגרת יעד העלות לאלף חשיפות (CPM) שהגדרתם.
TARGET_IMPRESSION_SHARE שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של מודעות לרשת החיפוש יוצגו בחלק העליון של הדף הראשון (או במיקום אחר שמוגדרת לו טירגוט).
TARGET_OUTRANK_SHARE 'יעד נתח הובלה בדירוג' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר על סמך החלק היחסי של המכרזים שבהם המפרסם צריך לעקוף מתחרה ספציפי. ערך ה-enum הזה הוצא משימוש.
TARGET_ROAS 'יעד החזר על הוצאות פרסום (ROAS)' היא שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך שמירה על החזר ממוצע ספציפי על הוצאות הפרסום (ROAS).
TARGET_SPEND 'יעד הוצאות' היא שיטת בידינג אוטומטית שמגדירה את הצעות המחיר באופן שיעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

EnhancedCpc

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

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

שיטת הבידינג הזו הוצאה משימוש ואי אפשר ליצור אותה יותר. כדי לקבל פונקציונליות זהה, משתמשים ב-ManualCpc עם ההגדרה enhancedCpcEnabled‏ = true.

MaximizeConversionValue

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

ייצוג ב-JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
שדות
cpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר המקסימלית שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. ניתן לשנות את ההגדרה הזו רק בשיטות בידינג כוללות.
cpcBidFloorMicros

string (int64 format)

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

number

האפשרות 'יעד החזר על הוצאות פרסום (ROAS)'. אם ההגדרה הזו מוגדרת, שיטת הבידינג תעזור לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל להוציא את כל התקציב. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הגבוה ביותר על הוצאות הפרסום במסגרת התקציב.

MaximizeConversions

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

ייצוג ב-JSON 
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
שדות
cpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר המקסימלית שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. ניתן לשנות את ההגדרה הזו רק בשיטות בידינג כוללות.
cpcBidFloorMicros

string (int64 format)

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

string (int64 format)

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

TargetCpa

זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

ייצוג ב-JSON 
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
שדות
targetCpaMicros

string (int64 format)

יעד עלות ממוצעת להמרה (CPA). היעד הזה צריך להיות גדול או שווה ליחידת החיוב המינימלית, בהתאם למטבע של החשבון.
cpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר המקסימלית שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. צריך להגדיר את האפשרות הזו רק בשיטות בידינג כוללות.
cpcBidFloorMicros

string (int64 format)

סף מינימלי להצעות מחיר שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. צריך להגדיר את האפשרות הזו רק בשיטות בידינג כוללות.

TargetImpressionShare

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

ייצוג ב-JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
location

enum (TargetImpressionShareLocation)

המיקום המטורגט בדף תוצאות החיפוש.
locationFractionMicros

string (int64 format)

החלק שנבחר מתוך המודעות שיוצגו במיקום הגיאוגרפי הרצוי, בחלקיקי מיקרו. לדוגמה, 1% שווה ל-10,000.
cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Enum שמתאר את היעדים האפשריים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ANYWHERE_ON_PAGE כל מיקום בדף האינטרנט.
TOP_OF_PAGE התיבה העליונה של המודעות.
ABSOLUTE_TOP_OF_PAGE המיקום העליון בתיבה העליונה של המודעות.

TargetOutrankShare

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

ייצוג ב-JSON 
{
  "cpcBidCeilingMicros": string
}
שדות
cpcBidCeilingMicros

string (Int64Value format)

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

TargetRoas

שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד החזר ספציפי על הוצאות הפרסום (ROAS).

ייצוג ב-JSON 
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
שדות
targetRoas

number

חובה. ההכנסה שנבחרה (על סמך נתוני ההמרות) לכל יחידת הוצאה. הערך צריך להיות בין 0.01 ל-1,000.0, כולל.
cpcBidCeilingMicros

string (int64 format)

תקרת הצעות המחיר המקסימלית שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. צריך להגדיר את האפשרות הזו רק בשיטות בידינג כוללות.
cpcBidFloorMicros

string (int64 format)

סף מינימלי להצעות מחיר שאפשר להגדיר בשיטת הבידינג. המגבלה חלה על כל מילות המפתח שמנוהלות על ידי השיטה. צריך להגדיר את האפשרות הזו רק בשיטות בידינג כוללות.

TargetSpend

שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

ייצוג ב-JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
targetSpendMicros
(deprecated)

string (int64 format)

הוצאת יעד: יעד ההוצאות במסגרתו יתבצע מקסימום קליקים. מגיש הצעות מחיר לפי יעד הוצאה ינסה להוציא את הסכום הנמוך מבין הערך הזה או סכום ההוצאה הטבעי לאחר הצמצום. אם לא צוין יעד הוצאה, המערכת תשתמש בתקציב כיעד ההוצאה. השדה הזה הוצא משימוש ואין להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

תקציב קמפיין.

ייצוג ב-JSON 
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
שדות
resourceName

string

שם המשאב של תקציב הקמפיין. שמות המשאבים של תקציב הקמפיין הם בפורמט:

customers/{customerId}/campaignBudgets/{campaign_budget_id}
deliveryMethod

enum (BudgetDeliveryMethod)

שיטת ההצגה שקובעת את הקצב שבו התקציב של הקמפיין מנוצל.

אם לא צוין ערך בפעולה ליצירה, ערך ברירת המחדל הוא STANDARD.
period

enum (BudgetPeriod)

התקופה שבמהלכה התקציב ינוצל. אם לא צוין ערך, ערך ברירת המחדל הוא DAILY.
amountMicros

string (int64 format)

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

BudgetDeliveryMethod

שיטות אפשריות להקצאת תקציב.

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

BudgetPeriod

תקופת התקציב.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
DAILY תקציב יומי.
FIXED_DAILY תקציב יומי קבוע.
CUSTOM_PERIOD אפשר להשתמש בתקציב מותאם אישית עם total_amount כדי לציין את מגבלת התקציב לטווח הארוך.

קמפיין

קמפיין.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "effectiveLabels": [
    string
  ],
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
שדות
resourceName

string

שם המשאב של הקמפיין. שמות המשאבים של הקמפיינים הם בפורמט:

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

הסטטוס של הקמפיין.

כשמוסיפים קמפיין חדש, הסטטוס שמוגדר כברירת מחדל הוא 'מופעל'.
servingStatus

enum (CampaignServingStatus)

סטטוס הצגת המודעות בקמפיין.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

סטטוס המערכת של שיטת הבידינג של הקמפיין.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

סטטוס האופטימיזציה של הצגת המודעות בקמפיין.
advertisingChannelType

enum (AdvertisingChannelType)

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

השדה הזה חובה, ואסור להשאיר אותו ריק כשיוצרים קמפיינים חדשים.

אפשר להגדיר את האפשרות הזו רק בזמן יצירת הקמפיינים. אי אפשר לשנות את השדה אחרי יצירת הקמפיין.
advertisingChannelSubType

enum (AdvertisingChannelSubType)

שיפור אופציונלי ל-advertisingChannelType. חייב להיות תת-סוג חוקי של סוג הערוץ ההורה.

אפשר להגדיר את האפשרות הזו רק בזמן יצירת הקמפיינים. אי אפשר לשנות את השדה אחרי יצירת הקמפיין.
urlCustomParameters[]

object (CustomParameter)

רשימת המיפויים שמשמשים להחלפת תגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

הגדרות לבידינג בזמן אמת, תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange.
networkSettings

object (NetworkSettings)

הגדרות הרשת של הקמפיין.
dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

ההגדרה לניהול מודעות דינמיות לרשת החיפוש (DSA).
shoppingSetting

object (ShoppingSetting)

ההגדרה לניהול קמפיינים של שופינג.
geoTargetTypeSetting

object (GeoTargetTypeSetting)

ההגדרה של טירגוט גיאוגרפי של מודעות.
effectiveLabels[]

string

שמות המשאבים של התוויות הפעילות שמצורפות לקמפיין הזה. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקמפיין הזה.
labels[]

string

שמות המשאבים של התוויות שמצורפות לקמפיין הזה.
biddingStrategyType

enum (BiddingStrategyType)

הסוג של שיטת הבידינג.

אפשר ליצור שיטת בידינג על ידי הגדרת תוכנית הבידינג ליצירת שיטת בידינג רגילה, או הגדרת השדה biddingStrategy ליצירת שיטת בידינג כוללת.

השדה הזה הוא לקריאה בלבד.
accessibleBiddingStrategy

string

שם המשאב של AccessibleBiddingStrategy, תצוגה לקריאה בלבד של המאפיינים ללא הגבלה של שיטת הבידינג הכוללת המצורפת, שזוהתה באמצעות 'biddingStrategy'. ריק, אם לא מוגדרת בקמפיין שיטת בידינג כוללת. מאפייני האסטרטגיה ללא הגבלה זמינים לכל הלקוחות שאיתם האסטרטגיה משותפת, והם נקראים מהמשאב AccessibleBiddingStrategy. לעומת זאת, מאפיינים מוגבלים זמינים רק ללקוח הבעלים של האסטרטגיה ולמנהלים שלו. אפשר לקרוא מאפיינים מוגבלים רק מהמשאב BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

רשימה שמגבילה את התדירות שבה כל משתמש יראה את המודעות בקמפיין הזה.
selectiveOptimization

object (SelectiveOptimization)

הגדרת אופטימיזציה סלקטיבית בקמפיין הזה, שכוללת קבוצה של פעולות המרה שהמערכת תבצע עליהן אופטימיזציה בקמפיין הזה. התכונה הזו רלוונטית רק לקמפיינים לקידום אפליקציות שמשתמשים ב-MULTI_CHANNEL בתור AdvertisingChannelType וב-APP_CAMPAIGN או ב-APP_CAMPAIGN_FOR_ENGAGEMENT בתור AdvertisingChannelSubType.
optimizationGoalSetting

object (OptimizationGoalSetting)

הגדרת יעד האופטימיזציה של הקמפיין, שכוללת קבוצה של סוגי יעדי אופטימיזציה.
trackingSetting

object (TrackingSetting)

הגדרות ברמת הקמפיין לגבי פרטי המעקב.
engineId

string

המזהה של הקמפיין בחשבון של מנוע החיפוש החיצוני. השדה הזה מיועד רק לחשבונות שאינם של Google Ads, למשל Yahoo Japan,‏ Microsoft,‏ Baidu וכו'. עבור ישות של Google Ads, צריך להשתמש במקום זאת ב-'campaign.id'.
excludedParentAssetFieldTypes[]

enum (AssetFieldType)

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

string

חותמת הזמן שבה הקמפיין נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'. השדה createTime יוסר בגרסה 1. במקום זאת, צריך להשתמש במאפיין creationTime.
creationTime

string

חותמת הזמן שבה הקמפיין נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
lastModifiedTime

string

חותמת הזמן של מועד השינוי האחרון של הקמפיין. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
id

string (int64 format)

המזהה של הקמפיין.
name

string

השם של מסע הפרסום.

השדה הזה חובה, ואסור להשאיר אותו ריק כשיוצרים קמפיינים חדשים.

אסור לכלול תווים של null (נקודת קוד 0x0), פיד שורה NL (נקודת קוד 0xA) או תו חזרה לתחילת השורה (נקודת קוד 0xD).
trackingUrlTemplate

string

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

string

שם המשאב של תקציב הקמפיין.
startDate

string

התאריך שבו הקמפיין התחיל לפעול לפי אזור הזמן של הלקוח שמקבל את המודעות, בפורמט YYYY-MM-DD.
endDate

string

היום האחרון של הקמפיין לפי אזור הזמן של הלקוח שמקבל את המודעות, בפורמט YYYY-MM-DD. במהלך היצירה, ברירת המחדל היא 30 בדצמבר 2037, כלומר הקמפיין יפעל ללא הגבלת זמן. כדי להגדיר קמפיין קיים לפעול ללא הגבלת זמן, צריך להגדיר את השדה הזה ל-30 בדצמבר 2037.
finalUrlSuffix

string

סיומת שמשמשת להוספת פרמטרים של שאילתות לדפי נחיתה שמוצגים עם מעקב מקביל.
urlExpansionOptOut

boolean

הערך הזה מייצג ביטול ההסכמה להרחבת כתובות URL לכתובות URL ממוקדות יותר. אם ההסכמה בוטלה (true), המערכת תתמקד רק בכתובות ה-URL הסופיות בקבוצת הנכסים או בכתובות ה-URL שצוינו בפידים של פרטי העסק או ב-Google Merchant Center של המפרסם. אם הבעלים הביעו הסכמה (false), הדומיין כולו יטורגט. אפשר להגדיר את השדה הזה רק בקמפיינים למיקסום הביצועים, שבהם ערך ברירת המחדל הוא false.

שדה האיחוד campaign_bidding_strategy. שיטת הבידינג של הקמפיין.

השיטה צריכה להיות שיטת בידינג כוללת (שיצרתם באמצעות השירות BiddingStrategy) או שיטת בידינג רגילה שמוטמעת בקמפיין. הערך של campaign_bidding_strategy יכול להיות רק אחת מהאפשרויות הבאות:
biddingStrategy

string

שם המשאב של שיטת הבידינג הכוללת שמשמשת את הקמפיין.
manualCpa

object (ManualCpa)

שיטת בידינג רגילה לפי עלות ידנית להמרה. שיטת בידינג ידנית שמאפשרת למפרסם להגדיר את הצעת המחיר לכל פעולה שצוינה על ידו. התכונה נתמכת רק בקמפיינים של 'Google בעלי מקצוע'.
manualCpc

object (ManualCpc)

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

object (ManualCpm)

שיטת בידינג רגילה לפי עלות לאלף חשיפות (CPM) בשיטה ידנית. בידינג ידני מבוסס-חשיפות שבו המשתמש משלם על כל אלף חשיפות.
maximizeConversions

object (MaximizeConversions)

שיטת בידינג רגילה לפי מקסימום המרות שמגדילה באופן אוטומטי את מספר ההמרות תוך ניצול התקציב.
maximizeConversionValue

object (MaximizeConversionValue)

אסטרטגיית בידינג רגילה לפי 'מקסימום ערך המרות' שמגדירה הצעות מחיר באופן אוטומטי כדי למקסם את ההכנסות תוך ניצול התקציב.
targetCpa

object (TargetCpa)

שיטת בידינג רגילה לפי יעד עלות להמרה (CPA) שמגדירה הצעות מחיר באופן אוטומטי כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
targetImpressionShare

object (TargetImpressionShare)

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

object (TargetRoas)

שיטת בידינג רגילה לפי יעד החזר על הוצאות פרסום (ROAS) שממקסמת באופן אוטומטי את ההכנסות תוך שמירה על החזר ממוצע על הוצאות פרסום (ROAS) ספציפי.
targetSpend

object (TargetSpend)

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

object (PercentCpc)

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

object (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 הצגת המודעות עברה אופטימיזציה על סמך שיעור הקליקים בקמפיין.
CONVERSION_OPTIMIZE האופטימיזציה של הצגת המודעות מתבצעת על סמך שיעור הקליקים * המרה בקמפיין. אם הקמפיין לא מוגדר בשיטת הבידינג של כלי אופטימיזציית ההמרות, ברירת המחדל שלו תהיה 'בוצעה אופטימיזציה'.
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 קמפיינים של 'Google בעלי מקצוע'.
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, כולל רשת החיפוש, YouTube ורשת המדיה של Google.
LOCAL_CAMPAIGN קמפיינים שמתאימים במיוחד לפרסום מקומי.
SHOPPING_COMPARISON_LISTING_ADS קמפיינים של שופינג עם מודעות השוואת מוצרים.
SMART_CAMPAIGN קמפיינים חכמים רגילים.
VIDEO_SEQUENCE קמפיינים של מודעות וידאו עם סדרת מודעות וידאו.
APP_CAMPAIGN_FOR_PRE_REGISTRATION קמפיין לקידום אפליקציה לקראת רישום מראש, שמתמקד בפרסום של רישום מראש לאפליקציות לנייד, ושמטרגט כמה ערוצי פרסום ב-Google Play, ב-YouTube וברשת המדיה.
VIDEO_REACH_TARGET_FREQUENCY קמפיין וידאו להגדלת פוטנציאל החשיפה עם שיטת בידינג לפי תדירות טירגוט.
TRAVEL_ACTIVITIES קמפיינים ל-Google נסיעות בנושא פעילויות.
SOCIAL_FACEBOOK_TRACKING_ONLY מעקב של Facebook רק בקמפיינים ברשתות החברתיות.

CustomParameter

מיפוי שאפשר להשתמש בו בתגי פרמטרים מותאמים אישית ב-trackingUrlTemplate, ב-finalUrls או ב-mobile_final_urls.

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

string

המפתח התואם לשם תג הפרמטר.
value

string

הערך שרוצים להחליף.

RealTimeBiddingSetting

הגדרות לבידינג בזמן אמת, תכונה שזמינה רק בקמפיינים שמטרגטים לרשת Ad Exchange.

ייצוג ב-JSON 
{
  "optIn": boolean
}
שדות
optIn

boolean

אם הקמפיין הוגדר לבידינג בזמן אמת.

NetworkSettings

הגדרות הרשת של הקמפיין.

ייצוג ב-JSON 
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean
}
שדות
targetSearchNetwork

boolean

אם המודעות יוצגו באתרים של שותפים ברשת החיפוש של Google (נדרש שהערך של targetGoogleSearch יהיה גם true).
targetContentNetwork

boolean

אם המודעות יוצגו במיקומי מודעות ספציפיים ברשת המדיה של Google. מיקומי המודעות מצוינים באמצעות קריטריון מיקום המודעה.
targetPartnerSearchNetwork

boolean

אם המודעות יוצגו ברשת שותפי Google. האפשרות הזו זמינה רק בחלק מחשבונות השותפים של Google.

DynamicSearchAdsSetting

ההגדרה לניהול מודעות דינמיות לרשת החיפוש (DSA).

ייצוג ב-JSON 
{
  "domainName": string,
  "languageCode": string,
  "useSuppliedUrlsOnly": boolean
}
שדות
domainName

string

חובה. שם הדומיין באינטרנט שההגדרה הזו מייצגת, למשל google.com או www.google.com.
languageCode

string

חובה. קוד השפה שמציין את שפת הדומיין, לדוגמה 'iw'.
useSuppliedUrlsOnly

boolean

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

ShoppingSetting

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

ייצוג ב-JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
שדות
feedLabel

string

תווית הפיד של המוצרים שרוצים לכלול בקמפיין. אפשר להגדיר רק אחד מהשדות feedLabel או salesCountry. אם משתמשים בשדה feedLabel במקום בשדה salesCountry, אפשר להזין בו קודי מדינות באותו פורמט. לדוגמה: 'XX'. אחרת, יכולה להיות כל מחרוזת שמשמשת לתווית פיד ב-Google Merchant Center.
useVehicleInventory

boolean

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

string (int64 format)

המזהה של חשבון Merchant Center. השדה הזה נדרש לפעולות יצירה. אי אפשר לשנות את השדה הזה בקמפיינים של שופינג.
salesCountry

string

מדינת המכירה של המוצרים שרוצים לכלול בקמפיין.
campaignPriority

integer

עדיפות הקמפיין. קמפיינים עם עדיפות גבוהה יותר מבחינה מספרית מקבלים עדיפות על פני קמפיינים עם עדיפות נמוכה יותר. השדה הזה נדרש בקמפיינים של שופינג, והערכים שלו יכולים להיות בין 0 ל-2, כולל. השדה הזה הוא אופציונלי בקמפיינים חכמים לשופינג, אבל אם מגדירים אותו, הוא חייב להיות שווה ל-3.
enableLocal

boolean

האם לכלול מוצרים בחנויות מקומיות.

GeoTargetTypeSetting

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

ייצוג ב-JSON 
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
שדות
positiveGeoTargetType

enum (PositiveGeoTargetType)

ההגדרה שמשמשת לטירגוט גיאוגרפי חיובי בקמפיין הספציפי הזה.
negativeGeoTargetType

enum (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[]

string

קבוצת שמות המשאבים שנבחרו לפעולות ההמרה לצורך אופטימיזציה של הקמפיין הזה.

OptimizationGoalSetting

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

ייצוג ב-JSON 
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
שדות
optimizationGoalTypes[]

enum (OptimizationGoalType)

רשימת סוגי יעדי האופטימיזציה.

OptimizationGoalType

סוג יעד האופטימיזציה

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש כערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו.
CALL_CLICKS מבצעים אופטימיזציה לקבלת יותר קליקים למודעות לשיחות. המרות מקליקים לשיחות הן מקרים שבהם אנשים בחרו באפשרות 'שיחה' כדי ליצור קשר עם חנות אחרי צפייה במודעה.
DRIVING_DIRECTIONS אופטימיזציה למסלולי נסיעה. המרות מסוג מסלול הגעה ברכב הן מקרים שבהם אנשים בחרו באפשרות 'קבלת מסלול' כדי לנווט לחנות אחרי צפייה במודעה.
APP_PRE_REGISTRATION מבצעים אופטימיזציה להגדלת מספר ההרשמות מראש. המרות מרישום מראש הן מספר ההרשמות מראש לקבלת התראה כשהאפליקציה תושק.

TrackingSetting

הגדרות ברמת הקמפיין לגבי פרטי המעקב.

ייצוג ב-JSON 
{
  "trackingUrl": string
}
שדות
trackingUrl

string

כתובת ה-URL שמשמשת למעקב דינמי.

ManualCpa

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

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

ManualCpc

בידינג ידני מבוסס-קליקים שבו המשתמש משלם לכל קליק.

ייצוג ב-JSON 
{
  "enhancedCpcEnabled": boolean
}
שדות
enhancedCpcEnabled

boolean

האם הצעות המחיר ישופרו על סמך נתונים מכלי אופטימיזציית ההמרות.

ManualCpm

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

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

PercentCpc

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

ייצוג ב-JSON 
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
שדות
cpcBidCeilingMicros

string (int64 format)

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

boolean

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

TargetCpm

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

'יעד עלות לאלף חשיפות' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לבצע אופטימיזציה של הביצועים בהתאם ליעד העלות לאלף חשיפות שהגדרתם.

CampaignAsset

קישור בין קמפיין לנכס.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
שדות
resourceName

string

שם המשאב של נכס הקמפיין. שמות המשאבים מסוג CampaignAsset הם בפורמט:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}
status

enum (AssetLinkStatus)

הסטטוס של נכס הקמפיין.
campaign

string

הקמפיין שאליו הנכס מקושר.
asset

string

הנכס שמקושר לקמפיין.

CampaignAssetSet

CampaignAssetSet הוא הקישור בין קמפיין לקבוצת נכסים. הוספת CampaignAssetSet מקשרת קבוצת נכסים לקמפיין.

ייצוג ב-JSON 
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
שדות
resourceName

string

שם המשאב של קבוצת הנכסים של הקמפיין. שמות המשאבים של נכסי קבוצת הנכסים הם בפורמט:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}
campaign

string

הקמפיין שאליו מקושר קבוצת הנכסים הזו.
assetSet

string

קבוצת הנכסים שמקושרת לקמפיין.
status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

תצוגה של קהל בקמפיין. הדוח כולל נתוני ביצועים מתחומי עניין ורשימות רימרקטינג של מודעות ברשת המדיה וב-YouTube Network, ורשימות רימרקטינג של מודעות לרשת החיפוש (RLSA), שמצטברים לפי קמפיין וקריטריון קהל. התצוגה הזו כוללת רק קהלים שצורפו ברמת הקמפיין.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

שם המשאב של תצוגת הקהל בקמפיין. שמות המשאבים של תצוגת הקהל בקמפיין הם בפורמט:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

קריטריון קמפיין.

ייצוג ב-JSON 
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
שדות
resourceName

string

שם המשאב של קריטריון הקמפיין. שמות המשאבים של קריטריונים בקמפיינים הם בפורמט:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}
displayName

string

שם התצוגה של הקריטריון.

המערכת מתעלמת מהשדה הזה בפעולות שינוי (mutate).
type

enum (CriterionType)

סוג הקריטריון.
status

enum (CampaignCriterionStatus)

הסטטוס של הקריטריון.
lastModifiedTime

string

תאריך ושעה של השינוי האחרון של קריטריון הקמפיין הזה. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
criterionId

string (int64 format)

המזהה של הקריטריון.

המערכת מתעלמת מהשדה הזה במהלך הטרנספורמציה.
bidModifier

number

המכפיל של הצעות המחיר כשהקריטריון תואם. הערך של המשתנה המשנה צריך להיות בטווח: 0.1 עד 10.0. רוב סוגי הקריטריונים לטירגוט תומכים בשימוש בגורמים משנים. כדי לבטל את ההסכמה לשימוש בסוג מכשיר מסוים, מזינים 0.
negative

boolean

אם לטרגט (false) או להחריג (true) את הקריטריון.

שדה האיחוד criterion. קריטריון הקמפיין.

צריך להגדיר רק ערך אחד. הערך של criterion יכול להיות רק אחת מהאפשרויות הבאות:
keyword

object (KeywordInfo)

מילת מפתח.
location

object (LocationInfo)

מיקום.
device

object (DeviceInfo)

מכשיר.
ageRange

object (AgeRangeInfo)

טווח הגילאים.
gender

object (GenderInfo)

מגדר.
userList

object (UserListInfo)

רשימת משתמשים.
language

object (LanguageInfo)

שפה.
webpage

object (WebpageInfo)

דף אינטרנט.
locationGroup

object (LocationGroupInfo)

קבוצת מיקומים

CampaignCriterionStatus

הסטטוסים האפשריים של CampaignCriterion.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED קריטריון הקמפיין מופעל.
PAUSED קריטריון הקמפיין מושהה.
REMOVED קריטריון הקמפיין יוסר.

LanguageInfo

קריטריון שפה.

ייצוג ב-JSON 
{
  "languageConstant": string
}
שדות
languageConstant

string

שם המשאב של קבוע השפה.

LocationGroupInfo

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

ייצוג ב-JSON 
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
שדות
geoTargetConstants[]

string

קבועים של טירגוט גיאוגרפי שמגבילים את היקף האזור הגיאוגרפי בפיד. בשלב זה מותר להשתמש רק בקבוע גיאו-טירגוט אחד.
radiusUnits

enum (LocationGroupRadiusUnits)

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

string

קבוצות של פריטי פיד שהפריטים שלהן בפיד מטרגטים. אם מציינים כמה מזהים, כל הפריטים שמופיעים בקבוצה אחת לפחות יטרגטו. לא ניתן להשתמש בשדה הזה עם geoTargetConstants. השדה הזה הוא אופציונלי וניתן להגדיר אותו רק בפעולות CREATE.
radius

string (int64 format)

המרחק ביחידות שצוין לרדיוס סביב המיקומים הגיאוגרפיים המדוברים. השדה הזה נדרש וצריך להגדיר אותו בפעולות CREATE.

LocationGroupRadiusUnits

יחידת המרחק של הרדיוס בקבוצת המיקומים (לדוגמה, קילומטרים)

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
METERS מטרים
MILES מיילים
MILLI_MILES מילי מייל

CampaignEffectiveLabel

מייצג קשר בין קמפיין לבין תווית יעילה. תווית יעילה היא תווית שעברה בירושה או הוקצתה ישירות לקמפיין הזה.

ייצוג ב-JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב. שמות המשאבים של CampaignEffectivelabel הם בפורמט: customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

הקמפיין שאליו מצורפת התווית היעילה.
label

string

התווית בפועל שהוקצה לקמפיין.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית היעילה.

CampaignLabel

מייצג קשר בין קמפיין לבין תווית.

ייצוג ב-JSON 
{
  "resourceName": string,
  "campaign": string,
  "label": string,
  "ownerCustomerId": string
}
שדות
resourceName

string

שם המשאב. שמות המשאבים של תוויות הקמפיינים הם בפורמט: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

הקמפיין שאליו מצורפת התווית.
label

string

התווית שהוקצה לקמפיין.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו התווית.

CartDataSalesView

תצוגת המכירות של נתוני עגלות הקניות.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

שם המשאב של תצוגת המכירות של נתוני עגלות הקניות. שמות המשאבים בתצוגת המכירות של נתוני עגלות הקניות הם בפורמט: customers/{customerId}/cartDataSalesView

קהל

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

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

string

שם המשאב של הקהל. שמות הקהלים מופיעים בתבנית:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

המזהה של הקהל.
name

string

חובה. שם הקהל. הוא צריך להיות ייחודי לכל הקהלים. האורך המינימלי של השדה הוא 1 והאורך המקסימלי הוא 255.
description

string

תיאור הקהל.

ConversionAction

פעולת המרה.

ייצוג ב-JSON 
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
שדות
resourceName

string

שם המשאב של פעולת ההמרה. שמות המשאבים של פעולות ההמרה מופיעים בתבנית:

customers/{customerId}/conversionActions/{conversion_action_id}
creationTime

string

חותמת הזמן של יצירת הפעילות ב-Floodlight, בפורמט ISO 8601.
status

enum (ConversionActionStatus)

הסטטוס של פעולת ההמרה הזו לצורך צבירת אירועי המרה.
type

enum (ConversionActionType)

הסוג של פעולת ההמרה הזו.
category

enum (ConversionActionCategory)

הקטגוריה של ההמרות שדוּוחו לגבי פעולת ההמרה הזו.
valueSettings

object (ValueSettings)

הגדרות שקשורות לערך של אירועי ההמרה המשויכים לפעולת ההמרה הזו.
attributionModelSettings

object (AttributionModelSettings)

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.
floodlightSettings

object (FloodlightSettings)

הגדרות Floodlight לסוגי המרות ב-Floodlight.
id

string (int64 format)

המזהה של פעולת ההמרה.
name

string

השם של פעולת ההמרה.

השדה הזה הוא חובה, ואסור להשאיר אותו ריק כשיוצרים פעולות המרה חדשות.
primaryForGoal

boolean

אם הבייט primaryForGoal של פעולת המרה הוא false, לא ניתן להגיש עליה הצעות מחיר בכל הקמפיינים, ללא קשר ליעד ההמרה של הלקוח או ליעד ההמרה של הקמפיין. עם זאת, יעדים מותאמים אישית של המרות לא מתייחסים ל-primaryForGoal, כך שאם בקמפיין מוגדר יעד המרה מותאם אישית עם פעולת המרה שהגדרתה כ-primaryForGoal = false, עדיין אפשר להגיש עליה הצעות מחיר. כברירת מחדל, אם לא תגדירו את הפרמטר primaryForGoal, הערך שלו יהיה true. בגרסה 9, אפשר להגדיר את primaryForGoal כ-false רק אחרי היצירה באמצעות פעולת 'update', כי הוא לא מוגדר כאופציונלי.
ownerCustomer

string

שם המשאב של הלקוח הבעלים של פעולת ההמרה, או null אם מדובר בפעולת המרה שהוגדרה על ידי המערכת.
includeInClientAccountConversionsMetric

boolean

האם פעולת ההמרה הזו צריכה להיכלל במדד 'clientAccountConversions'.
includeInConversionsMetric

boolean

האם פעולת ההמרה הזו צריכה להיכלל במדד 'המרות'.
clickThroughLookbackWindowDays

string (int64 format)

המספר המקסימלי של ימים שיכולים לחלוף בין אינטראקציה (למשל, קליק) לבין אירוע המרה.
appId

string

מזהה האפליקציה של פעולת המרה באפליקציה.

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 המרה מסוג מכירות בחנות הפיזית שמבוססת על העלאות של נתוני מוכרים מאינטראקציה ישירה (First-Party) או מצד שלישי. רק לקוחות שנמצאים ברשימת ההיתרים יכולים להשתמש בסוגי העלאה ישירה של מכירות בחנות.
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 יוסר וייוחלף בשיטה משופרת לייבוא המרות מ-Salesforce. - מידע נוסף זמין במאמר https://support.google.com/google-ads/answer/14728349
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

number

הערך שבו המערכת תשתמש כשאירועי המרה של פעולת ההמרה הזו יישלחו עם ערך לא חוקי, לא מורשה או חסר, או כשפעולת ההמרה הזו מוגדרת תמיד להשתמש בערך ברירת המחדל.
defaultCurrencyCode

string

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

boolean

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

AttributionModelSettings

הגדרות שקשורות למודל השיוך של פעולת ההמרה הזו.

ייצוג ב-JSON 
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
שדות
attributionModel

enum (AttributionModel)

סוג מודל השיוך של פעולת ההמרה הזו.
dataDrivenModelStatus

enum (DataDrivenModelStatus)

הסטטוס של מודל השיוך מבוסס-הנתונים לפעולת ההמרה.

AttributionModel

מודל השיוך שמתאר איך לחלק את הקרדיט על המרה מסוימת בין אינטראקציות קודמות רבות.

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

string

מחרוזת שמשמשת לזיהוי קבוצת פעילות ב-Floodlight בדיווח על המרות.
activityTag

string

מחרוזת שמשמשת לזיהוי פעילות ב-Floodlight בדיווח על המרות.
activityId

string (int64 format)

המזהה של הפעילות ב-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 (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
שדות
resourceName

string

שם המשאב של המשתנה המותאם אישית של ההמרה. השמות של משאבי המשתנים המותאמים אישית של ההמרות הם בפורמט:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}
id

string (int64 format)

המזהה של משתנה ההמרה המותאם אישית.
name

string

חובה. השם של המשתנה המותאם אישית של ההמרה. השם צריך להיות ייחודי. האורך המקסימלי של השם הוא 100 תווים. אסור להוסיף רווחים מיותרים בתחילתו של השם ובסופו.
tag

string

חובה. התג של המשתנה המותאם אישית של ההמרה. התג צריך להיות ייחודי ולהיפתח בתו u ולאחריו מספר שקטן מ-100 או שווה לו. לדוגמה: 'u4'.
status

enum (ConversionCustomVariableStatus)

הסטטוס של המשתנה המותאם אישית של ההמרה לצורך צבירת אירועי המרה.
ownerCustomer

string

שם המשאב של הלקוח שבבעלותו המשתנה המותאם אישית של ההמרה.
family

enum (ConversionCustomVariableFamily)

המשפחה של משתנה ההמרה המותאם אישית.
cardinality

enum (ConversionCustomVariableCardinality)

העוצמה של משתנה ההמרה המותאם אישית.
floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

שדות למשתנים מותאמים אישית של המרות ב-Floodlight ב-Search Ads 360.
customColumnIds[]

string (int64 format)

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

ConversionCustomVariableStatus

הסטטוסים האפשריים של משתנה המרה מותאם אישית.

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

משתנה ההמרה המותאם אישית בהמתנה להפעלה, והנתונים הסטטיסטיים שלו לא יצברו עד שיוגדר כ'מופעל'.

אי אפשר להשתמש בסטטוס הזה בבקשות CREATE ו-UPDATE.
ENABLED המשתנה המותאם אישית של ההמרה מופעל ויצבור נתונים סטטיסטיים.
PAUSED המשתנה המותאם אישית של ההמרה יושהה ולא יצטברו נתונים סטטיסטיים עד להגדרה מחדש של המצב שלו ל'מופעל'.

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),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
שדות
floodlightVariableType

enum (FloodlightVariableType)

סוג המשתנה ב-Floodlight שמוגדר ב-Search Ads 360.
floodlightVariableDataType

enum (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 מסוג 'מחרוזת'. אפשר להקצות את המשתנה הזה למשתני Floodlight מסוג מאפיין.

לקוח

לקוח/ה.

ייצוג ב-JSON 
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
שדות
resourceName

string

שם המשאב של הלקוח. שמות המשאבים של הלקוחות מופיעים בתבנית:

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

הגדרת מעקב המרות ללקוח.
accountType

enum (AccountType)

סוג חשבון מנוע החיפוש, לדוגמה, Google Ads,‏ Microsoft Advertising,‏ Yahoo Japan,‏ Baidu,‏ Facebook,‏ Engine Track וכו'.
doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

הגדרה ב-DoubleClick Campaign Manager (DCM) ללקוח ניהול.
accountStatus

enum (AccountStatus)

סטטוס החשבון, למשל: מופעל, מושהה, הוסר וכו'.
lastModifiedTime

string

חותמת הזמן של מועד השינוי האחרון של הלקוח. תאריך ושעה לפי אזור הזמן של הלקוח, בפורמט 'yyyy-MM-dd HH:mm:ss.ssssss'.
engineId

string

המזהה של החשבון בחשבון של מנוע החיפוש החיצוני.
status

enum (CustomerStatus)

הסטטוס של הלקוח.
creationTime

string

חותמת הזמן שבה הלקוח הזה נוצר. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
managerId

string (int64 format)

מספר הלקוח של חשבון הניהול. ערך 0 מציין שללקוח אין חשבון ניהול ב-SA360.
managerDescriptiveName

string

השם התיאורי של המנהל.
subManagerId

string (int64 format)

מספר הלקוח של חשבון הניהול המשני. ערך 0 מציין שללקוח אין חשבון ניהול משני ב-SA360.
subManagerDescriptiveName

string

השם התיאורי של חשבון הניהול המשני.
associateManagerId

string (int64 format)

מספר הלקוח של חשבון הניהול המשני. ערך 0 מציין שללקוח אין מנהל שותף ב-SA360.
associateManagerDescriptiveName

string

השם התיאורי של מנהל השותף.
accountLevel

enum (AccountLevelType)

רמת החשבון של הלקוח: חשבון ניהול, חשבון ניהול משני, חשבון ניהול משני לשותפים, חשבון שירות.
id

string (int64 format)

המזהה של הלקוח.
descriptiveName

string

שם תיאורי אופציונלי ולא ייחודי של הלקוח.
currencyCode

string

המטבע שבו פועל החשבון. יש תמיכה בקבוצת משנה של קודי המטבעות מהתקן ISO 4217.
timeZone

string

מזהה אזור הזמן המקומי של הלקוח.
trackingUrlTemplate

string

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

string

תבנית כתובת ה-URL להוספת פרמטרים לכתובת ה-URL הסופית.
autoTaggingEnabled

boolean

האם התיוג האוטומטי מופעל אצל הלקוח.
manager

boolean

האם הלקוח הוא מנהל.

ConversionTrackingSetting

אוסף של הגדרות ברמת הלקוח שקשורות למעקב ההמרות ב-Search Ads 360.

ייצוג ב-JSON 
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
שדות
acceptedCustomerDataTerms

boolean

אם הלקוח אישר את התנאים בנוגע לנתונים של לקוחות. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהחשבון הניהול. השדה הזה הוא לקריאה בלבד. מידע נוסף זמין בכתובת https://support.google.com/adspolicy/answer/7475709.
conversionTrackingStatus

enum (ConversionTrackingStatus)

סטטוס מעקב ההמרות. הוא מציין אם הלקוח משתמש במעקב המרות, ומי הבעלים של מעקב ההמרות של הלקוח הזה. אם הלקוח הזה משתמש במעקב המרות ברמת חשבון ניהול, הערך המוחזר ישתנה בהתאם ל-login-customer-id של הבקשה.
enhancedConversionsForLeadsEnabled

boolean

אם הלקוח הביע הסכמה לשימוש בתכונה 'המרות משופרות לצורך שיוך ללידים'. אם משתמשים במעקב המרות ברמת חשבון ניהול, הערך הזה עובר בירושה מהחשבון הניהול. השדה הזה הוא לקריאה בלבד.
googleAdsConversionCustomer

string

שם המשאב של הלקוח שבו נוצרות ומנוהלות ההמרות. השדה הזה הוא לקריאה בלבד.
conversionTrackingId

string (int64 format)

מזהה מעקב ההמרות שמשמש את החשבון הזה. המזהה הזה לא מציין אם הלקוח משתמש במעקב המרות (המזהה conversionTrackingStatus מציין זאת). השדה הזה הוא לקריאה בלבד.
googleAdsCrossAccountConversionTrackingId

string (int64 format)

מזהה מעקב ההמרות של חשבון הניהול של הלקוח. הערך הזה מוגדר כשהלקוח הביע הסכמה למעקב המרות, והוא מבטל את הערך של conversionTrackingId. אפשר לנהל את השדה הזה רק דרך ממשק המשתמש של Google Ads. השדה הזה הוא לקריאה בלבד.
crossAccountConversionTrackingId

string (int64 format)

מזהה מעקב ההמרות של חשבון הניהול של הלקוח. הערך הזה מוגדר כשהלקוח הביע הסכמה למעקב המרות ברמת חשבון ניהול, והוא מבטל את הערך של 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.
FACEBOOK_GATEWAY חשבון Facebook שמנוהל דרך שער.
GOOGLE_ADS חשבון Google Ads.
MICROSOFT חשבון Microsoft Advertising.
SEARCH_ADS_360 חשבון ניהול ב-Search Ads 360.
YAHOO_JAPAN חשבון Yahoo Japan.

DoubleClickCampaignManagerSetting

הגדרה ב-DoubleClick Campaign Manager (DCM) ללקוח ניהול.

ייצוג ב-JSON 
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
שדות
advertiserId

string (int64 format)

המזהה של המפרסם ב-Campaign Manager שמשויך ללקוח הזה.
networkId

string (int64 format)

המזהה של הרשת ב-Campaign Manager שמשויכת ללקוח הזה.
timeZone

string

אזור הזמן של הרשת ב-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 חשבון לקוח (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 (AssetLinkStatus)
}
שדות
resourceName

string

שם המשאב של נכס הלקוח. שמות המשאבים מסוג CustomerAsset הם בפורמט:

customers/{customerId}/customerAssets/{assetId}~{fieldType}
asset

string

חובה. הנכס שמקושר ללקוח.
status

enum (AssetLinkStatus)

הסטטוס של הנכס הדיגיטלי של הלקוח.

CustomerAssetSet

CustomerAssetSet הוא הקישור בין לקוח לבין קבוצת נכסים. הוספת CustomerAssetSet מקשרת קבוצת נכסים ללקוח.

ייצוג ב-JSON 
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
שדות
resourceName

string

שם המשאב של קבוצת הנכסים של הלקוח. שמות המשאבים של נכסי קבוצת הנכסים הם בפורמט:

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

קבוצת הנכסים שמקושרת ללקוח.
customer

string

הלקוח שאליו מקושר קבוצת הנכסים הזו.
status

enum (AssetSetLinkStatus)

הסטטוס של הנכס בקבוצת הנכסים הדיגיטליים של הלקוח. קריאה בלבד.

AccessibleBiddingStrategy

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

בניגוד ל-BiddingStrategy, המשאב הזה כולל אסטרטגיות שבבעלות מנהלי הלקוח ומשותפות עם הלקוח הזה – בנוסף לאסטרטגיות שבבעלות הלקוח הזה. המשאב הזה לא מספק מדדים, והוא חושף רק קבוצת משנה מוגבלת של המאפיינים של שיטת הבידינג.

ייצוג ב-JSON 
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
שדות
resourceName

string

שם המשאב של שיטת הבידינג הנגישה. שמות המשאבים של AccessibleBiddingStrategy מופיעים בפורמט:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

המזהה של שיטת הבידינג.
name

string

השם של שיטת הבידינג.
type

enum (BiddingStrategyType)

הסוג של שיטת הבידינג.
ownerCustomerId

string (int64 format)

המזהה של הלקוח שבבעלותו אסטרטגיית הבידינג.
ownerDescriptiveName

string

השם המפורט של הלקוח שבבעלותו שיטת הבידינג.

שדה האיחוד scheme. תוכנית הבידינג.

אפשר להגדיר רק אחד. הערך של scheme יכול להיות רק אחת מהאפשרויות הבאות:
maximizeConversionValue

object (MaximizeConversionValue)

שיטת בידינג אוטומטית שעוזרת לכם להשיג את ערך ההמרה הגבוה ביותר מהקמפיינים שלכם במסגרת התקציב.
maximizeConversions

object (MaximizeConversions)

שיטת בידינג אוטומטית שיעזרו לכם להשיג כמה שיותר המרות בקמפיינים במסגרת התקציב.
targetCpa

object (TargetCpa)

שיטת בידינג שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
targetImpressionShare

object (TargetImpressionShare)

שיטת בידינג שמבצעת אופטימיזציה אוטומטית להשגת אחוז מסוים של חשיפות.
targetRoas

object (TargetRoas)

שיטת בידינג שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד ספציפי של החזר על הוצאות פרסום (ROAS).
targetSpend

object (TargetSpend)

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

MaximizeConversionValue

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

ייצוג ב-JSON 
{
  "targetRoas": number
}
שדות
targetRoas

number

האפשרות 'יעד החזר על הוצאות פרסום (ROAS)'. אם ההגדרה הזו מוגדרת, שיטת הבידינג תעזור לכם למקסם את ההכנסות תוך שמירה על ערך ממוצע של יעד ההחזר על הוצאות הפרסום. אם יעד ההחזר על הוצאות הפרסום גבוה, יכול להיות ששיטת הבידינג לא תוכל להוציא את כל התקציב. אם לא תגדירו יעד החזר על הוצאות פרסום, שיטת הבידינג תנסה להשיג את ההחזר הגבוה ביותר על הוצאות הפרסום במסגרת התקציב.

MaximizeConversions

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

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

string (int64 format)

האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא לכל עסקה.
targetCpaMicros

string (int64 format)

האפשרות 'יעד עלות להמרה (CPA)'. זהו הסכום הממוצע שאתם רוצים להוציא לכל עסקה.

TargetCpa

זוהי שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.

ייצוג ב-JSON 
{
  "targetCpaMicros": string
}
שדות
targetCpaMicros

string (int64 format)

יעד עלות ממוצעת להמרה (CPA). היעד הזה צריך להיות גדול או שווה ליחידת החיוב המינימלית, בהתאם למטבע של החשבון.

TargetImpressionShare

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

ייצוג ב-JSON 
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
location

enum (TargetImpressionShareLocation)

המיקום המטורגט בדף תוצאות החיפוש.
locationFractionMicros

string (int64 format)

החלק שנבחר מתוך המודעות שיוצגו במיקום הגיאוגרפי הרצוי, בחלקיקי מיקרו. לדוגמה, 1% שווה ל-10,000.
cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

שיטת בידינג אוטומטית שעוזרת לכם למקסם את ההכנסות תוך עמידה בערך ממוצע של יעד החזר ספציפי על הוצאות הפרסום (ROAS).

ייצוג ב-JSON 
{
  "targetRoas": number
}
שדות
targetRoas

number

ההכנסה שנבחרה (על סמך נתוני ההמרות) לכל יחידת הוצאה.

TargetSpend

שיטת בידינג אוטומטית שמגדירה את הצעות המחיר כדי לעזור לכם לקבל כמה שיותר קליקים במסגרת התקציב.

ייצוג ב-JSON 
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
שדות
targetSpendMicros
(deprecated)

string (int64 format)

יעד ההוצאות במסגרתו יתבצע מיקסום הקליקים. מגיש הצעות מחיר לפי יעד הוצאה ינסה להוציא את הסכום הנמוך מבין הערך הזה או סכום ההוצאה הטבעי לאחר הצמצום. אם לא צוין יעד הוצאה, המערכת תשתמש בתקציב כיעד ההוצאה. השדה הזה הוצא משימוש ואין להשתמש בו יותר. פרטים נוספים זמינים בכתובת https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.
cpcBidCeilingMicros

string (int64 format)

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

ManagerLinkStatus

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

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
ACTIVE מציין את הקשר הנוכחי בתוקף
INACTIVE מציין קשר שהסתיים
PENDING המשמעות היא שהמנהל ביקש את הקשר, אבל הלקוח עדיין לא אישר אותו.
REFUSED הניהול התבקש על ידי המנהל, אבל הלקוח דחה אותו.
CANCELED המשמעות היא שהמנהל ביקש ליצור את הקשר, אבל ביטל אותו.

CustomerClient

קישור בין הלקוח הנתון ללקוח של לקוח. הרשאות CustomerClients קיימות רק ללקוחות ניהול. כל הלקוחות הישירים והעקיפים של הלקוח נכללים, וגם חשבון הניהול עצמו.

ייצוג ב-JSON 
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
שדות
resourceName

string

שם המשאב של לקוח הלקוח. שמות המשאבים של CustomerClient הם בפורמט: customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

שמות המשאבים של התוויות שבבעלות הלקוח המבקש שחלות על חשבון הלקוח. שמות המשאבים של התוויות הם בפורמט:

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

הסטטוס של לקוח הלקוח. קריאה בלבד.
clientCustomer

string

שם המשאב של לקוח הלקוח שמקושר ללקוח הנתון. קריאה בלבד.
hidden

boolean

מציין אם מדובר בחשבון מוסתר.

קריאה בלבד.
level

string (int64 format)

המרחק בין הלקוח ללקוח נתון. בקישור עצמי, ערך הרמה יהיה 0. קריאה בלבד.
timeZone

string

ייצוג מחרוזת של מאגר נתוני האזור (CLDR) של אזור הזמן של הלקוח, לדוגמה: America/Los_Angeles. קריאה בלבד.
testAccount

boolean

מזהה אם הלקוח הוא חשבון בדיקה. קריאה בלבד.
manager

boolean

מזהה אם הלקוח הוא חשבון ניהול. קריאה בלבד.
descriptiveName

string

שם תיאורי של הלקוח. קריאה בלבד.
currencyCode

string

קוד המטבע (לדוגמה, 'USD',‏ 'EUR') של הלקוח. קריאה בלבד.
id

string (int64 format)

המזהה של לקוח הלקוח. קריאה בלבד.

DynamicSearchAdsSearchTermView

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

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

string

שם המשאב של תצוגת מונחי החיפוש של המודעות הדינמיות לרשת החיפוש. שמות המשאבים בתצוגת מונח החיפוש של מודעות דינמיות לרשת החיפוש הם בפורמט הבא:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}
landingPage

string

כתובת דף הנחיתה שנבחרה באופן דינמי של החשיפת המודעות.

השדה הזה הוא לקריאה בלבד.

GenderView

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

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

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

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

קבוע של יעד גיאוגרפי.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
שדות
resourceName

string

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

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

הסטטוס של קבוע הטירגוט הגיאוגרפי.
id

string (int64 format)

המזהה של קבוע הטירגוט הגיאוגרפי.
name

string

השם באנגלית של קבוע הטירגוט הגיאוגרפי.
countryCode

string

קוד המדינה בתקן ISO-3166-1 alpha-2 שמשויך ליעד.
targetType

string

סוג היעד של טירגוט גיאוגרפי קבוע.
canonicalName

string

השם האנגלי המלא, שכולל את שם היעד ואת שם ההורה והמדינה שלו.
parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

הסטטוסים האפשריים של קבוע טירגוט גיאוגרפי.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין ערך.
UNKNOWN

הערך שהתקבל לא ידוע בגרסה הזו.

זהו ערך לתגובה בלבד.
ENABLED הקבוע של הטירגוט הגיאוגרפי תקין.
REMOVAL_PLANNED הקבוע של הגדרת היעד הגיאוגרפי הוצא משימוש ותוסר.

KeywordView

תצוגת מילות מפתח.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

שם המשאב של תצוגת מילות המפתח. שמות המשאבים בתצוגת מילות המפתח מופיעים בפורמט:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

תווית

תווית.

ייצוג ב-JSON 
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
שדות
resourceName

string

שם המשאב. שמות המשאבים של התוויות מופיעים בפורמט: customers/{customerId}/labels/{label_id}
status

enum (LabelStatus)

הסטטוס של התווית. קריאה בלבד.
textLabel

object (TextLabel)

סוג של תווית שמוצג בה טקסט על רקע צבעוני.
id

string (int64 format)

המזהה של התווית. קריאה בלבד.
name

string

השם של התווית.

השדה הזה חובה, ואסור שהוא יהיה ריק כשיוצרים תווית חדשה.

אורך המחרוזת צריך להיות בין 1 ל-80 תווים, כולל.

LabelStatus

הסטטוסים האפשריים של תווית.

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

TextLabel

סוג של תווית שמוצג בה טקסט על רקע צבעוני.

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

string

צבע הרקע של התווית בפורמט HEX. המחרוזת הזו צריכה להתאים לביטוי הרגולרי '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. הערה: יכול להיות שצבע הרקע לא יהיה גלוי בחשבונות ניהול.
description

string

תיאור קצר של התווית. האורך חייב להיות עד 200 תווים.

LanguageConstant

שפה.

ייצוג ב-JSON 
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
שדות
resourceName

string

שם המשאב של קבוע השפה. שמות המשאבים של קבועי השפה הם בפורמט:

languageConstants/{criterionId}
id

string (int64 format)

המזהה של קבוע השפה.
code

string

קוד השפה, למשל 'en_US',‏ 'en_AU',‏ 'es',‏ 'fr' וכו'.
name

string

השם המלא של השפה באנגלית, למשל, 'English (US)', 'Spanish' וכו'.
targetable

boolean

אם אפשר לטרגט את השפה.

LocationView

בתצוגה לפי מיקום מוצג סיכום של ביצועי הקמפיינים לפי קריטריון מיקום.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

שם המשאב של תצוגת המיקום. שמות המשאבים בתצוגת המיקום מופיעים בפורמט:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

קטגוריית בידינג של מוצרים.

ייצוג ב-JSON 
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
שדות
resourceName

string

שם המשאב של קטגוריית הבידינג של המוצר. שמות המשאבים של קטגוריות בידינג למוצרים הם בפורמט:

productBiddingCategoryConstants/{countryCode}~{level}~{id}
level

enum (ProductBiddingCategoryLevel)

הרמה של קטגוריית הבידינג של המוצר.
status

enum (ProductBiddingCategoryStatus)

הסטטוס של קטגוריית הבידינג של המוצר.
id

string (int64 format)

המזהה של קטגוריית הבידינג של המוצר.

המזהה הזה זהה למזהה google_product_category כפי שמתואר במאמר הזה: https://support.google.com/merchants/answer/6324436.
countryCode

string

קוד מדינה בן שתי אותיות באותיות רישיות של קטגוריית הבידינג של המוצר.
productBiddingCategoryConstantParent

string

שם המשאב של קטגוריית הבידינג של המוצר הראשי.
languageCode

string

קוד השפה של קטגוריית הבידינג של המוצר.
localizedName

string

ערך התצוגה של קטגוריית הבידינג של המוצר, שמותאם לשפה לפי 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

string

שם המשאב של תצוגת קבוצת המוצרים. שמות המשאבים בתצוגת קבוצת המוצרים הם בפורמט:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

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

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

שם המשאב של תצוגת הביצועים של שופינג. שמות המשאבים בתצוגת הביצועים של קמפיינים של שופינג הם בפורמט: customers/{customerId}/shoppingPerformanceView

UserList

רשימת משתמשים. זוהי רשימה של משתמשים שהלקוח יכול לטרגט.

ייצוג ב-JSON 
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
שדות
resourceName

string

שם המשאב של רשימת המשתמשים. שמות המשאבים של רשימות המשתמשים הם בפורמט:

customers/{customerId}/userLists/{user_list_id}
type

enum (UserListType)

סוג הרשימה.

השדה הזה הוא לקריאה בלבד.
id

string (int64 format)

המזהה של רשימת המשתמשים.
name

string

השם של רשימת המשתמשים הזו. בהתאם ל-access_reason, ייתכן ששם רשימת המשתמשים לא יהיה ייחודי (לדוגמה, אם access_reason=SHARED)

UserListType

טיפוס נתונים (enum) שמכיל את הסוגים האפשריים של רשימות משתמשים.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
REMARKETING רשימת משתמשים שמיוצגת כאוסף של סוגי המרות.
LOGICAL UserList שמיוצג כשילב של רשימות או תחומי עניין אחרים של משתמשים.
EXTERNAL_REMARKETING רשימת משתמשים שנוצרה בפלטפורמה של Google Ad Manager.
RULE_BASED UserList שמשויך לכלל.
SIMILAR רשימת משתמשים עם משתמשים שדומים למשתמשים ברשימת משתמשים אחרת.
CRM_BASED UserList של נתוני CRM מאינטראקציה ישירה (First-Party) שסופקו על ידי המפרסם בצורת כתובות אימייל או בפורמטים אחרים.

UserLocationView

תצוגה של מיקום המשתמש.

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

ייצוג ב-JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
שדות
resourceName

string

שם המשאב של תצוגת המיקום של המשתמש. שמות המשאבים בתצוגה UserLocation הם בפורמט:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

מזהה הקריטריון של המדינה.
targetingLocation

boolean

מציין אם המיקום היה מטורגט או לא.

WebpageView

תצוגה של דף אינטרנט.

ייצוג ב-JSON 
{
  "resourceName": string
}
שדות
resourceName

string

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

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

כניסה

ביקור.

ייצוג ב-JSON 
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
שדות
resourceName

string

שם המשאב של הביקור. שמות המשאבים של Visit הם בפורמט:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}
id

string (int64 format)

המזהה של הביקור.
criterionId

string (int64 format)

מזהה מילת המפתח ב-Search Ads 360. ערך של 0 מציין שמילות המפתח לא משויכות.
merchantId

string (int64 format)

המזהה של חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שלחצו עליו. המערכת של Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי שטחי פרסום ב-Search Ads 360.
adId

string (int64 format)

מזהה המודעה. ערך של 0 מציין שהמודעה לא משויכת.
clickId

string

מחרוזת ייחודית לכל ביקור, שמועברת לדף הנחיתה כפרמטר של כתובת ה-URL של מזהה הקליק.
visitDateTime

string

חותמת הזמן של אירוע הביקור. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
productId

string

המזהה של המוצר שעליו לחץ המשתמש.
productChannel

enum (ProductChannel)

ערוץ המכירות של המוצר שלחצו עליו: אונליין או מקומי.
productLanguageCode

string

השפה (ISO-639-1) שהוגדרה בפיד Merchant Center שמכיל נתונים על המוצר.
productStoreId

string

החנות שמוצגת במודעת המלאי של החנות המקומית שעליה בוצע הקליק. הערך הזה צריך להתאים למזהי החנויות שמשמשים בפיד המוצרים של החנויות המקומיות.
productCountryCode

string

המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לחץ המשתמש.
assetId

string (int64 format)

המזהה של הנכס שבו הייתה אינטראקציה במהלך אירוע הביקור.
assetFieldType

enum (AssetFieldType)

סוג השדה של הנכס באירוע הביקור.

ProductChannel

קבוצת ערכים שמתארת את המיקום של מוצר.

טיפוסים בני מנייה (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 (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
שדות
resourceName

string

שם המשאב של ההמרה. שמות המשאבים של ההמרות מופיעים בתבנית:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}
id

string (int64 format)

המזהה של ההמרה
criterionId

string (int64 format)

מזהה הקריטריון ב-Search Ads 360. ערך של 0 מציין שהקריטריון לא משויך.
merchantId

string (int64 format)

המזהה של חשבון המלאי ב-Search Ads 360 שמכיל את המוצר שלחצו עליו. המערכת של Search Ads 360 יוצרת את המזהה הזה כשמקשרים חשבון מלאי שטחי פרסום ב-Search Ads 360.
adId

string (int64 format)

מזהה המודעה. ערך של 0 מציין שהמודעה לא משויכת.
clickId

string

מחרוזת ייחודית של הביקור שאליו משויכת ההמרה, שמועברת לדף הנחיתה כפרמטר של כתובת ה-URL של מספר הקליק.
visitId

string (int64 format)

מזהה הביקור ב-Search Ads 360 שאליו משויכת ההמרה.
advertiserConversionId

string

בהמרות אופליין, זהו מזהה שמסופק על ידי המפרסמים. אם המפרסם לא מציין מזהה כזה, מערכת Search Ads 360 יוצרת מזהה כזה. בהמרות אונליין, השדה הזה שווה לעמודה id או לעמודה floodlightOrderId, בהתאם להוראות של המפרסם ב-Floodlight.
productId

string

המזהה של המוצר שעליו לחץ המשתמש.
productChannel

enum (ProductChannel)

ערוץ המכירות של המוצר שלחצו עליו: אונליין או מקומי.
productLanguageCode

string

השפה (ISO-639-1) שהוגדרה בפיד Merchant Center שמכיל נתונים על המוצר.
productStoreId

string

החנות שמוצגת במודעת המלאי של החנות המקומית שעליה בוצע הקליק. הערך הזה צריך להתאים למזהי החנויות שמשמשים בפיד המוצרים של החנויות המקומיות.
productCountryCode

string

המדינה (בפורמט ISO-3166) שרשומה בפיד המלאי שמכיל את המוצר שעליו לחץ המשתמש.
attributionType

enum (AttributionType)

הגורם שאליו משויכת ההמרה: ביקור או מילת מפתח + מודעה.
conversionDateTime

string

חותמת הזמן של אירוע ההמרה.
conversionLastModifiedDateTime

string

חותמת הזמן של הפעם האחרונה שבה ההמרה שונתה.
conversionVisitDateTime

string

חותמת הזמן של הביקור שאליו משויכת ההמרה.
conversionQuantity

string (int64 format)

כמות הפריטים שתועדה בהמרה, כפי שנקבע על ידי הפרמטר qty בכתובת ה-URL. המפרסם אחראי לאכלוס דינמי של הפרמטר (למשל, מספר הפריטים שנמכרו בהמרה). אחרת, הערך שמוגדר כברירת מחדל הוא 1.
conversionRevenueMicros

string (int64 format)

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

string (int64 format)

ההכנסה המקורית ללא שינוי שמשויכת לאירוע ב-Floodlight (במטבע של הדוח הנוכחי), לפני השינויים בהוראות המטבע ב-Floodlight.
floodlightOrderId

string

מזהה ההזמנה ב-Floodlight שסיפק המפרסם עבור ההמרה.
status

enum (ConversionStatus)

הסטטוס של ההמרה: 'מופעל' או 'הוסר'.
assetId

string (int64 format)

המזהה של הנכס שבו הייתה אינטראקציה במהלך אירוע ההמרה.
assetFieldType

enum (AssetFieldType)

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

AttributionType

סוג השיוך (Attribution) של המרות ב-Search Ads 360

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

ConversionStatus

הסטטוסים האפשריים של המרה.

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

מדדים

נתוני מדדים.

ייצוג ב-JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
שדות
allConversionsValueByConversionDate

number

הערך של כל ההמרות. כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.
allConversionsByConversionDate

number

המספר הכולל של המרות. הנתון הזה כולל את כל ההמרות, ללא קשר לערך של includeInConversionsMetric. כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.
conversionCustomMetrics[]

object (Value)

המדדים המותאמים אישית של ההמרות.
conversionsValueByConversionDate

number

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

number

הסכום של ההמרות לפי תאריך ההמרה עבור סוגי המרות שאפשר להגיש עליהם הצעות מחיר. יכול להיות חלקי בגלל יצירת מודל שיוך (Attribution). כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה.
historicalCreativeQualityScore

enum (QualityScoreBucket)

ציון האיכות בעבר של הקריאייטיב.
historicalLandingPageQualityScore

enum (QualityScoreBucket)

האיכות של חוויית המשתמש בדף הנחיתה בעבר.
historicalSearchPredictedCtr

enum (QualityScoreBucket)

שיעור הקליקים (CTR) החזוי בחיפוש ההיסטורי.
interactionEventTypes[]

enum (InteractionEventType)

סוגי האינטראקציות בתשלום ובחינם.
rawEventConversionMetrics[]

object (Value)

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

number

נתח החשיפות במיקום הבולט ביותר בחיפוש הוא אחוז החשיפות של המודעות לרשת החיפוש שהופיעו במיקום הבולט ביותר בחיפוש Google.
allConversionsFromInteractionsRate

number

כל ההמרות מאינטראקציות (בניגוד להמרות בעקבות צפייה) חלקי מספר האינטראקציות עם המודעות.
allConversionsValue

number

הערך של כל ההמרות.
allConversions

number

המספר הכולל של המרות. הנתון הזה כולל את כל ההמרות, ללא קשר לערך של includeInConversionsMetric.
allConversionsValuePerCost

number

הערך של כל ההמרות מחולק בעלות הכוללת של האינטראקציות עם המודעות (למשל קליקים על מודעות טקסט או צפיות במודעות וידאו).
allConversionsFromClickToCall

number

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

המדד הזה רלוונטי רק לפריטי פיד.
allConversionsFromDirections

number

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

המדד הזה רלוונטי רק לפריטי פיד.
allConversionsFromInteractionsValuePerInteraction

number

הערך של כל ההמרות מאינטראקציות חלקי המספר הכולל של האינטראקציות.
allConversionsFromMenu

number

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

המדד הזה רלוונטי רק לפריטי פיד.
allConversionsFromOrder

number

מספר הפעמים שאנשים ביצעו הזמנה בחנות לאחר לחיצה על מודעה.

המדד הזה רלוונטי רק לפריטי פיד.
allConversionsFromOtherEngagement

number

מספר ההמרות האחרות (למשל, פרסום ביקורת או שמירת מיקום החנות) שאירעו לאחר שאנשים לחצו על מודעה.

המדד הזה רלוונטי רק לפריטי פיד.
allConversionsFromStoreVisit

number

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

המדד הזה רלוונטי רק לפריטי פיד.
visits

number

קליקים שתועדו במערכת Search Ads 360 והועברו לדף הנחיתה של המפרסם.
allConversionsFromStoreWebsite

number

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

המדד הזה רלוונטי רק לפריטי פיד.
averageCost

number

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

number

העלות הכוללת של כל הקליקים חלקי המספר הכולל של הקליקים שהתקבלו. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
averageCpm

number

עלות ממוצעת לאלף חשיפות (CPM). המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clicks

string (int64 format)

מספר הקליקים.
contentBudgetLostImpressionShare

number

אחוז הפעמים המשוער שבהן המודעה הייתה כשירה להופיע ברשת המדיה, אבל לא הוצגה כי התקציב היה נמוך מדי. הערה: נתח החשיפות שהוחמצו מתקציב התוכן מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
contentImpressionShare

number

מספר החשיפות שקיבלתם ברשת המדיה חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות של התוכן מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.
contentRankLostImpressionShare

number

האחוז המשוער של החשיפות ברשת המדיה שהמודעות שלכם לא קיבלו בגלל דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו לפי דירוג התוכן מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
conversionsFromInteractionsRate

number

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

number

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

number

הערך של המרה שניתן להגיש עליה הצעת מחיר חלקי העלות הכוללת של אינטראקציות שעומדות בדרישות להמרה.
conversionsFromInteractionsValuePerInteraction

number

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

number

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

string (int64 format)

הסכום של העלויות לקליק (CPC) והעלויות לאלף חשיפות (CPM) בתקופה הזו. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
costPerAllConversions

number

העלות של האינטראקציות עם המודעות מחולקת במספר ההמרות.
costPerConversion

number

העלות הממוצעת להמרה שעומדת בדרישות להצגת הצעות מחיר, לכל המרה שאפשר להגיש עליה הצעות מחיר.
costPerCurrentModelAttributedConversion

number

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

number

המרות שמתרחשות כשלקוח לוחץ על מודעה במכשיר אחד, ולאחר מכן משלים המרה במכשיר או בדפדפן אחר. המרות חוצות-מכשירים כבר נכללות בעמודה allConversions.
crossDeviceConversionsByConversionDate

number

מספר ההמרות חוצות-המכשירים לפי תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.
crossDeviceConversionsValue

number

הסכום של הערך של המרות חוצות-מכשירים.
crossDeviceConversionsValueByConversionDate

number

הסכום של ערכי ההמרות חוצות-המכשירים לפי תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.
ctr

number

מספר הקליקים שהמודעה מקבלת (קליקים) חלקי מספר הפעמים שהמודעה מוצגת (חשיפות).
conversions

number

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

number

הסכום של ערכי ההמרות של ההמרות שכלולות בשדה 'המרות'. המדד הזה מועיל רק אם הזנת ערך לפעולות ההמרה.
averageQualityScore

number

ציון האיכות הממוצע.
historicalQualityScore

string (int64 format)

ציון האיכות בעבר.
impressions

string (int64 format)

מספר הפעמים שהמודעה שלכם הופיעה בדף תוצאות חיפוש או באתר ברשת Google.
interactionRate

number

התדירות שבה אנשים מקיימים אינטראקציה עם המודעה אחרי שהיא מוצגת להם. המדד הזה מייצג את מספר האינטראקציות חלקי מספר הפעמים שהמודעה הוצגה.
interactions

string (int64 format)

מספר האינטראקציות. אינטראקציה היא הפעולה העיקרית של המשתמש שמשויכת לפורמט המודעה – קליקים במקרה של מודעות טקסט ומודעות שופינג, צפיות במקרה של מודעות וידאו וכן הלאה.
invalidClickRate

number

אחוז הקליקים שסוננו מתוך המספר הכולל של הקליקים (קליקים שסוננו + קליקים שלא סוננו) במהלך תקופת הדיווח.
invalidClicks

string (int64 format)

מספר הקליקים ש-Google מחשיבה כלא חוקיים ולא מחייבת עליהם.
generalInvalidClickRate

number

אחוז הקליקים שסוננו מתוך כלל הקליקים (קליקים שסוננו + קליקים שלא סוננו) מכיוון שהם קליקים פסולים כלליים. אלה קליקים ש-Google מחשיבה כפסולים, והם מזוהים בעזרת אמצעי סינון שגרתיים (כלומר תנועה פסולה ידועה ממרכזי נתונים, בוטים וספיידרים או סורקים אחרים, דפוסים חריגים וכו'). אתה לא משלם עליהם, והם לא משפיעים על הסטטיסטיקה של החשבון. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/campaignmanager/answer/6076504.
generalInvalidClicks

string (int64 format)

מספר הקליקים הפסולים הכלליים. אלה קבוצת משנה של הקליקים הפסולים שזוהו באמצעות אמצעי סינון שגרתיים (למשל, תנועה פסולה ידועה ממרכזי נתונים, בוטים וספיידרים או סורקים אחרים, דפוסים חריגים וכו'). אתה לא משלם עליהם, והם לא משפיעים על הסטטיסטיקה של החשבון. פרטים נוספים זמינים בדף העזרה בכתובת https://support.google.com/campaignmanager/answer/6076504.
mobileFriendlyClicksPercentage

number

אחוז הקליקים בניידים שמובילים לדף שמותאם לניידים.
searchAbsoluteTopImpressionShare

number

אחוז החשיפות של המודעות של הלקוח לרשת החיפוש או לרשת שופינג שמוצגות במיקום הבולט ביותר בקמפיין שופינג. פרטים נוספים זמינים בכתובת https://support.google.com/sa360/answer/9566729. כל ערך נמוך מ-0.1 ידווח כ-0.0999.
searchBudgetLostAbsoluteTopImpressionShare

number

המספר שמציג הערכה של התדירות שבה המודעה לא הייתה המודעה הראשונה בין המודעות שהוצגו בראש הדף בתוצאות החיפוש, בגלל תקציב נמוך. הערה: המדד 'נתח החשיפות במיקום הראשון בחיפוש שהוחמצו (תקציב)' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
searchBudgetLostImpressionShare

number

אחוז הפעמים המשוער שבהן המודעה הייתה כשירה להופיע ברשת החיפוש, אבל היא לא הוצגה כי התקציב היה נמוך מדי. הערה: המדד 'נתח החשיפות שהוחמצו בתקציב לרשת החיפוש' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
searchBudgetLostTopImpressionShare

number

המספר שמציג הערכה של התדירות שבה המודעה לא הופיעה סמוך לחלק העליון של תוצאות החיפוש האורגני בגלל תקציב נמוך. הערה: המדד 'נתח החשיפות בראש הדף בחיפוש שהוחמצו (תקציב)' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
searchClickShare

number

מספר הקליקים שקיבלתם ברשת החיפוש, חלקי המספר המשוער של הקליקים שהייתם זכאים לקבל. הערה: נתח הקליקים בחיפוש מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.
searchExactMatchImpressionShare

number

מספר החשיפות שקיבלתם חלקי המספר המשוער של חשיפות שהייתם כשירים לקבל ברשת החיפוש, עבור מונחי חיפוש שתאמו את מילות המפתח שלכם במדויק (או שהיו גרסאות קרובות של מילת המפתח), ללא קשר לסוגים של התאמות למילות המפתח. הערה: נתח החשיפות בהתאמה מדויקת ברשת החיפוש מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.
searchImpressionShare

number

מספר החשיפות שקיבלתם ברשת החיפוש חלקי המספר המשוער של החשיפות שהייתם יכולים לקבל. הערה: נתח החשיפות ברשת החיפוש מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.
searchRankLostAbsoluteTopImpressionShare

number

המספר שמציג הערכה של התדירות שבה המודעה לא הייתה המודעה הראשונה שהוצגה במודעות העליונות בתוצאות החיפוש בגלל דירוג מודעה נמוך. הערה: המדד 'נתח החשיפות במיקום הבולט ביותר ברשת החיפוש שהוחמצו (דירוג)' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
searchRankLostImpressionShare

number

האחוז המשוער של החשיפות ברשת החיפוש שהמודעות שלכם לא קיבלו בגלל דירוג מודעה נמוך. הערה: נתח החשיפות שהוחמצו לפי דירוג בחיפוש מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
searchRankLostTopImpressionShare

number

המספר הזה מייצג את התדירות המשוערת שבה המודעה לא הופיעה סמוך לחלק העליון של תוצאות החיפוש האורגני בגלל דירוג מודעה נמוך. הערה: המדד 'נתח החשיפות בראש הדף בחיפוש שהוחמצו (דירוג)' מדווח בטווח שבין 0 ל-0.9. כל ערך מעל 0.9 ידווח כ-0.9001.
searchTopImpressionShare

number

מספר החשיפות שהמודעות קיבלו כשהופיעו בין המודעות העליונות, בהשוואה למספר המשוער של החשיפות שהן היו כשירות לקבל בין המודעות העליונות. הערה: נתח החשיפות בראש הדף בחיפוש מדווח בטווח שבין 0.1 ל-1. כל ערך נמוך מ-0.1 ידווח כ-0.0999.

מודעות עליונות בדרך כלל מופיעות מעל התוצאות הרגילות העליונות, אבל בשאילתות חיפוש מסוימות, המודעות האלה יכולות להופיע גם מתחת להן.
topImpressionPercentage

number

אחוז החשיפות של המודעות שמוצגות בסמוך לתוצאות החיפוש האורגני העליונות.
valuePerAllConversions

number

הערך של כל ההמרות חלקי מספר כל ההמרות.
valuePerAllConversionsByConversionDate

number

הערך של כל ההמרות חלקי מספר כל ההמרות. כשהעמודה הזו מסומנת עם תאריך, הערכים בעמודת התאריך מייצגים את תאריך ההמרה. פרטים על העמודות by_conversion_date זמינים בכתובת https://support.google.com/sa360/answer/9250611.
valuePerConversion

number

הערך של המרה שניתן להגיש עליה הצעת מחיר חלקי מספר ההמרות שניתן להגיש עליהן הצעת מחיר. העמודה הזו מציגה את הערך הממוצע של כל אחת מההמרות שניתן להגיש עליהן הצעות מחיר.
valuePerConversionsByConversionDate

number

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

string (int64 format)

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

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. ערך עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. ערך עלות המכר של מכירת מוצר או שירות לא קשור בהזמנה הזו הוא 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר החולצה הוא 80 ש"ח וערך עלות המכר שלה הוא 20 ש"ח. הרווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) הוא 60 ש"ח = 80 ש"ח פחות 20 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellRevenueMicros

string (int64 format)

המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellRevenueMicros

string (int64 format)

המדד 'הכנסה ממכירת מוצר או שירות לא קשור (cross-sell)' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה ממכירת מוצר או שירות לא קשור היא 80 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell) בחשבון הלקוח' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר אחר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.
crossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר בעקבות לידים (COGS) בחשבון הלקוח' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותו מוצר. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר בעקבות לידים' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, עלות המוצרים האלה תיכלל במדד 'עלות המכר בעקבות לידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר בעקבות לידים בהזמנה הזו היא 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים בחשבון לקוח' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו מלידים' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, אז ההכנסות מהמכירות האלה, בניכוי עלות המכר הן הרווח ברוטו מלידים. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח וערך עלות המכר שלו הוא 12 ש"ח. הרווח ברוטו מלידים בהזמנה הזו הוא 28 ש"ח = 40 ש"ח פחות 12 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadRevenueMicros

string (int64 format)

בעמודה 'הכנסה מלידים בחשבון הלקוח' מוצג הסכום הכולל שהרווחת ממוצרים שנמכרו כתוצאה מפרסום המוצרים האלה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
leadRevenueMicros

string (int64 format)

המדד 'הכנסה מלידים' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, הערך הכולל שהרווחת מהמכירות של המוצרים האלה יוצג בעמודה 'הכנסה מלידים'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר הכובע הוא 40 ש"ח ומחיר החולצה הוא 80 ש"ח. ההכנסה מלידים בהזמנה הזו היא 40 ש"ח. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountLeadUnitsSold

number

המדד 'יחידות לידים שנמכרו בחשבון הלקוח' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.
leadUnitsSold

number

המדד 'יחידות לידים – נמכר' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של אותם המוצרים. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים שפורסמו ונמכרו תואמים, המספר הכולל של המוצרים שנמכרו יוצג בעמודה 'יחידות לידים – נמכר'. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. המספר שיופיע בעמודה 'יחידות לידים – נמכר' לגבי ההזמנה הזו הוא 1. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.

ערך

מאגר נתונים כללי.

ייצוג ב-JSON 
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
שדות
שדה האיחוד value. ערך. הערך של value יכול להיות רק אחת מהאפשרויות הבאות:
booleanValue

boolean

ערך בוליאני.
int64Value

string (int64 format)

ערך int64.
floatValue

number

משתנה מסוג float.
doubleValue

number

כפול.
stringValue

string

מחרוזת.

QualityScoreBucket

Enum שמפרט את הקטגוריות האפשריות של ציון האיכות.

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

InteractionEventType

Enum שמתאר את הסוגים האפשריים של אינטראקציות בתשלום וחינמיות.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
CLICK לוחצים על 'לאתר'. ברוב המקרים, האינטראקציה הזו מובילה למיקום חיצוני, בדרך כלל דף הנחיתה של המפרסם. זהו גם ברירת המחדל של InteractionEventType לאירועי קליקים.
ENGAGEMENT הכוונה המוצהרת של המשתמש ליצור אינטראקציה עם המודעה באתר.
VIDEO_VIEW המשתמש צפה במודעת וידאו.
NONE ברירת המחדל של InteractionEventType לאירועי המרה של מודעות. האפשרות הזו משמשת כששורה של המרה ממודעה לא מציינת שצריך 'להעלות' את האינטראקציות בחינם (לדוגמה, ההמרות ממודעות) ולדווח עליהן כחלק מהמדדים המרכזיים. אלה פשוט המרות אחרות (של מודעות).

פלחים

שדות של פלחים בלבד.

ייצוג ב-JSON 
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
שדות
adNetworkType

enum (AdNetworkType)

סוג רשת המודעות.
conversionActionCategory

enum (ConversionActionCategory)

קטגוריית פעולת ההמרה.
conversionCustomDimensions[]

object (Value)

המאפיינים המותאמים אישית של ההמרות.
dayOfWeek

enum (DayOfWeek)

היום בשבוע, למשל MONDAY (שני).
device

enum (Device)

המכשיר שאליו חלים המדדים.
keyword

object (Keyword)

קריטריון של מילת מפתח.
productChannel

enum (ProductChannel)

הערוץ של המוצר.
productChannelExclusivity

enum (ProductChannelExclusivity)

הבלעדיות של המוצר בערוץ.
productCondition

enum (ProductCondition)

מצב המוצר.
productSoldCondition

enum (ProductCondition)

מצב המוצר שנמכר.
rawEventConversionDimensions[]

object (Value)

מאפייני ההמרה הגולמיים של האירוע.
conversionAction

string

שם המשאב של פעולת ההמרה.
conversionActionName

string

שם פעולת ההמרה.
date

string

התאריך שבו המדדים חלים. הפורמט הוא yyyy-MM-dd, לדוגמה, 2018-04-17.
geoTargetCity

string

שם המשאב של קבוע היעד הגיאוגרפי שמייצג עיר.
geoTargetCountry

string

שם המשאב של קבוע היעד הגיאוגרפי שמייצג מדינה.
geoTargetMetro

string

שם המשאב של קבוע היעד הגיאוגרפי שמייצג אזור מטרופולין.
geoTargetRegion

string

שם המשאב של קבוע היעד הגיאוגרפי שמייצג אזור.
hour

integer

השעה ביום כמספר בין 0 ל-23, כולל.
month

string

החודש כפי שהוא מיוצג בתאריך של היום הראשון בחודש. הפורמט הוא yyyy-MM-dd.
productBiddingCategoryLevel1

string

קטגוריית הבידינג (רמה 1) של המוצר.
productBiddingCategoryLevel2

string

קטגוריית הבידינג (רמה 2) של המוצר.
productBiddingCategoryLevel3

string

קטגוריית הבידינג (רמה 3) של המוצר.
productBiddingCategoryLevel4

string

קטגוריית הבידינג (רמה 4) של המוצר.
productBiddingCategoryLevel5

string

קטגוריית הבידינג (רמה 5) של המוצר.
productBrand

string

המותג של המוצר.
productCountry

string

שם המשאב של קבוע היעד הגיאוגרפי של מדינת המכירה של המוצר.
productCustomAttribute0

string

מאפיין מותאם אישית 0 של המוצר.
productCustomAttribute1

string

מאפיין מותאם אישית 1 של המוצר.
productCustomAttribute2

string

מאפיין מותאם אישית 2 של המוצר.
productCustomAttribute3

string

מאפיין מותאם אישית 3 של המוצר.
productCustomAttribute4

string

מאפיין מותאם אישית 4 של המוצר.
productItemId

string

מזהה הפריט של המוצר.
productLanguage

string

שם המשאב של קבוע השפה בשפה של המוצר.
productSoldBiddingCategoryLevel1

string

קטגוריית הבידינג (רמה 1) של המוצר שנמכר.
productSoldBiddingCategoryLevel2

string

קטגוריית הבידינג (רמה 2) של המוצר שנמכר.
productSoldBiddingCategoryLevel3

string

קטגוריית הבידינג (רמה 3) של המוצר שנמכר.
productSoldBiddingCategoryLevel4

string

קטגוריית הבידינג (רמה 4) של המוצר שנמכר.
productSoldBiddingCategoryLevel5

string

קטגוריית הבידינג (רמה 5) של המוצר שנמכר.
productSoldBrand

string

המותג של המוצר שנמכר.
productSoldCustomAttribute0

string

מאפיין מותאם אישית 0 של המוצר שנמכר.
productSoldCustomAttribute1

string

מאפיין מותאם אישית 1 של המוצר שנמכר.
productSoldCustomAttribute2

string

מאפיין מותאם אישית 2 של המוצר שנמכר.
productSoldCustomAttribute3

string

מאפיין מותאם אישית 3 של המוצר שנמכר.
productSoldCustomAttribute4

string

מאפיין מותאם אישית 4 של המוצר שנמכר.
productSoldItemId

string

מזהה הפריט של המוצר שנמכר.
productSoldTitle

string

שם המוצר שנמכר.
productSoldTypeL1

string

הסוג (רמה 1) של המוצר שנמכר.
productSoldTypeL2

string

הסוג (רמה 2) של המוצר שנמכר.
productSoldTypeL3

string

הסוג (רמה 3) של המוצר שנמכר.
productSoldTypeL4

string

הסוג (רמה 4) של המוצר שנמכר.
productSoldTypeL5

string

הסוג (רמה 5) של המוצר שנמכר.
productStoreId

string

מזהה החנות של המוצר.
productTitle

string

שם המוצר.
productTypeL1

string

הסוג (רמה 1) של המוצר.
productTypeL2

string

הסוג (רמה 2) של המוצר.
productTypeL3

string

הסוג (רמה 3) של המוצר.
productTypeL4

string

הסוג (רמה 4) של המוצר.
productTypeL5

string

הסוג (רמה 5) של המוצר.
quarter

string

הרבעון מיוצג על ידי התאריך של היום הראשון ברבעון. הרבעונים מבוססים על השנה הקלנדרית. לדוגמה, הרבעון השני של 2018 מתחיל ב-1 באפריל 2018. הפורמט הוא yyyy-MM-dd.
week

string

שבוע מוגדר כיום שני עד יום ראשון, ונציג על ידי תאריך יום שני. הפורמט הוא yyyy-MM-dd.
year

integer

השנה, בפורמט yyyy.
assetInteractionTarget

object (AssetInteractionTarget)

משמש רק עם המדדים CustomerAsset, ‏ CampaignAsset ו-AdGroupAsset. השדה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת. אינטראקציות (למשל, קליקים) נספרות בכל החלקים של המודעה שמוצגת (למשל, המודעה עצמה ורכיבים אחרים כמו קישורי Sitelink) כשהם מוצגים יחד. כשהערך של interactionOnThisAsset הוא true, המשמעות היא שהאינטראקציות מתרחשות בנכס הספציפי הזה. כשהערך של interactionOnThisAsset הוא false, המשמעות היא שהאינטראקציות לא מתרחשות בנכס הספציפי הזה, אלא בחלקים אחרים של המודעה המוצגת שבה מוצג הנכס הזה.

AdNetworkType

מציגה את סוגי הרשתות ב-Google Ads.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN הערך לא מוכר בגרסה הזו.
SEARCH חיפוש Google.
SEARCH_PARTNERS שותפי חיפוש.
CONTENT רשת המדיה.
YOUTUBE_WATCH סרטונים ב-YouTube
MIXED ברשתות שונות.

מילת מפתח

פלח של קריטריון של מילת מפתח.

ייצוג ב-JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
שדות
info

object (KeywordInfo)

פרטי מילות המפתח.
adGroupCriterion

string

שם המשאב AdGroupCriterion.

ProductChannelExclusivity

Enum שמתאר את הזמינות של מוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
SINGLE_CHANNEL הפריט נמכר דרך ערוץ אחד בלבד, בחנויות מקומיות או אונליין, כפי שמצוין בערך של ProductChannel.
MULTI_CHANNEL הפריט תואם למקבילו בחנות הווירטואלית או בחנות המקומית, ומציין שהוא זמין לרכישה בשני ShoppingProductChannels.

ProductCondition

מאפיין enum שמתאר את התנאי של מוצר.

טיפוסים בני מנייה (enum)
UNSPECIFIED לא צוין.
UNKNOWN משמש רק לערך המוחזר. מייצג ערך לא ידוע בגרסה הזו.
OLD מצב המוצר ישן.
NEW מצב המוצר הוא חדש.
REFURBISHED מצב המוצר הוא מחודש.
USED מוצג מצב המוצר.

AssetInteractionTarget

פלח AssetInteractionTarget.

ייצוג ב-JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
שדות
asset

string

שם המשאב של הנכס.
interactionOnThisAsset

boolean

משמש רק עם המדדים CustomerAsset, ‏ CampaignAsset ו-AdGroupAsset. השדה מציין אם מדדי האינטראקציה התרחשו בנכס עצמו או בנכס אחר או ביחידת מודעות אחרת.