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)

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

חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
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)

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

שיטות

audit

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

create

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

delete

 מוחק מפרסם.

editAssignedTargetingOptions

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

get

 משיגים מפרסם.

list

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

listAssignedTargetingOptions

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

patch

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