הממשק הקודם של 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

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

בסוף הדף הזה תוכלו למצוא רשימה של שיטות למשאב הזה.

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

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

{
  "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
    }
  ]
}

שם הנכס	Value	תיאור	הערות
`conversion[]`	`list`	ההמרות המבוקשות.
`conversion[].adGroupId`	`long`	מזהה קבוצת מודעות ב-DS.
`conversion[].adId`	`long`	מזהה המודעה ב-DS.
`conversion[].adUserDataConsent`	`string`	מייצג הסכמה להעדפות של שירותי פלטפורמה (CPS) בהגדרות. אין ערך ברירת מחדל. הערכים הקבילים הם: GRANTED: סטטוס ההסכמה הרצוי הוא להעניק. לקרוא את ההעדפות של בתי הספר הציבוריים של שיקגו בהגדרות GTE. נדחתה: סטטוס ההסכמה הרצוי הוא דחייה. רשימת ה-CPS ריקה.
`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`	מזהה הפילוח המספרי (לדוגמה, מזהה פעילות ב-Floodlight ב-DoubleClick Search).
`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`.

שיטות

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