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