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 ובמודעות ליצירת ביקוש במסגרת המפרסם הזה, אם לא סופק נכס לוגו.

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

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 תוסיף לתג הקריאייטיב תג Campaign Monitor של IAS שמכיל את המזהה הזה.
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

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