- משאב: YouTubeAdGroupAd
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- תמונה ממוזערת
- VideoPerformanceAd
- AdUrl
- AdUrlType
- שיטות
משאב: YouTubeAdGroupAd
מודעה יחידה שמשויכת לקבוצת מודעות ב-YouTube.
ייצוג 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 נוספות שקשורות למודעה, כולל משׂואות רשת (beacons).
ייצוג JSON |
---|
{
"type": enum ( |
שדות | |
---|---|
type |
הסוג של כתובת ה-URL של המודעה. |
url |
ערך המחרוזת של כתובת ה-URL. |
AdUrlType
סוגים אפשריים של כתובות URL של מודעה.
טיפוסים בני מנייה (enums) | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
לא ידוע או לא צוין. |
AD_URL_TYPE_BEACON_IMPRESSION |
פיקסל למעקב בגודל 1x1 שיבצע פינג כשמוצגת חשיפה של קריאייטיב. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
חיישן חשיפה ניתן להרחבה של DCM. בזמן ההצגה, הוא מורחב לכמה משואות רשת. |
AD_URL_TYPE_BEACON_CLICK |
כתובת ה-URL למעקב שיש לשלוח אליה פינג כשאירוע הקליק מופעל. |
AD_URL_TYPE_BEACON_SKIP |
כתובת ה-URL למעקב שאליה יש לבצע פינג כשהאירוע הדילוג מופעל. |
שיטות |
|
---|---|
|
יוצר מודעה בקבוצת מודעות ב-YouTube. |
|
בתיבת הדו-שיח הזו מוצגים המודעות של קבוצת המודעות ב-YouTube. |