REST Resource: accounts.conversionSources

משאב: ConversionSource

מייצג מקור המרות בבעלות חשבון מוכר. חשבון מוכר יכול לכלול עד 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.

טיפוסים בני מנייה (enums)
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.

ארץ

המצב של מקור ההמרות.

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

שלט רחוק

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

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

שיטות

create

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

delete

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

get

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

list

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

patch

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

undelete

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