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

צריך להזין כתובת 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, חשוב לזכור שמודעות שמוצגות דרך 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

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