הוספת המרות חדשות

מתקשרים לשיטה Conversion.insert() כדי להוסיף המרה אחת או יותר. כדי לשייך את ההמרה בצורה נכונה, בבקשה צריך לציין את השם של פעילות ב-Floodlight שהמפרסם משתמש בה כדי לדווח על המרות אופליין, וגם את המזהה של מילת המפתח, המודעה ואולי גם הקליק שהוביל להמרה. מידע על קבלת מזהים מ-Search Ads 360 זמין במאמר מזהים והמרות ב-Search Ads 360.

מידע על ההגבלות בנושא העלאת נתונים היסטוריים של המרות זמין במרכז העזרה של Search Ads 360.

אם בבקשת Conversion.insert() מצוינות כמה המרות, מערכת Search Ads 360 מנסה להעלות כל המרה בנפרד במקום להעלות את כל הקבוצה כעסקה של הכול או כלום. אם חלק מההמרות בקבוצה לא מועלות, יכול להיות שהמרות אחרות כן יועלו. העלאות של המרות עלולות להיכשל בגלל בקשה לא תקינה או בגלל כשלים זמניים ברשת או במערכת. לכן מומלץ לקרוא את התגובה לכל המרה שמוסיפים כדי לוודא שההעלאה הצליחה.

תוך כמה זמן אפשר להשתמש בנתונים שהועלו?

אם תציינו conversionTimestamp של היום או של אתמול להמרה, המדדים שקשורים להמרה יוצגו בממשק המשתמש של Search Ads 360 תוך שעה ממועד ההעלאה. אם תציינו conversionTimestamp שחלה לפני אתמול, המדדים יעודכנו תוך כמה שעות.

ממירים את כל חותמות הזמן של ההמרות לזמן ראשית יוניקס (Unix epoch).

האם אפשר ליצור פעילויות ב-Floodlight דרך ה-API?

אם המפרסם עדיין לא יצר פעילות ב-Floodlight למעקב אחרי המרות אופליין, אפשר להשתמש ב-Campaign Manager API כדי ליצור פעילות כזו. אי אפשר להשתמש ב-API כדי לציין שפעילות ב-Floodlight משמשת בעיקר להמרות אופליין. זוהי שיטת עבודה מומלצת כששיטות הבידינג ישתמשו בנתונים מההמרה.

מומלץ שאחרי שמשתמשים ב-API כדי ליצור פעילות ב-Floodlight, משתמש ב-Search Ads 360 ייכנס ל-Search Ads 360 וישנה את ההגדרה של הפעילות כדי לציין שהמקור העיקרי של ההמרות הוא פעילות אופליין.

שיטות מומלצות להוספת המרות

אלה השיטות המומלצות להוספת המרות:

  1. מבקשים ממשתמש ב-Search Ads 360 להיכנס לחשבון ולשנות את ההגדרות של כל פעילות ב-Floodlight שמשמשת לדיווח על המרות אופליין. ההגדרות צריכות לציין שהמקור העיקרי להמרות הוא פעילות אופליין. הוראות מפורטות זמינות במרכז העזרה של Search Ads 360.

  2. מומלץ להעלות את ההמרות ברגע שהן זמינות. אם אתם משייכים המרות לביקורים ספציפיים, צריך להמתין לפחות 6 שעות אחרי הביקור לפני שמעלים את ההמרה. יכול להיות שמערכת Search Ads 360 לא תזהה את מזהה הקליק של הביקור אם תעלו את הנתונים לפני שיחלפו 6 שעות מהביקור. במקרים נדירים, יכול להיות שתצטרכו להמתין עד 24 שעות עד שמערכת Search Ads 360 תזהה את מזהה הקליק.

    חשוב לוודא שכל העלאה מכילה את ההמרות העדכניות ביותר. בבקשת העלאה אחת, אין בעיה אם הרשומות לא מסודרות בסדר כרונולוגי. אבל יכול להיות ששיטת בידינג לא תוכל להתייחס להמרות ישנות יותר שתעלו מאוחר יותר בבקשה אחרת.

שליחת בקשה להוספת מודעה

אפשר לשלוח בקשת Conversion.insert() כדי לבצע את הפעולות הבאות:

  • שיוך המרה לביקור ספציפי
  • שיוך המרה למילת מפתח בלבד

השדות שנדרשים בבקשת Conversion.insert() תלויים באירוע או בפריט שאליו משייכים את ההמרה. בקטעים הבאים מפורטים שדות החובה והשדות האופציונליים לכל אירוע או פריט שאפשר לשייך לו המרה.

שיוך המרה לביקור ספציפי

כשלקוח לוחץ על מודעה אחת או יותר ומגיע לאתר של מפרסם, מערכת Search Ads 360 מחשיבה את סשן המשתמש באתר של המפרסם כביקור. כדי לשייך המרה לביקור, צריך לציין את הפרטים הבאים בבקשה Conversion.insert():

שדות חובה

  • ‫clickId: מזהה הקליק של הביקור, תלוי אותיות רישיות. מחפשים את מספר הקליק ביומני האינטרנט של המפרסם או מציגים את רשימת ההמרות ומשתמשים במספר קליק מהמרה אחרת. מערכת Search Ads 360 תשייך את ההמרה למילת המפתח, למודעה ולאובייקטים אחרים ב-Search Ads 360 שהיו אחראים ליצירת הביקור.
    צריך להמתין לפחות 6 שעות אחרי שמערכת Search Ads 360 יוצרת מזהה קליק כדי להעלות המרות. אם מופיעה השגיאה 'מזהה הקליק לא נמצא', צריך להמתין 24 שעות ואז להעלות את ההמרות שוב. צריך להעלות את כל ההמרות תוך 90 ימים ממועד היצירה של מספר הקליק. אחרת, יכול להיות ש-Search Ads 360 API לא יזהה את הביקור.
  • ‫conversionId: במקרה של המרות אופליין, המפרסמים מספקים את המזהה הזה. מפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורם. לכל המרה בבקשה צריך להיות מזהה ייחודי, והשילוב של המזהה וחותמת הזמן צריך להיות ייחודי בין כל ההמרות בחשבון של המפרסם. במקרה של המרות אונליין, מערכת Search Ads 360 מעתיקה את dsConversionId או floodlightOrderId למאפיין הזה, בהתאם להוראות Floodlight של המפרסם.
  • ‫conversionTimestamp: מציין את התאריך והשעה שבהם התרחשה ההמרה. לדוגמה, אם ההמרה מתרחשת ביום שישי, 5 באוגוסט 2016 בשעה 11:53:22 לפי שעון הקיץ של החוף המזרחי (GMT -4:00), צריך לציין את חותמת הזמן במילישניות של Epoch: 1470412402000.
  • ‫segmentationType: מציין את סוג מערכת ההמרות שאליה אתם מעלים את ההמרה. בשלב הזה נתמכות רק המרות מ-Floodlight, ולכן תמיד צריך לציין בשדה הזה את הערך FLOODLIGHT.
  • ‫segmentationName: השם של הפעילות ב-Floodlight שבה המפרסם משתמש כדי לדווח על ההמרה.

    אם המפרסם מכיל פעילויות עם אותו שם (זה יכול לקרות אם הפעילויות שייכות לקבוצות שונות ב-Floodlight), הפעולה המומלצת היא לשנות את השם של אחת מהפעילויות.

    לחלופין, אם אתם יודעים את המזהה ש-Search Ads 360 הקצה לפעילות ב-Floodlight, אתם יכולים לציין את המזהה ב-segmentationId במקום לציין את השם בשדה segmentationName. ‫(Campaign Manager גם מקצה מזהה לפעילות ב-Floodlight, אבל המזהה ב-Campaign Manager שונה מהמזהה ב-Search Ads 360 ואי אפשר להשתמש בו לשיוך המרות). כדי לראות את מזהה Search Ads 360 של פעילות ב-Floodlight, מורידים דוח המרות (ממשק המשתמש של Search Ads 360 או מ-Reporting API). אם לפחות המרה אחת שויכה לפעילות ב-Floodlight במהלך טווח הזמן של הדוח, מזהה Search Ads 360 יופיע בדוח.

  • ‫type: סוג ההמרה, כלומר ACTION או TRANSACTION. להמרה מסוג ACTION אין ערך כספי, אבל להמרה מסוג TRANSACTION יש. לדוגמה, הרשמה לרשימת תפוצה (ACTION) לעומת רכישות במסחר אלקטרוני (TRANSACTION).

    אם מציינים TRANSACTION, צריך לציין גם את השדה הבא:

    • ‫revenueMicros: הערך הכספי של ההמרה.

שדות אופציונליים

  • ‫quantityMillis: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לקבלת ניוזלטר באימייל או הכמות הכוללת של פריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג ACTION, מערכת Search Ads 360 מוסיפה באופן אוטומטי ערך של 1000.
  • ‫currencyCode: המטבע של ההכנסה מעסקה. כברירת מחדל, ההנחה היא שההכנסות מדווחות במטבע של המפרסם. אם תציינו מטבע אחר, מערכת Search Ads 360 תמיר את סכום ההכנסה שציינתם למטבע של המפרסם. מידע נוסף
    כדי לציין מטבע, צריך להשתמש בפורמט אלפביתי לפי תקן ISO 4217‏ (3 תווים).
    רלוונטי רק להמרות מסוג 'עסקה'.
  • ‫customMetric ו-customDimension: העלאה של נתונים נוספים על המרה, כמו המדינה שאליה נשלח פריט שנרכש, מזהי מוצרים או אפילו משך שיחת טלפון. מידע נוסף על העלאת נתונים למשתנים מותאמים אישית של Floodlight
  • ‫deviceType: מציין את סוג המכשיר שבו התרחשה ההמרה. ברשימת הערכים הקבילים בשדה הזה מופיעים הערכים שנתמכים.

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

שיוך המרה למילת מפתח בלבד

אם הדאגה העיקרית שלכם היא שיוך המרות למילות מפתח – ולא שיוך המרות למודעות – אתם יכולים להשמיט את רוב המזהים של Search Ads 360 ולציין רק את המזהה של מילת המפתח יחד עם כמה שדות אחרים:

שדות חובה

  • ‫criterionId: זהו מזהה מילת המפתח. כדי לקבל את הערך criterionId, מוסיפים את פקודת המאקרו TrackerId לכתובות של דפי הנחיתה. מידע נוסף על קבלת מזהי מילות מפתח זמין במאמר מזהים והמרות ב-Search Ads 360.
  • ‫conversionId: במקרה של המרות אופליין, המפרסמים מספקים את המזהה הזה. מפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורם. לכל המרה בבקשה צריך להיות מזהה ייחודי, והשילוב של המזהה וחותמת הזמן צריך להיות ייחודי בין כל ההמרות בחשבון של המפרסם. במקרה של המרות אונליין, מערכת Search Ads 360 מעתיקה את dsConversionId או floodlightOrderId למאפיין הזה, בהתאם להוראות Floodlight של המפרסם.
  • ‫conversionTimestamp: מציין את התאריך והשעה שבהם התרחשה ההמרה. לדוגמה, אם ההמרה מתרחשת ביום שישי, 5 באוגוסט 2016 בשעה 11:53:22 לפי שעון הקיץ של החוף המזרחי (GMT -4:00), צריך לציין את חותמת הזמן במילישניות של Epoch: 1470412402000.
  • ‫segmentationType: מציין את סוג מערכת ההמרות שאליה אתם מעלים את ההמרה. בשלב הזה נתמכות רק המרות מ-Floodlight, ולכן תמיד צריך לציין בשדה הזה את הערך FLOODLIGHT.
  • ‫segmentationName: השם של הפעילות ב-Floodlight שבה המפרסם משתמש כדי לדווח על ההמרה.

    אם המפרסם מכיל פעילויות עם אותו שם (זה יכול לקרות אם הפעילויות שייכות לקבוצות שונות ב-Floodlight), הפעולה המומלצת היא לשנות את השם של אחת מהפעילויות.

    לחלופין, אם אתם יודעים את המזהה ש-Search Ads 360 הקצה לפעילות ב-Floodlight, אתם יכולים לציין את המזהה ב-segmentationId במקום לציין את השם בשדה segmentationName. ‫(Campaign Manager גם מקצה מזהה לפעילות ב-Floodlight, אבל המזהה ב-Campaign Manager שונה מהמזהה ב-Search Ads 360 ואי אפשר להשתמש בו לשיוך המרות). כדי לראות את מזהה Search Ads 360 של פעילות ב-Floodlight, מורידים דוח המרות (ממשק המשתמש של Search Ads 360 או מ-Reporting API). אם לפחות המרה אחת שויכה לפעילות ב-Floodlight במהלך טווח הזמן של הדוח, מזהה Search Ads 360 יופיע בדוח.

  • ‫type: סוג ההמרה, כלומר ACTION או TRANSACTION. להמרה מסוג ACTION אין ערך כספי, אבל להמרה מסוג TRANSACTION יש. לדוגמה, הרשמה לרשימת תפוצה (ACTION) לעומת רכישות במסחר אלקטרוני (TRANSACTION).

    אם מציינים TRANSACTION, צריך לציין גם את השדה הבא:

    • ‫revenueMicros: הערך הכספי של ההמרה.

שדות אופציונליים

  • ‫quantityMillis: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לקבלת ניוזלטר באימייל או הכמות הכוללת של פריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג ACTION, מערכת Search Ads 360 מוסיפה באופן אוטומטי ערך של 1000.
  • ‫currencyCode: המטבע של ההכנסה מעסקה. כברירת מחדל, ההנחה היא שההכנסות מדווחות במטבע של המפרסם. אם תציינו מטבע אחר, מערכת Search Ads 360 תמיר את סכום ההכנסה שציינתם למטבע של המפרסם. מידע נוסף
    כדי לציין מטבע, צריך להשתמש בפורמט אלפביתי לפי תקן ISO 4217‏ (3 תווים).
    רלוונטי רק להמרות מסוג 'עסקה'.
  • ‫customMetric ו-customDimension: העלאה של נתונים נוספים על המרה, כמו המדינה שאליה נשלח פריט שנרכש, מזהי מוצרים או אפילו משך שיחת טלפון. מידע נוסף על העלאת נתונים למשתנים מותאמים אישית של Floodlight
  • ‫deviceType: מציין את סוג המכשיר שבו התרחשה ההמרה. ברשימת הערכים הקבילים בשדה הזה מופיעים הערכים שנתמכים.

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

העלאת נתונים ממודל שיוך של צד שלישי

מודל שיוך מחלק את הקרדיט על ההמרה בין כלל הפעילויות בנתיב ההמרה. לדוגמה, אם צרכן לוחץ על מודעת חיפוש בתשלום, על מודעה לרשת המדיה ועל עוד מודעת חיפוש בתשלום לפני שהוא מבצע המרה, מודל שיוך לינארי יקצה לכל קליק 33% מהקרדיט על ההמרה.

ב-Search Ads 360 יש מודלים של שיוך, אבל אם אתם משתמשים בשירות של צד שלישי או בשירות שפיתחתם כדי לחלק את הקרדיט לקליקים, אתם יכולים להעלות את נתוני השיוך של הצד השלישי אל Search Ads 360 ולהשתמש בנתונים האלה בדוחות ובשיטות בידינג ב-Search Ads 360.

לפני שמתחילים

ב-Campaign Manager, יוצרים מודל שיוך בהתאמה אישית ומייבאים אותו אל Search Ads 360. חשוב לוודא ששם המודל הוא External Attribution Model. ההגדרה הזו מאפשרת לתכונות של Search Ads 360 לזהות שמודל שיוך (Attribution) הוחל על נתוני ההמרות שאתם מעלים. מידע נוסף

שדות חובה

כדי להחיל מודל שיוך של צד שלישי על המרה, צריך לציין את כל הפרטים הבאים בבקשה Conversion.insert():

  • ‫clickId: מזהה הקליק של הביקור, תלוי אותיות רישיות. מחפשים את מספר הקליק ביומני האינטרנט של המפרסם או מציגים את רשימת ההמרות ומשתמשים במספר קליק מהמרה אחרת. מערכת Search Ads 360 תשייך את ההמרה למילת המפתח, למודעה ולאובייקטים אחרים ב-Search Ads 360 שהיו אחראים ליצירת הביקור.
    מחכים לפחות 30 דקות אחרי שמערכת Search Ads 360 יוצרת מזהה קליק, לפני שמעלים המרה עם המזהה. אחרת, יכול להיות ש-Search Ads 360 API לא יזהה את הביקור.
  • ‫attributionModel: מוגדר כ-External Attribution Model. מידע נוסף
  • ‫countMillis: סכום הקרדיט על ההמרה שיוקצה לקליק הזה. רלוונטי רק אם הבקשה כוללת גם את השדה attributionModel.

    חשוב לא להתבלבל בין הפרמטר הזה לבין quantityMillis, שדה אופציונלי שבו מציינים את מספר הפריטים בהמרה (למשל, מספר הפריטים ברכישה בעגלת קניות).

  • ‫conversionId: במקרה של המרות אופליין, המפרסמים מספקים את המזהה הזה. מפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורם. לכל המרה בבקשה צריך להיות מזהה ייחודי, והשילוב של המזהה וחותמת הזמן צריך להיות ייחודי בין כל ההמרות בחשבון של המפרסם. במקרה של המרות אונליין, מערכת Search Ads 360 מעתיקה את dsConversionId או floodlightOrderId למאפיין הזה, בהתאם להוראות Floodlight של המפרסם.
  • ‫conversionTimestamp: מציין את התאריך והשעה שבהם התרחשה ההמרה. לדוגמה, אם ההמרה מתרחשת ביום שישי, 5 באוגוסט 2016 בשעה 11:53:22 לפי שעון הקיץ של החוף המזרחי (GMT -4:00), צריך לציין את חותמת הזמן במילישניות של Epoch: 1470412402000.
  • ‫segmentationType: מציין את סוג מערכת ההמרות שאליה אתם מעלים את ההמרה. בשלב הזה נתמכות רק המרות מ-Floodlight, ולכן תמיד צריך לציין בשדה הזה את הערך FLOODLIGHT.
  • ‫segmentationName: השם של הפעילות ב-Floodlight שבה המפרסם משתמש כדי לדווח על ההמרה.

    אם המפרסם מכיל פעילויות עם אותו שם (זה יכול לקרות אם הפעילויות שייכות לקבוצות שונות ב-Floodlight), הפעולה המומלצת היא לשנות את השם של אחת מהפעילויות.

    לחלופין, אם אתם יודעים את המזהה ש-Search Ads 360 הקצה לפעילות ב-Floodlight, אתם יכולים לציין את המזהה ב-segmentationId במקום לציין את השם בשדה segmentationName. ‫(Campaign Manager גם מקצה מזהה לפעילות ב-Floodlight, אבל המזהה ב-Campaign Manager שונה מהמזהה ב-Search Ads 360 ואי אפשר להשתמש בו לשיוך המרות). כדי לראות את מזהה Search Ads 360 של פעילות ב-Floodlight, מורידים דוח המרות (ממשק המשתמש של Search Ads 360 או מ-Reporting API). אם לפחות המרה אחת שויכה לפעילות ב-Floodlight במהלך טווח הזמן של הדוח, מזהה Search Ads 360 יופיע בדוח.

  • ‫type: סוג ההמרה, כלומר ACTION או TRANSACTION. להמרה מסוג ACTION אין ערך כספי, אבל להמרה מסוג TRANSACTION יש. לדוגמה, הרשמה לרשימת תפוצה (ACTION) לעומת רכישות במסחר אלקטרוני (TRANSACTION).

    אם מציינים TRANSACTION, צריך לציין גם את השדה הבא:

    • ‫revenueMicros: הערך הכספי של ההמרה.

אם אתם עוקבים אחרי הכנסות מהמרות, ודאו שהמודל משייך הכנסות לכל נקודת מגע בנתיב ההמרה. לדוגמה, אם המודל משתמש בגישה לינארית (חלוקה שווה של ההכנסה בין כל נקודות המגע), בנתיב המרה שכולל 3 קליקים על מודעות, לכל קליק ישויך 33% מההמרה. אם ההמרה הניבה הכנסה של 100$, צריך לוודא שהמודל מחלק הכנסה של 33 $‎ לכל קליק, ושהפרמטר revenueMicros מציין הכנסה של 33 $‎ בלבד לכל קליק.

שדות אופציונליים

  • ‫quantityMillis: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לקבלת ניוזלטר באימייל או הכמות הכוללת של פריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג ACTION, מערכת Search Ads 360 מוסיפה באופן אוטומטי ערך של 1000.
  • ‫currencyCode: המטבע של ההכנסה מעסקה. כברירת מחדל, ההנחה היא שההכנסות מדווחות במטבע של המפרסם. אם תציינו מטבע אחר, מערכת Search Ads 360 תמיר את סכום ההכנסה שציינתם למטבע של המפרסם. מידע נוסף
    כדי לציין מטבע, צריך להשתמש בפורמט אלפביתי לפי תקן ISO 4217‏ (3 תווים).
    רלוונטי רק להמרות מסוג 'עסקה'.
  • ‫customMetric ו-customDimension: העלאה של נתונים נוספים על המרה, כמו המדינה שאליה נשלח פריט שנרכש, מזהי מוצרים או אפילו משך שיחת טלפון. מידע נוסף על העלאת נתונים למשתנים מותאמים אישית של Floodlight
  • ‫deviceType: מציין את סוג המכשיר שבו התרחשה ההמרה. ברשימת הערכים הקבילים בשדה הזה מופיעים הערכים שנתמכים.

דוגמה

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

טיפול בתגובות של Search Ads 360

התשובה מ-Search Ads 360 מציינת הצלחה רק אם כל ההמרות בבקשה אומתו והועלו בהצלחה.

אם הבקשה מצליחה

אם הבקשה מצליחה, התגובה כוללת את הייצוג הפנימי המלא של כל המרה שהועלתה ב-Search Ads 360, כמו מזהה קמפיין, מזהה קבוצת מודעות ומזהה מילת מפתח (קריטריון).

{
 "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"
  },
  ...
 ]
}

אם הבקשה לא מצליחה

אם אימות של המרה אחת או יותר נכשל או שההעלאה שלהן נכשלה, התשובה כוללת הודעות על כל העלאת המרה שנכשלה. התשובה לא מכילה הודעות לגבי המרות שהועלו בהצלחה.

זוהי דוגמה לתשובה לבקשה שלא הצליחה באופן מלא:

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

כל הודעת שגיאה מכילה שני שדות חשובים: סיבה והודעת שגיאה מפורטת. השדה reason יכול להכיל את הערכים requestValidation,‏ internalError,‏ transactionFailed או lateStageRequestError.

שגיאות באימות הבקשה

שגיאות של requestValidation מצביעות על בעיות בנתונים בבקשת העלאת ההמרות (לדוגמה, ההמרה כבר הועלתה או שלא נמצא clickId). בסוג השגיאה הזה, הפרטים של ההודעה מכילים שני פריטים:

  • קוד הקסדצימלי שמזהה את סוג השגיאה. אתם יכולים להשתמש בקוד בסקריפטים שלכם כדי לזהות את השגיאות.
  • תיאור של שגיאת האימות.

מידע נוסף זמין ברשימת הקודים והתיאורים ש-Search Ads 360 יכול להחזיר לשגיאות בהעלאת המרות.

סוגים נוספים של שגיאות

כל סוגי השגיאות האחרים (internalError,‏ transactionFailed או lateStageRequestError) מצביעים על בעיה פנימית ב-Search Ads 360.

תגובה לשגיאה

אם הבקשה נכשלת, כדאי לנסות לשלוח מחדש את כל בקשת השיחה מאוחר יותר. מערכת Search Ads 360 תדווח על שגיאות requestValidation לגבי המרות שכבר הועלו, אבל היא תנסה להעלות את ההמרות שנותרו.

אם השגיאות עדיין מופיעות אחרי השליחה מחדש, אפשר לעיין בקטע פתרון בעיות כדי לקבל מידע על המשך הפעולה.