יוצרים נכסים שמצורפים למודעות

בטא: שליפה וניהול של נכסים בקמפיינים ליצירת ביקוש נמצאים בגרסת בטא. התכונה הזו זמינה רק לשותפים שנכללים ברשימת ההיתרים.

בניגוד לקריאייטיבים שמוצגים על ידי סוגים אחרים של פריטים, הקריאייטיבים שמוצגים על ידי מודעות ליצירת ביקוש נבנים במשאבים של AdGroupAd עצמם. נכסי התמונות והסרטונים שמוקצים למודעות כדי ליצור את הקריאייטיבים האלה מיוצגים ב-Display & Video 360 API על ידי משאבי AdAsset.

לפני שיוצרים משאב AdGroupAd, צריך ליצור את משאבי AdAsset הרלוונטיים שהמודעה תשתמש בהם אם הם עדיין לא קיימים. אם הם נוצרו בעבר באמצעות ממשק המשתמש או ה-API, אפשר לאחזר נכסים קיימים באמצעות השירות advertisers.adAssets get והשיטות list.

שימו לב: חובה להשתמש בנכסי AdAsset במודעות ליצירת ביקוש. אם תנסו להשתמש במשאבי Asset, שמשמשים במשאבי Creative רגילים, כשאתם יוצרים משאב AdGroupAd, תוחזר שגיאה.

משאבי תמונות וסרטונים AdAsset נוצרים בשיטות שונות:

• צריך להעלות את נכסי התמונות ל-Display & Video 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.")