- משאב: פריט שורה
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- פלטפורמה
- שיטות
משאב: פריט שורה
פריט יחיד.
ייצוג JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
שדות | |
---|---|
name |
פלט בלבד. שם המשאב של הפריט. |
advertiserId |
פלט בלבד. המזהה הייחודי של המפרסם שאליו שייך הפריט. |
campaignId |
פלט בלבד. המזהה הייחודי של הקמפיין שהפריט שייך לו. |
insertionOrderId |
חובה. לא משתנה. המזהה הייחודי של הזמנת הקמפיין שאליה שייך הפריט. |
lineItemId |
פלט בלבד. המזהה הייחודי של הפריט. הוקצה על ידי המערכת. |
displayName |
חובה. השם המוצג של הפריט. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים. |
lineItemType |
חובה. לא משתנה. סוג הפריט. |
entityStatus |
חובה. המדיניות הזו קובעת אם הפריט יכול לנצל את התקציב ולהגיש הצעות מחיר על מלאי שטחי פרסום.
|
updateTime |
פלט בלבד. חותמת הזמן של העדכון האחרון של הפריט. הוקצה על ידי המערכת. חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
partnerCosts[] |
עלויות השותף שמשויכות לפריט. אם המאפיין חסר או ריק בשיטה |
flight |
חובה. זמן ההתחלה ושעת הסיום של הטיסה של הפריט. |
budget |
חובה. הגדרת הקצאת התקציב של הפריט. |
pacing |
חובה. הגדרת מהירות ההוצאה של התקציב של הפריט. |
frequencyCap |
חובה. ההגדרות של מכסת תדירות החשיפות של הפריט. אם מקצים מכסה מוגבלת, צריך להשתמש בשדה |
partnerRevenueModel |
חובה. הגדרת מודל הכנסות השותף עבור הפריט. |
conversionCounting |
הגדרת מעקב ההמרות של הפריט. |
creativeIds[] |
המזהים של נכסי הקריאייטיב שמשויכים לפריט. |
bidStrategy |
חובה. שיטת הבידינג של הפריט. |
integrationDetails |
פרטי השילוב של הפריט. |
inventorySourceIds[] |
המזהים של המקורות של מלאי שטחי הפרסום הפרטי שהוקצו לפריט. |
targetingExpansion |
הגדרות הרחבת הטירגוט של הפריט. אפשר להחיל את ההגדרה הזו רק אם לפריט מוקצה טירגוט שעומד בדרישות של רשימות קהלים. |
warningMessages[] |
פלט בלבד. הודעות האזהרה שנוצרו על ידי הפריט. האזהרות האלה לא חוסמות את שמירת הפריט, אבל חלק מהן עלולות לחסום את ההפעלה של הפריט. |
mobileApp |
האפליקציה לנייד שהפריט מקדם. רלוונטי רק כאשר הערך של |
reservationType |
פלט בלבד. סוג ההזמנה של הפריט. |
excludeNewExchanges |
האם להחריג בורסות חדשות מטירגוט אוטומטי על ידי הפריט. השדה הזה מוגדר כ-False כברירת מחדל. |
LineItemType
סוגים אפשריים של פריט.
סוג הפריט קובע אילו הגדרות ואפשרויות ניתן להחיל, כמו הפורמט של המודעות או אפשרויות הטירגוט.
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
LINE_ITEM_TYPE_DISPLAY_DEFAULT |
מודעות תמונה, HTML5, מודעות מותאמות או מודעות מדיה עשירה. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL |
מודעות ברשת המדיה שמעודדות התקנות של אפליקציה. |
LINE_ITEM_TYPE_VIDEO_DEFAULT |
מודעות וידאו שנמכרות על בסיס עלות לאלף חשיפות במגוון סביבות. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL |
מודעות וידאו שמעודדות התקנות של אפליקציה. |
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY |
מודעות לרשת המדיה מוצגות במלאי שטחי פרסום באפליקציות לנייד. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
מודעות וידאו מוצגות במלאי שטחי פרסום באפליקציות לנייד. |
LINE_ITEM_TYPE_AUDIO_DEFAULT |
מודעות אודיו של RTB שנמכרות במגוון סביבות. |
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP |
מודעות ישירות ללקוח (OTT). הסוג הזה רלוונטי רק לפריטים עם הזמנת קמפיין של insertionOrderType OVER_THE_TOP . |
LINE_ITEM_TYPE_DISPLAY_COMMERCE |
מודעות ממומנות למוצר שמוצגות בנכס של קמעונאי. |
LineItemFlight
הגדרות שקובעות את משך הפעילות של פריט.
ייצוג JSON |
---|
{ "flightDateType": enum ( |
שדות | |
---|---|
flightDateType |
חובה. הסוג של תאריכי הטיסה של הפריט. |
dateRange |
תאריכי ההתחלה והסיום של הטיסה בפריט. הם מזוהים בהתאם לאזור הזמן של מפרסם ההורה.
|
triggerId |
המזהה של הטריגר הידני שמשויך לפריט.
|
LineItemFlightDateType
סוגים אפשריים של תאריכי טיסה של פריט.
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED |
תאריכי פרק הזמן של הפרסום של הפריט עוברים בירושה מהזמנת האם של הפריט. |
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM |
לפריט הזה יש תאריכי פרסום מותאמים אישית משלו. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
הפריט משתמש בטריגר. |
LineItemBudget
הגדרות שקובעות את אופן הקצאת התקציב.
ייצוג JSON |
---|
{ "budgetAllocationType": enum ( |
שדות | |
---|---|
budgetAllocationType |
חובה. הסוג של הקצאת התקציב.
|
budgetUnit |
פלט בלבד. יחידת התקציב מציינת אם התקציב מבוסס על מטבע או על חשיפות. הערך הזה עובר בירושה מהזמנת ההורה. |
maxAmount |
סכום התקציב המקסימלי שיושקע בפריט. חייב להיות גדול מ-0. כשהערך בשדה
|
LineItemBudgetAllocationType
סוגים אפשריים של הקצאת התקציב
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC |
הקצאת תקציב אוטומטית מופעלת עבור הפריט. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED |
סכום קבוע של תקציב מקסימלי מוקצה לפריט. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
לא חלה מגבלת תקציב על הפריט. |
PartnerRevenueModel
הגדרות שקובעות איך מחושבות הכנסות השותף.
ייצוג JSON |
---|
{
"markupType": enum ( |
שדות | |
---|---|
markupType |
חובה. סוג תגי העיצוב של מודל הכנסות השותף. |
markupAmount |
חובה. סכום תגי העיצוב של מודל הכנסות השותף. חייב להיות גדול מ-0 או שווה לו.
|
PartnerRevenueModelMarkupType
סוגי תגי עיצוב אפשריים במודל הכנסות השותף.
טיפוסים בני מנייה (enums) | |
---|---|
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED |
ערך הסוג לא צוין או שהוא לא ידוע בגרסה הזו. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM |
מחשבים את הכנסות השותף על סמך עלות קבועה לאלף חשיפות. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP |
מחשבים את הכנסות השותף על סמך אחוז התשלום הנוסף מתוך עלות המדיה. |
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP |
מחשבים את הכנסות השותף על סמך אחוז התשלום הנוסף מתוך עלות המדיה הכוללת, שכולל את כל עלויות השותפים ועלויות הנתונים. |
ConversionCountingConfig
הגדרות שקובעות איך המרות נספרות.
המערכת תספור את כל ההמרות שהתרחשו בעקבות קליק. ניתן להגדיר ערך באחוזים לספירת המרות לאחר צפייה.
ייצוג JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
שדות | |
---|---|
postViewCountPercentageMillis |
אחוז ההמרות לאחר צפייה שצריך לספור, באלפיות השנייה (1/1,000 של אחוז). חייב להיות בין 0 ל-100,000, כולל. לדוגמה, כדי לעקוב אחר 50% מההמרות שהתרחשו לאחר קליק, מגדירים את הערך 50,000. |
floodlightActivityConfigs[] |
הגדרות הפעילות ב-Floodlight שמשמשות למעקב אחר המרות. מספר ההמרות שנספרו הוא הסכום של כל ההמרות שנספרו לפי כל מזהי הפעילות ב-Floodlight שצוינו בשדה הזה. |
TrackingFloodlightActivityConfig
הגדרות שקובעות את ההתנהגות של תצורה יחידה של פעילות ב-Floodlight.
ייצוג JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
שדות | |
---|---|
floodlightActivityId |
חובה. המזהה של הפעילות ב-Floodlight. |
postClickLookbackWindowDays |
חובה. מספר הימים לאחר קליק על מודעה שבהם ניתן לספור המרה. חייב להיות בין 0 ל-90, כולל. |
postViewLookbackWindowDays |
חובה. מספר הימים לאחר צפייה במודעה שבהם ניתן לספור המרה. חייב להיות בין 0 ל-90, כולל. |
TargetingExpansionConfig
הגדרות שקובעות את הרחבת הטירגוט של הפריט. הרחבת הטירגוט מאפשרת לפריט להגיע לקהל גדול יותר על סמך רשימת החברים בקהל המקורית ורמת הרחבת הטירגוט.
ייצוג JSON |
---|
{
"targetingExpansionLevel": enum ( |
שדות | |
---|---|
targetingExpansionLevel |
חובה. מידת ההרחבה של הטירגוט הרלוונטי בפריט הזה. |
excludeFirstPartyAudience |
חובה. האם להחריג קהלים מאינטראקציה ישירה מהטירגוט. קהלים דומים מרשימות שהוחרגו מאינטראקציה ישירה לא יוחרגו. רלוונטי רק כאשר קהל מאינטראקציה ישירה מטורגט באופן חיובי (ישירות או נכלל בקהל משולב), אחרת המערכת תתעלם מהבחירה הזו. |
TargetingExpansionLevel
תיאור איכותני של רמת ההרחבה.
טיפוסים בני מנייה (enums) | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
רמת הרחבת הטירגוט לא צוינה או שאינה ידועה בגרסה זו. |
NO_EXPANSION |
הרחבת הטירגוט מושבתת. |
LEAST_EXPANSION |
הרחבת טירגוט שמרני, פוטנציאל חשיפה נמוך יותר. |
SOME_EXPANSION |
הרחבת טירגוט שמרנית במידה בינונית, פוטנציאל חשיפה נמוך יותר. |
BALANCED_EXPANSION |
הרחבת טירגוט ברמה בינונית, פוטנציאל חשיפה בינוני. |
MORE_EXPANSION |
הרחבת טירגוט בצורה אגרסיבית יותר, פוטנציאל חשיפה גבוה יותר. |
MOST_EXPANSION |
הרחבת טירגוט אגרסיבית, פוטנציאל חשיפה מקסימלי. |
LineItemWarningMessage
הודעות האזהרה שנוצרו על ידי פריט מסוים. אזהרות מסוג זה לא חוסמות שמירת פריט, אבל הן עלולות לחסום הפעלה של פריט.
טיפוסים בני מנייה (enums) | |
---|---|
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED |
לא צוין או לא ידוע. |
INVALID_FLIGHT_DATES |
לפריט הזה הוגדרו תאריכים לא חוקיים של פרק זמן של פרסום פעיל. הפריט לא יפעל. |
EXPIRED |
תאריך הסיום של הפריט הזה חל בעבר. |
PENDING_FLIGHT |
הפריט הזה יתחיל לפעול בעתיד. |
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED |
כל הערוצים המופעלים של שותפים נכללים במיקוד שלילי. הפריט לא יפעל. |
INVALID_INVENTORY_SOURCE |
אין מיקוד למקורות פעילים של מלאי שטחי פרסום. הפריט לא יפעל. |
APP_INVENTORY_INVALID_SITE_TARGETING |
המיקוד לאפליקציות ולכתובות URL של הפריט הזה לא כולל אפליקציות לנייד. סוג הפריט הזה מחייב אותך לכלול אפליקציות לנייד בטירגוט של הערוץ, רשימת האתרים או האפליקציות. הפריט לא יפעל. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
הפריט הזה לא מטרגט משתמשים בנייד. לסוג הפריט הזה צריך לטרגט רשימת משתמשים עם משתמשים בנייד. הפריט לא יפעל. |
NO_VALID_CREATIVE |
הפריט הזה לא מכיל קריאייטיב חוקי. הפריט לא יפעל. |
PARENT_INSERTION_ORDER_PAUSED |
סדר ההכנסה של הפריט הזה נמצא בהשהיה. הפריט לא יפעל. |
PARENT_INSERTION_ORDER_EXPIRED |
לסדר ההכנסה של הפריט הזה הוגדר תאריך סיום שכבר חלף. הפריט לא יפעל. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
הפריט הזה לא ממקד לרשימות קהלים, מה שעשוי להוביל לניצול מהיר מדי של התקציב. |
APP_INSTALL_NO_CONVERSION_PIXEL |
לפריט הזה של התקנת אפליקציה עדיין לא הוגדר פיקסל המרה. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
הפריט הזה מטרגט רשימת משתמשים אחת או יותר שכבר לא זמינה. מצב כזה ימנע בעתיד את הצגת הפריט, לכן מומלץ להסיר את הרשימות האלה מהטירגוט. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
לפריט הזה לעידוד התקנת אפליקציה לא הוגדרה שיטת בידינג אופטימלית |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
הפריט הזה ממקד לעסקאות שתומכות בגודלי קראייטיב שלא נמצאים בשימוש. מצב כזה עשוי להגביל את ההצגה או הביצועים של הפריט. |
NO_CREATIVE_FOR_TARGETED_DEALS |
הפריט הזה לא מכיל קריאייטיב עבור העסקאות המטורגטות. |
TARGETING_DEPRECATED_GEO_TARGET |
הפריט הזה מטרגט טירגוט גיאוגרפי שהוצא משימוש. |
MobileApp
אפליקציה לנייד המקודמת על ידי פריט של התקנת אפליקציה לנייד.
ייצוג JSON |
---|
{
"appId": string,
"platform": enum ( |
שדות | |
---|---|
appId |
חובה. מזהה האפליקציה שסופק על ידי חנות הפלטפורמה. אפליקציות ל-Android מזוהות לפי מזהה החבילה שמשמש את חנות Play של Android, למשל אפליקציות ל-iOS מזוהות באמצעות מזהה אפליקציה בן תשע ספרות ש-App Store של Apple משתמש בו. למשל: |
platform |
פלט בלבד. פלטפורמת האפליקציה. |
displayName |
פלט בלבד. שם האפליקציה. |
publisher |
פלט בלבד. הבעלים של האפליקציה. |
הפלטפורמה
פלטפורמות אפשריות של אפליקציות לנייד.
טיפוסים בני מנייה (enums) | |
---|---|
PLATFORM_UNSPECIFIED |
לא צוינה פלטפורמה. |
IOS |
iOS. |
ANDROID |
פלטפורמת Android. |
שיטות |
|
---|---|
|
ביצוע עריכות בכמות גדולה של אפשרויות טירגוט בפריט יחיד. |
|
בתיבת הדו-שיח הזו מפורטים אפשרויות טירגוט שהוקצו לפריט בכל סוגי הטירגוט. |
|
יצירת פריט חדש. |
|
מוחק פריט. |
|
הפונקציה יוצרת פריט חדש עם ההגדרות (כולל טירגוט) שעברו בירושה מהזמנת הקמפיין וentity_status ENTITY_STATUS_DRAFT . |
|
מקבל פריט. |
|
בתיבת הדו-שיח הזו מוצגים פריטים של מפרסם. |
|
עדכון פריט קיים. |