- ייצוג JSON
- AdGroupCriterionStatus
- QualityInfo
- CriterionSystemServingStatus
- AdGroupCriterionApprovalStatus
- PositionEstimates
- ListingGroupInfo
- ListingGroupType
- ListingDimensionPath
- AppPaymentModelInfo
- AppPaymentModelType
- CustomIntentInfo
קריטריון של קבוצת מודעות. הדוח adGroupCriterion מחזיר רק קריטריונים שנוספו במפורש לקבוצת המודעות.
ייצוג JSON |
---|
{ "resourceName": string, "displayName": string, "status": enum ( |
שדות | |
---|---|
resourceName |
בלתי משתנה. שם המשאב של קריטריון קבוצת המודעות. שמות המשאבים של קריטריון של קבוצות מודעות בפורמט הבא:
|
displayName |
פלט בלבד. השם המוצג של הקריטריון. השינויים בשדה הזה לא נלקחים בחשבון. |
status |
הסטטוס של הקריטריון. זהו הסטטוס של ישות הקריטריון של קבוצת המודעות, שהוגדרה על ידי הלקוח. הערה: יכול להיות שבדוחות בממשק המשתמש יש מידע נוסף שמשפיע על העמידה של קריטריון מסוים. במקרים מסוימים, קריטריון שהוסר מ-API עדיין עשוי להופיע כמופעל בממשק המשתמש. לדוגמה, קמפיינים מוצגים כברירת מחדל למשתמשים בכל טווחי הגילאים, אלא אם הם מוחרגים. בממשק המשתמש כל טווח גילאים יוצג כ'מופעל', מכיוון שטווח הגילאים יהיה 'מופעל'. לעומת זאת, ב-AdGroupCriterion.status יוצג הסטטוס 'הוסר' מפני שלא נוסף קריטריון חיובי. |
qualityInfo |
פלט בלבד. מידע בנוגע לאיכות הקריטריון. |
type |
פלט בלבד. סוג הקריטריון. |
systemServingStatus |
פלט בלבד. סטטוס ההצגה של הקריטריון. |
approvalStatus |
פלט בלבד. סטטוס האישור של הקריטריון. |
disapprovalReasons[] |
פלט בלבד. רשימת הסיבות לדחייה של הקריטריון. הסיבות השונות לדחיית קריטריון מופיעות כאן: https://support.google.com/adspolicy/answer/6008942 השדה הזה הוא לקריאה בלבד. |
labels[] |
פלט בלבד. שמות המשאבים של התוויות המצורפות לקריטריון של קבוצת המודעות הזו. |
effectiveCpcBidSource |
פלט בלבד. המקור של הצעת המחיר בפועל לקליק. |
effectiveCpmBidSource |
פלט בלבד. המקור של הצעת המחיר בפועל לאלף חשיפות. |
effectiveCpvBidSource |
פלט בלבד. המקור של הצעת המחיר האפקטיבית לצפייה. |
effectivePercentCpcBidSource |
פלט בלבד. המקור של הצעת המחיר בפועל לקליק באחוזים. |
positionEstimates |
פלט בלבד. אומדנים של הצעות מחיר לקריטריון במיקומים שונים. |
finalUrls[] |
הרשימה של כתובות ה-URL הסופיות האפשריות לאחר כל ההפניות האוטומטיות בדומיינים של המודעה. |
finalMobileUrls[] |
הרשימה של כתובות ה-URL הסופיות האפשריות בנייד לאחר כל ההפניות האוטומטיות בדומיינים שונים. |
urlCustomParameters[] |
רשימת המיפויים שמשמשת להחלפת תגי פרמטרים מותאמים אישית ב- |
criterionId |
פלט בלבד. מזהה הקריטריון. השינויים בשדה הזה לא נלקחים בחשבון. |
adGroup |
בלתי משתנה. קבוצת המודעות שאליה שייך הקריטריון. |
negative |
בלתי משתנה. האם לטרגט ( אי אפשר לשנות את השדה הזה. כדי לשנות קריטריון מחיובי לשלילי, יש להסיר אותו ולהוסיף אותו מחדש. |
bidModifier |
ערך ההתאמה של הצעת המחיר כאשר הקריטריון תואם. ערך ההתאמה חייב להיות בטווח: 0.1 - 10.0. רוב סוגי הקריטריונים שניתן לטרגט תומכים במגבילי התאמה. |
cpcBidMicros |
הצעת המחיר לקליק (CPC). |
cpmBidMicros |
הצעת המחיר לאלף חשיפות הניתנות לצפייה (vCPM). |
cpvBidMicros |
הצעת המחיר של עלות לצפייה (CPV). |
percentCpcBidMicros |
סכום הצעת המחיר לקליק, מבוטאת כשבר מהמחיר שפורסם עבור מוצר או שירות כלשהו. הטווח החוקי של השבר הוא [0,1) והערך שמאוחסן כאן הוא 1,000,000 * [fraction]. |
effectiveCpcBidMicros |
פלט בלבד. הצעת המחיר האפקטיבית לקליק. |
effectiveCpmBidMicros |
פלט בלבד. הצעת המחיר בפועל לאלף חשיפות (CPM) (עלות לאלף חשיפות הניתנות לצפייה). |
effectiveCpvBidMicros |
פלט בלבד. הצעת המחיר האפקטיבית לצפייה (CPV). |
effectivePercentCpcBidMicros |
פלט בלבד. הסכום בפועל של הצעת המחיר באחוזים לקליק. |
finalUrlSuffix |
תבנית לכתובת URL להוספת פרמטרים לכתובת URL סופית. |
trackingUrlTemplate |
התבנית של כתובת ה-URL ליצירת כתובת URL למעקב. |
שדה איחוד יש להגדיר בדיוק ערך אחד. |
|
keyword |
בלתי משתנה. מילת מפתח. |
placement |
בלתי משתנה. מיקום. |
mobileAppCategory |
בלתי משתנה. קטגוריית אפליקציות לנייד. |
mobileApplication |
בלתי משתנה. אפליקציה לנייד. |
listingGroup |
בלתי משתנה. הקבוצה של כרטיסי המוצר. |
ageRange |
בלתי משתנה. טווח גילאים. |
gender |
בלתי משתנה. מגדר. |
incomeRange |
בלתי משתנה. טווח הכנסה. |
parentalStatus |
בלתי משתנה. סטטוס הורה. |
userList |
בלתי משתנה. רשימת משתמשים. |
youtubeVideo |
בלתי משתנה. סרטון ב-YouTube. |
youtubeChannel |
בלתי משתנה. ערוץ YouTube. |
topic |
בלתי משתנה. נושא. |
userInterest |
בלתי משתנה. תחום עניין של משתמש. |
webpage |
בלתי משתנה. דף אינטרנט |
appPaymentModel |
בלתי משתנה. מודל תשלום לאפליקציות. |
customAffinity |
בלתי משתנה. תחום עניין משותף שהוגדר |
customIntent |
בלתי משתנה. קהל בהתאמה אישית לפי כוונת רכישה. |
customAudience |
בלתי משתנה. קהל בהתאמה אישית. |
combinedAudience |
בלתי משתנה. קהל משולב. |
audience |
בלתי משתנה. קהל. |
location |
בלתי משתנה. מיקום. |
language |
בלתי משתנה. שפה. |
AdGroupCriterionStatus
הסטטוסים האפשריים של קבוצת מודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין ערך. |
UNKNOWN |
הערך שהתקבל לא ידוע בגרסה הזו. זהו ערך לתגובה בלבד. |
ENABLED |
קריטריון של קבוצת מודעות מופעל. |
PAUSED |
קריטריון קבוצת המודעות מושהה. |
REMOVED |
קריטריון של קבוצת מודעות הוסר. |
QualityInfo
מאגר למידע על איכות של קריטריון של קבוצת מודעות.
ייצוג JSON |
---|
{ "creativeQualityScore": enum ( |
שדות | |
---|---|
creativeQualityScore |
פלט בלבד. ביצועי המודעה בהשוואה למפרסמים אחרים. |
postClickQualityScore |
פלט בלבד. ציון האיכות של דף הנחיתה. |
searchPredictedCtr |
פלט בלבד. שיעור הקליקים בהשוואה לשיעור הקליקים של מפרסמים אחרים. |
qualityScore |
פלט בלבד. ציון האיכות. ייתכן שהשדה הזה לא יאוכלס אם אין ל-Google מספיק מידע כדי לקבוע ערך. |
CriterionSystemServingStatus
מונה את סטטוס ההצגה של מערכת הקריטריונים.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
ELIGIBLE |
כשירה. |
RARELY_SERVED |
נפח חיפושים נמוך. |
AdGroupCriterionApprovalStatus
מציין את סטטוס האישור של קבוצת המודעות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
הערך לא ידוע בגרסה הזו. |
APPROVED |
מאושר. |
DISAPPROVED |
לא מאושר. |
PENDING_REVIEW |
בהמתנה לבדיקה. |
UNDER_REVIEW |
בבדיקה. |
PositionEstimates
אומדנים של הצעות מחיר לקריטריון במיקומים שונים.
ייצוג JSON |
---|
{ "firstPageCpcMicros": string, "firstPositionCpcMicros": string, "topOfPageCpcMicros": string, "estimatedAddClicksAtFirstPositionCpc": string, "estimatedAddCostAtFirstPositionCpc": string } |
שדות | |
---|---|
firstPageCpcMicros |
פלט בלבד. האומדן של הצעת המחיר לקליק הדרושה כדי שהמודעה תופיע בדף הראשון של תוצאות החיפוש. |
firstPositionCpcMicros |
פלט בלבד. ההערכה של הצעת המחיר לקליק הנדרשת כדי שהמודעה תופיע במיקום הראשון, בראש הדף הראשון של תוצאות החיפוש. |
topOfPageCpcMicros |
פלט בלבד. האומדן של הצעת המחיר לקליק הדרושה כדי שהמודעה תוצג בראש הדף הראשון של תוצאות החיפוש. |
estimatedAddClicksAtFirstPositionCpc |
פלט בלבד. הערכה של מספר הקליקים שניתן לקבל בשבוע על ידי שינוי הצעת המחיר למילות מפתח לערך ב-firstPositionCpcMicros. |
estimatedAddCostAtFirstPositionCpc |
פלט בלבד. הערכת האופן שבו העלות לשבוע עשויה להשתנות כאשר משנים את הצעת המחיר למילות מפתח לערך ב-firstPositionCpcMicros. |
ListingGroupInfo
קריטריון של קבוצה של כרטיסי מוצר.
ייצוג JSON |
---|
{ "type": enum ( |
שדות | |
---|---|
type |
סוג הקבוצה של כרטיסי המוצר. |
caseValue |
ערך המאפיין שלפיו הקבוצה של כרטיסי המוצר משפרת את ההורה שלה. לא מוגדר לקבוצת הבסיס. |
parentAdGroupCriterion |
שם המשאב של קריטריון של קבוצת מודעות, שהוא חלוקת המשנה של הקבוצה של כרטיסי המוצר ברמה העליונה. null בקבוצת הבסיס. |
path |
נתיב המאפיינים המגדירים את הקבוצה הזו של כרטיסי מוצר. |
ListingGroupType
סוג הקבוצה של כרטיסי המוצר.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
SUBDIVISION |
חלוקת משנה של מוצרים לאורך מאפיין מסוים של כרטיס המוצר. הצמתים האלה לא משמשים לצורך טירגוט ערכים של רישומים, אלא רק כדי להגדיר את מבנה העץ. |
UNIT |
יחידה של קבוצה של כרטיסי מוצר שמגדירה הצעת מחיר. |
ListingDimensionPath
נתיב המאפיינים המגדירים קבוצה של כרטיסי מוצר.
ייצוג JSON |
---|
{
"dimensions": [
{
object ( |
שדות | |
---|---|
dimensions[] |
הנתיב המלא של מאפיינים בהיררכיה של הקבוצה של כרטיסי המוצר, מהרמה הבסיסית (root) (לא כולל הרמה הבסיסית) ועד לקבוצה הזו של כרטיסי המוצר. |
AppPaymentModelInfo
קריטריון של מודל תשלום לאפליקציה.
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
סוג מודל התשלום של האפליקציה. |
AppPaymentModelType
דוגמאות למודלים אפשריים של תשלום באפליקציות.
טיפוסים בני מנייה (enums) | |
---|---|
UNSPECIFIED |
לא צוין. |
UNKNOWN |
משמש לציון הערך המוחזר בלבד. מייצג ערך לא ידוע בגרסה הזו. |
PAID |
מייצגות אפליקציות בתשלום. |
CustomIntentInfo
קריטריון בהתאמה אישית עם כוונת רכישה. ניתן לטרגט קריטריון מהסוג הזה בלבד.
ייצוג JSON |
---|
{ "customIntent": string } |
שדות | |
---|---|
customIntent |
שם המשאב של תחום עניין בהתאמה אישית. |