REST Resource: accounts.conversionSources

משאב: ConversionSource

מקור המרות שנמצא בבעלות של חשבון Merchant. לחשבון מוכר יכולים להיות עד 200 מקורות של המרות.

ייצוג JSON 
{
  "name": string,
  "state": enum (State),
  "expireTime": string,
  "controller": enum (Controller),

  // Union field source_data can be only one of the following:
  "googleAnalyticsLink": {
    object (GoogleAnalyticsLink)
  },
  "merchantCenterDestination": {
    object (MerchantCenterDestination)
  }
  // End of list of possible types for union field source_data.
}
שדות
name

string

פלט בלבד. מזהה. נוצר על ידי ה-Content API בזמן היצירה של ConversionSource חדש. פורמט: [a-z]{4}:.+ ארבעת התווים שלפני הנקודתיים מייצגים את סוג מקור ההמרה. התוכן שמופיע אחרי הנקודתיים מייצג את המזהה של מקור ההמרות בסוג הזה. המזהה של שני מקורות המרה שונים עשוי להיות זהה בסוגים שונים של המרות. הקידומות הבאות נתמכות: - galk: למקורות של GoogleAnalyticsLink. - mcdn: למקורות ב-MerchantCenterDestination.
state

enum (State)

פלט בלבד. המצב הנוכחי של מקור ההמרות הזה. לא ניתן לערוך דרך ה-API.
expireTime

string (Timestamp format)

פלט בלבד. המועד שבו מקור המרות שהועבר לארכיון נמחק באופן סופי ולא ניתן יותר לבטל את המחיקה.
controller

enum (Controller)

פלט בלבד. הבקר של מקור ההמרות.
שדה איחוד source_data. חובה. נתונים של מקור המרות שהם ספציפיים לכל סוג של מקור. source_data יכול להיות רק אחת מהאפשרויות הבאות:
merchantCenterDestination

object (MerchantCenterDestination)

מקור המרות מסוג 'יעד התג של Merchant Center'.

AttributionSettings

מייצג את הגדרות השיוך של מקורות של המרות שמקבלים נתונים לפני השיוך.

ייצוג JSON 
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
שדות
attributionLookbackWindowDays

integer

חובה. חלונות מבט לאחור (בימים) שמשמשים לשיוך במקור הזה. הערכים הנתמכים הם 7, 30, 40.
attributionModel

enum (AttributionModel)

חובה. מודל שיוך (Attribution).
conversionType[]

object (ConversionType)

בלתי ניתן לשינוי. רשימה לא ממוינת. רשימה של סוגי ההמרות השונים שאפשר לסווג כאירוע המרה. "רכישה" רגילה הסוג ייווצר באופן אוטומטי אם הרשימה ריקה בזמן היצירה.

AttributionModel

מודל השיוך (Attribution) ששימש במקור הזה. אנחנו תומכים באותן קבוצות של מודלים ב-Google Analytics 4, כפי שמתואר בכתובת: https://support.google.com/analytics/answer/10596866.

טיפוסים בני מנייה (enum)
ATTRIBUTION_MODEL_UNSPECIFIED דגם לא מוגדר.
CROSS_CHANNEL_LAST_CLICK מודל 'קליק אחרון בכל הערוצים'.
ADS_PREFERRED_LAST_CLICK מודל 'קליק אחרון עם העדפה ל-Google Ads'.
CROSS_CHANNEL_DATA_DRIVEN מודל מבוסס נתונים חוצה-ערוצים.
CROSS_CHANNEL_FIRST_CLICK מודל 'קליק ראשון בכל הערוצים'.
CROSS_CHANNEL_LINEAR מודל לינארי חוצה-ערוצים.
CROSS_CHANNEL_POSITION_BASED מודל מבוסס מיקום חוצה-ערוצים.
CROSS_CHANNEL_TIME_DECAY מודל 'דעיכה לאורך זמן' חוצה-ערוצים.

ConversionType

הודעה שמייצגת סוגים של אירועי המרה

ייצוג JSON 
{
  "name": string,
  "report": boolean
}
שדות
name

string

פלט בלבד. שם אירוע ההמרה, כפי שידווח על ידי הלקוח.
report

boolean

פלט בלבד. אפשרות שמציינת אם הסוג ייכלל בדוחות של Merchant Center.

MerchantCenterDestination

'יעד ב-Merchant Center' אפשר להשתמש במקורות כדי לשלוח אירועי המרה מחנות וירטואלית באמצעות Google Tag ישירות לחשבון Merchant Center שבו נוצר המקור.

ייצוג JSON 
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
שדות
destination

string

פלט בלבד. מזהה יעד ב-Merchant Center.
attributionSettings

object (AttributionSettings)

חובה. הגדרות השיוך (Attribution) שבהן נעשה שימוש ביעד Merchant Center.
displayName

string

חובה. השם המוצג של היעד על ידי המוכר. זהו השם שמשמש לזיהוי מקור ההמרות בממשק המשתמש של Merchant Center. מוגבלת ל-64 תווים.
currencyCode

string

חובה. קוד מטבע בן שלוש אותיות (ISO 4217). קוד המטבע מגדיר את המטבע שבו ידווחו ההמרות שנשלחות ליעד הזה ב-Merchant Center.

מדינה

מייצג את המצב של מקור ההמרות.

טיפוסים בני מנייה (enum)
STATE_UNSPECIFIED המצב של מקור ההמרה לא צוין.
ACTIVE מקור ההמרות פעיל באופן מלא.
ARCHIVED מקור ההמרות הועבר לארכיון ב-30 הימים האחרונים וכרגע הוא לא פעיל. אפשר לשחזר אותם באמצעות השיטה לביטול מחיקה.
PENDING היצירה של מקור ההמרות התחילה אבל עדיין לא הסתיימה במלואה.

שלט רחוק

הישות ששולטת במקור ההמרות.

טיפוסים בני מנייה (enum)
CONTROLLER_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
MERCHANT בשליטת המוכר שמקור ההמרות נמצא בבעלותו.
YOUTUBE_AFFILIATES בשליטת תוכנית השותפים של YouTube.

שיטות

create

 יצירת מקור המרות חדש.

delete

 העברה לארכיון של מקור המרות קיים.

get

 אחזור מקור המרות.

list

 אחזור הרשימה של מקורות ההמרות שאליהם יש למשתמש ששלח את הקריאה.

patch

 מעדכן את המידע של מקור המרות קיים.

undelete

 הפעלה מחדש של מקור המרות שהועבר לארכיון.