ایجاد دارایی‌های تبلیغاتی

برخلاف مواردی که توسط سایر انواع آیتم‌های خطی ارائه می‌شوند، تبلیغات Demand Gen در منابع AdGroupAd ساخته می‌شوند. تصاویر و ویدیوهای اختصاص داده شده به تبلیغات برای ساخت این تبلیغات، در رابط برنامه‌نویسی کاربردی Display & Video 360 توسط منابع AdAsset نمایش داده می‌شوند.

قبل از ایجاد یک منبع AdGroupAd ، منابع AdAsset مربوطه را که تبلیغ از آنها استفاده خواهد کرد، در صورت عدم وجود، ایجاد کنید. اگر قبلاً با استفاده از UI یا API ایجاد شده‌اند، می‌توانید دارایی‌های موجود را با استفاده از متدهای get و list سرویس advertisers.adAssets بازیابی کنید.

منابع تصویر و ویدئو AdAsset با استفاده از روش‌های مختلفی ایجاد می‌شوند:

  • تصاویر باید با استفاده از متد advertisers.adAssets.upload در Display & Video 360 آپلود شوند.
  • فایل‌های ویدیویی باید با استفاده از شناسه ویدیوی یوتیوب مرتبط شده و با استفاده از متد advertisers.adAssets.create ایجاد شوند.

adAssetId مربوط به یک منبع AdAsset برای مرتبط کردن یک دارایی با یک تبلیغ Demand Gen استفاده می‌شود.

بارگذاری تصاویر

فایل‌های تصویری را آپلود کنید تا بتوانید دارایی‌های AD_ASSET_TYPE_IMAGE ایجاد کنید که می‌توانند به عنوان بنرهای همراه، لوگوها و تصاویر بازاریابی استفاده شوند.

در اینجا نحوه آپلود یک تصویر برای ایجاد یک منبع AdAsset آورده شده است:

پایتون

# 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.")

ایجاد دارایی‌های یوتیوب

شناسه‌های ویدیوی یوتیوب را برای ایجاد دارایی‌های AD_ASSET_TYPE_YOUTUBE_VIDEO که می‌توانند در تبلیغات ویدیویی Demand Gen استفاده شوند، ارائه دهید.

در اینجا نحوه ایجاد یک دارایی ویدیویی یوتیوب برای ایجاد یک منبع AdAsset آورده شده است:

پایتون

# 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.")