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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אפשר לשלוח בקשה מסוג 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), מומלץ לשנות את השם של אחת מהפעילויות.

    לחלופין, אם אתם יודעים מה המזהה שהוקצה לפעילות ב-Floodlight על ידי Search Ads 360, תוכלו לציין את המזהה בשדה 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. להמרה מסוג 'פעולה' אין ערך כספי, אבל להמרה מסוג 'עסקה' יש. לדוגמה, הרשמות לרשימת אימייל (פעולה) לעומת רכישות במסחר אלקטרוני (עסקה).

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

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

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

  • quantityMillis: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לקבלת ניוזלטר באימייל או הכמות הכוללת של הפריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג פעולה, מערכת 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), מומלץ לשנות את השם של אחת מהפעילויות.

    לחלופין, אם אתם יודעים מה המזהה שהוקצה לפעילות ב-Floodlight על ידי Search Ads 360, תוכלו לציין את המזהה בשדה 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. להמרה מסוג 'פעולה' אין ערך כספי, אבל להמרה מסוג 'עסקה' יש. לדוגמה, הרשמות לרשימת אימייל (פעולה) לעומת רכישות במסחר אלקטרוני (עסקה).

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

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

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

  • quantityMillis: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לקבלת ניוזלטר באימייל או הכמות הכוללת של הפריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג פעולה, מערכת 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. חשוב לתת למודל את השם מודל שיוך (Attribution) חיצוני. כך התכונות של Search Ads 360 יוכלו לזהות שמודל שיוך (Attribution) הופעל על נתוני ההמרות שאתם מעלים. מידע נוסף

שדות חובה

כדי להחיל מודל שיוך של צד שלישי על המרה, צריך לציין את כל הפרטים הבאים בבקשה 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), צריך לציין את חותמת הזמן במיליסקונדות של Epoch: 1470412402000.
  • segmentationType: מציינים את סוג מערכת ההמרות שאליה מעלים את ההמרה. בשלב הזה יש תמיכה רק בהמרות מ-Floodlight, ולכן תמיד צריך לציין בשדה הזה את הערך FLOODLIGHT.
  • segmentationName: השם של הפעילות ב-Floodlight שבה המפרסם משתמש כדי לדווח על ההמרה.

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

    לחלופין, אם אתם יודעים מה המזהה שהוקצה לפעילות ב-Floodlight על ידי Search Ads 360, תוכלו לציין את המזהה בשדה 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. להמרה מסוג 'פעולה' אין ערך כספי, אבל להמרה מסוג 'עסקה' יש. לדוגמה, הרשמות לרשימת אימייל (פעולה) לעומת רכישות במסחר אלקטרוני (עסקה).

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

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

אם אתם עוקבים אחרי ההכנסות מההמרות, חשוב לוודא שהמודל שלכם מחלק את ההכנסות בין כל נקודות המגע בנתיב ההמרות. לדוגמה, אם המודל משתמש בגישה לינארית (חלוקת ההכנסה באופן שווה בין כל נקודת מגע), בנתיב המרה שכולל 3 קליקים על מודעות, כל קליק ישויך ל-33% מההמרה. אם ההמרה הניבה הכנסה של 400 ש"ח, צריך לוודא שהמודל מחלק הכנסה של 133 ש"ח לכל קליק, ולוודא ש-revenueMicros מציין רק הכנסה של 133 ש"ח לכל קליק.

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

  • quantityMillis: מספר הפריטים בהמרה הזו. לדוגמה, מספר האנשים שנרשמו לקבלת ניוזלטר באימייל או הכמות הכוללת של הפריטים שנמכרו. אם לא מציינים את השדה הזה להמרות מסוג פעולה, מערכת 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 ..."
       }
    ]
  }
}

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

שגיאות requestValidation

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

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

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

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

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

תגובה לשגיאה

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

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