REST Resource: advertisers

משאב: מפרסם

מפרסם יחיד ברשת המדיה 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,
  "billingConfig": {
    object (AdvertiserBillingConfig)
  }
}
שדות
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 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "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 למטרות תכנון תקציב, חיוב והתאמת תקציב עבור המפרסם הזה.

billingConfig

object (AdvertiserBillingConfig)

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

AdvertiserGeneralConfig

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

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

string

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

צריך להזין כתובת 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,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}
שדות
cmAccountId

string (int64 format)

חובה. בלתי ניתן לשינוי. מספר החשבון של הגדרת Floodlight ב-CM360 שמקושרת למפרסם ב-DV360.

cmFloodlightConfigId

string (int64 format)

חובה. בלתי ניתן לשינוי. המזהה של הגדרת Floodlight ב-CM360 שמקושרת למפרסם ב-DV360.

cmAdvertiserIds[]

string (int64 format)

פלט בלבד. הקבוצה של מזהי המפרסמים ב-CM360 שחולקים את הגדרות Floodlight ב-CM360.

cmSyncableSiteIds[]

string (int64 format)

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

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

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

dv360ToCmDataSharingEnabled

boolean

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

dv360ToCmCostReportingEnabled

boolean

האם לדווח על העלות ב-DV360 ל-CM360.

cmFloodlightLinkingAuthorized

boolean

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

האם להשבית או לא להשבית את התכונה 'בנוגע למודעה הזו' של Google שמוסיפה תגים (לזיהוי התוכן כמודעה) ומידע בנושא שקיפות (באינטראקציה עם 'בנוגע למודעה הזו') למודעות שלכם בהתאם לדרישות התקינה ולפרסום המבוסס על התנהגות המשתמשים אונליין (OBA). המידע על המודעה הזו נותן למשתמשים יותר שליטה במודעות שהם רואים, ועוזר לך להסביר למה הם רואים את המודעה. מידע נוסף

אם בוחרים להגדיר את השדה הזה לערך true, חשוב לשים לב שהמודעות מוצגות דרך רשת המדיה Video 360 צריך לעמוד בדרישות הבאות:

  • לעמוד בדרישות של התוכנית 'פרסום המבוסס על התנהגות המשתמשים אונליין' (OBA), בהתאם לחוזה שלכם עם Google Marketing Platform.
  • באזור הכלכלי האירופי (EEA), יש לכלול מידע בנושא שקיפות ומנגנון שמאפשר למשתמשים לדווח על תוכן לא חוקי במודעות. אם משתמשים בפתרון חלופי לסימון מודעות, לשקיפות ולדיווח, יש לוודא שהפתרון כולל את פרטי השקיפות הנדרשים ואת המנגנון לסימון תוכן לא חוקי. בנוסף, צריך להודיע ל-Google על כל דיווח על תוכן לא חוקי באמצעות הטופס המתאים.
dynamicCreativeEnabled

boolean

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

videoCreativeDataSharingAuthorized

boolean

הגדרת השדה הזה לערך true מבטאת את הסכמתך, בשם החברה שלך, ל-Google להשתמש בקריאייטיבים של וידאו המשויכים לקמפיין הזה לרשת המדיה מפרסם ב-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

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

AdvertiserBillingConfig

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

ייצוג JSON
{
  "billingProfileId": string
}
שדות
billingProfileId

string (int64 format)

המזהה של פרופיל חיוב שהוקצה למפרסם.

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

שיטות

audit

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

create

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

delete

מוחק מפרסם.

editAssignedTargetingOptions

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

get

משיגים מפרסם.

list

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

listAssignedTargetingOptions

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

patch

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