Reklam öğeleri oluşturma

Beta: Talep Yaratma kaynaklarının alınması ve yönetilmesi beta sürümündedir. Bu özellik yalnızca izin verilenler listesindeki iş ortakları tarafından kullanılabilir.

Diğer satır öğesi türleri tarafından yayınlanan reklam öğelerinin aksine, Talep Yaratma reklamları tarafından yayınlanan reklam öğeleri AdGroupAd kaynaklarında oluşturulur. Bu reklam öğelerini oluşturmak için reklamlara atanan resim ve video öğeleri, Display & Video 360 API'sinde AdAsset kaynaklarıyla temsil edilir.

AdGroupAd kaynağı oluşturmadan önce, reklamın kullanacağı ilgili AdAsset kaynakları oluşturun. Daha önce kullanıcı arayüzü veya API kullanılarak oluşturulmuşlarsa advertisers.adAssets hizmeti get ve list yöntemlerini kullanarak mevcut öğeleri alabilirsiniz.

Dikkat: AdAsset kaynakları, Talep Yaratma reklamlarında kullanılmalıdır. AdGroupAd kaynağı oluştururken normal Creative kaynaklarında kullanılan Asset kaynaklarını kullanmaya çalışmak hataya neden olur.

Resim ve video AdAsset kaynakları farklı yöntemlerle oluşturulur:

• Resim öğeleri, advertisers.adAssets.upload yöntemi kullanılarak Display & Video 360'a yüklenmelidir.
• Video öğeleri, bir YouTube video kimliği kullanılarak ilişkilendirilmeli ve advertisers.adAssets.create yöntemiyle oluşturulmalıdır.

Bir AdAsset kaynağının adAssetId, bir öğeyi Talep Yaratma reklamıyla ilişkilendirmek için kullanılır.

Resim öğelerini yükleme

AD_ASSET_TYPE_IMAGE öğeleri oluşturmak için resim dosyaları yükleyin. Bu öğeler, eşlik eden banner'lar, logolar ve pazarlama resimleri olarak kullanılabilir.

Dikkat: Resimlerin çözünürlüğü ve boyutu önemlidir. Bir reklamdaki resim öğesi, reklam koşullarını karşılamıyorsa advertisers.adGroupAds.create isteği başarısız olur.

AdAsset kaynağı oluşturmak için resim öğesi yükleme:

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 öğeleri oluşturma

Talep Yaratma video reklamlarında kullanılabilecek AD_ASSET_TYPE_YOUTUBE_VIDEO öğeleri oluşturmak için YouTube video kimlikleri sağlayın.

AdAsset kaynağı oluşturmak için YouTube video öğesi oluşturma adımları:

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