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,
      "sessionAttributesEncoded": bytes
    }
  ]
}

שם הנכס	ערך	תיאור	הערות
conversion[]	list	ההמרות המבוקשות.
conversion[].adGroupId	long	מזהה קבוצת המודעות ב-DS.
conversion[].adId	long	מזהה מודעה ב-DS.
conversion[].adUserDataConsent	string	מייצג את ההעדפות של המשתמשים לגבי שירותי הפלטפורמה המרכזית (CPS) בהגדרות. אין ערך ברירת מחדל. הערכים הקבילים הם: GRANTED: המשתמש נותן הסכמה. קריאת ההעדפות של CPS מההגדרות של GTE. DENIED: המשתמש לא נותן הסכמה. הרשימה של שירותי הפלטפורמה המרכזית ריקה. הערכים הקבילים הם: "DENIED" "GRANTED" "UNKNOWN"
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	השעה שבה ההמרה שונתה בפעם האחרונה, באלפיות השנייה של עידן Unix לפי שעון 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, מיקרו (ערך כפול 1,000,000, ללא נקודה עשרונית). לדוגמה, כדי לציין ערך הכנסה של '10', מזינים בבקשה את הערך '10000000' (10 מיליון).	לכתיבה
conversion[].segmentationId	long	המזהה המספרי של פילוח (לדוגמה, מזהה הפעילות ב-DoubleClick Search Floodlight).
conversion[].segmentationName	string	המזהה הידידותי של פילוח (לדוגמה, שם הפעילות ב-DoubleClick Search Floodlight).
conversion[].segmentationType	string	סוג הפילוח של ההמרה הזו (לדוגמה, FLOODLIGHT). הערכים הקבילים הם: "FLOODLIGHT"
conversion[].sessionAttributesEncoded	bytes	מאפייני הסשן של האירוע, שמיוצגים כמחרוזת JSON בקידוד base64. התוכן צריך להיווצר על ידי ספרייה שסופקה על ידי Google.
conversion[].state	string	המצב של ההמרה, כלומר ACTIVE או REMOVED. הערה: המצב DELETED הוצא משימוש. הערכים הקבילים הם: "ACTIVE" 'DELETED':  (הוחלפה) "REMOVED"	לכתיבה
conversion[].storeId	string	המזהה של החנות המקומית שבה המוצר שווק. רלוונטי רק כשהערוץ הוא 'local'.
conversion[].type	string	סוג ההמרה, כלומר ACTION או TRANSACTION. המרה מסוג ACTION היא פעולה של המשתמש שאין לה ערך כספי שניתן למדוד, ואילו המרה מסוג TRANSACTION היא פעולה שיש לה ערך כספי שניתן למדוד. דוגמאות לכך הן הרשמות לרשימות של כתובות אימייל (ACTION) לעומת רכישות במסחר אלקטרוני (TRANSACTION). הערכים הקבילים הם: "ACTION" "TRANSACTION"
kind	string	מזהה את הקוד הזה כמשאב ConversionList. ערך: המחרוזת הקבועה doubleclicksearch#conversionList.

Methods

get

אחזור רשימת המרות מחשבון מנוע חיפוש של DoubleClick.

getByCustomerId

אחזור רשימה של המרות מחשבון מנוע חיפוש של DoubleClick Search באמצעות מזהה לקוח חדש ב-Search Ads 360.

insert

הוספה של קבוצה של המרות חדשות ל-DoubleClick Search.

עדכון

עדכון של קבוצת המרות ב-DoubleClick Search.

updateAvailability

מעדכן את הזמינות של קבוצה של פעילויות ב-Floodlight ב-DoubleClick Search.