Package google.shopping.merchant.conversions.v1beta

אינדקס

ConversionSourcesService

שירות לניהול מקורות ההמרות בחשבון של מוכר.

CreateConversionSource

rpc CreateConversionSource(CreateConversionSourceRequest) returns (ConversionSource)

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

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/content

למידע נוסף, ראו סקירה כללית על OAuth 2.0.
DeleteConversionSource

rpc DeleteConversionSource(DeleteConversionSourceRequest) returns (Empty)

העברת מקור המרות קיים לארכיון. אם מקור ההמרות הוא יעד ב-Merchant Center, אפשר יהיה לשחזר אותו למשך 30 יום. אם מקור ההמרות הוא קישור ל-Google Analytics, הוא יימחק באופן מיידי וניתן יהיה לשחזר אותו על ידי יצירת קישור חדש.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/content

למידע נוסף, ראו סקירה כללית על OAuth 2.0.
GetConversionSource

rpc GetConversionSource(GetConversionSourceRequest) returns (ConversionSource)

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

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/content

למידע נוסף, ראו סקירה כללית על OAuth 2.0.
ListConversionSources

rpc ListConversionSources(ListConversionSourcesRequest) returns (ListConversionSourcesResponse)

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

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/content

למידע נוסף, ראו סקירה כללית על OAuth 2.0.
UndeleteConversionSource

rpc UndeleteConversionSource(UndeleteConversionSourceRequest) returns (ConversionSource)

הפעלה מחדש של מקור המרות שהועברו לארכיון. האפשרות הזו זמינה רק למקורות המרות מסוג יעד ב-Merchant Center.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/content

למידע נוסף, ראו סקירה כללית על OAuth 2.0.
UpdateConversionSource

rpc UpdateConversionSource(UpdateConversionSourceRequest) returns (ConversionSource)

עדכון המידע של מקור המרות קיים. האפשרות הזו זמינה רק למקורות המרות מסוג יעד עסקי ב-Merchant Center.

היקפי הרשאה

נדרש היקף הרשאות OAuth הבא:

  • https://www.googleapis.com/auth/content

למידע נוסף, ראו סקירה כללית על OAuth 2.0.

AttributionSettings

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

שדות
attribution_lookback_window_days

int32

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

AttributionModel

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

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

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

שדות
name

string

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

bool

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

ConversionSource

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

שדות
name

string

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

State

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

Timestamp

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

Controller

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

MerchantCenterDestination

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

בקר

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

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

מדינה

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

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

CreateConversionSourceRequest

הודעת הבקשה של ה-method CreateConversionSource.

שדות
parent

string

חובה. חשבון המוכר שיהיו בבעלותו המקור החדש של ההמרות. פורמט: accounts/{account}
conversion_source

ConversionSource

חובה. תיאור מקור ההמרה. מזהה חדש יוקצה לו באופן אוטומטי בזמן היצירה.

DeleteConversionSourceRequest

הודעת הבקשה של שיטת DeleteConversionSource.

שדות
name

string

חובה. השם של מקור ההמרות שרוצים למחוק. פורמט: accounts/{account}/conversionSources/{conversion_source}

GetConversionSourceRequest

הודעת הבקשה של שיטת GetConversionSource.

שדות
name

string

חובה. השם של מקור ההמרות שרוצים לאחזר. פורמט: accounts/{account}/conversionSources/{conversion_source}

ListConversionSourcesRequest

הודעת הבקשה של השיטה ListConversionSources.

שדות
parent

string

חובה. חשבון המוכר שבבעלותו האוסף של מקורות ההמרות. פורמט: accounts/{account}
page_size

int32

זה שינוי אופציונלי. המספר המקסימלי של מקורות המרות שאפשר להציג בדף. אם לא מציינים ערך ל-page_size, המערכת משתמשת ב-100 בתור ערך ברירת המחדל. הערך המקסימלי הוא 200. ערכים מעל 200 יומרו לערך 200. ללא קשר לחלוקה לדפים, מוצגים בסך הכול עד 200 מקורות המרות.
page_token

string

זה שינוי אופציונלי. טוקן דף.
show_deleted

bool

זה שינוי אופציונלי. הצגת האפשרות 'נמחקו (הועברו לארכיון)'.

ListConversionSourcesResponse

הודעת התגובה של השיטה ListConversionSources.

שדות
conversion_sources[]

ConversionSource

רשימת מקורות ההמרות.
next_page_token

string

אסימון שמשמש לאחזור של דף התוצאות הבא.

MerchantCenterDestination

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

שדות
destination

string

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

AttributionSettings

חובה. הגדרות השיוך (Attribution) שמוגדרות ליעד ב-Merchant Center.
display_name

string

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

string

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

UndeleteConversionSourceRequest

הודעת הבקשה של השיטה UndeleteConversionSource.

שדות
name

string

חובה. השם של מקור ההמרות שרוצים לבטל את המחיקה שלו. פורמט: accounts/{account}/conversionSources/{conversion_source}

UpdateConversionSourceRequest

הודעת הבקשה של השיטה UpdateConversionSource.

שדות
conversion_source

ConversionSource

חובה. הגרסה החדשה של נתוני מקור ההמרות. פורמט: accounts/{account}/conversionSources/{conversion_source}
update_mask

FieldMask

זה שינוי אופציונלי. רשימת השדות שמתעדכנים.