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. Generowane przez Content API po utworzeniu nowego ConversionSource. Format: [a-z]{4}:.+ 4 znaki przed dwukropkiem oznaczają typ źródła konwersji. Treść po dwukropku to identyfikator źródła konwersji w ramach danego typu. Identyfikator 2 różnych źródeł konwersji może być taki sam w przypadku różnych typów. Obsługiwane są te prefiksy typów: – galk: źródła GoogleAnalyticsLink. – mcdn: dotyczy źródeł MerchantCenterDestination.
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, w którym zarchiwizowane źródło konwersji zostanie trwale usunięte i nie będzie można go przywrócić.
controller

enum (Controller)

Tylko dane wyjściowe. Administrator źródła konwersji.
Pole unii source_data. Wymagane. Dane o źródłach konwersji, które są specyficzne dla każdego typu źródła. source_data może być tylko jednym z tych elementów:
merchantCenterDestination

object (MerchantCenterDestination)

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

AttributionSettings

Reprezentują ustawienia atrybucji źródeł konwersji, które otrzymują dane przed atrybucją.

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

integer

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

enum (AttributionModel)

Wymagane. Model atrybucji.
conversionType[]

object (ConversionType)

Niezmienna. Lista nieuporządkowana. Lista różnych typów konwersji, do których może należeć zdarzenie konwersji. Jeśli ta lista będzie pusta w momencie tworzenia, zostanie automatycznie utworzony standardowy typ „purchase” (zakup).

AttributionModel

Model atrybucji używany w przypadku tego źródła. Obsługujemy ten sam zestaw modeli oferowanych przez Google Analytics 4, jak opisano 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 z uwzględnieniem pozycji w wielu kanałach.
CROSS_CHANNEL_TIME_DECAY Model spadku udziału z upływem czasu w wielu kanałach.

ConversionType

Komunikat przedstawiający rodzaje zdarzeń konwersji

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

string

Tylko dane wyjściowe. Nazwa zdarzenia konwersji, jaką będzie ono zgłaszane przez klienta.
report

boolean

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

MerchantCenterDestination

Źródeł „Merchant Center Destination” można używać do przesyłania zdarzeń konwersji ze sklepu internetowego za pomocą tagu Google bezpośrednio na konto Merchant Center, na którym zostało utworzone to ź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 w przypadku miejsca docelowego Merchant Center.
displayName

string

Wymagane. Wyświetlana nazwa miejsca docelowego określona przez sprzedawcę. Jest to nazwa identyfikująca źródło konwersji w interfejsie Merchant Center. Może zawierać maksymalnie 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 stan nieokreślony.
ACTIVE Źródło konwersji działa prawidłowo.
ARCHIVED Źródło konwersji zostało zarchiwizowane w ciągu ostatnich 30 dni i nie jest obecnie aktywne. Można je przywrócić za pomocą metody przywracania po usunięciu.
PENDING Tworzenie źródła konwersji zostało rozpoczęte, ale nie zostało jeszcze ukoń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 dotychczasowe źródło konwersji.

get

 Pobiera źródło konwersji.

list

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

patch

 Aktualizuje informacje o dotychczasowym źródle konwersji.

undelete

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