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

פלט בלבד. השם של אזור הזמן של המפרסם במסד הנתונים הרגיל של אזורי זמן. לדוגמה, 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 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "thirdPartyOnlyConfig": {
    object (ThirdPartyOnlyConfig)
  },
  "cmHybridConfig": {
    object (CmHybridConfig)
  }
  // End of mutually exclusive fields.
}
שדות
חובה. הרשימה הבאה כוללת שדות שאי אפשר להשתמש בהם בו-זמנית. בכל תשובה יוגדר לכל היותר אחד מהשדות:
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 צריכות לעמוד בדרישות הבאות:

  • השימוש ב-Google Marketing Platform צריך להיות בהתאם לכללים של פרסום המבוסס על התנהגות המשתמשים אונליין (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

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