إنشاء مواد عرض الإعلانات

الإصدار التجريبي: يتوفّر حاليًا إصدار تجريبي من ميزة استرداد موارد "حملات زيادة الطلب" وإدارتها. تتوفّر هذه الميزة للشركاء المدرَجين في قائمة السماح فقط.

على عكس تصاميم الإعلانات التي تعرضها أنواع أخرى من البنود الإعلانية، يتم إنشاء تصاميم الإعلانات التي تعرضها "إعلانات زيادة الطلب" في AdGroupAd نفسها. يتم تمثيل مواد عرض الصور والفيديوهات المعيّنة للإعلانات من أجل إنشاء تصاميم الإعلانات هذه في واجهة برمجة التطبيقات الخاصة بـ "مساحة العرض والفيديو 360" من خلال موارد AdAsset.

قبل إنشاء مرجع AdGroupAd، أنشئ مراجع AdAsset ذات الصلة التي سيستخدمها الإعلان إذا لم تكن متوفّرة. إذا تم إنشاؤها سابقًا باستخدام واجهة المستخدم أو واجهة برمجة التطبيقات، يمكنك استرداد مواد العرض الحالية باستخدام الخدمة advertisers.adAssets والطريقتَين get وlist.

تنبيه: يجب استخدام مواد العرض AdAsset في "الإعلانات لزيادة الطلب". سيؤدي محاولة استخدام موارد Asset، التي يتم استخدامها في موارد Creative العادية، عند إنشاء مورد AdGroupAd إلى عرض خطأ.

يتم إنشاء مراجع AdAsset للصور والفيديوهات باستخدام طرق مختلفة:

• يجب تحميل ملفات أصول الصور إلى "مساحة العرض والفيديو 360" باستخدام طريقة advertisers.adAssets.upload.
• يجب ربط مواد عرض الفيديو باستخدام معرّف فيديو على YouTube وإنشاؤها باستخدام طريقة advertisers.adAssets.create.

يتم استخدام adAssetId لمورد AdAsset لربط مادة عرض بإعلان زيادة الطلب.

تحميل مواد عرض الصور

حمِّل ملفات الصور لإنشاء مواد عرض AD_ASSET_TYPE_IMAGE يمكن استخدامها كإعلانات بانر مصاحبة وشعارات وصور تسويقية.

تنبيه: من المهم مراعاة دقة الصور وحجمها. إذا لم تستوفِ مادة عرض الصورة في أحد الإعلانات متطلبات الإعلان، سيفشل طلب advertisers.adGroupAds.create.

في ما يلي كيفية تحميل مادة عرض صورة لإنشاء AdAsset مورد:

Python

# Import the object used as the media body for the upload request.
from apiclient.http import MediaFileUpload

# Provide the parent advertiser ID to upload the media file under.
advertiser_id = advertiser-id

# Provide the filename and local path to the media file.
asset_filename = asset-filename
asset_path = asset-path

# Create the request body.
body = {"filename": asset_filename, "adAssetType": "AD_ASSET_TYPE_IMAGE"}

# Create the upload object and use a default MIME type if not identified.
media = MediaFileUpload(asset_path)
if not media.mimetype():
  media = MediaFileUpload(asset_path, "application/octet-stream")

# Upload the asset.
upload_response = (
    service.advertisers()
    .adAssets()
    .upload(advertiserId=advertiser_id, body=body, media_body=media)
    .execute()
)

# Display the new ad asset.
print(f"Ad asset {upload_response['adAsset']['name']} was created.")

إنشاء مواد عرض على YouTube

قدِّم معرّفات فيديوهات على YouTube لإنشاء مواد عرض AD_ASSET_TYPE_YOUTUBE_VIDEO يمكن استخدامها في إعلانات الفيديو ضمن "حملات زيادة الطلب".

إليك كيفية إنشاء مادة عرض فيديو على YouTube لإنشاء مورد AdAsset:

Python

# Provide the ID of the parent advertiser.
advertiser_id = advertiser-id

# Provide the ID of the parent insertion order.
youtube_video_id = youtube-video-id

# Create a line item object with example values.
ad_asset_create_body = {
    "adAsset": {
        "adAssetType": "AD_ASSET_TYPE_YOUTUBE_VIDEO",
        "youtubeVideoAsset": {"youtubeVideoId": youtube_video_id},
    }
}

# Build and execute request.
response = (
    service.advertisers()
    .adAssets()
    .create(advertiserId=advertiser_id, body=ad_asset_create_body)
    .execute()
)

# Display the new ad asset.
print(f"Ad asset {response['name']} was created.")