- المورد: 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 |
تفاصيل إعلان مستنِد إلى تصميم إعلان في "مساحة العرض والفيديو 360". |
mastheadAd |
|
inStreamAd |
تفاصيل إعلان أثناء عرض الفيديو قابل للتخطي بعد 5 ثوانٍ، يُستخدَم لتعزيز الوعي بالعلامة التجارية أو الوصول إلى الأهداف التسويقية. |
nonSkippableAd |
تفاصيل إعلان قصير غير قابل للتخطي أثناء عرض الفيديو، تتراوح مدته بين 6 ثوانٍ و15 ثانية، ويُستخدم لتحقيق الأهداف التسويقية. |
bumperAd |
تفاصيل إعلان فيديو قصير غير قابل للتخطّي، تبلغ مدته 6 ثوانٍ أو أقلّ، ويتم استخدامه لمدى الوصول إلى الجمهور. |
audioAd |
تفاصيل إعلان صوتي يُستخدَم لتحقيق الأهداف التسويقية. |
videoDiscoverAd |
تفاصيل إعلان يروِّج لفيديو يظهر في أماكن العثور عليه |
videoPerformanceAd |
تفاصيل إعلان مستخدَم في حملة فيديو إجرائية لجذب المزيد من الإجراءات إلى النشاط التجاري أو الخدمة أو المنتج. |
DisplayVideoSourceAd
مصدر الإعلان من تصميم إعلان على "مساحة العرض والفيديو 360".
تمثيل JSON |
---|
{ "creativeId": string } |
الحقول | |
---|---|
creativeId |
رقم تعريف تصميم الإعلان المصدر. |
MastheadAd
تفاصيل "إعلان التسمية الرئيسية".
تمثيل JSON |
---|
{ "video": { object ( |
الحقول | |
---|---|
video |
فيديو YouTube الذي يستخدمه الإعلان. |
headline |
عنوان الإعلان. |
description |
وصف الإعلان. |
videoAspectRatio |
نسبة العرض إلى الارتفاع لفيديو YouTube الذي يتم تشغيله تلقائيًا على إعلان التسمية الرئيسية |
autoplayVideoStartMillisecond |
مقدار الوقت بالمللي ثانية الذي سيبدأ بعده تشغيل الفيديو. |
autoplayVideoDuration |
المدة التي سيتم خلالها تشغيل الفيديو تلقائيًا. مدة بالثواني يصل عددها إلى تسعة أرقام كسرية وتنتهي بـ " |
callToActionButtonLabel |
النص المعروض على زر عبارة الحث على اتخاذ إجراء. |
callToActionFinalUrl |
عنوان URL المقصود لزر عبارة الحث على الشراء. |
callToActionTrackingUrl |
عنوان URL لتتبُّع زر عبارة الحث على اتخاذ إجراء. |
showChannelArt |
ما إذا كنت تريد إظهار خلفية أو بانر في أعلى صفحة YouTube |
companionYoutubeVideos[] |
الفيديوهات التي تظهر بجانب "إعلان التسمية الرئيسية" على أجهزة الكمبيوتر المكتبي لا يمكن أن يكون أكثر من اثنين. |
YoutubeVideoDetails
تفاصيل فيديو على YouTube
تمثيل JSON |
---|
{
"id": string,
"unavailableReason": enum ( |
الحقول | |
---|---|
id |
معرّف فيديو YouTube الذي يمكن البحث عنه على صفحة YouTube على الويب. |
unavailableReason |
سبب عدم توفّر بيانات الفيديو |
VideoAspectRatio
نِسب العرض إلى الارتفاع المحتملة لفيديو على YouTube
عمليات التعداد | |
---|---|
VIDEO_ASPECT_RATIO_UNSPECIFIED |
غير محدد أو غير معروف. |
VIDEO_ASPECT_RATIO_WIDESCREEN |
يتم تمديد الفيديو واقتصاص الجزء العلوي والسفلي من الفيديو. |
VIDEO_ASPECT_RATIO_FIXED_16_9 |
يستخدم الفيديو نسبة عرض إلى ارتفاع ثابتة تبلغ 16:9. |
InStreamAd
تفاصيل الإعلان أثناء عرض الفيديو.
تمثيل JSON |
---|
{
"commonInStreamAttribute": {
object ( |
الحقول | |
---|---|
commonInStreamAttribute |
سمات الإعلانات الشائعة |
customParameters |
المعلمات المخصصة لتمرير القيم المخصصة إلى نموذج عنوان URL للتتبع. عنصر يحتوي على قائمة من أزواج |
CommonInStreamAttribute
السمات الشائعة للإعلانات أثناء عرض الفيديو والإعلانات غير القابلة للتخطّي وإعلانات الملصقات الصغيرة
تمثيل 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 |
الصورة المصغّرة المستخدمة في الإعلان |
الصورة المصغّرة
خيارات الصور المصغّرة المحتملة في "الإعلانات أثناء التصفّح" للفيديو
عمليات التعداد | |
---|---|
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 الإضافية ذات الصلة بالإعلان، بما في ذلك الإشارات.
تمثيل JSON |
---|
{
"type": enum ( |
الحقول | |
---|---|
type |
نوع عنوان URL للإعلان. |
url |
قيمة سلسلة عنوان URL. |
AdUrlType
أنواع عناوين URL الإعلانية المحتملة.
عمليات التعداد | |
---|---|
AD_URL_TYPE_UNSPECIFIED |
غير معروفة أو غير محدّدة |
AD_URL_TYPE_BEACON_IMPRESSION |
بكسل تتبع 1×1 يتم إرساله عند عرض تصميم إعلان. |
AD_URL_TYPE_BEACON_EXPANDABLE_DCM_IMPRESSION |
إشارة الظهور القابلة للتوسيع في DCM وفي وقت العرض، يتم توسيع النطاق ليشمل عدّة إشارات مرجعية. |
AD_URL_TYPE_BEACON_CLICK |
عنوان URL للتتبّع الذي سيتم إرسال إشعار إليه عند بدء حدث النقر. |
AD_URL_TYPE_BEACON_SKIP |
عنوان URL لتتبّع الذي سيتم إرسال إشعار إليه عند بدء حدث التخطّي |
الطُرق |
|
---|---|
|
تظهر له إعلان مجموعة إعلانية على YouTube. |
|
يسرد إعلانات المجموعة الإعلانية على YouTube. |