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

צריך לספק כתובת 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 עם המפרסם הזה ב-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

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

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

  • לעמוד בדרישות של תוכנית הפרסום אונליין לפי התנהגות המשתמש (OBA), בהתאם לחוזה שלכם עם Google Marketing Platform.
  • באזור הכלכלי האירופי (EEA), יש לכלול מידע על שקיפות ומנגנון שמאפשר למשתמשים לדווח על תוכן לא חוקי במודעות. אם אתם משתמשים בפתרון חלופי לדיווח, לשקיפות ולתגים של מודעות, עליכם לוודא שהפתרון כולל את מידע השקיפות הנדרש ואת המנגנון הנדרש לסימון תוכן לא חוקי. בנוסף, עליכם להודיע ל-Google על כל דיווח על תוכן לא חוקי באמצעות הטופס המתאים.
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

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

AdvertiserBillingConfig

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

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

string (int64 format)

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

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

שיטות

audit

 מבקרת מפרסם.

create

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

delete

 מוחק מפרסם.

editAssignedTargetingOptions

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

get

 מקבל מפרסם.

list

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

listAssignedTargetingOptions

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

patch

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