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

מודל השיוך שמשמש את המקור הזה. אנחנו תומכים באותה קבוצת מודלים שמוצעת ב-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 מודל שיוך מבוסס-נתונים (DDA) חוצה-ערוצים.
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 הימים האחרונים והוא לא פעיל כרגע. אפשר לשחזר אותם באמצעות השיטה undelete.
PENDING תהליך היצירה של מקור ההמרות התחיל, אבל עדיין לא הסתיים.

בקר

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

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

Methods

create

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

delete

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

get

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

list

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

patch

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

undelete

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