Aby dodać co najmniej 1 konwersję, wywołaj metodę Conversion.insert(). Aby prawidłowo przypisać konwersję, żądanie musi zawierać nazwę aktywności Floodlight, której reklamodawca używa do raportowania konwersji offline, oraz identyfikator słowa kluczowego, reklamy i prawdopodobnie kliknięcie, które doprowadziło do konwersji. Informacje o uzyskiwaniu identyfikatorów Search Ads 360 znajdziesz w artykule [GA4] Identyfikatory i konwersje Search Ads 360.
Informacje o ograniczeniach przesyłania konwersji historycznych znajdziesz w Centrum pomocy Search Ads 360.
Jeśli żądanie Conversion.insert() wskazuje wiele konwersji, Search Ads 360 próbuje przesłać każdą z nich w miarę swoich możliwości, zamiast przesyłać całą partię w ramach transakcji „wszystko albo nic”. Jeśli nie uda się przesłać niektórych konwersji w grupie, inne konwersje mogą zostać przesłane. Przesyłanie konwersji może się nie udać z powodu nieprawidłowego żądania, przejściowych awarii sieci lub systemu. Dlatego zalecamy czytanie odpowiedzi na każdą wprowadzoną konwersję, aby mieć pewność, że przesyłanie się powiedzie.
Jak szybko mogę zacząć korzystać z przesłanych danych?
Jeśli określisz konwersję jako
conversionTimestamp z dzisiaj lub wczoraj, dane dotyczące tej konwersji pojawią się w interfejsie Search Ads 360 w ciągu godziny od przesłania. Jeśli określisz wartość conversionTimestamp starszą niż wczoraj, dane zostaną zaktualizowane za kilka godzin.
Konwertuj wszystkie sygnatury czasowe konwersji na czas epoki (nazywany też czasem uniksowym).
Czy mogę tworzyć aktywności Floodlight za pomocą interfejsu API?
Jeśli reklamodawca nie utworzył jeszcze aktywności Floodlight do śledzenia konwersji offline, możesz ją utworzyć przy użyciu interfejsu API Campaign Manager. Za pomocą interfejsu API nie możesz określać, że aktywność Floodlight jest używana głównie na potrzeby konwersji offline. Jest to sprawdzona metoda, gdy strategie ustalania stawek korzystają z danych o konwersji.
Zalecamy, by po utworzeniu aktywności Floodlight za pomocą interfejsu API użytkownik Search Ads 360 zalogował się w Search Ads 360 i zmienił ustawienie aktywności, by wskazać, że głównym źródłem konwersji jest aktywność offline.
Sprawdzone metody dodawania konwersji
Zalecamy stosowanie tych sprawdzonych metod dodawania konwersji:
Poproś użytkownika Search Ads 360, by zalogował się w tej usłudze i zmienił ustawienia każdej aktywności Floodlight używanej do raportowania konwersji offline. Ustawienia powinny wskazywać, że głównym źródłem konwersji są działania offline. Instrukcje znajdziesz w Centrum pomocy Search Ads 360.
Przesyłaj konwersje, gdy tylko będą dostępne. Jeśli przypisujesz konwersje do konkretnych wizyt, przed przesłaniem konwersji odczekaj co najmniej 30 minut od wizyty. Search Ads 360 może nie rozpoznać identyfikatora clickID wizyty, jeśli prześlesz konwersję przed upływem 30 minut. W rzadkich przypadkach może minąć do 4 godzin, zanim Search Ads 360 rozpozna identyfikator clickId.
Upewnij się, że każdy przesyłany plik zawiera najnowsze konwersje. Wpisy w jednej prośbie o przesłanie mogą być w złej kolejności chronologicznej. Strategia ustalania stawek może jednak nie uwzględnić starszych konwersji, jeśli prześlesz je później w innej prośbie.
Jeśli czekasz dłużej niż 24 godziny przed przesłaniem konwersji z aktywności Floodlight, wyślij sygnaturę czasową dostępności.
Sygnatura czasowa dostępności powinna mieć jedną z tych wartości:
- Jeśli w ciągu ostatnich 24 godzin konwersje były rejestrowane, ale nie zostały jeszcze przesłane, sygnatura czasowa powinna zawierać czas wystąpienia ostatniej przesłanej konwersji. Search Ads 360 otrzyma wtedy informację, że w ciągu ostatnich 24 godzin mogły wystąpić konwersje, ale dane nie zostały jeszcze przez Ciebie podane. Strategie ustalania stawek i inne systemy automatyczne będą brać pod uwagę historię skuteczności tylko do momentu przesłania przez Ciebie ostatniej konwersji.
- Jeśli w ciągu ostatnich 24 godzin nie było żadnych konwersji, sygnatura czasowa powinna zawierać bieżącą datę i godzinę. Search Ads 360 otrzyma wtedy informację, że w ciągu ostatnich 24 godzin nie było żadnych konwersji. Strategie ustalania stawek i inne automatyczne systemy uwzględnią ostatnie 24 godziny (cały dzień bez konwersji) w historii skuteczności.
Wysyłanie prośby o wstawienie
Możesz wysłać prośbę Conversion.insert(), aby wykonać dowolną z tych czynności:
- Przypisywanie konwersji do konkretnej wizyty
- Przypisywanie konwersji tylko do słowa kluczowego
Pola wymagane w żądaniu Conversion.insert() zależą od zdarzenia lub elementu, do którego przypisujesz konwersję. W sekcjach poniżej znajdziesz wymagane i opcjonalne pola w przypadku każdego zdarzenia lub elementu, do którego możesz przypisać konwersję.
Przypisywanie konwersji do konkretnej wizyty
Gdy klient kliknie co najmniej 1 reklamę i przejdzie na stronę reklamodawcy, Search Ads 360 uzna sesję użytkownika w witrynie tego reklamodawcy za wizytę.
Aby przypisać konwersję do wizyty, określ w żądaniu Conversion.insert() te elementy:
Pola wymagane
clickId: identyfikator kliknięcia uwzględniający wielkość liter w wizytie. Poszukaj identyfikatora kliknięcia w dziennikach strony internetowej reklamodawcy lub wyświetl listę konwersji i użyj identyfikatora kliknięcia z innej konwersji. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które doprowadziły do wizyty.
Gdy Search Ads 360 wygeneruje identyfikator kliknięcia, odczekaj co najmniej 30 minut, aby przesłać konwersje. Jeśli pojawi się błąd „Nie znaleziono identyfikatora kliknięcia”, odczekaj 4 godziny i ponownie prześlij konwersje. Wszystkie konwersje należy przesłać w ciągu 90 dni od wygenerowania identyfikatora kliknięcia. W przeciwnym razie interfejs Search Ads 360 API może nie rozpoznać wizyty.conversionId: ten identyfikator podaje reklamodawca w przypadku konwersji offline. 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 Search Ads 360 kopiujedsConversionIdlubfloodlightOrderIddo tej usługi w zależności od instrukcji Floodlight reklamodawcy.conversionTimestamp: wskazuje datę i godzinę dokonania konwersji. Jeśli na przykład konwersja ma miejsce 5 sierpnia 2016 r. o 11:53:22 czasu wschodniego letniego (GMT -4:00), podaj sygnaturę czasową w milisekundach epoki:1470412402000.segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, dlatego w tym polu zawsze należy określićFLOODLIGHT.segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.Jeśli reklamodawca zawiera aktywności o tej samej nazwie (może się tak zdarzyć, gdy należą one do różnych grup Floodlight), zalecamy zmianę nazw jednej z nich.
Jeśli znasz identyfikator przypisany przez Search Ads 360 do aktywności Floodlight, możesz go też podać w polu
segmentationId, zamiast podawać jego nazwę w polusegmentationName. Campaign Manager przypisuje też identyfikator do aktywności Floodlight, ale identyfikator Campaign Managera jest inny niż identyfikator Search Ads 360 i nie można go używać do przypisywania konwersji. Aby wyświetlić identyfikator Search Ads 360 w przypadku aktywności Floodlight, pobierz raport o konwersjach (z interfejsu Search Ads 360 lub interfejsu API do raportowania). Jeśli w okresie objętym raportem co najmniej jedna konwersja została przypisana do aktywności Floodlight, zobaczysz w nim identyfikator Search Ads 360.type: typ konwersji, np.ACTIONlubTRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja TRANSACTION ma taką wartość. Przykłady to rejestracje na liście e-mailowej (ACTION) i zakupy e-commerce (TRANSACTION).Jeśli określisz wartość
TRANSACTION, musisz też określić to pole:revenueMicros: wartość pieniężna konwersji.
Pola opcjonalne
quantityMillis: liczba elementów w tej konwersji. Może to być na przykład liczba osób, które zaprenumerowały newsletter e-mail, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola dla konwersji ACTION, Search Ads 360 automatycznie wstawi wartość1000.currencyCode: waluta przychodów z transakcji. Domyślnie zakłada się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy wskazaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
Aby określić walutę, użyj formatu alfabetycznego w formacie ISO 4217 (3 znaki).
Dotyczy tylko konwersji TRANSAKCJA.customMetricicustomDimension: przesyła dodatkowe dane o konwersji, np. kraj, do którego został wysłany zakupiony produkt, identyfikatory produktów, a nawet czas trwania rozmowy telefonicznej. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.deviceType: określa typ urządzenia, na którym doszło do konwersji. Zobacz listę akceptowanych wartości dla tego pola.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"clickId" : "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
"conversionId" : "test_20130906_04",
"conversionTimestamp" : "1378710000000",
"segmentationType" : "FLOODLIGHT",
"segmentationName" : "Test",
"type": "TRANSACTION",
"revenueMicros": "10000000", // 10 million revenueMicros is equivalent to $10 of revenue
"currencyCode": "USD"
}]
}
Java
/**
* Instantiate the Doubleclicksearch service, create conversions, and upload them.
*/
public static void main(String[] args) throws Exception {
Doubleclicksearch service = getService(); // See Set Up Your Application.
// Set up a List to keep track of each conversion you create.
List<Conversion> conversions = new Vector<Conversion>();
// Add a conversion to the List.
addTransactionConversionForVisit(conversions, "COiYmPDTv7kCFcP0KgodOzQAAA", // Replace with a click ID from your site
"test_" + System.currentTimeMillis(), 10000000L, 1378710000000L);
// Upload the List and handle the response.
uploadConversions(conversions, service);
}
/**
* Create a TRANSACTION conversion and add it to a List<Conversion>. This sample hard-codes
* the segmentation name and currency. You probably wouldn't want your production code to be so brittle.
*/
private static List<Conversion> addTransactionConversionForVisit(List<Conversion> conversions,
String clickId, String conversionId, Long revenue, Long timeStamp) {
Conversion conversion = new Conversion().setClickId(clickId)
.setConversionId(conversionId)
.setSegmentationType("FLOODLIGHT")
.setSegmentationName("Test")
.setType("TRANSACTION")
.setRevenueMicros(revenue)
.setCurrencyCode("USD")
.setConversionTimestamp(BigInteger.valueOf(timeStamp));
conversions.add(conversion);
return conversions;
}
/**
* Convert the List of conversions to a DS ConversionList, send an insert request to DS,
* and output the response to a file.
*/
private static void uploadConversions(List<Conversion> conversions, Doubleclicksearch service)
throws IOException {
FileOutputStream outputStream =
new FileOutputStream(new File("./", "InsertConversionsResponse.txt"));
final PrintStream printStream = new PrintStream(outputStream);
try {
// Convert the List to a ConversionList.
ConversionList conversionList = new ConversionList().setConversion(conversions);
// Insert an upload request and download the response to a file.
service.conversion().insert(conversionList).executeAndDownloadTo(printStream);
printStream.close();
} catch (GoogleJsonResponseException e) {
System.err.println("Get request was rejected.");
for (ErrorInfo error : e.getDetails().getErrors()) {
System.err.println(error.getMessage());
}
System.exit(e.getStatusCode());
}
}
Python
def insert_conversion(service):
"""Create and upload a TRANSACTION conversion that is attributed to a visit.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().insert(
body=
{
'conversion': [{
'clickId': 'COiYmPDTv7kCFcP0KgodOzQAAA', // Replace with a click ID from your site
'conversionId': 'test_20140206_00',
'conversionTimestamp': '1378710000000',
'segmentationType': 'FLOODLIGHT',
'segmentationName': 'Test',
'type': 'TRANSACTION',
'revenueMicros': '10000000', // 10 million revenueMicros is equivalent to $10 of revenue
'currencyCode': 'USD'
}]
}
)
pprint.pprint(request.execute())
Przypisywanie konwersji tylko do słowa kluczowego
Jeśli zależy Ci przede wszystkim na przypisywaniu konwersji do słów kluczowych i nie zależy Ci na ich przypisywaniu, możesz pominąć większość identyfikatorów Search Ads 360 i podać tylko identyfikator słowa kluczowego oraz kilka innych pól:
Pola wymagane
criterionId: to identyfikator słowa kluczowego. Możesz uzyskaćcriterionId, dodając makroTrackerIddo adresów URL stron docelowych. Informacje o uzyskiwaniu identyfikatorów słów kluczowych znajdziesz w artykule Identyfikatory i konwersje Search Ads 360.conversionId: ten identyfikator podaje reklamodawca w przypadku konwersji offline. 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 Search Ads 360 kopiujedsConversionIdlubfloodlightOrderIddo tej usługi w zależności od instrukcji Floodlight reklamodawcy.conversionTimestamp: wskazuje datę i godzinę dokonania konwersji. Jeśli na przykład konwersja ma miejsce 5 sierpnia 2016 r. o 11:53:22 czasu wschodniego letniego (GMT -4:00), podaj sygnaturę czasową w milisekundach epoki:1470412402000.segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, dlatego w tym polu zawsze należy określićFLOODLIGHT.segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.Jeśli reklamodawca zawiera aktywności o tej samej nazwie (może się tak zdarzyć, gdy należą one do różnych grup Floodlight), zalecamy zmianę nazw jednej z nich.
Jeśli znasz identyfikator przypisany przez Search Ads 360 do aktywności Floodlight, możesz go też podać w polu
segmentationId, zamiast podawać jego nazwę w polusegmentationName. Campaign Manager przypisuje też identyfikator do aktywności Floodlight, ale identyfikator Campaign Managera jest inny niż identyfikator Search Ads 360 i nie można go używać do przypisywania konwersji. Aby wyświetlić identyfikator Search Ads 360 w przypadku aktywności Floodlight, pobierz raport o konwersjach (z interfejsu Search Ads 360 lub interfejsu API do raportowania). Jeśli w okresie objętym raportem co najmniej jedna konwersja została przypisana do aktywności Floodlight, zobaczysz w nim identyfikator Search Ads 360.type: typ konwersji, np.ACTIONlubTRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja TRANSACTION ma taką wartość. Przykłady to rejestracje na liście e-mailowej (ACTION) i zakupy e-commerce (TRANSACTION).Jeśli określisz wartość
TRANSACTION, musisz też określić to pole:revenueMicros: wartość pieniężna konwersji.
Pola opcjonalne
quantityMillis: liczba elementów w tej konwersji. Może to być na przykład liczba osób, które zaprenumerowały newsletter e-mail, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola dla konwersji ACTION, Search Ads 360 automatycznie wstawi wartość1000.currencyCode: waluta przychodów z transakcji. Domyślnie zakłada się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy wskazaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
Aby określić walutę, użyj formatu alfabetycznego w formacie ISO 4217 (3 znaki).
Dotyczy tylko konwersji TRANSAKCJA.customMetricicustomDimension: przesyła dodatkowe dane o konwersji, np. kraj, do którego został wysłany zakupiony produkt, identyfikatory produktów, a nawet czas trwania rozmowy telefonicznej. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.deviceType: określa typ urządzenia, na którym doszło do konwersji. Zobacz listę akceptowanych wartości dla tego pola.
JSON
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"criterionId": "43700003491981017", // Replace with your ID
"conversionId": "customerTransaction73126",
"conversionTimestamp": "1351196386000",
"segmentationType": "FLOODLIGHT",
"segmentationName": "Offline Purchase",
"type": "TRANSACTION",
"revenueMicros": "20000000", // 20 million revenueMicros is equivalent to $20 of revenue
"currencyCode": "USD"
}]
}
Java
/** * Creates a TRANSACTION conversion, attributes it to a keyword only, and adds it to a List<Conversion>. * The example in the preceding section contains the uploadConversions method, * which can submit the list as an insert() request. */ private static List<Conversion> addTransactionConversionForKeyword(List<Conversion> conversions, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCriterionId(criterionId) .setConversionId(conversionId) .setSegmentationType("FLOODLIGHT") .setSegmentationName("Test") .setType("TRANSACTION") .setRevenueMicros(revenue) .setCurrencyCode("USD") .setConversionTimestamp(BigInteger.valueOf(timeStamp)); conversions.add(conversion); return conversions; }
Python
def insert_conversion(service):
"""Create and upload a TRANSACTION conversion that is attributed to a keyword only.
Args:
service: An authorized Doubleclicksearch service. See Set Up Your Application.
"""
request = service.conversion().insert(
body=
{
'conversion': [{
'criterionId': '43700004289911004', // Replace with your ID
'conversionId': 'test_1378710000000',
'conversionTimestamp': '1378710000000',
'segmentationType': 'FLOODLIGHT',
'segmentationName': 'Test',
'type': 'TRANSACTION',
'revenueMicros': '20000000', // 20 million revenueMicros is equivalent to $20 of revenue
'currencyCode': 'USD'
}]
}
)
pprint.pprint(request.execute())
Przesyłanie danych z zewnętrznego modelu atrybucji
Model atrybucji przypisuje udział w konwersji poszczególnym działaniom na ścieżce konwersji. Jeśli na przykład przed konwersją użytkownik kliknął reklamę w płatnych wynikach wyszukiwania, reklamę displayową i inną reklamę w płatnych wynikach wyszukiwania, liniowy model atrybucji przypisze każdemu kliknięciu 33% udziału w konwersji.
Search Ads 360 udostępnia gotowe modele atrybucji, ale jeśli do przypisywania udziału w konwersji kliknięciom korzystasz z usługi innej firmy lub usługi opracowanej samodzielnie, możesz przesłać zewnętrzne dane atrybucji do Search Ads 360 i używać ich w raportach oraz strategiach ustalania stawek Search Ads 360.
Zanim rozpoczniesz
Utwórz w usłudze Campaign Manager niestandardowy model atrybucji i zaimportuj go do Search Ads 360. Pamiętaj, by nazwać go Zewnętrznym modelem atrybucji. Dzięki temu funkcje Search Ads 360 będą mogły rozpoznać, że do przesyłanych przez Ciebie danych o konwersjach został zastosowany model atrybucji. Więcej informacji
Pola wymagane
Aby zastosować do konwersji zewnętrzny model atrybucji, w żądaniu Conversion.insert() podaj wszystkie te elementy:
clickId: identyfikator kliknięcia uwzględniający wielkość liter w wizytie. Poszukaj identyfikatora kliknięcia w dziennikach strony internetowej reklamodawcy lub wyświetl listę konwersji i użyj identyfikatora kliknięcia z innej konwersji. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które doprowadziły do wizyty.
Zanim prześlesz konwersję z tym identyfikatorem, odczekaj co najmniej 30 minut od wygenerowania identyfikatora kliknięcia przez Search Ads 360. W przeciwnym razie interfejs Search Ads 360 API może nie rozpoznać wizyty.attributionModel: ustaw External Attribution Model (Zewnętrzny model atrybucji). Więcej informacjicountMillis: udział w konwersji przypisany do tego kliknięcia. Ma zastosowanie tylko wtedy, gdy żądanie zawiera też poleattributionModel.Nie należy tego mylić z polem
quantityMillis, opcjonalnym polem określającym liczbę produktów w konwersji (np. liczbę produktów w koszyku).conversionId: ten identyfikator podaje reklamodawca w przypadku konwersji offline. 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 Search Ads 360 kopiujedsConversionIdlubfloodlightOrderIddo tej usługi w zależności od instrukcji Floodlight reklamodawcy.conversionTimestamp: wskazuje datę i godzinę dokonania konwersji. Jeśli na przykład konwersja ma miejsce 5 sierpnia 2016 r. o 11:53:22 czasu wschodniego letniego (GMT -4:00), podaj sygnaturę czasową w milisekundach epoki:1470412402000.segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, dlatego w tym polu zawsze należy określićFLOODLIGHT.segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.Jeśli reklamodawca zawiera aktywności o tej samej nazwie (może się tak zdarzyć, gdy należą one do różnych grup Floodlight), zalecamy zmianę nazw jednej z nich.
Jeśli znasz identyfikator przypisany przez Search Ads 360 do aktywności Floodlight, możesz go też podać w polu
segmentationId, zamiast podawać jego nazwę w polusegmentationName. Campaign Manager przypisuje też identyfikator do aktywności Floodlight, ale identyfikator Campaign Managera jest inny niż identyfikator Search Ads 360 i nie można go używać do przypisywania konwersji. Aby wyświetlić identyfikator Search Ads 360 w przypadku aktywności Floodlight, pobierz raport o konwersjach (z interfejsu Search Ads 360 lub interfejsu API do raportowania). Jeśli w okresie objętym raportem co najmniej jedna konwersja została przypisana do aktywności Floodlight, zobaczysz w nim identyfikator Search Ads 360.type: typ konwersji, np.ACTIONlubTRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja TRANSACTION ma taką wartość. Przykłady to rejestracje na liście e-mailowej (ACTION) i zakupy e-commerce (TRANSACTION).Jeśli określisz wartość
TRANSACTION, musisz też określić to pole:revenueMicros: wartość pieniężna konwersji.
Jeśli śledzisz przychody z konwersji, upewnij się, że stosowany model rozdziela przychody między wszystkie punkty styczności z klientem na ścieżce konwersji.Jeśli np. Twój model stosuje podejście liniowe (czyli rozdziela przychody po równo na każdy punkt styczności z klientem), na ścieżce konwersji, która obejmuje 3 kliknięcia reklamy, każdemu kliknięciu zostanie przypisane 33% udziału w konwersji. Jeśli konwersja przyniosła przychody w wysokości 100 zł, upewnij się, że Twój model rozdziela przychody w wysokości 33 zł na każde kliknięcie i upewnij się, że parametr revenueMicros określa tylko 33 USD przychodów z każdego kliknięcia.
Pola opcjonalne
quantityMillis: liczba elementów w tej konwersji. Może to być na przykład liczba osób, które zaprenumerowały newsletter e-mail, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola dla konwersji ACTION, Search Ads 360 automatycznie wstawi wartość1000.currencyCode: waluta przychodów z transakcji. Domyślnie zakłada się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy wskazaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
Aby określić walutę, użyj formatu alfabetycznego w formacie ISO 4217 (3 znaki).
Dotyczy tylko konwersji TRANSAKCJA.customMetricicustomDimension: przesyła dodatkowe dane o konwersji, np. kraj, do którego został wysłany zakupiony produkt, identyfikatory produktów, a nawet czas trwania rozmowy telefonicznej. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.deviceType: określa typ urządzenia, na którym doszło do konwersji. Zobacz listę akceptowanych wartości dla tego pola.
Przykład
POST https://www.googleapis.com/doubleclicksearch/v2/conversion
Authorization: Bearer your OAuth 2.0 access token
Content-type: application/json
{
"kind": "doubleclicksearch#conversionList",
"conversion" : [{
"clickId" : "PP5K8iI6ul7Vw09JZZDEp", // Replace with a click ID from your site
"conversionId" : "test_20130906_04",
"conversionTimestamp" : "1378710000000",
"segmentationType" : "FLOODLIGHT",
"segmentationName" : "Test",
"type": "TRANSACTION",
"attributionModel": "External Attribution Model",
"countMillis": "330",
"revenueMicros": "33000000", // 33 million revenueMicros is equivalent to $33 of revenue
"currencyCode": "USD"
}]
}
Obsługa odpowiedzi Search Ads 360
Odpowiedź z Search Ads 360 oznacza powodzenie tylko wtedy, gdy wszystkie konwersje w żądaniu zostały zweryfikowane i przesłane.
Jeśli żądanie zostanie zrealizowane
Jeśli żądanie zostanie zrealizowane, odpowiedź będzie zawierać pełny wewnętrzny identyfikator każdej przesłanej konwersji w Search Ads 360, np. identyfikator kampanii, identyfikator grupy reklam i identyfikator słowa kluczowego (kryterium).
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"agencyId": "12300000000000456",
"advertiserId": "45600000000010291",
"engineAccountId": "700000000042441",
"campaignId": "71700000002044839",
"adGroupId": "58700000032026064",
"criterionId": "43700004289911004",
"adId": "0",
"dsConversionId": "48719131694768384",
"conversionId": "test_1383157331951",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "20000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368"
},
...
]
}
Jeśli żądanie nie zostanie zrealizowane
Jeśli co najmniej 1 konwersja nie uda się zweryfikować lub przesłać, odpowiedź będzie zawierać komunikaty o każdym nieudanym przesłaniu konwersji. Odpowiedź nie zawiera komunikatów o przesłanych konwersjach.
Przykładowa odpowiedź na żądanie, które nie zostało w pełni zakończone:
{
"error": {
"errors": [
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x0000011F: Advertiser conversion ID ..."
},
{
"reason": "requestValidation",
"message": "The request was not valid. Details: [0x00000101: Click ID ..."
}
]
}
}
Każdy komunikat o błędzie zawiera 2 ważne pola: przyczynę i szczegółowy komunikat o błędzie. Pole przyczyny może zawierać obiekt requestValidation, internalError, transactionFailed lub lateStageRequestError.
Błędy żądania walidacji
Błędy funkcji requestValidation wskazują problemy z danymi w żądaniu przesłania konwersji (np. konwersja została już przesłana lub nie można znaleźć identyfikatora clickId). W przypadku błędu tego typu komunikat details zawiera 2 elementy:
- Kod szesnastkowy określający typ błędu. Możesz użyć kodu we własnych skryptach, aby zidentyfikować błędy.
- Opis błędu weryfikacji.
Więcej informacji znajdziesz na liście kodów i opisów, które Search Ads 360 może zwracać w przypadku błędów przesyłania konwersji.
Inne typy błędów
Wszystkie inne typy błędów (internalError, transactionFailed lub lateStageRequestError) wskazują na błąd wewnętrzny w Search Ads 360.
Reagowanie na błąd
Jeśli żądanie nie zostanie zrealizowane, spróbuj ponownie przesłać całe wywołanie żądania później. Search Ads 360 zgłasza błędy requestValidation w przypadku wszystkich przesłanych już konwersji, ale próbuje przesłać pozostałe.
Jeśli po ponownym przesłaniu zgłoszenia nadal występują błędy, zapoznaj się z sekcją dotyczącą rozwiązywania problemów, aby dowiedzieć się, co należy zrobić.