- משאב: AdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- תמונה ממוזערת
- VideoPerformanceAd
- AdUrl
- AdUrlType
- שיטות
משאב: AdGroupAd
מודעה יחידה שמשויכת לקבוצת מודעות.
ייצוג JSON |
---|
{ "name": string, "advertiserId": string, "adGroupAdId": string, "adGroupId": string, "displayName": string, "entityStatus": enum ( |
שדות | |
---|---|
name |
שם המשאב של המודעה. |
advertiserId |
המזהה הייחודי של המפרסם שאליו שייכת המודעה. |
adGroupAdId |
המזהה הייחודי של המודעה. הוקצה על ידי המערכת. |
adGroupId |
המזהה הייחודי של קבוצת המודעות שאליה שייכת המודעה. |
displayName |
השם המוצג של המודעה. חייב להיות בקידוד UTF-8 ובגודל מקסימלי של 255 בייטים. |
entityStatus |
סטטוס הישות של המודעה. |
adUrls[] |
רשימה של כתובות ה-URL שבהן המודעה משתמשת. |
שדה איחוד ad_details . פרטי המודעה. הערך של ad_details יכול להיות רק אחת מהאפשרויות הבאות: |
|
displayVideoSourceAd |
פרטים על מקור מודעה מקריאייטיב של Display & Video 360. |
mastheadAd |
פרטים על המודעה שהוצגה בפיד הבית של YouTube. |
inStreamAd |
פרטים על מודעת וידאו In-stream שניתן לדלג עליה אחרי 5 שניות, המשמשת להגברת המוּדעוּת למותג או להשגת יעדים שיווקיים. |
nonSkippableAd |
פרטים על מודעת וידאו קצרה In-stream שלא ניתן לדלג עליה באורך של 6 עד 15 שניות, המשמשת להשגת יעדים שיווקיים. |
bumperAd |
פרטים על מודעת וידאו קצרה שלא ניתן לדלג עליה, באורך של פחות מ-6 שניות, המשמשת להגדלת פוטנציאל החשיפה. |
audioAd |
פרטים של מודעת אודיו המשמשת להשגת יעדים שיווקיים. |
videoDiscoverAd |
פרטים על מודעה שמקדמת סרטון שמוצג במקומות שבהם המשתמשים מחפשים. |
videoPerformanceAd |
פרטים על מודעה שנכללת בקמפיין וידאו עם קריאה לפעולה כדי לעודד פעולות בעסק, בשירות או במוצר. |
DisplayVideoSourceAd
המקור של המודעה הוא קריאייטיב של DV360.
ייצוג JSON |
---|
{ "creativeId": string } |
שדות | |
---|---|
creativeId |
המזהה של קריאייטיב המקור. |
MastheadAd
פרטים לגבי מודעה מסוג Masthead.
ייצוג JSON |
---|
{ "video": { object ( |
שדות | |
---|---|
video |
סרטון ה-YouTube המשמש את המודעה. |
headline |
הכותרת של המודעה. |
description |
תיאור המודעה. |
videoAspectRatio |
יחס הגובה-רוחב של סרטון YouTube שמופעל אוטומטית במודעה מסוג Masthead. |
autoplayVideoStartMillisecond |
משך הזמן באלפיות השנייה שאחריו הסרטון מתחיל לפעול. |
autoplayVideoDuration |
משך הזמן שבמהלכו הסרטון יופעל באופן אוטומטי. משך זמן בשניות עם עד תשע ספרות אחרי הנקודה העשרונית, המסתיים ב-' |
callToActionButtonLabel |
הטקסט בלחצן הקריאה לפעולה. |
callToActionFinalUrl |
כתובת היעד של לחצן הקריאה לפעולה. |
callToActionTrackingUrl |
כתובת ה-URL למעקב של לחצן הקריאה לפעולה. |
showChannelArt |
האם להציג רקע או באנר שמופיעים בחלק העליון של דף YouTube. |
companionYoutubeVideos[] |
הסרטונים שמופיעים לצד מודעות מסוג Masthead במחשב. יכולים להיות לכל היותר שניים. |
YoutubeVideoDetails
פרטים של סרטון ב-YouTube.
ייצוג JSON |
---|
{
"id": string,
"unavailableReason": enum ( |
שדות | |
---|---|
id |
מזהה הווידאו ב-YouTube, שניתן לחפש בדף האינטרנט ב-YouTube. |
unavailableReason |
הסיבה לכך שנתוני הסרטון לא זמינים. |
VideoAspectRatio
יחסי גובה-רוחב אפשריים לסרטון YouTube.
טיפוסים בני מנייה (enums) | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
לא צוין או לא ידוע. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
לאחר מתיחת הסרטון, החלק העליון והתחתון נחתכים. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
לסרטון יש יחס גובה-רוחב קבוע של 16:9. |
InStreamAd
פרטים של מודעת וידאו In-stream.
ייצוג JSON |
---|
{
"commonInStreamAttribute": {
object ( |
שדות | |
---|---|
commonInStreamAttribute |
מאפייני מודעות נפוצים. |
customParameters |
הפרמטרים המותאמים אישית שצריך להעביר ערכים מותאמים אישית לתבנית של כתובת URL למעקב. אובייקט שמכיל רשימה של |
CommonInStreamAttribute
מאפיינים נפוצים של מודעות וידאו In-stream, מודעות שלא ניתן לדלג עליהן ומודעות באמפר.
ייצוג JSON |
---|
{ "displayUrl": string, "finalUrl": string, "trackingUrl": string, "actionButtonLabel": string, "actionHeadline": string, "video": { object ( |
שדות | |
---|---|
displayUrl |
כתובת דף האינטרנט שמופיעה במודעה. |
finalUrl |
כתובת ה-URL של הדף שאליו אנשים מגיעים אחרי שלחצו על המודעה. |
trackingUrl |
כתובת ה-URL שנטענת ברקע למטרות מעקב. |
actionButtonLabel |
הטקסט בלחצן הקריאה לפעולה. |
actionHeadline |
הכותרת של הבאנר של הקריאה לפעולה. |
video |
סרטון YouTube של המודעה. |
companionBanner |
התמונה שמוצגת לצד מודעת הווידאו. |
ImageAsset
מטא-נתונים של נכס תמונות.
ייצוג JSON |
---|
{
"mimeType": string,
"fullSize": {
object ( |
שדות | |
---|---|
mimeType |
סוג MIME של נכס התמונה. |
fullSize |
מטא-נתונים לתמונה הזו בגודלה המקורי. |
fileSize |
גודל הקובץ של נכס התמונות בבייטים. |
NonSkippableAd
פרטים לגבי מודעה שאי אפשר לדלג עליה.
ייצוג JSON |
---|
{
"commonInStreamAttribute": {
object ( |
שדות | |
---|---|
commonInStreamAttribute |
מאפייני מודעות נפוצים. |
customParameters |
הפרמטרים המותאמים אישית שצריך להעביר ערכים מותאמים אישית לתבנית של כתובת URL למעקב. אובייקט שמכיל רשימה של |
BumperAd
פרטים על מודעת באמפר.
ייצוג JSON |
---|
{
"commonInStreamAttribute": {
object ( |
שדות | |
---|---|
commonInStreamAttribute |
מאפייני מודעות נפוצים. |
AudioAd
פרטים על מודעת אודיו.
ייצוג JSON |
---|
{
"displayUrl": string,
"finalUrl": string,
"trackingUrl": string,
"video": {
object ( |
שדות | |
---|---|
displayUrl |
כתובת דף האינטרנט שמופיעה במודעה. |
finalUrl |
כתובת ה-URL של הדף שאליו אנשים מגיעים אחרי שלחצו על המודעה. |
trackingUrl |
כתובת ה-URL שנטענת ברקע למטרות מעקב. |
video |
סרטון YouTube של המודעה. |
VideoDiscoveryAd
פרטים של מודעת Video Discovery.
ייצוג JSON |
---|
{ "headline": string, "description1": string, "description2": string, "video": { object ( |
שדות | |
---|---|
headline |
הכותרת של המודעה. |
description1 |
שורת הטקסט הראשונה של המודעה. |
description2 |
שורת הטקסט השנייה של המודעה. |
video |
סרטון YouTube שהמודעה מקדמת. |
thumbnail |
תמונה ממוזערת שמופיעה במודעה. |
התמונה הממוזערת
אפשרויות לתמונות ממוזערות אפשריות במודעות Video Discovery.
טיפוסים בני מנייה (enums) | |
---|---|
THUMBNAIL_UNSPECIFIED |
לא ידוע או לא מפורט. |
THUMBNAIL_DEFAULT |
התמונה הממוזערת המוגדרת כברירת מחדל ניתנת ליצירה אוטומטית או להעלאה על ידי משתמשים. |
THUMBNAIL_1 |
תמונה ממוזערת 1, שנוצרה מהסרטון. |
THUMBNAIL_2 |
תמונה ממוזערת 2, שנוצרה מהסרטון. |
THUMBNAIL_3 |
תמונה ממוזערת 3, שנוצרה מהסרטון. |
VideoPerformanceAd
פרטים על מודעת וידאו לביצועים.
ייצוג JSON |
---|
{ "finalUrl": string, "trackingUrl": string, "actionButtonLabels": [ string ], "headlines": [ string ], "longHeadlines": [ string ], "descriptions": [ string ], "displayUrlBreadcrumb1": string, "displayUrlBreadcrumb2": string, "domain": string, "videos": [ { object ( |
שדות | |
---|---|
finalUrl |
כתובת ה-URL של הדף שאליו אנשים מגיעים אחרי שלחצו על המודעה. |
trackingUrl |
כתובת ה-URL שנטענת ברקע למטרות מעקב. |
actionButtonLabels[] |
רשימת נכסי הטקסט שמוצגת בלחצן הקריאה לפעולה. |
headlines[] |
רשימת הכותרות שמוצגת בבאנר הקריאה לפעולה. |
longHeadlines[] |
רשימת הכותרות הבודדות שמוצגת בבאנר הקריאה לפעולה. |
descriptions[] |
רשימת התיאורים שמוצגים בבאנר של הקריאה לפעולה. |
displayUrlBreadcrumb1 |
החלק הראשון אחרי הדומיין בכתובת ה-URL לתצוגה. |
displayUrlBreadcrumb2 |
החלק השני אחרי הדומיין בכתובת ה-URL לתצוגה. |
domain |
הדומיין של כתובת ה-URL לתצוגה. |
videos[] |
רשימת נכסי הווידאו ב-YouTube שבהם נעשה שימוש במודעה הזו. |
customParameters |
הפרמטרים המותאמים אישית שצריך להעביר ערכים מותאמים אישית לתבנית של כתובת URL למעקב. אובייקט שמכיל רשימה של |
companionBanners[] |
רשימת מודעות הבאנר הנלוות שבהן משתמשת מודעה זו. |
AdUrl
כתובות URL נוספות שקשורות למודעה, כולל איתות Bluetooth.
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
הסוג של כתובת ה-URL של המודעה. |
url |
ערך המחרוזת של כתובת ה-URL. |
AdUrlType
סוגים אפשריים של כתובות אתרים של מודעה.
טיפוסים בני מנייה (enums) | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
לא ידוע או לא מפורט. |
AD_URL_TYPE_BEACON_IMPRESSION |
פיקסל למעקב בגודל 1x1 שמבצע פינג כשמוצגת חשיפה של קריאייטיב. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
חיישן חשיפה של DCM שניתן להרחבה. בזמן ההצגה, הרדיוס מתרחב למספר איתות Bluetooth. |
AD_URL_TYPE_BEACON_CLICK |
כתובת ה-URL למעקב שאליה יש לשלוח פינג כשאירוע הקליק מופעל. |
AD_URL_TYPE_BEACON_SKIP |
כתובת ה-URL למעקב שאליה יש לשלוח פינג כשאירוע הדילוג מופעל. |
שיטות |
|
---|---|
|
הפונקציה מקבלת מודעה ברמת קבוצת המודעות. |
|
הצגת המודעות בקבוצת המודעות. |