REST Resource: advertisers

{
  "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)
  }
}

string

פלט בלבד. שם המשאב של המפרסם.

string (int64 format)

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

string (int64 format)

חובה. בלתי ניתן לשינוי. המזהה הייחודי של השותף שאליו שייך המפרסם.

string

חובה. השם המוצג של המפרסם.

חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 240 בייטים.

enum (EntityStatus)

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

• הערכים הקבילים הם ENTITY_STATUS_ACTIVE, ENTITY_STATUS_PAUSED ו-ENTITY_STATUS_SCHEDULED_FOR_DELETION.
• אם המדיניות מוגדרת לערך ENTITY_STATUS_SCHEDULED_FOR_DELETION, המפרסם יימחק 30 ימים מהמועד שבו תוזמן המחיקה שלו לראשונה.

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".

object (AdvertiserGeneralConfig)

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

object (AdvertiserAdServerConfig)

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

object (AdvertiserCreativeConfig)

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

object (AdvertiserDataAccessConfig)

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

object (IntegrationDetails)

פרטי השילוב של המפרסם. בשלב זה, רק הערך integrationCode רלוונטי למפרסם. שדות אחרים של IntegrationDetails לא נתמכים והמערכת תתעלם מהם אם יסופקו.

object (AdvertiserTargetingConfig)

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

boolean

האם השילוב עם Mediaocean (Prisma) מופעל. הפעלת ההגדרה הזו מבטאת את ההסכמה שלך לתנאים הבאים:

בשם החברה שלי, אני מרשה ל-Mediaocean (Prisma) לשלוח תוכניות לפלחי תקציב אל Google, ואני מרשה ל-Google לשלוח חשבוניות ודיווחים תואמים מ-DV360 אל Mediaocean למטרות תכנון תקציב, חיוב והתאמת תקציב עבור המפרסם הזה.

object (AdvertiserBillingConfig)

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

{
  "domainUrl": string,
  "timeZone": string,
  "currencyCode": string
}

string

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

צריך להזין כתובת URL ללא נתיב או מחרוזת שאילתה, שמתחילה ב-http: או ב-https:. לדוגמה, http://www.example.com

string

פלט בלבד. השם הסטנדרטי של מסד הנתונים TZ באזור הזמן של המפרסם. לדוגמה, America/New_York.

מידע נוסף זמין בכתובת: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

למפרסמים שמשתמשים ב-CM360, אזור הזמן שמוגדר בחשבון זהה לאזור הזמן שמוגדר בחשבון CM360 שמשויך להם. למפרסמים של צד שלישי בלבד, אזור הזמן זהה לאזור הזמן של שותף ההורה.

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 : ראנד דרום אפריקני

{

  // 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.
}

object (ThirdPartyOnlyConfig)

ההגדרה הזו מיועדת רק למפרסמים שמשתמשים בשרתי מודעות של צד שלישי.

object (CmHybridConfig)

ההגדרה למפרסמים שמשתמשים גם ב-Campaign Manager 360 (CM360) וגם בשרתי מודעות של צד שלישי.

{
  "pixelOrderIdReportingEnabled": boolean
}

boolean

האם להפעיל דיווח על מזהה הזמנה לפיקסלים או לא. אי אפשר לשנות את הערך הזה אחרי שמגדירים אותו ל-true.

{
  "cmAccountId": string,
  "cmFloodlightConfigId": string,
  "cmAdvertiserIds": [
    string
  ],
  "cmSyncableSiteIds": [
    string
  ],
  "dv360ToCmDataSharingEnabled": boolean,
  "dv360ToCmCostReportingEnabled": boolean,
  "cmFloodlightLinkingAuthorized": boolean
}

string (int64 format)

חובה. בלתי ניתן לשינוי. מספר החשבון של הגדרת Floodlight ב-CM360 שמקושרת למפרסם ב-DV360.

string (int64 format)

חובה. בלתי ניתן לשינוי. המזהה של הגדרת Floodlight ב-CM360 שמקושרת למפרסם ב-DV360.

string (int64 format)

פלט בלבד. הקבוצה של מזהי המפרסמים ב-CM360 שחולקים את הגדרות Floodlight ב-CM360.

string (int64 format)

רשימה של אתרים ב-CM360 שמיקומי המודעות שלהם יסונכרנו עם DV360 כקריאייטיבים.

אם השדה חסר או ריק בשיטה advertisers.create, המערכת תיצור באופן אוטומטי אתר ב-CM360.

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

boolean

האם לכלול או לא לכלול נתוני DV360 בדוחות העברת נתונים ב-CM360.

boolean

האם לדווח על העלות ב-DV360 ל-CM360.

boolean

חובה. בלתי ניתן לשינוי. הגדרת השדה הזה לערך true מבטאת את הסכמתך בשם החברה שלך לשיתוף מידע מתצורת Floodlight הנתונה מפרסם ב-Video 360.

{
  "iasClientId": string,
  "obaComplianceDisabled": boolean,
  "dynamicCreativeEnabled": boolean,
  "videoCreativeDataSharingAuthorized": boolean
}

string (int64 format)

מזהה להגדרת מעקב אחר קמפיינים, שסופק על ידי Integral Ad Service (IAS). מערכת DV360 תוסיף IAS 'Campaign Monitor' שמכיל את המזהה הזה לתג הקריאייטיב.

boolean

האם להשבית או לא להשבית את התכונה 'בנוגע למודעה הזו' של Google שמוסיפה תגים (לזיהוי התוכן כמודעה) ומידע בנושא שקיפות (באינטראקציה עם 'בנוגע למודעה הזו') למודעות שלכם בהתאם לדרישות התקינה ולפרסום המבוסס על התנהגות המשתמשים אונליין (OBA). המידע על המודעה הזו נותן למשתמשים יותר שליטה במודעות שהם רואים, ועוזר לך להסביר למה הם רואים את המודעה. מידע נוסף

אם בוחרים להגדיר את השדה הזה לערך true, חשוב לשים לב שהמודעות מוצגות דרך רשת המדיה Video 360 צריך לעמוד בדרישות הבאות:

• לעמוד בדרישות של התוכנית 'פרסום המבוסס על התנהגות המשתמשים אונליין' (OBA), בהתאם לחוזה שלכם עם Google Marketing Platform.
• באזור הכלכלי האירופי (EEA), יש לכלול מידע בנושא שקיפות ומנגנון שמאפשר למשתמשים לדווח על תוכן לא חוקי במודעות. אם משתמשים בפתרון חלופי לסימון מודעות, לשקיפות ולדיווח, יש לוודא שהפתרון כולל את פרטי השקיפות הנדרשים ואת המנגנון לסימון תוכן לא חוקי. בנוסף, צריך להודיע ל-Google על כל דיווח על תוכן לא חוקי באמצעות הטופס המתאים.

boolean

האם האפשרות של קריאייטיבים דינמיים מופעלת למפרסם או לא.

boolean

הגדרת השדה הזה לערך true מבטאת את הסכמתך, בשם החברה שלך, ל-Google להשתמש בקריאייטיבים של וידאו המשויכים לקמפיין הזה לרשת המדיה מפרסם ב-Video 360 כדי לספק דיווח ותכונות שקשורות לקמפיינים של המפרסם בטלוויזיה.

רלוונטי רק אם למפרסם יש הגדרה של שרת מודעות מסוג CM360 hybrid.

{
  "sdfConfig": {
    object (AdvertiserSdfConfig)
  }
}

object (AdvertiserSdfConfig)

הגדרות של קובצי נתונים מובנים (SDF) למפרסם.

אם לא מציינים זאת, המערכת תשתמש בהגדרות ה-SDF של השותף הראשי.

{
  "overridePartnerSdfConfig": boolean,
  "sdfConfig": {
    object (SdfConfig)
  }
}

boolean

ההגדרה קובעת אם המפרסם הזה מבטל את הגדרת ה-SDF של השותף הראשי שלו.

כברירת מחדל, מפרסם יורש את הגדרות ה-SDF מהשותף ההורה. כדי לשנות את ההגדרה של השותף, צריך להגדיר את השדה הזה ל-true ולספק את ההגדרה החדשה ב-sdfConfig.

object (SdfConfig)

תצורת ה-SDF עבור המפרסם.

• חובה כשהערך בשדה overridePartnerSdfConfig הוא true.
• פלט רק כאשר overridePartnerSdfConfig הוא false.

{
  "exemptTvFromViewabilityTargeting": boolean
}

boolean

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

{
  "billingProfileId": string
}

string (int64 format)

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