REST Resource: accounts.conversionSources

Zasób: ConversionSource

Reprezentuje źródło konwersji należące do konta sprzedawcy. Konto sprzedawcy może mieć maksymalnie 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 elementu ConversionSource. Format: [a-z]{4}:.+ Cztery znaki przed dwukropkiem określają typ źródła konwersji. Treść po dwukropku reprezentuje identyfikator źródła konwersji w ramach danego typu. Identyfikatory 2 różnych źródeł konwersji mogą być takie same w zależności od typu. Obsługiwane są następujące prefiksy typu: – galk: dla źródeł połączeń Google Analytics. – mcdn: dotyczy źródeł miejsca docelowego MerchantCenter.
state

enum (State)

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

string (Timestamp format)

Tylko dane wyjściowe. Czas, kiedy zarchiwizowane źródło konwersji zostanie trwale usunięte i nie można go już przywrócić.
controller

enum (Controller)

Tylko dane wyjściowe. Kontroler źródła konwersji.
Pole sumy source_data. Wymagane. Dane źródła konwersji specyficzne dla poszczególnych typów źródeł. source_data może być tylko jedną z tych wartości:
merchantCenterDestination

object (MerchantCenterDestination)

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

AttributionSettings

Reprezentuje ustawienia atrybucji w przypadku źródeł konwersji, które otrzymują 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łe. Lista nieuporządkowana. Lista różnych typów konwersji, do których można sklasyfikować zdarzenie konwersji. Jeśli lista będzie pusta w momencie tworzenia, zostanie utworzony automatycznie standardowy typ „zakupu”.

AttributionModel

Model atrybucji używany na potrzeby tego źródła. Obsługujemy ten sam zestaw modeli, który jest dostępny w Google Analytics 4, zgodnie z opisem 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 na podstawie danych w wielu kanałach.
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

Wiadomość reprezentująca typy zdarzeń konwersji

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

string

Tylko dane wyjściowe. Nazwa zdarzenia konwersji, zgodnie z raportem klienta.
report

boolean

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

MerchantCenterDestination

Źródła „Miejsce docelowe Merchant Center” 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ę. Jest to nazwa, która identyfikuje źródło konwersji w interfejsie użytkownika Merchant Center. Limit wynosi 64 znaki.
currencyCode

string

Wymagane. Trzyliterowy kod waluty (ISO 4217). Kod waluty określa, w jakiej 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 Źródło konwersji ma nieokreślony stan.
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ć, korzystając z metody „undelete”.
PENDING Tworzenie źródła konwersji już się rozpoczęło, ale nie zostało jeszcze w pełni zakończone.

Kontroler

Podmiot kontrolujący źródło konwersji.

Wartości w polu enum
CONTROLLER_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
MERCHANT Kontrolowane przez sprzedawcę, do którego należy źródło 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 osoba wywołująca.

patch

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

undelete

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