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.