Dodaj nowe konwersje

Jak szybko mogę zacząć korzystać z przesłanych danych?

Jeśli określisz parametr conversionTimestamp z dzisiaj lub wczoraj w przypadku konwersji, dane dotyczące konwersja pojawi się w interfejsie Search Ads 360 w ciągu godziny od przesłania. Jeśli podaj datę 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 użyj interfejsu API Campaign Managera, aby go utworzyć. Za pomocą interfejsu API nie można określić aktywność Floodlight jest wykorzystywana głównie do konwersji offline, co najlepiej ćwiczenie, kiedy strategie ustalania stawek będą używać danych z konwersji.

Zalecamy, aby po użyciu interfejsu API do utworzenia aktywności Floodlight aktywność, użytkownik Search Ads 360 loguje się w Search Ads 360 i zmienia tę aktywność wskazuje, że głównym źródłem konwersje to aktywność offline.

Sprawdzone metody dodawania konwersji

Zalecamy stosowanie tych sprawdzonych metod dodawania konwersji:

1. Poproś użytkownika usługi Search Ads 360 o zalogowanie się w tej usłudze i zmianę ustawień dla każdej aktywności Floodlight używanej do raportowania konwersji offline. Ustawienia powinny wskazują, że głównym źródłem konwersji są działania offline. Zobacz Centrum pomocy Search Ads 360 .

2. Przesyłaj konwersje, gdy tylko będą dostępne. Jeśli przypisujesz konwersje do konkretnych wizyt, odczekaj co najmniej 30 minut wizyty przed przesłaniem konwersji. Search Ads 360 może nie rozpoznać identyfikatora clickID wizyty, jeśli prześlesz ponad 30 minut po wizycie. W rzadkich przypadkach konieczne może być wykonanie tych czynności poczekaj do 4 godzin, zanim Search Ads 360 rozpozna identyfikator clickId.

   Upewnij się, że każdy przesyłany plik zawiera najnowsze konwersje. W jednym przesłane w niewłaściwej kolejności chronologicznej, nic nie szkodzi. Strategia ustalania stawek nie będzie można uwzględnić starszych konwersji, jeśli prześlesz je później w innej prośbie.

3. Jeśli odczekasz ponad 24 godziny przed przesłaniem konwersji z aktywności Floodlight, wyślij sygnatura czasowa dostępności.

   Sygnatura czasowa dostępności powinna mieć jedną z tych wartości:

   • Jeśli konwersje zostały zarejestrowane w ciągu ostatnich 24 godzin, ale nie zostały przesłane ale sygnatura czasowa powinna być czasem ostatniej przesłanej konwersji . Informuje to Search Ads 360, że mogły wystąpić konwersje w ciągu ostatnich 24 godzin, ale jeszcze nie otrzymaliśmy od Ciebie danych. Strategie ustalania stawek inne automatyczne systemy przeanalizują historię skuteczności tylko do ostatniego przesłanej przez Ciebie konwersji.
   • Jeśli w ciągu ostatnich 24 godzin nie było żadnych konwersji, sygnatura czasowa powinna być: bieżącą godzinę i datę Search Ads 360 informuje wtedy, że żadne Liczba konwersji, które miały miejsce w ciągu ostatnich 24 godzin: Strategie ustalania stawek i inne rozwiązania automatyczne uwzględnią ostatnie 24 godziny – cały dzień bez konwersji – który jest ważnym elementem 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 zdarzenie lub element, któremu przypisujesz konwersję. W sekcjach poniżej znajdziesz wymagane i opcjonalne pola w przypadku każdego zdarzenia lub elementu, któremu możesz przypisać konwersję.

Przypisywanie konwersji do konkretnej wizyty

Gdy klient kliknie co najmniej 1 reklamę i przejdzie na stronę reklamodawcy, Search Ads 360 uznaje sesję użytkownika w witrynie reklamodawcy za wizytę. Aby przypisać konwersję do wizyty, w Conversion.insert() żądanie:

Pola wymagane

• clickId: identyfikator kliknięcia uwzględniający wielkość liter w wizytie. Zajrzyj do dzienników sieciowych reklamodawcy dla identyfikatora kliknięcia lub listy konwersji i użyj funkcji identyfikator kliknięcia z innej konwersji. Search Ads 360 przypisze konwersję do: słowo kluczowe, reklama i inne obiekty Search Ads 360, które odpowiadały za podczas generowania wizyty.
  Zaczekaj co najmniej 30 minut po Search Ads 360 generuje identyfikator kliknięcia, aby przesyłać konwersje. Jeśli pojawia się komunikat „Nie znaleziono identyfikatora kliknięcia” , odczekaj 4 godziny i prześlij konwersji. Wszystkie konwersje należy przesłać w ciągu 90 dni od identyfikator kliknięcia. W przeciwnym razie interfejs Search Ads 360 API może nie rozpoznać wizyty.
• conversionId: ten identyfikator jest podawany przez reklamodawcę w przypadku konwersji offline. Reklamodawcy mogą określ wszystkie istotne dla niego identyfikatory. Każda konwersja w żądaniu musi określać 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 kopiuje dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
• conversionTimestamp: wskazuje datę i godzinę rozpoczęcia konwersja wystąpiła. Na przykład, jeśli plik konwersja następuje w pt., 5 sierpnia 2016 r. o 11:53:22 czasu wschodniego letniego (GMT -4:00), określ sygnaturę czasową w milisekundach epoki: 1470412402000.
• segmentationType: określa typ przesyłanego systemu konwersji. konwersji. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane do określenia FLOODLIGHT.
• segmentationName: nazwa aktywności Floodlight reklamodawcy. używanego do raportowania konwersji.

  Jeśli reklamodawca zawiera 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 zmienić nazwę jednego z działań.

  Jeśli znasz identyfikator przypisany przez Search Ads 360 aktywności Floodlight, możesz podać identyfikator w polu segmentationId, zamiast podawać go w w polu segmentationName. Campaign Manager przypisuje też identyfikator aktywności Floodlight, ale identyfikator Campaign Managera jest inny niż identyfikator Search Ads 360 i nie można go użyć do przypisania conversions.) Aby wyświetlić identyfikator Search Ads 360 dla aktywności Floodlight, pobierz plik raportu konwersji (z poziomu Interfejs Search Ads 360 lub raportowanie API). Jeśli do aktywności Floodlight w danym okresie została przypisana co najmniej 1 konwersja w jakimś okresie, w raporcie będzie widoczny identyfikator Search Ads 360.

• type: typ konwersji, czyli ACTION. lub TRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a TRANSAKCJA. Przykłady: rejestracja 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. Na przykład parametr liczba osób, które zaprenumerowały newsletter, 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 przychody wynoszą przyjmuje się, że jest w walucie reklamodawcy. Jeśli wskażesz inną walutę, Search Ads 360 przelicza określoną kwotę przychodów na walutę reklamodawcy. Więcej informacji
  Użyj alfabetu ISO 4217 (3 znaki) format, aby określić walutę.
  Dotyczy tylko konwersji TRANSACTION.
• customMetric i customDimension: przesyła dodatkowe dane o takich jak kraj, do którego został wysłany kupiony produkt, identyfikatory produktów, a nawet na czas trwania połączenia telefonicznego. Więcej informacji o przesyłanie danych niestandardowych Zmienne Floodlight.
• deviceType: określa typ urządzenia, na którym doszło do konwersji. Zobacz listę akceptowanych wartości dla tej .

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"
  }]
}
          

  /**
   * 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());
    }
  }
            

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, a nie nie chcesz uwzględniać atrybucji w reklamach, możesz pominąć większość konwersji Search Ads 360 i podaj tylko identyfikator słowa kluczowego wraz z kilkoma innymi polami:

Pola wymagane

• criterionId: to identyfikator słowa kluczowego. Możesz uzyskać criterionId, dodając TrackerId do adresów URL stron docelowych. Informacje o uzyskiwaniu identyfikatorów słów kluczowych znajdziesz na stronie Search Ads 360 ID Konwersje.
• conversionId: ten identyfikator jest podawany przez reklamodawcę w przypadku konwersji offline. Reklamodawcy mogą określ wszystkie istotne dla niego identyfikatory. Każda konwersja w żądaniu musi określać 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 kopiuje dsConversionId lub floodlightOrderId w zależności od instrukcji Floodlight reklamodawcy.
• conversionTimestamp: wskazuje datę i godzinę rozpoczęcia konwersja wystąpiła. Na przykład, jeśli plik konwersja następuje w pt., 5 sierpnia 2016 r. o 11:53:22 czasu wschodniego letniego (GMT -4:00), określ sygnaturę czasową w milisekundach epoki: 1470412402000.
• segmentationType: określa typ przesyłanego systemu konwersji. konwersji. Obecnie obsługiwane są tylko konwersje Floodlight, więc to pole jest zawsze wymagane do określenia FLOODLIGHT.
• segmentationName: nazwa aktywności Floodlight reklamodawcy. używanego do raportowania konwersji.

  Jeśli reklamodawca zawiera 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 zmienić nazwę jednego z działań.

  Jeśli znasz identyfikator przypisany przez Search Ads 360 aktywności Floodlight, możesz podać identyfikator w polu segmentationId, zamiast podawać go w w polu segmentationName. Campaign Manager przypisuje też identyfikator aktywności Floodlight, ale identyfikator Campaign Managera jest inny niż identyfikator Search Ads 360 i nie można go użyć do przypisania conversions.) Aby wyświetlić identyfikator Search Ads 360 dla aktywności Floodlight, pobierz plik raportu konwersji (z poziomu Interfejs Search Ads 360 lub raportowanie API). Jeśli do aktywności Floodlight w danym okresie została przypisana co najmniej 1 konwersja w jakimś okresie, w raporcie będzie widoczny identyfikator Search Ads 360.

• type: typ konwersji, czyli ACTION. lub TRANSACTION. Konwersja typu ACTION nie ma wartości pieniężnej, a TRANSAKCJA. Przykłady: rejestracja 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. Na przykład parametr liczba osób, które zaprenumerowały newsletter, 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 przychody wynoszą przyjmuje się, że jest w walucie reklamodawcy. Jeśli wskażesz inną walutę, Search Ads 360 przelicza określoną kwotę przychodów na walutę reklamodawcy. Więcej informacji
  Użyj alfabetu ISO 4217 (3 znaki) format, aby określić walutę.
  Dotyczy tylko konwersji TRANSACTION.
• customMetric i customDimension: przesyła dodatkowe dane o takich jak kraj, do którego został wysłany kupiony produkt, identyfikatory produktów, a nawet na czas trwania połączenia telefonicznego. Więcej informacji o przesyłanie danych niestandardowych Zmienne Floodlight.
• deviceType: określa typ urządzenia, na którym doszło do konwersji. Zobacz listę akceptowanych wartości dla tej .

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"
  }]
}

  /**
   * 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;
  }        

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())

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"
  }]
}
          

Błędy żądania walidacji

Błędy funkcji requestValidation wskazują problemy z danymi w przesyłaniu konwersji. (np. konwersja została już przesłana lub nie znaleziono identyfikatora clickId). W tym typu błędu, komunikat szczegóły zawiera 2 elementy:

• Kod szesnastkowy określający typ błędu. Możesz użyć kodu samodzielnie skryptów.
• Opis błędu weryfikacji.

Więcej informacji: listy kodów opisów, które Search Ads 360 może zwracać z powodu błędów przesyłania konwersji.

Inne typy błędów

Wszystkie inne typy błędów (internalError, transactionFailed, lub lateStageRequestError) wskazują, że wystąpił problem wewnętrzny 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 konwersji, które już przesłano, ale spróbuje przesłać pozostałe konwersje.

Jeśli po ponownym przesłaniu formularza nadal występują błędy, wyświetl rozwiązywanie problemów .