- משאב: קמפיין
- 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 |
פלט בלבד. חותמת הזמן של העדכון האחרון של הקמפיין. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
campaignGoal |
חובה. מטרת הקמפיין. |
campaignFlight |
חובה. ההוצאה המתוכננת ומשך הזמן של הקמפיין. |
frequencyCap |
חובה. ההגדרה של מכסת התדירות בקמפיין. |
campaignBudgets[] |
רשימת התקציבים שזמינים לקמפיין הזה. אם לא מגדירים את השדה הזה, הקמפיין משתמש בתקציב בלתי מוגבל. |
CampaignGoal
הגדרות שקובעות מה היעד של הקמפיין.
ייצוג JSON |
---|
{ "campaignGoalType": enum ( |
שדות | |
---|---|
campaignGoalType |
חובה. הסוג של יעד הקמפיין. |
performanceGoal |
חובה. יעד הביצועים של הקמפיין. הערכים הקבילים עבור
|
CampaignGoalType
סוגים אפשריים של יעדי קמפיין.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
ייצוג עשרוני של אחוז היעד במיליוניות השנייה. רלוונטי אם
לדוגמה: 70000 מייצג את 7% (0.07 עשרוני). |
performanceGoalString |
מחרוזת של אינדיקטור ביצועים מרכזיים (KPI), שיכולה להיות ריקה. הקידוד חייב להיות UTF-8 באורך של עד 100 תווים. רלוונטי אם הערך של |
PerformanceGoalType
סוגים אפשריים של יעדי ביצועים.
טיפוסים בני מנייה (enums) | |
---|---|
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_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
מקור חיצוני לפלח תקציב של קמפיין.
טיפוסים בני מנייה (enums) | |
---|---|
EXTERNAL_BUDGET_SOURCE_UNSPECIFIED |
הערך של מקור התקציב החיצוני לא צוין או לא ידוע בגרסה הזו. |
EXTERNAL_BUDGET_SOURCE_NONE |
לתקציב אין מקור חיצוני. |
EXTERNAL_BUDGET_SOURCE_MEDIA_OCEAN |
מקור התקציב הוא Mediaocean. |
PrismaConfig
הגדרות ספציפיות לכלי Mediaocean Prisma.
ייצוג JSON |
---|
{ "prismaType": enum ( |
שדות | |
---|---|
prismaType |
חובה. סוג Prisma. |
prismaCpeCode |
חובה. קודים רלוונטיים של לקוחות, מוצרים והערכות מכלי Mediaocean Prisma. |
supplier |
חובה. הישות הקצתה את התקציב הזה (DSP, אתר וכו'). |
PrismaType
סוגים אפשריים של תקציב ב-Prisma.
טיפוסים בני מנייה (enums) | |
---|---|
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. |
שיטות |
|
---|---|
|
יצירת קמפיין חדש. |
|
מוחק קמפיין לצמיתות. |
|
הפונקציה מקבלת קמפיין. |
|
בתיבת הדו-שיח הזו מוצגים הקמפיינים של המפרסם. |
|
רשימת אפשרויות מיקוד שהוקצו לקמפיין בסוגי טירגוט שונים. |
|
עדכון קמפיין קיים. |