ה-API של Display & Video 360 מאפשר לכם להוסיף גילוי נאות לגבי נכסים שנוצרו או נערכו על ידי AI. תוויות יתווספו למודעות עם נכסים כאלה כשהן יוצגו באזורים שבהם יש תקנות מקומיות לגבי סימון תוויות AI.
מידע נוסף זמין במרכז העזרה של Display & Video 360.
תמיכה ב-Display & Video 360 API
Display & Video 360 API כולל שדה אופציונלי, syntheticContentAttestationStatus, במשאבים Creative ו-AdAsset. בשדה הזה אפשר לציין אם קובץ קריאייטיב או נכס מכילים תוכן שנוצר או נערך באמצעות AI.
הגדרה של syntheticContentAttestationStatus לערך IS_SYNTHETIC מוסיפה את תווית ה-AI באזורים שבהם יש תקנות מקומיות בנושא תיוג AI, והגדרה של לערך NOT_SYNTHETIC מאשרת שהתוכן לא דורש תווית. אפשר גם להשאיר את השדה ללא הגדרה. אם לא תגדירו את השדה, לא תתווסף תווית.
עם זאת, אחרי שמגדירים את השדה למשאב, אי אפשר לבטל את ההגדרה שלו, ואפשר לעדכן אותו רק לערך IS_SYNTHETIC או NOT_SYNTHETIC.
הערכים התקינים של ה-enum SyntheticContentAttestationStatus מוצגים בטבלה הבאה:
SyntheticContentAttestationStatus ערכי enum | |
|---|---|
SYNTHETIC_CONTENT_ATTESTATION_STATUS_UNSPECIFIED |
לא סופק אימות. |
NOT_SYNTHETIC |
הצהרה שהתוכן לא נוצר או נערך באמצעות AI. |
IS_SYNTHETIC |
התוכן הזה נוצר או נערך בעזרת AI. |
מידע נוסף על ההשפעה של הגדרת השדה הזה על הצגת המודעות זמין במרכז העזרה של Display & Video 360.
סימון נכסי קריאייטיב בבידינג בזמן אמת
ב-Display & Video 360 API, נכסי הקריאייטיב של המודעות שמוצגות באמצעות בידינג בזמן אמת מוגדרים על ידי משאבי Creative. כדי לתייג קריאייטיבים של בידינג בזמן אמת, משתמשים בשדה syntheticContentAttestationStatus במשאב Creative.
קריאייטיבים חדשים
צריך להגדיר את השדה הזה כשיוצרים נכסי קריאייטיב חדשים באמצעות advertisers.creatives.create.
קריאייטיבים קיימים
כדי לעדכן נכסי קריאייטיב קיימים:
- אפשר לאחזר את נכסי הקריאייטיב הקיימים באמצעות
advertisers.creatives.list. - בודקים את הערך הקיים בשדה
syntheticContentAttestationStatus. - במקרה הצורך, משתמשים ב-
advertisers.creatives.patchכדי לעדכן את השדה של נכסי קריאייטיב קיימים.
הוספת תוויות לנכסים שמצורפים למודעות ב-YouTube ולמודעות ליצירת ביקוש
ב-Display & Video 360 API, הקריאייטיבים של המודעות שמוצגות ב-YouTube ובמודעות ליצירת ביקוש מורכבים ממקורות נפרדים של AdAsset. כדי לתייג סרטון ב-YouTube או נכסי תמונה שמשמשים במודעות ב-YouTube ובמודעות ליצירת ביקוש, צריך להשתמש בשדה syntheticContentAttestationStatus במשאב AdAsset.
נכסים חדשים
צריך להגדיר את השדה הזה כשיוצרים נכסים חדשים:
- בנכס חדש של סרטון ב-YouTube, באובייקט
AdAssetשל בקשתadvertisers.adAssets.create. - במקרה של נכס תמונה, בגוף הבקשה של
advertisers.adAssets.upload.
אם מוגדר ערך בשדה syntheticContentAttestationStatus, הוא צריך להיות זהה בכל הנכסים של אותו סרטון ב-YouTube. כדי לבדוק אם כבר קיים נכס עם מזהה הווידאו הרלוונטי ב-YouTube לפני שמנסים ליצור נכס חדש, אפשר להשתמש ב-advertisers.adAssets.list עם פרמטר הסינון הבא:
youtubeVideoAsset.youtubeVideoId=youtube-video-id
נכסים קיימים
כדי לעדכן נכסים קיימים:
- אפשר לאחזר את נכסי הקריאייטיב הקיימים באמצעות
advertisers.adAssets.list. - בודקים את הערך הקיים בשדה
syntheticContentAttestationStatus. - במקרה הצורך, משתמשים ב
advertisers.adAssets.patchכדי לעדכן את השדה של נכסים שמצורפים למודעות קיימים.