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)
}
שדות
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 תוך יום.

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

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