- المورد: إعلان المجموعة الإعلانية
- DisplayVideoSourceAd
- MastheadAd
- YoutubeVideoDetails
- VideoUnavailableReason
- VideoAspectRatio
- InStreamAd
- CommonInStreamAttribute
- ImageAsset
- NonSkippableAd
- BumperAd
- AudioAd
- VideoDiscoveryAd
- الصورة المصغّرة
- VideoPerformanceAd
- AdUrl
- AdUrlType
- الطُرق
المورد: إعلان المجموعة الإعلانية
إعلان واحد مرتبط بمجموعة إعلانية.
تمثيل 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 للتتبّع لإرسال إشعار إليه عند بدء حدث التخطّي. |
الطُرق |
|
---|---|
|
يظهر إعلان للمجموعة الإعلانية. |
|
يسرد إعلانات المجموعة الإعلانية. |