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.sssss'.
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.sssss'.

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

טקסט שמצורף לנתיב 1 עם מפריד.
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

טקסט שמצורף לנתיב 1 עם מפריד.
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. הטווח הוא בין 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 : הקריטריון בהמתנה לבדיקה
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.sssss'.
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 של תמונה/jpeg.
IMAGE_GIF סוג MIME של תמונה/GIF.
IMAGE_PNG סוג ה-MIME של image/png.
FLASH סוג ה-MIME של application/x-shockwave-flash.
TEXT_HTML סוג ה-MIME של text/html.
PDF סוג ה-MIME של application/pdf.
MSWORD סוג ה-MIME של application/msword.
MSEXCEL סוג ה-MIME של application/vnd.ms-excel.
RTF סוג ה-MIME הוא application/rtf.
AUDIO_WAV סוג ה-MIME של audio/wav.
AUDIO_MP3 סוג ה-MIME של audio/mp3.
HTML5_AD_ZIP סוג ה-MIME של application/x-html5-ad-zip.

ImageDimension

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

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

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.

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

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

ייצוג ב-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 סוג הקריאה לפעולה הוא 'להרשמה'.
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'. הנתונים האלה מסונכרנים מחשבון פרופיל העסק.
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 הנכס שימש בכותרת ארוכה (שנעשה בה שימוש ב-MultiAssetResponsiveAd).
DESCRIPTION הנכס שימש בתיאור. יש להשתמש באפשרות הזו רק אם יש תיאור אחד בלבד במודעה. אחרת, צריך להשתמש בממשקי ה-enum של DESCRIPTION_1 או של DESCRIPTION_@
DESCRIPTION_IN_PORTRAIT הנכס שימש כתיאור בתמונה לאורך.
BUSINESS_NAME_IN_PORTRAIT הנכס שימש כשם העסק בתמונה בתצוגה לאורך.
BUSINESS_NAME הנכס שימש כשם העסק.
MARKETING_IMAGE הנכס שימש כתמונה שיווקית.
MARKETING_IMAGE_IN_PORTRAIT הנכס שימש כתמונה שיווקית בתצוגה לאורך.
SQUARE_MARKETING_IMAGE הנכס שימש כתמונה שיווקית ריבועית.
PORTRAIT_MARKETING_IMAGE הנכס שימש כתמונה שיווקית בפורמט לאורך.
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 שמוצגת במודעה. אפשר להגדיר את השדה הזה רק כשמוגדר נתיב 1.
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

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

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

string (int64 format)

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

string

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

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

string

המטבע שמוגדר בשיטת הבידינג (קוד בן שלוש אותיות לפי תקן 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 סכמת הצעות מחיר מסוג 'קידום דף ראשון', שמגדירה הצעות מחיר מקסימליות לקליק כך שיטרגטו חשיפות בדף הראשון או בדף 1 ב-google.com. ערך enum זה הוצא משימוש.
PERCENT_CPC 'עלות להמרה באחוזים' היא שיטת בידינג שבה הצעות המחיר הן חלק מהמחיר המפורסם של מוצר או שירות כלשהו.
TARGET_CPA 'יעד עלות להמרה' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר המרות במסגרת יעד העלות להמרה (CPA) שהגדרתם.
TARGET_CPM 'יעד עלות לאלף חשיפות' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר כדי לעזור לכם להשיג כמה שיותר חשיפות במסגרת יעד העלות לאלף חשיפות (CPM) שהגדרתם.
TARGET_IMPRESSION_SHARE שיטת בידינג אוטומטית שמגדירה הצעות מחיר כך שאחוז מסוים של מודעות לרשת החיפוש יוצגו בחלק העליון של הדף הראשון (או במיקום אחר שמוגדרת לו טירגוט).
TARGET_OUTRANK_SHARE 'יעד נתח הובלה בדירוג' היא שיטת בידינג אוטומטית שמגדירה הצעות מחיר על סמך החלק היחסי של המכרזים שבהם המפרסם צריך לעקוף מתחרה ספציפי. ערך המניין הזה הוצא משימוש.
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)

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

string (int64 format)

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

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.12.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)

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

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

boolean

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

ShoppingSetting

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

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

string

תווית הפיד של המוצרים שרוצים לכלול בקמפיין. אפשר להגדיר רק אחד מהשדות feedLabel או salesCountry. אם משתמשים בו במקום salesCountry, השדה feedLabel מקבל קודי מדינות באותו פורמט, לדוגמה: '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

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

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

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, ורשימות רימרקטינג של מודעות לרשת החיפוש (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 המרה למכירות בחנות הפיזית על סמך העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי. רק לקוחות שמופיעים ברשימת ההיתרים יכולים להשתמש בהעלאה ישירה של מכירות בחנות הפיזית.
STORE_SALES המרה מסוג מכירות בחנות פיזית שמבוססת על העלאות של נתוני מוכרים מאינטראקציה ישירה או מצד שלישי, ו/או על רכישות בחנות פיזית באמצעות כרטיסים מרשתות תשלומים. רק לקוחות שמופיעים ברשימת ההיתרים יכולים להשתמש בסוגים של מכירות בחנות הפיזית. קריאה בלבד.
FIREBASE_ANDROID_FIRST_OPEN המרות מסוג 'פתיחה ראשונה' של אפליקציות ל-Android שבוצעו מעקב אחריהן דרך Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE המרות מרכישות מתוך אפליקציה ל-Android שבוצעו במסגרת מעקב דרך Firebase.
FIREBASE_ANDROID_CUSTOM המרות בהתאמה אישית באפליקציות ל-Android שבוצעו מעקב אחריהן דרך Firebase.
FIREBASE_IOS_FIRST_OPEN המרות מסוג 'פתיחה ראשונה' של אפליקציות ל-iOS שבוצעו מעקב אחריהן דרך Firebase.
FIREBASE_IOS_IN_APP_PURCHASE המרות מסוג רכישה באפליקציה ל-iOS שמתבצע אחריהן מעקב דרך Firebase.
FIREBASE_IOS_CUSTOM מתבצע מעקב אחר המרות מותאמות אישית באפליקציות ל-iOS דרך Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN המרות מסוג 'פתיחה ראשונה של אפליקציה ל-Android' שבוצעו במסגרת מעקב דרך שירות צד שלישי לניתוח נתוני אפליקציות.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE המרות מסוג רכישה באפליקציה ל-Android שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM המרות מותאמות אישית באפליקציות ל-Android שמתבצע מעקב אחריהן באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN המרות בפתיחה הראשונה של אפליקציה ל-iOS, שמתועדות באמצעות ניתוח נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE המרות של רכישות מתוך אפליקציה ל-iOS שבוצעו במסגרת מעקב אחר נתוני אפליקציות של צד שלישי.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM המרות בהתאמה אישית באפליקציות ל-iOS שבוצעו מעקב אחריהן דרך שירותי ניתוח נתוני אפליקציות של צד שלישי.
ANDROID_APP_PRE_REGISTRATION המרות שמתרחשות כשמשתמש נרשם מראש לאפליקציה לנייד מחנות Google Play. קריאה בלבד.
ANDROID_INSTALLS_ALL_OTHER_APPS המרות שמתעדות את כל ההורדות מ-Google Play שלא מתבצע עבורן מעקב לפי סוג ספציפי לאפליקציה. קריאה בלבד.
FLOODLIGHT_ACTION פעילות ב-Floodlight שמספרת כמה פעמים משתמשים ביקרו בדף אינטרנט מסוים אחרי שצפו במודעה של מפרסם מסוים או לחצו עליה. קריאה בלבד.
FLOODLIGHT_TRANSACTION פעילות ב-Floodlight שעוקבת אחרי מספר המכירות שבוצעו או אחרי מספר הפריטים שנרכשו. היא יכולה גם לתעד את הערך הכולל של כל מכירה. קריאה בלבד.
GOOGLE_HOSTED המרות שמתעדות פעולות מקומיות במוצרים ובשירותים של Google אחרי אינטראקציה עם מודעה. קריאה בלבד.
LEAD_FORM_SUBMIT המרות מדווחות כשמשתמש שולח טופס להשארת פרטים. קריאה בלבד.
SALESFORCE המרות שמגיעות מ-Salesforce. קריאה בלבד.
SEARCH_ADS_360 ההמרות מיובאות מנתוני Floodlight ב-Search Ads 360. קריאה בלבד.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL המרות מסוג שיחה שמתרחשות במודעות של קמפיינים חכמים בלי להגדיר מעקב אחר שיחות, באמצעות קריטריונים מותאמים אישית של קמפיין חכם. קריאה בלבד.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL המשתמש לוחץ על רכיב שיחה במפות Google. קמפיין חכם בלבד. קריאה בלבד.
SMART_CAMPAIGN_MAP_DIRECTIONS המשתמש מבקש מסלול הגעה למיקום של עסק במפות Google. קמפיין חכם בלבד. קריאה בלבד.
SMART_CAMPAIGN_TRACKED_CALLS המרות לשיחות שמתרחשות במודעות בקמפיינים חכמים שהוגדרו להם מעקב שיחות, על סמך קריטריונים מותאמים אישית של הקמפיין החכם. קריאה בלבד.
STORE_VISITS המרות שמתרחשות כשמשתמש מבקר בחנות הפיזית של המפרסם. קריאה בלבד.
WEBPAGE_CODELESS המרות שנוצרו מאירועים באתר (כמו שליחות של טפסים או טעינות של דפים), שלא נעשה בהן שימוש בקטעי קוד של אירועים (event snippet) שמקודדים בנפרד. קריאה בלבד.
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). מיועד לשימוש לצורך ייבוא מטרות עסקיות מ-Google Analytics, מ-Firebase ומ-Google Analytics.
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 המערכת משייכת יותר קרדיט על המרה לקליק האחרון שלה באמצעות שיוך (Attribution) לחיפוש Google (חצי חיים של שבוע).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED המערכת משייכת 40% מהקרדיט על ההמרה לקליק הראשון ולקליק האחרון שלה. 20% הנותרים מתחלקים באופן שווה בין כל שאר הקליקים. המערכת משתמשת ב-Attribution בחיפוש 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' ואחריו מספר קטן מ-ormequal עד 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

מידע על משתנים מותאמים אישית של המרות ב-Search Ads 360 Floodlight

ייצוג ב-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,
  "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.sssss'.
engineId

string

המזהה של החשבון בחשבון מנוע החיפוש החיצוני.
status

enum (CustomerStatus)

הסטטוס של הלקוח.
creationTime

string

חותמת הזמן של מועד יצירת הלקוח. חותמת הזמן היא לפי אזור הזמן של הלקוח ובפורמט 'yyyy-MM-dd HH:mm:ss'.
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. הסטטוס הוא קבוע ולא ניתן לפתוח אותו מחדש.

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

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

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

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

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

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

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

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

קוד מדינה בן 2 אותיות באותיות רישיות של קטגוריית הבידינג של המוצר.
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 UserList שמוצג כקבוצה של סוגי המרות.
LOGICAL UserList שמיוצג כשילב של רשימות או תחומי עניין אחרים של משתמשים.
EXTERNAL_REMARKETING רשימת משתמשים שנוצרה בפלטפורמה של Google Ad Manager.
RULE_BASED UserList שמשויך לכלל.
SIMILAR רשימת משתמשים עם משתמשים שדומים למשתמשים ברשימת משתמשים אחרת.
CRM_BASED UserList של נתוני CRM מאינטראקציה ישירה שסופקו על ידי המפרסם בצורת כתובות אימייל או בפורמטים אחרים.

UserLocationView

תצוגת מיקום של משתמש

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

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

string

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

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

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

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

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

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

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

number

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

number

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

number

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

סכום ערכי ההמרות של ההמרות שכלולות בשדה conversions (המרות). המדד הזה מועיל רק אם הזנת ערך לפעולות ההמרה.
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) בחשבון לקוח' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) של ההזמנה היא 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. אפשר לעיין בפרמטר metrics_currency בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
crossSellCostOfGoodsSoldMicros

string (int64 format)

המדד 'עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell)' מייצג את העלות הכוללת של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא תואמים, מדובר במכירת מוצר או שירות לא קשור (cross-sell). עלות המכר של מכירת מוצר או שירות לא קשור מייצגת את העלות הכוללת של המוצרים שנמכרו אבל לא פורסמו. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. ערך עלות המכר של הכובע הוא 12 ש"ח וערך עלות המכר של החולצה הוא 20 ש"ח. עלות המכר של מכירת מוצר או שירות לא קשור (cross-sell) של ההזמנה היא 5$. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות. המדד הזה הוא ערך כספי, והוא מוחזר במטבע של הלקוח כברירת מחדל. פרמטר metrics_currency מופיע בכתובת https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
clientAccountCrossSellGrossProfitMicros

string (int64 format)

המדד 'רווח ברוטו ממכירת מוצר או שירות לא קשור (cross-sell) בחשבון לקוח' מייצג את הרווח ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה, בניכוי עלות המכר (COGS). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר החולצה הוא 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). איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול ברכישה הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. הרווח ברוטו ממכירת מוצר או שירות לא קשור מייצג את ההכנסה ממכירת מוצר או שירות לא קשור שמשויכת למודעות שלכם, בניכוי עלות המכר. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע וגם חולצה. מחיר החולצה הוא 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) בחשבון לקוח' מייצג את הסכום הכולל שהרווחתם ממוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. ההכנסה ממכירת מוצר או שירות לא קשור מייצגת את הערך הכולל שהרווחתם ממכירת מוצר או שירות לא קשור, שמשויכת למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה. מחיר הכובע הוא 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) בחשבון הלקוח' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במאמר בנושא מודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.
crossSellUnitsSold

number

המדד 'מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור (cross sell)' מייצג את המספר הכולל של המוצרים שנמכרו כתוצאה מפרסום של מוצר שונה. איך זה עובד: אתם מדווחים על המרות עם נתונים מעגלות קניות לגבי רכישות שבוצעו באתר. אם במודעה שאיתה הייתה ללקוח אינטראקציה לפני הרכישה הוצג מוצר קשור (פרטים נוספים זמינים במודעות שופינג), המערכת מתייחסת למוצר הזה בתור המוצר שפורסם. כל מוצר שכלול בהזמנה של הלקוח הוא מוצר שנמכר. אם המוצרים האלה לא זהים, המכירה נחשבת כמכירת מוצר או שירות לא קשור. מספר היחידות שנמכרו במסגרת מכירת מוצר או שירות לא קשור מייצג את המספר הכולל של המוצרים שנמכרו במסגרת מכירת מוצר או שירות לא קשור בכל ההזמנות שמשויכות למודעות שלכם. דוגמה: משתמש לחץ על מודעת שופינג לקידום כובע, ולאחר מכן קנה את אותו הכובע, וגם חולצה וז'קט. מספר היחידות שנמכרו במסגרת מכירת המוצר הלא קשור בהזמנה הזו הוא 2. המדד הזה זמין רק אם מדווחים על המרות עם נתונים מעגלות קניות.
clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

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

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