Wywołaj metodę Conversion.insert(), aby dodać co najmniej 1 konwersję. Aby prawidłowo przypisać konwersję, żądanie musi zawierać nazwę aktywności Floodlight, której reklamodawca używa do raportowania konwersji offline, oraz identyfikator kliknięcia wizyty lub identyfikatory słowa kluczowego, które doprowadziło do konwersji. Informacje o uzyskiwaniu identyfikatorów Search Ads 360 znajdziesz w artykule Identyfikatory i konwersje Search Ads 360.
Informacje o ograniczeniach dotyczących przesyłania konwersji historycznych znajdziesz w Centrum pomocy Search Ads 360.
Jeśli żądanie Conversion.insert() określa wiele konwersji, Search Ads 360 próbuje przesłać każdą konwersję, dokładając wszelkich starań, zamiast przesyłać całą partię jako transakcję typu „wszystko albo nic”. Jeśli nie uda się przesłać niektórych konwersji z partii, pozostałe mogą zostać przesłane. Przesyłanie konwersji może się nie udać z powodu nieprawidłowego żądania lub tymczasowych awarii sieci lub systemu. Dlatego zalecamy zapoznanie się z odpowiedzią dotyczącą każdej wstawionej konwersji, aby upewnić się, że przesyłanie się powiodło.
Jak szybko mogę zacząć korzystać z przesłanych danych?
Jeśli podasz conversionTimestamp konwersji z dzisiaj lub wczoraj, dane związane z konwersją pojawią się w interfejsie Search Ads 360 w ciągu godziny od przesłania. Jeśli podasz starszą wartość conversionTimestamp, dane zostaną zaktualizowane w ciągu kilku godzin.
Przekonwertuj wszystkie sygnatury czasowe konwersji na czas epoki (znany też jako czas uniksowy).
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 utworzyć ją za pomocą interfejsu Campaign Manager API. Nie możesz używać interfejsu API do określania, że aktywność Floodlight jest używana głównie do konwersji offline, co jest sprawdzoną metodą, gdy strategie ustalania stawek będą używać danych z konwersji.
Zalecamy, aby 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, aby 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, aby zalogował się w Search Ads 360 i zmienił ustawienia każdej aktywności Floodlight, której używasz do raportowania konwersji offline. Ustawienia powinny wskazywać, że głównym źródłem konwersji jest aktywność 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, odczekaj co najmniej 6 godzin od wizyty, zanim prześlesz konwersję. Search Ads 360 może nie rozpoznać identyfikatora kliknięcia wizyty, jeśli prześlesz go wcześniej niż 6 godzin po wizycie. W rzadkich przypadkach może minąć nawet 24 godziny, zanim Search Ads 360 rozpozna identyfikator kliknięcia.
Upewnij się, że każdy przesyłany plik zawiera ostatnie konwersje. W ramach pojedynczego żądania przesyłania wpisy mogą być niechronologiczne. Strategia ustalania stawek może jednak nie uwzględniać starszych konwersji, które prześlesz później w innym żądaniu.
Wysyłanie żądania wstawienia
Możesz wysłać żądanie Conversion.insert(), aby:
- Przypisywanie udziału w konwersji do konkretnej wizyty
- Przypisanie udziału w 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 listę wymaganych i opcjonalnych pól dla każdego zdarzenia lub elementu, któremu możesz przypisać konwersję.
Przypisywanie udziału w konwersji do konkretnej wizyty
Gdy klient kliknie co najmniej 1 reklamę i przejdzie do witryny reklamodawcy, Search Ads 360 uznaje sesję użytkownika w witrynie reklamodawcy za wizytę.
Aby przypisać konwersję do wizyty, w żądaniu Conversion.insert() podaj te informacje:
Pola wymagane
clickId: identyfikator kliknięcia (z uwzględnieniem wielkości liter). Poszukaj identyfikatora kliknięcia w dziennikach strony internetowej reklamodawcy lub pobierzconversion.click_idinnej konwersji za pomocą nowego interfejsu Search Ads 360 Reporting API. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które wygenerowały wizytę.
Odczekaj co najmniej 6 godzin od wygenerowania przez Search Ads 360 identyfikatora kliknięcia, zanim prześlesz konwersje. Jeśli pojawi się błąd „Nie znaleziono identyfikatora kliknięcia”, odczekaj 24 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: w przypadku konwersji offline ten identyfikator podają reklamodawcy. Reklamodawcy mogą określić dowolny identyfikator, który jest dla nich istotny. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być unikalna wśród wszystkich konwersji w obrębie reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwościdsConversionIdlubfloodlightOrderIdw zależności od instrukcji Floodlight reklamodawcy.conversionTimestamp: wskazuje datę i godzinę wystąpienia konwersji. Jeśli na przykład konwersja nastąpiła w piątek 5 sierpnia 2016 r. o godzinie 11:53:22 czasu letniego wschodniego (GMT -4:00), podaj sygnaturę czasową w milisekundach od początku epoki:1470412402000.segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane, aby określić wartośćFLOODLIGHT.segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.Jeśli reklamodawca ma aktywności o tej samej nazwie (może się tak zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecane działanie to zmiana nazwy jednej z nich.
Możesz też podać identyfikator aktywności Floodlight w polu
segmentationIdzamiast nazwy w polusegmentationName. Użyj identyfikatora przypisanego przez Campaign Managera do aktywności Floodlight. Identyfikator ten możesz pobrać za pomocą polaconversion_action.floodlight_settings.activity_idw nowym interfejsie Search Ads 360 Reporting API. Akceptowany jest też identyfikatorsegmentationId, który Search Ads 360 zwraca w odpowiedzi na żądanie konwersji.type: typ konwersji, czyliACTIONlubTRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja typu TRANSACTION ma taką wartość. Przykłady: zapisanie się na listę e-mailową (DZIAŁANIE) i zakup w e-commerce (TRANSAKCJA).Jeśli podasz
TRANSACTION, musisz też podać to pole:revenueMicros: wartość pieniężna konwersji.
Pola opcjonalne
quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zasubskrybowały newsletter, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola w przypadku konwersji typu ACTION, Search Ads 360 automatycznie wstawi wartość1000.currencyCode: waluta przychodów z transakcji. Domyślnie przyjmuje się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
Użyj formatu alfabetycznego ISO 4217 (3 znaki), aby określić walutę.
Dotyczy tylko konwersji typu TRANSACTION.customMetricicustomDimension: przesyłają dodatkowe dane o konwersji, np. kraj, do którego wysłano zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę wartości akceptowanych w tym polu.
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())
Przypisanie udziału w konwersji tylko do słowa kluczowego
Jeśli nie masz identyfikatora kliknięcia, możesz przypisać konwersję bezpośrednio do słowa kluczowego. W nowej wersji Search Ads 360 identyfikatory słów kluczowych są unikalne tylko w obrębie grupy reklam, dlatego musisz podać pełny zestaw identyfikatorów nowej wersji Search Ads 360, które identyfikują słowo kluczowe, oraz kilka innych pól:
Pola wymagane
customerId: identyfikator klienta konta klienta, które zawiera słowo kluczowe, np.123-456-7890.campaignId: identyfikator kampanii, która zawiera słowo kluczowe.adGroupId: identyfikator grupy reklam, która zawiera słowo kluczowe.criterionId: identyfikator słowa kluczowego.Jeśli konwersja określa
criterionIdbezcustomerId,campaignIdlubadGroupId, kończy się niepowodzeniem i wyświetla kod błędu0x0000012E. Informacje o tym, jak uzyskać te identyfikatory, znajdziesz w artykule Identyfikatory i konwersje Search Ads 360.conversionId: w przypadku konwersji offline ten identyfikator podają reklamodawcy. Reklamodawcy mogą określić dowolny identyfikator, który jest dla nich istotny. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być unikalna wśród wszystkich konwersji w obrębie reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwościdsConversionIdlubfloodlightOrderIdw zależności od instrukcji Floodlight reklamodawcy.conversionTimestamp: wskazuje datę i godzinę wystąpienia konwersji. Jeśli na przykład konwersja nastąpiła w piątek 5 sierpnia 2016 r. o godzinie 11:53:22 czasu letniego wschodniego (GMT -4:00), podaj sygnaturę czasową w milisekundach od początku epoki:1470412402000.segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane, aby określić wartośćFLOODLIGHT.segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.Jeśli reklamodawca ma aktywności o tej samej nazwie (może się tak zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecane działanie to zmiana nazwy jednej z nich.
Możesz też podać identyfikator aktywności Floodlight w polu
segmentationIdzamiast nazwy w polusegmentationName. Użyj identyfikatora przypisanego przez Campaign Managera do aktywności Floodlight. Identyfikator ten możesz pobrać za pomocą polaconversion_action.floodlight_settings.activity_idw nowym interfejsie Search Ads 360 Reporting API. Akceptowany jest też identyfikatorsegmentationId, który Search Ads 360 zwraca w odpowiedzi na żądanie konwersji.type: typ konwersji, czyliACTIONlubTRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja typu TRANSACTION ma taką wartość. Przykłady: zapisanie się na listę e-mailową (DZIAŁANIE) i zakup w e-commerce (TRANSAKCJA).Jeśli podasz
TRANSACTION, musisz też podać to pole:revenueMicros: wartość pieniężna konwersji.
Pola opcjonalne
quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zasubskrybowały newsletter, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola w przypadku konwersji typu ACTION, Search Ads 360 automatycznie wstawi wartość1000.currencyCode: waluta przychodów z transakcji. Domyślnie przyjmuje się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
Użyj formatu alfabetycznego ISO 4217 (3 znaki), aby określić walutę.
Dotyczy tylko konwersji typu TRANSACTION.customMetricicustomDimension: przesyłają dodatkowe dane o konwersji, np. kraj, do którego wysłano zakupiony produkt, identyfikatory produktów, a nawet czas trwania połączenia telefonicznego. Dowiedz się więcej o przesyłaniu danych na potrzeby niestandardowych zmiennych Floodlight.deviceType: określa typ urządzenia, na którym nastąpiła konwersja. Zobacz listę wartości akceptowanych w tym polu.
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" : [{ "customerId": "123-456-7890", // Replace with your ID "campaignId": "14660344555", // Replace with your ID "adGroupId": "105138634255", // Replace with your ID "criterionId": "948710340465", // 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, String customerId, Long campaignId, Long adGroupId, Long criterionId, String conversionId, Long revenue, Long timeStamp) { Conversion conversion = new Conversion() .setCustomerId(customerId) .setCampaignId(campaignId) .setAdGroupId(adGroupId) .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': [{ 'customerId': '123-456-7890', // Replace with your ID 'campaignId': '14660344555', // Replace with your ID 'adGroupId': '105138634255', // Replace with your ID 'criterionId': '948710340465', // 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 modelu atrybucji innej firmy
Model atrybucji rozdziela udział w konwersji między wszystkie aktywności na ścieżce konwersji. Jeśli na przykład przed konwersją użytkownik kliknął reklamę w wyszukiwarce, 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, aby nazwać model External Attribution Model (Zewnętrzny model atrybucji). Dzięki temu funkcje Search Ads 360 mogą wykryć, że do przesyłanych danych o konwersjach został zastosowany model atrybucji. Więcej informacji
Pola wymagane
Aby zastosować do konwersji model atrybucji innej firmy, w żądaniu Conversion.insert() podaj wszystkie te informacje:
clickId: identyfikator kliknięcia (z uwzględnieniem wielkości liter). Poszukaj identyfikatora kliknięcia w dziennikach strony internetowej reklamodawcy lub pobierzconversion.click_idinnej konwersji za pomocą nowego interfejsu Search Ads 360 Reporting API. Search Ads 360 przypisze konwersję do słowa kluczowego, reklamy i innych obiektów Search Ads 360, które wygenerowały wizytę.
Odczekaj co najmniej 30 minut od wygenerowania przez Search Ads 360 identyfikatora kliknięcia, zanim prześlesz konwersję z tym identyfikatorem. W przeciwnym razie interfejs Search Ads 360 API może nie rozpoznać wizyty.attributionModel: ustaw na External Attribution Model (Zewnętrzny model atrybucji). Więcej informacjicountMillis: udział w konwersji, który ma zostać przypisany temu kliknięciu. Ma zastosowanie tylko wtedy, gdy żądanie zawiera też poleattributionModel.Nie należy go mylić z polem
quantityMillis, które jest opcjonalne i określa liczbę elementów w konwersji (np. liczbę produktów w koszyku).conversionId: w przypadku konwersji offline ten identyfikator podają reklamodawcy. Reklamodawcy mogą określić dowolny identyfikator, który jest dla nich istotny. Każda konwersja w żądaniu musi mieć unikalny identyfikator, a kombinacja identyfikatora i sygnatury czasowej musi być unikalna wśród wszystkich konwersji w obrębie reklamodawcy. W przypadku konwersji online Search Ads 360 kopiuje do tej właściwościdsConversionIdlubfloodlightOrderIdw zależności od instrukcji Floodlight reklamodawcy.conversionTimestamp: wskazuje datę i godzinę wystąpienia konwersji. Jeśli na przykład konwersja nastąpiła w piątek 5 sierpnia 2016 r. o godzinie 11:53:22 czasu letniego wschodniego (GMT -4:00), podaj sygnaturę czasową w milisekundach od początku epoki:1470412402000.segmentationType: określa typ systemu konwersji, do którego przesyłasz konwersję. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane, aby określić wartośćFLOODLIGHT.segmentationName: nazwa aktywności Floodlight, której reklamodawca używa do raportowania konwersji.Jeśli reklamodawca ma aktywności o tej samej nazwie (może się tak zdarzyć, jeśli aktywności należą do różnych grup Floodlight), zalecane działanie to zmiana nazwy jednej z nich.
Możesz też podać identyfikator aktywności Floodlight w polu
segmentationIdzamiast nazwy w polusegmentationName. Użyj identyfikatora przypisanego przez Campaign Managera do aktywności Floodlight. Identyfikator ten możesz pobrać za pomocą polaconversion_action.floodlight_settings.activity_idw nowym interfejsie Search Ads 360 Reporting API. Akceptowany jest też identyfikatorsegmentationId, który Search Ads 360 zwraca w odpowiedzi na żądanie konwersji.type: typ konwersji, czyliACTIONlubTRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a konwersja typu TRANSACTION ma taką wartość. Przykłady: zapisanie się na listę e-mailową (DZIAŁANIE) i zakup w e-commerce (TRANSAKCJA).Jeśli podasz
TRANSACTION, musisz też podać to pole:revenueMicros: wartość pieniężna konwersji.
Jeśli śledzisz przychody z konwersji, upewnij się, że stosowany model przypisuje odpowiedni udział w nich każdemu punktowi kontaktu na ścieżce konwersji. Jeśli na przykład Twój model stosuje podejście liniowe (które zakłada przypisywanie każdemu punktowi kontaktu równego udziału w przychodach), każde kliknięcie reklamy na ścieżce konwersji obejmującej 3 takie kliknięcia otrzyma 33% udziału w konwersji. Jeśli konwersja przyniosła przychód w wysokości 100 PLN, upewnij się, że model przypisze każdemu kliknięciu 33 PLN przychodu i że parametr revenueMicros określa dla każdego kliknięcia tylko taką kwotę.
Pola opcjonalne
quantityMillis: liczba elementów w tej konwersji. Może to być np. liczba osób, które zasubskrybowały newsletter, lub łączna liczba sprzedanych produktów. Jeśli nie określisz tego pola w przypadku konwersji typu ACTION, Search Ads 360 automatycznie wstawi wartość1000.currencyCode: waluta przychodów z transakcji. Domyślnie przyjmuje się, że przychody są podawane w walucie reklamodawcy. Jeśli podasz inną walutę, Search Ads 360 przeliczy podaną kwotę przychodów na walutę reklamodawcy. Więcej informacji
Użyj formatu alfabetycznego ISO 4217 (3 znaki), aby określić walutę.
Dotyczy tylko konwersji typu TRANSACTION.customMetricicustomDimension: przesyłają dodatkowe dane o konwersji, np. kraj, do którego wysłano 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 nastąpiła konwersja. Zobacz listę wartości akceptowanych w tym polu.
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 wskazuje powodzenie tylko wtedy, gdy wszystkie konwersje w żądaniu zostały pomyślnie zweryfikowane i przesłane.
Jeśli żądanie się powiedzie
Jeśli żądanie się powiedzie, odpowiedź będzie zawierać pełną wewnętrzną reprezentację Search Ads 360 dla każdej przesłanej konwersji. Reprezentacja używa nowych identyfikatorów Search Ads 360: identyfikatora klienta konta klienta oraz identyfikatora kampanii, identyfikatora grupy reklam, identyfikatora słowa kluczowego (kryterium) i identyfikatora reklamy, do których przypisana jest konwersja.
Oto przykładowa odpowiedź dotycząca konwersji przypisanej do wizyty:
{
"kind": "doubleclicksearch#conversionList",
"conversion": [
{
"customerId": "123-456-7890",
"campaignId": "14660344555",
"adGroupId": "105138634255",
"criterionId": "948710340465",
"adId": "562719339005",
"clickId": "COiYmPDTv7kCFcP0KgodOzQAAA",
"conversionId": "test_20130906_04",
"state": "ACTIVE",
"type": "TRANSACTION",
"revenueMicros": "10000000",
"currencyCode": "USD",
"segmentationType": "FLOODLIGHT",
"segmentationId": "25700000001464141",
"segmentationName": "Test",
"conversionTimestamp": "1378710000000",
"conversionModifiedTimestamp": "1383157332368",
"floodlightOrderId": "test_20130906_04",
"countMillis": "1000",
"deviceType": "DESKTOP"
},
...
]
}
Odpowiedź zawiera tylko identyfikatory, które mają zastosowanie do konwersji. Na przykład odpowiedź dotycząca konwersji przypisanej tylko do słowa kluczowego nie zawiera pól clickId i adId.
Jeśli prośba nie zostanie rozpatrzona pozytywnie
Jeśli nie uda się zweryfikować lub przesłać co najmniej 1 konwersji, odpowiedź będzie zawierać komunikaty dotyczące każdej nieudanej próby przesłania konwersji. Odpowiedź nie zawiera komunikatów o konwersjach, które zostały przesłane.
Oto przykładowa odpowiedź na żądanie, które nie zostało w pełni zrealizowane:
{
"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 niepowodzeniu zawiera 2 ważne pola: przyczynę i szczegółowy komunikat o błędzie. Pole przyczyny może zawierać wartość requestValidation, internalError, transactionFailed lub lateStageRequestError.
Błędy requestValidation
Błędy requestValidation wskazują na problemy z danymi w żądaniu przesłania konwersji (np. konwersja została już przesłana lub nie znaleziono identyfikatora kliknięcia). W przypadku tego typu błędu szczegóły komunikatu zawierają 2 elementy:
- Kod szesnastkowy, który identyfikuje typ błędu. Możesz użyć tego 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ą, że w Search Ads 360 wystąpił problem wewnętrzny.
Reagowanie na błąd
Jeśli żądanie się nie powiedzie, spróbuj później przesłać je ponownie. Search Ads 360 zgłosi błędy requestValidation w przypadku wszystkich konwersji, które zostały już przesłane, ale spróbuje przesłać pozostałe konwersje.
Jeśli po ponownym przesłaniu nadal widzisz błędy, zapoznaj się z sekcją Rozwiązywanie problemów, aby dowiedzieć się, co zrobić.