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.