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

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

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

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

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

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

ממירים את כל חותמות הזמן של ההמרות לתקופה של זמן מערכת (שנקרא גם 'זמן יוניקס').

אפשר ליצור פעילויות Floodlight מה-API?

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

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

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

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

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

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

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

  3. אם מחכים יותר מ-24 שעות לפני העלאת המרות של פעילות ב-Floodlight, צריך לשלוח חותמת זמן של זמינות.

    חותמת הזמן של הזמינות צריכה להיות אחת מהאפשרויות הבאות:

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

שליחה של בקשת הוספה

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

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

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

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

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

שדות חובה

  • clickId: מזהה קליק של הביקור תלוי אותיות רישיות. אפשר לחפש ביומני האינטרנט של המפרסם את מספר הקליק או את הצגת ההמרות ולהשתמש במספר קליק מהמרה אחרת. מערכת Search Ads 360 תשייך את ההמרה למילת המפתח, למודעה ולאובייקטים אחרים ב-Search Ads 360 שאחראים ליצירת הביקור.
    ממתינים לפחות 30 דקות אחרי שמערכת Search Ads 360 יוצרת מספר קליק כדי להעלות המרות. אם מופיעה הודעת השגיאה "מספר הקליק לא נמצא", צריך להמתין 4 שעות ואז להעלות את ההמרות שוב. צריך להעלות את כל ההמרות תוך 90 יום ממועד היצירה של מספר הקליק. אחרת, ייתכן ש-Search Ads 360 API לא יזהה את הביקור.
  • conversionId: עבור המרות אופליין, המפרסמים מספקים את המזהה הזה. המפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורם. לכל המרה בבקשה צריך לציין מזהה ייחודי, והשילוב של המזהה וחותמת הזמן חייב להיות ייחודי בין כל ההמרות אצל המפרסם. כשמדובר בהמרות אונליין, מערכת Search Ads 360 מעתיקה את dsConversionId או את floodlightOrderId לנכס הזה בהתאם להוראות Floodlight של המפרסם.
  • conversionTimestamp: מציין את התאריך והשעה שבהם התרחשה ההמרה. לדוגמה, אם ההמרה מתרחשת ביום שישי, 5 באוגוסט 2016 בשעה 11:53:22 לפי שעון החוף המזרחי (GMT -4:00), צריך לציין את חותמת הזמן באלפיות השנייה: 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: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לניוזלטר באימייל או הכמות הכוללת של הפריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג 'פעולה', מערכת Search Ads 360 תוסיף באופן אוטומטי את הערך 1000.
  • currencyCode: המטבע של ההכנסה מעסקה. כברירת מחדל, ההנחה היא שההכנסה היא במטבע של המפרסם. אם מציינים מטבע אחר, מערכת Search Ads 360 תמיר את סכום ההכנסה שצוין למטבע של המפרסם. מידע נוסף
    כדי לציין מטבע, צריך להשתמש בפורמט אלפביתי לפי תקן ISO 4217 (3 תווים).
    רלוונטי רק להמרות מסוג TRANSACTION.
  • 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), צריך לציין את חותמת הזמן באלפיות השנייה: 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: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לניוזלטר באימייל או הכמות הכוללת של הפריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג 'פעולה', מערכת Search Ads 360 תוסיף באופן אוטומטי את הערך 1000.
  • currencyCode: המטבע של ההכנסה מעסקה. כברירת מחדל, ההנחה היא שההכנסה היא במטבע של המפרסם. אם מציינים מטבע אחר, מערכת Search Ads 360 תמיר את סכום ההכנסה שצוין למטבע של המפרסם. מידע נוסף
    כדי לציין מטבע, צריך להשתמש בפורמט אלפביתי לפי תקן ISO 4217 (3 תווים).
    רלוונטי רק להמרות מסוג TRANSACTION.
  • 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())

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

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

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

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

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

שדות חובה

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

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

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

  • conversionId: עבור המרות אופליין, המפרסמים מספקים את המזהה הזה. המפרסמים יכולים לציין כל מזהה שיש לו משמעות עבורם. לכל המרה בבקשה צריך לציין מזהה ייחודי, והשילוב של המזהה וחותמת הזמן חייב להיות ייחודי בין כל ההמרות אצל המפרסם. כשמדובר בהמרות אונליין, מערכת Search Ads 360 מעתיקה את dsConversionId או את floodlightOrderId לנכס הזה בהתאם להוראות Floodlight של המפרסם.
  • conversionTimestamp: מציין את התאריך והשעה שבהם התרחשה ההמרה. לדוגמה, אם ההמרה מתרחשת ביום שישי, 5 באוגוסט 2016 בשעה 11:53:22 לפי שעון החוף המזרחי (GMT -4:00), צריך לציין את חותמת הזמן באלפיות השנייה: 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: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לניוזלטר באימייל או הכמות הכוללת של הפריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג 'פעולה', מערכת Search Ads 360 תוסיף באופן אוטומטי את הערך 1000.
  • currencyCode: המטבע של ההכנסה מעסקה. כברירת מחדל, ההנחה היא שההכנסה היא במטבע של המפרסם. אם מציינים מטבע אחר, מערכת Search Ads 360 תמיר את סכום ההכנסה שצוין למטבע של המפרסם. מידע נוסף
    כדי לציין מטבע, צריך להשתמש בפורמט אלפביתי לפי תקן ISO 4217 (3 תווים).
    רלוונטי רק להמרות מסוג TRANSACTION.
  • 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 ..."
       }
    ]
  }
}

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

שגיאות requestVerifyation

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

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

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

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

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

איך עונים לשגיאה

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

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