REST Resource: advertisers

משאב: מפרסם

מפרסם יחיד ב-Display & Video 360 (DV360).

ייצוג JSON 
{
  "name": string,
  "advertiserId": string,
  "partnerId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "generalConfig": {
    object (AdvertiserGeneralConfig)
  },
  "adServerConfig": {
    object (AdvertiserAdServerConfig)
  },
  "creativeConfig": {
    object (AdvertiserCreativeConfig)
  },
  "dataAccessConfig": {
    object (AdvertiserDataAccessConfig)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "servingConfig": {
    object (AdvertiserTargetingConfig)
  },
  "prismaEnabled": boolean
}
שדות
name

string

פלט בלבד. שם המשאב של המפרסם.
advertiserId

string (int64 format)

פלט בלבד. המזהה הייחודי של המפרסם. הוקצה על ידי המערכת.
partnerId

string (int64 format)

חובה. לא משתנה. המזהה הייחודי של השותף שאליו המפרסם שייך.
displayName

string

חובה. השם המוצג של המפרסם.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.
entityStatus

enum (EntityStatus)

חובה. המדיניות הזו קובעת אם הזמנות הקמפיין ופריטים של המפרסם יוכלו לנצל את התקציבים ולהגיש הצעות מחיר על מלאי שטחי פרסום.

  • הערכים הקבילים הם ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED ו-ENTITY_STATUS_SCHEDULED_FOR_DELETION.
  • אם המדיניות מוגדרת לערך ENTITY_STATUS_SCHEDULED_FOR_DELETION, המפרסם יימחק 30 יום אחרי המועד שבו תוזמנה המחיקה בפעם הראשונה.
updateTime

string (Timestamp format)

פלט בלבד. חותמת הזמן של העדכון האחרון של המפרסם. הוקצה על ידי המערכת.

חותמת זמן בפורמט "זולו" RFC3339 UTC, ברזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
generalConfig

object (AdvertiserGeneralConfig)

חובה. הגדרות כלליות של המפרסם.
adServerConfig

object (AdvertiserAdServerConfig)

חובה. לא משתנה. הגדרות של המפרסם הקשורות לשרת המודעות.
creativeConfig

object (AdvertiserCreativeConfig)

חובה. הגדרות של המפרסם שקשורות לקריאייטיב.
dataAccessConfig

object (AdvertiserDataAccessConfig)

הגדרות שקובעות את הגישה לנתוני המפרסם.
integrationDetails

object (IntegrationDetails)

פרטי השילוב של המפרסם. כרגע רק integrationCode רלוונטי למפרסם. שדות אחרים של IntegrationDetails לא נתמכים והמערכת תתעלם מהם אם תספקו אותם.
servingConfig

object (AdvertiserTargetingConfig)

הגדרות טירגוט שקשורות להצגת המודעות של המפרסם.
prismaEnabled

boolean

האם השילוב עם Mediaocean (Prisma) מופעל. הפעלת ההגדרה הזו מבטאת את הסכמתך לתנאים הבאים:

בשם החברה שלי, אני מאשר/ת ל-Mediaocean (Prisma) לשלוח תוכניות פילוח תקציב ל-Google, ואני מאשר/ת ל-Google לשלוח דוחות וחשבוניות תואמים מ-DV360 ל-Mediaocean למטרות תכנון תקציב, חיוב והתאמה עבור המפרסם הזה.

AdvertiserGeneralConfig

הגדרות כלליות של מפרסם.

ייצוג JSON 
{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}
שדות
domainUrl

string

חובה. כתובת ה-URL של הדומיין של האתר הראשי של המפרסם. המערכת תשלח מידע זה לבעלי אתרים שזקוקים לכתובת אתר כדי לשייך קמפיין למפרסם.

עליך לציין כתובת URL ללא נתיב או מחרוזת שאילתה, שמתחילה ב-http: או ב-https:. לדוגמה, http://www.example.com
timeZone

string

פלט בלבד. השם הסטנדרטי של מסד הנתונים TZ באזור הזמן של המפרסם. לדוגמה, America/New_York.

מידע נוסף זמין בכתובת: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

למפרסמים משולבים ב-CM360, אזור הזמן זהה לאזור הזמן בחשבון המשויך ב-CM360. אצל מפרסמים של צד שלישי בלבד, אזור הזמן זהה לאזור הזמן של שותף ההורה.
currencyCode

string

חובה. לא משתנה. המטבע של המפרסם בפורמט ISO 4217.

הקודים הקבילים והמטבעות שהם מייצגים הם:

קוד מטבע : שם מטבע

  • ARS : פזו ארגנטינאי
  • AUD : דולר אוסטרלי
  • BRL : ריאל ברזילאי
  • CAD : דולר קנדי
  • CHF : פרנק שוויצרי
  • CLP : פזו צ'יליאני
  • CNY : יואן סיני
  • COP : פזו קולומביאני
  • CZK : קורונה צ'כית
  • DKK : כתר דני
  • EGP : לירה מצרית
  • EUR : אירו
  • GBP : לירה שטרלינג
  • HKD : דולר הונג קונג
  • HUF : פורינט הונגרי
  • IDR : רופיה אינדונזית
  • ILS : שקל ישראלי
  • INR : רופי הודי
  • JPY : ין יפני
  • KRW : וון דרום קוריאני
  • MXN : פזו מקסיקני
  • MYR : רינגיט מלזי
  • NGN : נאירה ניגרי
  • NOK : כתר נורווגי
  • NZD : דולר ניו זילנדי
  • PEN : סול פרואני חדש
  • PLN : זלוטי פולני
  • RON : לאו רומני חדש
  • RUB : רובל רוסי
  • SEK : כתר שוודי
  • TRY : לירה טורקית
  • TWD : דולר טייוואני חדש
  • USD : דולר אמריקני
  • ZAR : ראנד דרום אפריקני

AdvertiserAdServerConfig

הגדרות של מפרסם הקשורות לשרת המודעות.

ייצוג JSON 
{

  // Union field ad_server_config_scheme can be only one of the following:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of list of possible types for union field ad_server_config_scheme.
}
שדות
שדה איחוד ad_server_config_scheme. חובה. הערך של ad_server_config_scheme יכול להיות רק אחת מהאפשרויות הבאות:
thirdPartyOnlyConfig

object (ThirdPartyOnlyConfig)

ההגדרה הזאת למפרסמים שמשתמשים בשרתי מודעות של צד שלישי בלבד.
cmHybridConfig

object (CmHybridConfig)

ההגדרה למפרסמים שמשתמשים גם בשרתי מודעות של Campaign Manager 360 (CM360) וגם בשרתי מודעות של צד שלישי.

ThirdPartyOnlyConfig

הגדרות למפרסמים שמשתמשים בשרתי מודעות של צד שלישי בלבד.

ייצוג JSON 
{
  "pixelOrderIdReportingEnabled": boolean
}
שדות
pixelOrderIdReportingEnabled

boolean

אם מופעל דיווח על מזהה הזמנה עבור פיקסלים. אי אפשר לשנות את הערך הזה אחרי שמגדירים אותו כ-true.

CmHybridConfig

הגדרות למפרסמים שמשתמשים גם ב-Campaign Manager 360 (CM360) וגם בשרתי מודעות של צד שלישי.

ייצוג JSON 
{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
שדות
cmAccountId

string (int64 format)

חובה. לא משתנה. מספר החשבון בתצורת Floodlight ב-CM360 שמקושר למפרסם ב-DV360.
cmFloodlightConfigId

string (int64 format)

חובה. לא משתנה. המזהה של תצורת Floodlight ב-CM360 שמקושר למפרסם ב-DV360.
cmSyncableSiteIds[]

string (int64 format)

רשימה של אתרים ב-CM360 שהמיקומים שלהם יסונכרנו עם DV360 כקריאייטיבים.

אם המאפיין חסר או ריק בשיטה advertisers.create, המערכת תיצור אתר של CM360 באופן אוטומטי.

הסרת אתרים מהרשימה הזו עלולה לגרום למחיקה של קריאייטיבים של DV360 שסונכרנו מ-CM360. יש לציין לפחות אתר אחד.
dv360ToCmDataSharingEnabled

boolean

האם לכלול נתוני DV360 בדוחות העברת נתונים ב-CM360.
dv360ToCmCostReportingEnabled

boolean

קביעה אם לדווח ל-CM360 על העלות של DV360.
cmFloodlightLinkingAuthorized

boolean

חובה. לא משתנה. הגדרת השדה הזה כ-true מבטאת אישור בשם החברה שלך לשיתוף מידע מהתצורה הנתונה ב-Floodlight עם המפרסם הזה ב-Display & Video 360.

AdvertiserCreativeConfig

הגדרות של מפרסם שקשורות לקריאייטיבים.

ייצוג JSON 
{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}
שדות
iasClientId

string (int64 format)

המזהה להגדרת מעקב אחר קמפיינים שסופק על ידי Integral Ad Service (IAS). מערכת DV360 תוסיף לתג הקריאייטיב תג IAS "Campaign Monitor" שמכיל את המזהה הזה.
obaComplianceDisabled

boolean

האם להשתמש בתאימות לפרסום התנהגותי אונליין (OBA) של DV360.

אזהרה: שינוי הגדרות OBA עלול לגרום לבבורסות פרסום מסוימות לאפס את סטטוס הביקורת של נכסי הקריאייטיב, וכתוצאה מכך הם לא יעמדו בדרישות להצגה עד שיאושרו מחדש.
dynamicCreativeEnabled

boolean

מציין אם המפרסם הופעל או לא הפעיל את האפשרות ליצירת קריאייטיבים דינמיים.
videoCreativeDataSharingAuthorized

boolean

הגדרת השדה הזה כ-true מהווה אישור מצידך בשם החברה ל-Google להשתמש בקריאייטיבים של וידאו המשויכים למפרסם הזה ב-Display & Video 360 כדי לספק תכונות ודיווח שקשורים לקמפיינים של המפרסם לטלוויזיה.

רלוונטי רק כאשר למפרסם יש תצורת שרת מודעות מסוג CM360 hybrid.

AdvertiserDataAccessConfig

הגדרות שקובעות איך אפשר לגשת לנתונים שקשורים למפרסם.

ייצוג JSON 
{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}
שדות
sdfConfig

object (AdvertiserSdfConfig)

הגדרות של קובצי נתונים מובנים (SDF) למפרסם.

אם לא מציינים שום אפשרות, המערכת תשתמש בהגדרות של SDF של שותף ההורה.

AdvertiserSdfConfig

הגדרות של קובצי נתונים מובְנים (SDF) של מפרסם.

ייצוג JSON 
{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}
שדות
overridePartnerSdfConfig

boolean

מציין אם המפרסם מבטל את הגדרת ה-SDF של שותף ההורה שלו.

כברירת מחדל, מפרסם יורש את ההגדרה של SDF משותף ההורה. כדי לשנות את הגדרות השותף, צריך להגדיר את השדה הזה כ-true ולהזין את ההגדרה החדשה ב-sdfConfig.
sdfConfig

object (SdfConfig)

תצורת SDF עבור המפרסם.

AdvertiserTargetingConfig

הגדרות טירגוט שקשורות להצגת המודעות של המפרסם.

ייצוג JSON 
{
  "exemptTvFromViewabilityTargeting": boolean
}
שדות
exemptTvFromViewabilityTargeting

boolean

מציין אם מכשירי טלוויזיה מחוברים פטורים מטירגוט ניראות בכל פריטי הווידאו של המפרסם.

שיטות

audit

 מפרסם מבצע ביקורת.

bulkEditAdvertiserAssignedTargetingOptions

 ביצוע עריכות בכמות גדולה של אפשרויות טירגוט אצל מפרסם יחיד.

bulkListAdvertiserAssignedTargetingOptions

 רשימת אפשרויות מיקוד שהוקצו למפרסם בכל סוגי המיקוד.

create

 יוצר מפרסם חדש.

delete

 מוחק מפרסם.

get

 מקבל מפרסם.

list

 רשימה של מפרסמים שנגישים למשתמש הנוכחי.

patch

 עדכון מפרסם קיים.