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