הממשק הקודם של Search Ads 360 Reporting API יוצא משימוש ב-30 ביוני 2024. חשוב לדעת ש-Search Ads 360 Conversion API לא מושפע מכך, ונמשיך לתמוך בו. בכל פיתוח הדוחות החדש יש להשתמש ב-Search Ads 360 Reporting API החדש.

החל מאפריל 2024, תוחזר שגיאה שאינה נתמכתApiVersion בתגובה לבקשת דוח. ניתן למצוא פרטים נוספים כאן.

מומלץ מאוד להעביר את כל ההטמעות הקיימות של Search Ads 360 ל-API החדש. מידע נוסף זמין במדריך לתחילת העבודה ובמדריך להעברת נתונים של Search Ads 360 Reporting API.

דף זה תורגם על ידי Cloud Translation API.

Conversion

משאב ההמרה כולל methods שמאפשרות למשתמשים ליצור, לשנות ולאחזר המרות ב-Floodlight בכמות גדולה.

רשימה של ה-methods במשאב הזה מופיעה בסוף הדף.

ייצוגי משאבים

רשימה של המרות.

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}

שם הנכס	ערך	תיאור	הערות
`conversion[]`	`list`	ההמרות שהתבקשו.
`conversion[].adGroupId`	`long`	מזהה קבוצת מודעות ב-DS.
`conversion[].adId`	`long`	מזהה מודעה ב-DS.
`conversion[].adUserDataConsent`	`string`	מייצג את ההסכמה להעדפות של שירותי הפלטפורמה המרכזית (CPS) בהגדרות. אין ערך ברירת מחדל. הערכים הקבילים הם: GRANTED: סטטוס ההסכמה הרצוי הוא לתת הסכמה. אפשר לקרוא את ההעדפות של ה-CPS בהגדרות של GTE. DENIED: סטטוס ההסכמה הרצוי הוא לא לתת הסכמה. הרשימה של שירותי הפלטפורמה המרכזית ריקה.
`conversion[].advertiserId`	`long`	מזהה המפרסם ב-DS.
`conversion[].agencyId`	`long`	מזהה הסוכנות ב-DS.
`conversion[].attributionModel`	`string`	האפשרות הזו זמינה למפרסמים רק לאחר פנייה לתמיכת הלקוחות של DoubleClick Search.
`conversion[].campaignId`	`long`	מזהה הקמפיין ב-DS.
`conversion[].channel`	`string`	ערוץ המכירות של המוצר. הערכים הקבילים הם: "`local`": חנות פיזית "`online`": חנות וירטואלית
`conversion[].clickId`	`string`	מספר הקליק ב-DS שמשויך להמרה.
`conversion[].conversionId`	`string`	כשמדובר בהמרות אופליין, המפרסמים מספקים את המזהה הזה. המפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורו. לכל המרה בבקשה צריך לציין מזהה ייחודי, והשילוב של המזהה וחותמת הזמן חייב להיות ייחודי בין כל ההמרות אצל המפרסם. כשמדובר בהמרות אונליין, מערכת DS מעתיקה את `dsConversionId` או את `floodlightOrderId` לנכס הזה, בהתאם להוראות לדיווח על פעילות מ-Floodlight של המפרסם.
`conversion[].conversionModifiedTimestamp`	`unsigned long`	המועד שבו בוצע השינוי האחרון בהמרה, בתקופת זמן של אלפיות שנייה לפי שעון UTC.
`conversion[].conversionTimestamp`	`unsigned long`	השעה שבה התרחשה ההמרה, בתקופת זמן של אלפיות השנייה לפי שעון UTC.
`conversion[].countMillis`	`long`	האפשרות הזו זמינה למפרסמים רק לאחר פנייה לתמיכת הלקוחות של DoubleClick Search.
`conversion[].criterionId`	`long`	מזהה קריטריון (מילת מפתח) ב-DS.
`conversion[].currencyCode`	`string`	קוד המטבע של ההכנסה מההמרה. צריך להיות בפורמט אלפביתי לפי תקן ISO 4217 (3 תווים).	ניתן לכתיבה
`conversion[].customDimension[]`	`list`	מאפיינים מותאמים אישית של ההמרה, שאפשר להשתמש בהם כדי לסנן נתונים בדוח.
`conversion[].customDimension[].name`	`string`	שם המאפיין המותאם אישית.
`conversion[].customDimension[].value`	`string`	ערך של מאפיין מותאם אישית.
`conversion[].customMetric[]`	`list`	מדדים מותאמים אישית של ההמרה.
`conversion[].customMetric[].name`	`string`	שם המדד המותאם אישית.
`conversion[].customMetric[].value`	`double`	ערך מספרי של מדד מותאם אישית.
`conversion[].customerId`	`string`	מספר הלקוח בממשק החדש של Search Ads 360. צריך להיות חשבון לקוח. כשהשדה הזה מוגדר, כל שאר שדות המזהה צריכים להיות מוגדרים כמזהים של הממשק החדש של Search Ads 360.
`conversion[].deviceType`	`string`	סוג המכשיר שבו התרחשה ההמרה. הערכים הקבילים הם: "`DESKTOP`" "`HIGH_END_MOBILE`" "`OTHER_DEVICE`" "`TABLET`"
`conversion[].dsConversionId`	`long`	המזהה שנוצר ב-DoubleClick Search לכל המרה.
`conversion[].engineAccountId`	`long`	מספר חשבון מנוע החיפוש ב-DS.
`conversion[].floodlightOrderId`	`string`	מזהה ההזמנה ב-Floodlight שסופק על ידי המפרסם עבור ההמרה.
`conversion[].inventoryAccountId`	`long`	המזהה שמערכת DS יוצרת ומשתמשת בו כדי לזהות באופן ייחודי את חשבון המלאי שמכיל את המוצר.
`conversion[].productCountry`	`string`	המדינה הרשומה בפיד של Merchant Center שמכיל את המוצר. צריך להשתמש בקוד ISO 3166 כדי לציין מדינה.
`conversion[].productGroupId`	`long`	מזהה קבוצת המוצרים ב-DS.
`conversion[].productId`	`string`	מזהה המוצר (מק"ט).
`conversion[].productLanguage`	`string`	השפה הרשומה בפיד של Merchant Center שמכיל את המוצר. צריך להשתמש בקוד ISO 639 כדי לציין שפה.
`conversion[].quantityMillis`	`long`	הכמות של ההמרה הזו, באלפיות השנייה.	ניתן לכתיבה
`conversion[].revenueMicros`	`long`	סכום ההכנסה של ההמרה הזו מסוג `TRANSACTION`, במיקרו (ערך כפול 1000000, ללא מספר עשרוני). לדוגמה: כדי לציין את ערך ההכנסה '10' להזין '10000000' (10 מיליון) בבקשה שלכם.	ניתן לכתיבה
`conversion[].segmentationId`	`long`	מזהה הפילוח המספרי (לדוגמה, מזהה פעילות ב-DoubleClick Search Floodlight).
`conversion[].segmentationName`	`string`	מזהה הפילוח הידידותי (לדוגמה, שם פעילות ב-DoubleClick Search Floodlight).
`conversion[].segmentationType`	`string`	סוג הפילוח של ההמרה הזו (לדוגמה, `FLOODLIGHT`). הערכים הקבילים הם: "`FLOODLIGHT`"
`conversion[].state`	`string`	המצב של ההמרה, כלומר `ACTIVE` או `REMOVED`. הערה: המצב 'נמחק' הוצא משימוש. הערכים הקבילים הם: "`ACTIVE`" "`DELETED`": (הוצא משימוש) "`REMOVED`"	ניתן לכתיבה
`conversion[].storeId`	`string`	המזהה של החנות המקומית שהמוצר פורסם בה. רלוונטי רק כאשר הערוץ הוא '`local`'.
`conversion[].type`	`string`	סוג ההמרה, כלומר `ACTION` או `TRANSACTION`. המרה מסוג `ACTION` היא פעולה של המשתמש שאין לה ערך ניתן לכימות מבחינה כספית. לעומת זאת, המרה `TRANSACTION` היא פעולה שיש לה ערך שניתן לכימות מבחינה כספית. דוגמאות: הרשמות לרשימות של כתובות אימייל (`ACTION`) לעומת רכישות במסחר אלקטרוני (`TRANSACTION`). הערכים הקבילים הם: "`ACTION`" "`TRANSACTION`"
`kind`	`string`	מזהה אותו בתור משאב ConversionList. ערך: המחרוזת הקבועה `doubleclicksearch#conversionList`.

שיטות

הורדה: אחזור רשימת המרות מחשבון מנוע חיפוש של DoubleClick.
getByCustomerId: אחזור רשימת המרות מחשבון מנוע חיפוש של DoubleClick באמצעות מספר לקוח בממשק החדש של Search Ads 360.
הוספה: מצרף מספר המרות חדשות ל-DoubleClick Search.
עדכון: מעדכן קבוצת המרות ב-DoubleClick Search.
updateAvailability: מעדכן את הזמינות של קבוצת פעילויות Floodlight ב-DoubleClick Search.