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)

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

הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", ‏ "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
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 של אתר כדי לשייך קמפיין למפרסם.

יש לציין כתובת 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)

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

Methods

audit

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

create

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

delete

 מחיקה של מפרסם.

editAssignedTargetingOptions

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

get

 הפונקציה מקבלת מפרסם.

list

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

listAssignedTargetingOptions

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

patch

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