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)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "defaultBusinessName": string,
  "defaultLogoAssetId": string
}
שדות
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 ספרות אחרי הנקודה. אפשר להשתמש גם בהיסטים אחרים, לא רק ב-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 לשלוח ל-Mediaocean דיווחים וחשבוניות תואמים מ-DV360 לצורך תכנון תקציב, חיוב והתאמה של המפרסם הזה.
billingConfig

object (AdvertiserBillingConfig)

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

enum (EuPoliticalAdvertisingStatus)

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

אם השדה הזה מוגדר ל-DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, יקרו הדברים הבאים:

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

string

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

זהו הערך שמשמש במודעות ב-YouTube ובקמפיינים ליצירת ביקוש אצל המפרסם הזה אם לא צוין שם עסק.
defaultLogoAssetId

string (int64 format)

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

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

חובה להשתמש ב-advertisers.adAssets.upload כדי להעלות את הנכס הזה באמצעות ה-API.

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)

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

Methods

audit

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

create

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

delete

 מחיקת מפרסם.

editAssignedTargetingOptions

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

get

 מקבלים מפרסם.

list

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

listAssignedTargetingOptions

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

patch

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