REST Resource: accounts.conversionSources

Zasób: ConversionSource

Reprezentuje źródło konwersji należące do konta sprzedawcy. Konto sprzedawcy może mieć do 200 źródeł konwersji.

Zapis 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.
}
Pola
name

string

Tylko dane wyjściowe. Identyfikator. Wygenerowane przez Content API po utworzeniu nowego ConversionSource. Format: [a–z]{4}:.+ Cztery znaki przed dwukropkiem reprezentują typ źródła konwersji. Treść po dwukropku odpowiada identyfikatorowi źródła konwersji w ramach danego typu. Identyfikatory 2 różnych źródeł konwersji mogą być takie same w przypadku różnych typów. Obsługiwane są następujące prefiksy typów: - galk: w przypadku źródeł GoogleAnalyticsLink. – mcdn: w przypadku źródeł Merchant CenterDestination.

state

enum (State)

Tylko dane wyjściowe. Bieżący stan tego źródła konwersji. Nie można ich edytować przy użyciu interfejsu API.

expireTime

string (Timestamp format)

Tylko dane wyjściowe. Moment, w którym zarchiwizowane źródło konwersji zostaje trwale usunięte i nie można już go cofnąć.

controller

enum (Controller)

Tylko dane wyjściowe. Kontroler źródła konwersji.

Pole sumy source_data. Wymagane. Dane źródła konwersji związane z poszczególnymi typami źródeł. source_data może mieć tylko jedną z tych wartości:
merchantCenterDestination

object (MerchantCenterDestination)

Źródło konwersji typu „Miejsce docelowe tagu Merchant Center”.

AttributionSettings

Reprezentuje ustawienia atrybucji dla źródeł konwersji otrzymujących dane poprzedzające atrybucję.

Zapis JSON
{
  "attributionLookbackWindowDays": integer,
  "attributionModel": enum (AttributionModel),
  "conversionType": [
    {
      object (ConversionType)
    }
  ]
}
Pola
attributionLookbackWindowDays

integer

Wymagane. Okresy ważności (w dniach) używane na potrzeby atrybucji w tym źródle. Obsługiwane wartości to 7, 30 i 40.

attributionModel

enum (AttributionModel)

Wymagane. Model atrybucji.

conversionType[]

object (ConversionType)

Stały. Lista nieuporządkowana. Lista różnych typów konwersji, do których można zaklasyfikować zdarzenie konwersji. Standardowy „zakup” Jeśli w momencie utworzenia lista była pusta, zostanie utworzony automatycznie.

AttributionModel

Model atrybucji używany w przypadku tego źródła. Obsługujemy ten sam zestaw modeli, który jest dostępny w Google Analytics 4. Więcej informacji na ten temat znajdziesz na stronie https://support.google.com/analytics/answer/10596866.

Wartości w polu enum
ATTRIBUTION_MODEL_UNSPECIFIED Nieokreślony model.
CROSS_CHANNEL_LAST_CLICK Model ostatniego kliknięcia w wielu kanałach.
ADS_PREFERRED_LAST_CLICK Model ostatniego kliknięcia preferowany w Google Ads.
CROSS_CHANNEL_DATA_DRIVEN Model oparty na danych z wielu kanałów.
CROSS_CHANNEL_FIRST_CLICK Model pierwszego kliknięcia w wielu kanałach.
CROSS_CHANNEL_LINEAR Model liniowy w wielu kanałach.
CROSS_CHANNEL_POSITION_BASED Model oparty na pozycji w wielu kanałach.
CROSS_CHANNEL_TIME_DECAY Model spadku udziału z upływem czasu w wielu kanałach.

ConversionType

Komunikat reprezentujący typy zdarzeń konwersji

Zapis JSON
{
  "name": string,
  "report": boolean
}
Pola
name

string

Tylko dane wyjściowe. Nazwa zdarzenia konwersji, która będzie podana przez klienta.

report

boolean

Tylko dane wyjściowe. Opcja określająca, czy ten typ powinien być uwzględniany w raportach Merchant Center.

MerchantCenterDestination

„Miejsce docelowe w Merchant Center” Źródła mogą służyć do wysyłania zdarzeń konwersji ze sklepu internetowego za pomocą tagu Google bezpośrednio na konto Merchant Center, na którym zostało utworzone źródło.

Zapis JSON
{
  "destination": string,
  "attributionSettings": {
    object (AttributionSettings)
  },
  "displayName": string,
  "currencyCode": string
}
Pola
destination

string

Tylko dane wyjściowe. Identyfikator miejsca docelowego w Merchant Center.

attributionSettings

object (AttributionSettings)

Wymagane. Ustawienia atrybucji używane na potrzeby miejsca docelowego w Merchant Center.

displayName

string

Wymagane. Wyświetlana nazwa miejsca docelowego określona przez sprzedawcę. Nazwa, która identyfikuje źródło konwersji w interfejsie Merchant Center. Limit wynosi 64 znaki.

currencyCode

string

Wymagane. Trzyliterowy kod waluty (ISO 4217). Kod waluty określa, w której walucie konwersje wysyłane do tego miejsca docelowego będą raportowane w Merchant Center.

Stan

Reprezentuje stan źródła konwersji.

Wartości w polu enum
STATE_UNSPECIFIED Stan źródła konwersji jest nieokreślony.
ACTIVE Źródło konwersji jest w pełni funkcjonalne.
ARCHIVED Źródło konwersji zostało zarchiwizowane w ciągu ostatnich 30 dni i obecnie nie działa. Można je przywrócić przy użyciu metody cofania usunięcia.
PENDING Tworzenie źródła konwersji już się rozpoczęło, ale nie zostało jeszcze w pełni zakończone.

Kontroler

Jednostka kontrolująca źródło konwersji.

Wartości w polu enum
CONTROLLER_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MERCHANT Kontrolowane przez sprzedawcę, który jest właścicielem Źródła konwersji.
YOUTUBE_AFFILIATES Kontrolowane przez program partnerski YouTube.

Metody

create

Tworzy nowe źródło konwersji.

delete

Archiwizuje istniejące źródło konwersji.

get

Pobiera źródło konwersji.

list

Pobiera listę źródeł konwersji, do których ma dostęp element wywołujący.

patch

Aktualizuje informacje o istniejącym źródle konwersji.

undelete

Ponownie włącza zarchiwizowane źródło konwersji.