- משאב: קמפיין
- CampaignGoal
- CampaignGoalType
- PerformanceGoal
- PerformanceGoalType
- CampaignFlight
- CampaignBudget
- ExternalBudgetSource
- PrismaConfig
- PrismaType
- PrismaCpeCode
- שיטות
משאב: קמפיין
קמפיין יחיד.
ייצוג ב-JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "displayName": string, "entityStatus": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של הקמפיין. |
advertiserId |
פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הקמפיין. |
campaignId |
פלט בלבד. המזהה הייחודי של הקמפיין. המערכת מקצה את השם. |
displayName |
חובה. שם התצוגה של הקמפיין. הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים. |
entityStatus |
חובה. ההגדרה קובעת אם הזמנות ההכנסה בקמפיין הזה יוכלו להוציא את התקציבים שלהן ולהגיש הצעות מחיר על מלאי שטחי הפרסום.
|
updateTime |
פלט בלבד. חותמת הזמן של מועד העדכון האחרון של הקמפיין. המערכת מקצה את השם. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: |
campaignGoal |
חובה. היעד של הקמפיין. |
campaignFlight |
חובה. ההוצאה המתוכננת ומשך הקמפיין. |
frequencyCap |
חובה. הגדרת מכסת התדירות של הקמפיין. |
campaignBudgets[] |
רשימת התקציבים שזמינים לקמפיין הזה. אם השדה הזה לא מוגדר, הקמפיין משתמש בתקציב בלתי מוגבל. |
CampaignGoal
הגדרות ששולטות ביעד של קמפיין.
ייצוג ב-JSON |
---|
{ "campaignGoalType": enum ( |
שדות | |
---|---|
campaignGoalType |
חובה. הסוג של יעד הקמפיין. |
performanceGoal |
חובה. יעד הביצועים של הקמפיין. הערכים הקבילים של
|
CampaignGoalType
סוגי היעדים האפשריים בקמפיינים.
טיפוסים בני מנייה (enum) | |
---|---|
CAMPAIGN_GOAL_TYPE_UNSPECIFIED |
ערך היעד לא צוין או לא ידוע בגרסה הזו. |
CAMPAIGN_GOAL_TYPE_APP_INSTALL |
הגדלת מספר ההתקנות של האפליקציה או האינטראקציות עם האפליקציה. |
CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS |
להגביר את המוּדעוּת למותג או למוצר. |
CAMPAIGN_GOAL_TYPE_OFFLINE_ACTION |
הגדלת המכירות אופליין או המכירות בחנות. |
CAMPAIGN_GOAL_TYPE_ONLINE_ACTION |
הגדלת מספר הפעולות אונליין או את מספר הכניסות. |
PerformanceGoal
הגדרות ששולטות ביעד הביצועים של קמפיין.
ייצוג ב-JSON |
---|
{ "performanceGoalType": enum ( |
שדות | |
---|---|
performanceGoalType |
חובה. הסוג של יעד הביצועים. |
שדה האיחוד performance_goal_value . חובה. ערך יעד הביצועים שתואם ל-performance_goal_type נתון. הערך של performance_goal_value יכול להיות רק אחת מהאפשרויות הבאות: |
|
performanceGoalAmountMicros |
סכום היעד, במיליוניות של המטבע של המפרסם. רלוונטי כאשר
לדוגמה, הערך 1500000 מייצג 1.5 יחידות סטנדרטיות של המטבע. |
performanceGoalPercentageMicros |
הייצוג העשרוני של אחוז היעד ב-micros. רלוונטי כאשר
לדוגמה, הערך 70000 מייצג 7% (0.07 בערך עשרוני). |
performanceGoalString |
מחרוזת של מדד ביצועים מרכזי (KPI), שיכולה להיות ריקה. חייב להיות מקודד ב-UTF-8 באורך של עד 100 תווים. רלוונטי כאשר |
PerformanceGoalType
סוגי יעדי הביצועים האפשריים.
טיפוסים בני מנייה (enum) | |
---|---|
PERFORMANCE_GOAL_TYPE_UNSPECIFIED |
סוג יעד הביצועים לא צוין או שהוא לא ידוע בגרסה הזו. |
PERFORMANCE_GOAL_TYPE_CPM |
יעד הביצועים מוגדר לפי עלות לאלף חשיפות (CPM). |
PERFORMANCE_GOAL_TYPE_CPC |
יעד הביצועים מוגדר לפי עלות לקליק (CPC). |
PERFORMANCE_GOAL_TYPE_CPA |
יעד הביצועים מוגדר לפי עלות להמרה (CPA). |
PERFORMANCE_GOAL_TYPE_CTR |
יעד הביצועים מוגדר כאחוז שיעור הקליקים (CTR). |
PERFORMANCE_GOAL_TYPE_VIEWABILITY |
יעד הביצועים מוגדר באחוזים של ניראות. |
PERFORMANCE_GOAL_TYPE_CPIAVC |
יעד הביצועים מוגדר כעלות לחשיפת אודיו וחשיפה ויזואלית בעת ההשלמה (CPIAVC). |
PERFORMANCE_GOAL_TYPE_CPE |
יעד הביצועים מוגדר לפי עלות למעורבות (CPE). |
PERFORMANCE_GOAL_TYPE_CPV |
יעד הביצועים מוגדר לפי עלות לצפייה (CPV). |
PERFORMANCE_GOAL_TYPE_CLICK_CVR |
יעד הביצועים מוגדר באחוזים של שיעור ההמרה מקליקים (המרות לכל קליק). |
PERFORMANCE_GOAL_TYPE_IMPRESSION_CVR |
יעד הביצועים מוגדר כאחוז שיעור ההמרה לחשיפה (המרות לכל חשיפה). |
PERFORMANCE_GOAL_TYPE_VCPM |
יעד הביצועים מוגדר לפי עלות לאלף חשיפות שניתנות לצפייה (VCPM). |
PERFORMANCE_GOAL_TYPE_VTR |
יעד הביצועים מוגדר כאחוז של שיעור הצפיות ב-YouTube (צפיות ב-YouTube לכל חשיפה). |
PERFORMANCE_GOAL_TYPE_AUDIO_COMPLETION_RATE |
יעד הביצועים מוגדר באחוזים של שיעור השלמת ההאזנה לאודיו (האזנות מלאות לאודיו לכל חשיפת מודעה). |
PERFORMANCE_GOAL_TYPE_VIDEO_COMPLETION_RATE |
יעד הביצועים מוגדר כאחוז שיעור השלמת הצפייה בסרטון (צפיות בסרטון שהושלמו לכל חשיפה). |
PERFORMANCE_GOAL_TYPE_OTHER |
יעד הביצועים מוגדר כ'אחר'. |
CampaignFlight
הגדרות למעקב אחרי ההוצאה המתוכננת והמשך הקמפיין.
ייצוג ב-JSON |
---|
{
"plannedSpendAmountMicros": string,
"plannedDates": {
object ( |
שדות | |
---|---|
plannedSpendAmountMicros |
הסכום הצפוי להוצאה בקמפיין עבור הסכום מופיע במיליוניות. חייב להיות גדול מ-0 או שווה לו. לדוגמה, הערך 500000000 מייצג 500 יחידות רגילות של המטבע. |
plannedDates |
חובה. התאריכים שבהם הקמפיין צפוי לפעול. הן מומרות לפי אזור הזמן של המפרסם ההורה.
|
CampaignBudget
הגדרות שקובעות את אופן הקצאת התקציב של הקמפיין.
ייצוג ב-JSON |
---|
{ "budgetId": string, "displayName": string, "budgetUnit": enum ( |
שדות | |
---|---|
budgetId |
המזהה הייחודי של תקציב הקמפיין. המערכת מקצה את השם. לא להגדיר תקציבים חדשים. צריך לכלול את השדה הזה כשמוסיפים או מעדכנים תקציבים ב- |
displayName |
חובה. השם המוצג של התקציב. הקידוד חייב להיות UTF-8 והגודל המקסימלי הוא 240 בייטים. |
budgetUnit |
חובה. לא ניתן לשינוי. השדה מציין אם התקציב נמדד במטבע או בחשיפות. |
budgetAmountMicros |
חובה. הסכום הכולל שאפשר להקצות לפלחים של סדרי ההכנסה המקושרים. הסכום מופיע במיליוניות. הערך חייב להיות גדול מ-0. לדוגמה, הערך 500000000 מייצג 500 יחידות רגילות של המטבע. |
dateRange |
חובה. טווח התאריכים של תקציב הקמפיין. יכול להיות שטווח התאריכים של פלחים מקושרים של תקציב יהיה שונה. הן מומרות לפי אזור הזמן של המפרסם ההורה. הערכים של |
externalBudgetSource |
חובה. המקור החיצוני של התקציב. |
externalBudgetId |
לא ניתן לשינוי. המזהה שמזהה את התקציב הזה למקור החיצוני. אם השדה הזה מוגדר ורמת הפרטים בחשבונית של פרופיל החיוב התואם מוגדרת כ'הזמנת רכש ברמת התקציב', כל החשיפות שמוצגות במסגרת התקציב הזה יכללו את המזהה הזה בחשבונית. השם חייב להיות ייחודי בקמפיין. |
invoiceGroupingId |
לא ניתן לשינוי. המזהה שמשמש לקבץ תקציבים כך שייכללו באותה חשבונית. אם השדה הזה מוגדר וברמת החשבונית של פרופיל החיוב המתאים מוגדר הערך 'מזהה קיבוץ של חשבונית תקציב', כל ה- |
prismaConfig |
מטא-נתונים נוספים לשימוש בכלי Mediaocean Prisma. חובה עבור תקציבים של Mediaocean. המאפיין הזה רלוונטי רק למפרסמים ב- |
ExternalBudgetSource
מקור חיצוני לפלח של תקציב הקמפיין.
טיפוסים בני מנייה (enum) | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
הערך של מקור התקציב החיצוני לא צוין או לא ידוע בגרסה הזו. |
EXTERNAL_BUDGET_SOURCE_NONE |
לתקציב אין מקור חיצוני. |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
מקור התקציב הוא Mediaocean. |
PrismaConfig
הגדרות ספציפיות לכלי Mediaocean Prisma.
ייצוג ב-JSON |
---|
{ "prismaType": enum ( |
שדות | |
---|---|
prismaType |
חובה. סוג Prisma. |
prismaCpeCode |
חובה. קודי לקוח, מוצר והצעת מחיר רלוונטיים מהכלי Prisma של Mediaocean. |
supplier |
חובה. הישות שהקצתה את התקציב הזה (מערכת ניהול רשתות פרסום, אתר וכו'). |
PrismaType
הסוגים האפשריים של תקציב ב-Prisma.
טיפוסים בני מנייה (enum) | |
---|---|
PRISMA_TYPE_UNSPECIFIED |
הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
PRISMA_TYPE_DISPLAY |
סוג התצוגה. |
PRISMA_TYPE_SEARCH |
סוג החיפוש. |
PRISMA_TYPE_VIDEO |
סוג הסרטון. |
PRISMA_TYPE_AUDIO |
סוג האודיו. |
PRISMA_TYPE_SOCIAL |
סוג הרשת החברתית. |
PRISMA_TYPE_FEE |
סוג העמלה. |
PrismaCpeCode
במרכז התשלומים ב-Google יש תמיכה בחיפוש ובסינון של שדות הרכיבים של הקוד הזה.
ייצוג ב-JSON |
---|
{ "prismaClientCode": string, "prismaProductCode": string, "prismaEstimateCode": string } |
שדות | |
---|---|
prismaClientCode |
קוד הלקוח ב-Prisma. |
prismaProductCode |
קוד המוצר ב-Prisma. |
prismaEstimateCode |
קוד ההצעה של Prisma. |
Methods |
|
---|---|
|
יוצרים קמפיין חדש. |
|
מחיקה לצמיתות של קמפיין. |
|
אחזור קמפיין. |
|
רשימת הקמפיינים של המפרסם. |
|
רשימה של אפשרויות הטירגוט שהוקצו לקמפיין לפי סוגי טירגוט. |
|
עדכון של קמפיין קיים. |