Zasób konwersji ma metody, które pozwalają użytkownikom zbiorczo tworzyć, modyfikować i pobierać konwersje Floodlight.
Listę metod stosowanych w przypadku tego zasobu znajdziesz na końcu tej strony.
Reprezentacje zasobów
Lista konwersji.
{ "kind": "doubleclicksearch#conversionList", "conversion": [ { "agencyId": long, "advertiserId": long, "engineAccountId": long, "campaignId": long, "customerId": string, "adGroupId": long, "criterionId": long, "adId": long, "clickId": string, "dsConversionId": long, "conversionId": string, "state": string, "type": string, "revenueMicros": long, "currencyCode": string, "quantityMillis": long, "segmentationType": string, "segmentationId": long, "segmentationName": string, "conversionTimestamp": unsigned long, "conversionModifiedTimestamp": unsigned long, "floodlightOrderId": string, "customMetric": [ { "name": string, "value": double } ], "customDimension": [ { "name": string, "value": string } ], "countMillis": long, "attributionModel": string, "productGroupId": long, "inventoryAccountId": long, "productId": string, "productCountry": string, "productLanguage": string, "channel": string, "storeId": string, "deviceType": string, "adUserDataConsent": string } ] }
nazwa usługi, | Wartość | Opis | Uwagi |
---|---|---|---|
conversion[] |
list |
Żądane konwersje. | |
conversion[].adGroupId |
long |
Identyfikator grupy reklam w DS. | |
conversion[].adId |
long |
Identyfikator reklamy w DS. | |
conversion[].adUserDataConsent |
string |
Reprezentuje preferencje dotyczące zgody na przetwarzanie danych w podstawowych usługach platformy (CPS) w ustawieniach. Brak wartości domyślnej. Akceptowane wartości: GRANTED: pożądany stan zgody użytkownika to „Przyznanie”. Odczyt preferencji CPS z ustawień GTE. DENIED: pożądany stan zgody to „Odrzucenie”, a lista CPS jest pusta. | |
conversion[].advertiserId |
long |
Identyfikator reklamodawcy DS. | |
conversion[].agencyId |
long |
Identyfikator agencji w DS. | |
conversion[].attributionModel |
string |
Dostępne dla reklamodawców dopiero po skontaktowaniu się z obsługą klienta DoubleClick Search. | |
conversion[].campaignId |
long |
Identyfikator kampanii w DS. | |
conversion[].channel |
string |
Kanał sprzedaży produktu. Akceptowane wartości:
|
|
conversion[].clickId |
string |
Identyfikator kliknięcia DS odpowiadający konwersji. | |
conversion[].conversionId |
string |
W przypadku konwersji offline reklamodawcy podają ten identyfikator. Reklamodawcy mogą podać dowolny identyfikator, który ma dla nich znaczenie. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być niepowtarzalna wśród wszystkich konwersji u reklamodawcy. W przypadku konwersji online DS kopiuje do tej usługi parametr dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy. |
|
conversion[].conversionModifiedTimestamp |
unsigned long |
Czas ostatniej modyfikacji konwersji podany w milisekundach epoki UTC. | |
conversion[].conversionTimestamp |
unsigned long |
Czas dokonania konwersji podany w milisekundach epoki UTC. | |
conversion[].countMillis |
long |
Dostępne dla reklamodawców dopiero po skontaktowaniu się z obsługą klienta DoubleClick Search. | |
conversion[].criterionId |
long |
Identyfikator kryterium (słowa kluczowego) DS. | |
conversion[].currencyCode |
string |
Kod waluty przychodów z konwersji. Nazwa powinna być w formacie alfabetycznym ISO 4217 (3 znaki). | z możliwością zapisu |
conversion[].customDimension[] |
list |
Niestandardowe wymiary na potrzeby konwersji, które mogą służyć do filtrowania danych w raporcie. | |
conversion[].customDimension[].name |
string |
Nazwa wymiaru niestandardowego. | |
conversion[].customDimension[].value |
string |
Wartość wymiaru niestandardowego. | |
conversion[].customMetric[] |
list |
Dane niestandardowe dotyczące konwersji. | |
conversion[].customMetric[].name |
string |
Nazwa danych niestandardowych. | |
conversion[].customMetric[].value |
double |
Wartość liczbowa danych niestandardowych. | |
conversion[].customerId |
string |
Nowy identyfikator klienta Search Ads 360. Musi to być konto klienta. Gdy to pole jest skonfigurowane, we wszystkich pozostałych polach identyfikatorów należy ustawić nowe identyfikatory Search Ads 360. | |
conversion[].deviceType |
string |
Typ urządzenia, na którym doszło do konwersji.
Akceptowane wartości:
|
|
conversion[].dsConversionId |
long |
Identyfikator generowany przez DoubleClick Search dla każdej konwersji. | |
conversion[].engineAccountId |
long |
Identyfikator konta wyszukiwarki DS. | |
conversion[].floodlightOrderId |
string |
Identyfikator zamówienia Floodlight podany przez reklamodawcę na potrzeby konwersji. | |
conversion[].inventoryAccountId |
long |
Identyfikator generowany i używany przez DS do jednoznacznego identyfikowania konta zasobów reklamowych zawierającego produkt. | |
conversion[].productCountry |
string |
Kraj zarejestrowany w pliku danych Merchant Center zawierającym produkt. Wskaż kraj za pomocą kodu ISO 3166. | |
conversion[].productGroupId |
long |
Identyfikator grupy produktów w DS. | |
conversion[].productId |
string |
Identyfikator produktu (SKU). | |
conversion[].productLanguage |
string |
Język zarejestrowany w pliku danych Merchant Center zawierającym produkt. Określ język za pomocą kodu ISO 639. | |
conversion[].quantityMillis |
long |
Ilość tej konwersji podana w milisekundach. | z możliwością zapisu |
conversion[].revenueMicros |
long |
Kwota przychodów z tej konwersji typu TRANSACTION wyrażona w mikro (wartość pomnożona przez 1 000 000, bez cyfr po przecinku). Aby np. określić wartość przychodów równą „10”, wpisz w żądaniu „10000000” (10 milionów). |
z możliwością zapisu |
conversion[].segmentationId |
long |
Liczbowy identyfikator podziału na segmenty (np. identyfikator aktywności Floodlight w usłudze DoubleClick Search). | |
conversion[].segmentationName |
string |
Identyfikator prostego podziału na segmenty (np. nazwa aktywności Floodlight w DoubleClick Search). | |
conversion[].segmentationType |
string |
Typ podziału tej konwersji na segmenty (np. FLOODLIGHT ).Akceptowane wartości:
|
|
conversion[].state |
string |
Stan konwersji, czyli ACTIVE lub REMOVED . Uwaga: stan DELETED nie jest już używany.
Akceptowane wartości:
|
z możliwością zapisu |
conversion[].storeId |
string |
Identyfikator lokalnego sklepu, w którym reklamowany jest produkt. Ma zastosowanie tylko wtedy, gdy kanał to „local ”. |
|
conversion[].type |
string |
Typ konwersji, czyli ACTION lub TRANSACTION . Konwersja ACTION to działanie użytkownika, które nie ma wymiernej wartości pieniężnej, a konwersja TRANSACTION to działanie, które ma mierzalną wartość pieniężną. Przykładami są subskrypcje list e-mailowych (ACTION ) i zakupy e-commerce (TRANSACTION ).
Akceptowane wartości:
|
|
kind |
string |
Określa jako zasób ConversionList. Wartość: ustalony ciąg znaków doubleclicksearch#conversionList . |
Metody
- pobierz
- Pobiera listę konwersji z konta wyszukiwarki DoubleClick Search.
- getByCustomerId
- Pobiera listę konwersji z konta wyszukiwarki DoubleClick Search za pomocą nowego identyfikatora klienta Search Ads 360.
- wstaw
- Wstawia grupę nowych konwersji do DoubleClick Search.
- aktualizacja
- Aktualizuje grupę konwersji w usłudze DoubleClick Search.
- updateAvailability
- Aktualizuje dostępność grupy aktywności Floodlight w usłudze DoubleClick Search.