בינג אַדס אינטעגראַציע

פֿאַרבינדן אייער קאַטאַלאָג צו מייקראָסאָפֿט מערטשאַנט צענטער שטעלט אייערע פּראָדוקטן פֿאַר קויפֿער אויף דער מייקראָסאָפֿט זוכן נעץ — אַ פּול פֿון זוכן נאָכפֿראַגע וואָס איבערדעקט נישט פֿולשטענדיק מיט גוגל'ס. פֿאַר רובֿ אַדווערטייזערז מיינט דאָס אַ ביסל מער דערגרייכונג, און אָפֿט אַ נידעריקער קאָסטן-פּער-קליק ווי גוגל שאַפּינג, אָן בויען אַ צווייטן קאַטאַלאָג פֿון גאָרנישט.

מייקראָסאָפֿט'ס קאָנטענט API גייד ליסטירט שאַפּינג קאַמפּיינז און פּראָדוקט אַדס ווי געשטיצט איבער אַ גרויסע סכום מאַרקן - פֿון די פֿאַראייניקטע שטאַטן, קאַנאַדע און פֿאַראייניקטע קעניגרייך ביז קלענערע מאַרקן ווי מאַלטאַ, מאַוריטיוס, ציפּערן און פֿידזשי - מיט אַן נאָך סכום לענדער בנימצא צו פּילאָט קאַסטאַמערז. די ברייטקייט מיינט אַז אַן איינציקער, גוט-סטרוקטורירטער פֿיד קען אויסברייטערן אַ שאַפּינג בייַזייַן אין מאַרקן וואָס איר האָט אפשר נישט פּריאָריטיזירט אויף גוגל.

ווייל מייקראָסאָפֿט'ס פּראָדוקט סכעמע איז באַוואוסטזיניק געבויט געוואָרן צו זיין אינטעראָפּעראַבל מיט גוגל'ס, רובֿ פון די זעלבע פּראָדוקט דאַטן — טיטל, פּרייז, בילדער, GTIN, בראַנד, MPN — וואָס זענען נויטיק פֿאַר אַ גוגל מערטשאַנט צענטער פֿיד, טרייבט אויך אייערע מייקראָסאָפֿט מערטשאַנט צענטער ליסטינגס, וואָס האַלט די אינקרעמענטאַלע סעטאַפּ מי רעלאַטיוו נידעריק.

מייקראָסאָפֿט'ס קאָנטענט API דאָקומענטאַציע איז אויסערגעוויינלעך אָפן וועגן וואו איר סכעמע בארגט זיך פון גוגל'ס — און וואו זי שטילערהייט דיווערדזשירט. א צאָל פעלדער אין דעם פּראָדוקט אָביעקט עקזיסטירן ריין "פֿאַר גוגל קאָמפּאַטאַביליטי": מייקראָסאָפֿט'ס API וועט אָננעמען additionalImageLinks, adwordsGrouping, adwordsLabels, destinations, און taxes, אבער איר אייגענע דאקומענטאציע זאגט קלאר אז מייקראסאפט מערטשאנט צענטער ניצט בכלל נישט די פעלדער. אויב איר ניצט ווידער א גוגל-פארמאטירטן פיד, גייען די פעלדער פשוט אדורך אומשעדלעך אנשטאט צו טון עפעס אויף דער מייקראסאפט זייט.

מייקראָסאָפֿט דאָקומענטירט אויך אַ פֿונקציע וואָס גוגל שאַפּינג האָט נישט אין דער זעלבער פֿאָרעם: שאַפּינג קאַמפּיינז פֿאַר בראַנדזאין דעם קאָאָפּעראַטיוו מאָדעל, אַ פאַבריקאַנט לאָודט אַרויף אַ פּראָדוקט רשימה וואָס כּולל בלויז Brand, GTIN, און MPN, פֿאַרבינדט עס צו אַ ריטעיל פּאַרטנער'ס מייקראָסאָפֿט מערטשאַנט צענטער קראָם, און ביידע פּאַרטייען קענען דאַן בידן אויף דער געטיילטער רשימה פֿון פּאַסיקע פּראָדוקטן — און טיילן די קאָסטן פֿון קליקן. מייקראָסאָפֿט'ס דאָקומענטאַציע באַמערקט אַז דאָס איז איצט באַגרענעצט צו די פֿאַראייניקטע שטאַטן און פֿאַראייניקטע קעניגרייך און איז אונטער אָפֿענער ביתא פֿאַר פּילאָט קאַסטאַמערז.

נאך א פראקטישע חילוק: מייקראסאפט אפווארפט אויסדריקליך דערוואקסענע פראדוקטן גלייך ("דערוואקסענע פראדוקטן ווערן נישט געשטיצט און וועלן אפגעווארפן ווערן"), און עס האלט אן זיין אייגענע אידענטיפיקאציע-וואלידאציע לאגיק (זעה די פארלאנגטע-אטריבוטן סעקציע אונטן) וואס לויפט אומאפהענגיק פון וועלכער וואלידאציע אייער פיד האט שוין דורכגעפירט פאר גוגל.

מייקראָסאָפֿט מערטשאַנט צענטער אַקסעפּטירט אייער קאַטאַלאָג אין צוויי ברייטע וועגן, לויט זיין באַאַמטער דאָקומענטאַציע:

1. א פלאַכע פיד טעקע אַרויפגעלאָדן צו אייער קראָם אָדער קאַטאַלאָג, אריינגעשיקט אויף אַ קעסיידערדיקן פּלאַן דורך FTP/SFTP.
2. די אינהאַלט API — אַ RESTful, JSON-באַזירטע API דאָקומענטירט ביי content.api.bingads.microsoft.com/shopping/v9.1/bmc/ — פֿאַר אַרײַנשטעלן, אַפּדייטן, צוריקקריגן און אויסמעקן יחידישע פּראָדוקטן אָדער זיי פאַראַרבעטן אין גרויסן דורך די /products/batch ענדפּוינט.

די קאָנטענט API'ס באַטש ענדפּוינט דאָקומענטירט קאָנקרעטע לימיטן וואָס זענען ווערט צו פּלאַנירן אַרום: אַן איינציקע באַטש בקשה קען אַרייַננעמען ביז 12,000 זאכן, אָבער די גאַנצע בקשה גוף קען נישט יקסיד 4 מעגאבייט, אַזוי מייקראָסאָפֿט'ס אייגענע גיידאַנס איז אַז איר קענט טיפּיש פּאַסיק 2,000-6,000 אַנקאַמפּרעסט אָפפערס פּער באַטש (ביז די פולע 12,000 אויב איר gzip-קאָמפּרעסירן די פּיילאָוד מיט די). Content-Encoding: gzip כעדער). ליסטע פארלאנגען ווערן געצילט מיט א מאקסימום פון 250 פראדוקטן פער רוף ניצנדיק max-results און start-token.

פּראָדוקטן וואוינען אין אַ מייקראָסאָפֿט מערטשאַנט צענטער קראָם, און אַ קראָם קען אָפּציאָנעל אַנטהאַלטן קייפל קאַטאַלאָגז (ספּעציפֿיצירט מיט די bmc-catalog-id פּאַראַמעטער אויף אַריינלייגן). יעדע אָפער וואָס איר שיקט אַרײַן דאַרף אַן עקספּיראַציע האָריזאָנט: מייקראָסאָפֿט'ס דאָקומענטאַציע באַשטעטיקט אַז סײַדן איר שטעלט אַ קלאָרן expirationDate, אַן אָפער עקספּירירט אויטאָמאַטיש 30 טעג נאָכדעם וואָס עס איז געשריבן געוואָרן צום קראָם.

מייקראָסאָפֿט'ס קאָנטענט API רעפֿערענץ איז קלאָר וועגן וועלכע פֿעלדער זענען פֿאַרפֿליכטעט צו אַריינשטעלן אַן אָפֿער, און וועלכע ווערן פֿאַרפֿליכטעט באַדינגט. לויט דער אָפֿיציעלער פּראָדוקט רעסורס דאָקומענטאַציע:

פידאַנס בויט דעם מייקראָסאָפֿט מערטשאַנט צענטער פֿיד גלייך פֿון די פּראָדוקט דאַטן וואָס איר שוין פֿאַרוואַלטעט אין אייער קראָם אָדער PIM — קיין מאַנועלע ספּרעדשיט עקספּאָרטן. די מאַפּינג מאָטאָר באַשטימט אייערע מקור פֿעלדער צו מייקראָסאָפֿט'ס סכעמע, אַרייַנגערעכנט די קאָמפּאָזיט-ID פֿעלדער (channel, contentLanguage, targetCountry, offerId) וואָס מייקראָסאָפֿט פֿאַרשפּאַרט נאָך דער ערשטער סאַבמישאַן, אַזוי עס איז וויכטיק זיי צו באַקומען גלייך פֿון פֿריִער.

1. פֿאַרבינדט אײַער קראָם אָדער דאַטן מקור (e-קאַמערץ פּלאַטפאָרמע, PIM, אָדער עקסיסטירנדיק פּראָדוקט עקספּאָרט) צו Feedance.
2. מאַפּ אייערע פעלדער צו מייקראָסאָפֿט'ס פארלאנגטע און קאָנדיציאָנעלע אַטריביוטן — Feedance מאַרקירט פעלנדיקע אידענטיפיצירער און אַפּלייז identifierExists: false אויטאָמאַטיש ווען די בראַנד, GTIN, אדער MPN זענען טאַקע נישט פֿאַראַן, אַזוי איר זאָלט נישט זאַמלען קיין וואָרענונגען וואָס מען קען פֿאַרמייַדן.
3. דזשענערירט דעם פיד אין דער סטרוקטור וואָס מייקראָסאָפֿט'ס קאָנטענט API און סטאָר אינסדזששאַן ערוואַרטן, און ליפערט עס דורך סקעדזשולד פיד אַפּלאָוד אָדער דירעקט API סאַבמישאַן צו דיין מייקראָסאָפֿט מערטשאַנט צענטער סטאָר ID.
4. פידאַנס מאָניטאָרירט די רעזולטאַטן פּראָדוקט סטאַטוסעס — באַשטעטיקט, וואָרענונג, נישט באַשטעטיקט, פּענדינג, און עקספּייערינג — אַזוי איר קענט זען און פאַרריכטן itemLevelIssues אָן זיך אַרײַנצולאָגן אין דער מייקראָסאָפֿט אַדווערטייזינג וועב אַפּ פֿאַר יעדן טשעק.

ווייל אייער עקזיסטירנדיקע גוגל מערטשענט צענטער מאַפּינג דעקט שוין רובֿ פון די זעלבע אַטריביוטן וואָס מייקראָסאָפֿט פארלאנגט, איז פֿאַרבינדן אַ צווייטע דעסטינאַציע דורך פידאַנס טיפּיש אַ ענין פון אַטריביוט איבערבליק, נישט אַ ריבילדינג.

מייקראָסאָפֿטס אייגענע דאָקומענטאַציע שטעלט אַ שטרענגע באַקסטאָפּ: סיידן איר שטעלט אויסדריקליך אַ expirationDate, יעדע אָפער עקספּירירט אויטאָמאַטיש 30 טעג נאָכדעם וואָס זי איז לעצט געשריבן געוואָרן צום קראָם — אין וועלכן פונקט הערט זי אויף צו זיין בארעכטיגט צו ווערן געוויזן. פשוט ווידער אריינשיקן דעם פּראָדוקט (אפילו אָן ענדערן קיין פעלדער) ריסעט יענע 30-טאָגיקע זייגער, אָבער נאָר אויב איר האָט נישט מאַנועל באַשטימט אַן עקספּליציטן עקספּיראַציע דאַטע אַליין.

אין פּראַקטיק, איז יענע 30-טאָגיקע עקספּיראַציע-דאַטע אַ לימיט, נישט אַ ציל. ווײַל פּרײַז און פֿאַרפֿיגבאַרקייט מוזן שטימען מיט וואָס איז אויף אײַער לעבעדיקער פּראָדוקט-בלאַט — באַשטעטיקט מײַקראָסאָפֿט עקספּליציט אַז דער פֿיד price פּאַסט צו דער וועבזייטל פֿונעם פּראָדוקט — יעדער קאַטאַלאָג מיט רעגולערע פּרייז ענדערונגען, אויספאַרקויפטע פּראָדוקטן, אָדער פּראָמאָציעס זאָל זיך דערפֿרישן פֿיל אָפֿטער ווי איין מאָל אַ חודש. אַ קאַדענץ פֿון לפּחות טעגלעך האַלט די פֿאַרפֿיגבאַרקייט און פּרייזן גענוי און פֿאַרמייַדט דעם שטילן ריס צווישן ווען אַ פּראָדוקט פֿאַרקויפֿט זיך אויס און ווען אײַער פֿיד דערגרייכט.

מייקראָסאָפֿט'ס אינהאַלט API גיט צוריק קאָנקרעטע, דאָקומענטירטע סטאַטוס קאָודן פֿאַר פּראָבלעמאַטישע אָפפערס אַנשטאָט וואָלקע אָפּוואַרפֿונגען. צוויי עכטע ביישפילן גלייך פֿון מייקראָסאָפֿט'ס אייגענעם פּראָדוקט-אָפער-סטאַטוסן רעפֿערענץ:

1. GtinPlusBrandRequiredWarn — "פעלנדיק איין אדער מערערע אידענטיפיצירער - די בראַנד און GTIN אדער בראַנד און MPN זענען פארלאנגט." דאָס איז אַ ווארענונג, נישט קיין גלייכע אפווארף: מייקראסאפט'ס סערוואַביליטי פעלד מארקירט עס "נישט באאיינפלוסט," וואס מיינט אז די אנבאט סערווירט נאך אלץ, אבער איר זאלט ​​עס פאררעכטן — אדער צושטעלן די עכטע אידענטיפיצירער אדער שטעלן identifierExists צו false אויב קיין איינס עקזיסטירט נישט.
2. EVRejectedErr צוזאַמען מיט אַ ספּעציפֿישן סיבה קאָד ווי למשל EV_39 ("טריידמארק אינהאַלט") — דאָס איז אַ שטרענגע אָפּזאָג; מייקראָסאָפֿט'ס דאָקומענטאַציע ווײַזט דעם אָפֿער'ס status פעלד געשטעלט צו "נישט באשטעטיקט" און servability שטעלן צו "נישט באשטעטיקט," וואס מיינט אז דער פראדוקט וועט נישט ווערן געוויזן ביז דער מארקירטער אינהאלט ווערט פארראכטן.

ווייטער פון יחידישע אייטעמס פראבלעמען, באשטעטיגט מייקראסאפט'ס דאקומענטאציע אז נאכדעם וואס עס גייט אדורך גרונטלעכע וואלידאציע, גייט יעדע אפער אדורך נאָך "אָפפליין וואלידאציעס און באריכטן, ווי למשל רעדאקציאנעלע באריכטן, וואס קענען נעמען ביז 36 ​​שעה" איידער עס איז בארעכטיגט צו ווערן סערווירט — אזוי אז א ניי אריינגעגעבענע אדער ניי דערהיינטיקטע אפער וואס זיצט אין "פּענדינג" סטאטוס פאר א טאג איז ערווארטעטע אויפפירונג, נישט א באַג. א געשעפט-לעוועל קיצער איבערבליק (צו דערגרייכן דורך די פּראָדוקטסטאַטוסעס רעסורס) באריכטעט ציילן אריבער. approved, disapproved, expiring, און pending, וואָס איז דער שנעלסטער וועג צו זען קאַטאַלאָג געזונט אויף איין בליק.

1. צושטעלן אַלע דריי אידענטיפיצירער ווען זיי עקסיסטירן. מייקראָסאָפֿט'ס דאָקומענטאַציע איז קלאָר אַז אויב אַ פאַבריקאַנט האָט צוגעטיילט אַ GTIN, בראַנד, אָדער MPN, מוז מען עס אַרייננעמען — אויסלאָזן אַ באַקאַנטן אידענטיפֿיקאַטאָר פּראָדוצירט די GtinPlusBrandRequiredWarn ווארענונג אפילו כאָטש די אָפער איז נאָך גילטיק. אויב קיין איינע איז נישט טאַקע גילטיק, שטעלט identifierExists צו false אנשטאט לאָזן די פעלדער ליידיק.
2. גרופע וועריאנטן מיט itemGroupId. פֿאַר אַ פּראָדוקט וואָס ווערט פֿאַרקויפֿט אין קייפל פֿאַרבן, גרייסן אָדער מוסטערן, רעקאָמענדירט מײַקראָסאָפֿטס דאָקומענטאַציע צו שאַפֿן איין אָפֿער פּער וואַריאַנט און זיי פֿאַרבינדן מיט אַ געטיילטן... itemGroupId אנשטאט צו פרובירן צו אריינשטופן יעדע אפציע אין איין אנבאטע.
3. נוצן customLabel0-customLabel4 פֿאַר קאַמפּיין סעגמענטאַציע. די פינף פעלדער עקזיסטירן ספעציפיש כדי איר זאלט ​​קענען פילטערן און בידן אויף סובסעטס פון אייער קאַטאַלאָג אין מייקראָסאָפֿט שאַפּינג קאַמפּיינז.
4. האַלט טיטלען און באַשרייַבונגען אָן פּראָמאָציע. ביידע פעלדער מעגן אויסדריקליך "נישט אנטהאלטן פראמאציאנעלע טעקסט" און ביידע גייען דורך רעדאקציאנעלע איבערקוק — פארקויף שפראך איינגעבאקן אין טיטל ריזיקירט אפזאג אנשטאט צו ברענגען קליקן.
5. טראַק עקספּיראַציע פּראָאַקטיוולי. ווייל אָפערס פאַרלאָזן שטילערהייט 30 טעג נאָך זייער לעצטע דערהייַנטיקונג סיידן איר שטעלט איין אייער אייגענע expirationDate, פידס פאר לאנגזאם-גייענדיקע קאַטאַלאָגן דאַרפֿן נאָך אַ דערפרישונג קאַדענץ, אפילו אויב קיין איינע פון ​​די אונטערלייגנדיקע פּראָדוקט דאַטן האָט זיך נישט געביטן.
6. שרייב אריין shipping פֿאַר דײַטשע ליסטינגס. מייקראָסאָפֿט'ס דאָקומענטאַציע מאַרקירט שיפּינג, שיפּינג לייבל, און שיפּינג וואָג ווי ספּעציפֿיש פארלאנגט פֿאַר אַ targetCountry פון DE — אַ כלל וואָס איז גרינג צו פאַרפעלן אויב אייער הויפּט מאַרק איז אַנדערשוואו.

איז "בינג עדס" נאך אן עכטער פראדוקט נאמען? ניין — מייקראסאפט האט איבערגעבראנדעט בינג עדס צו מייקראסאפט אדווערטייזינג אין 2019. "בינג מערטשענט צענטער" איז יעצט מייקראסאפט מערטשענט צענטער. די אונטערליגענדע פלאטפארמע און שאפינג קאמפיין מעכאניק זענען נישט געענדערט; נאר דער נאמען איז.

קען איך ווידער נוצן מיין גוגל מערטשאַנט צענטער פיד פֿאַר מייקראָסאָפֿט? גרויסענטייל יא. מייקראָסאָפֿט'ס פּראָדוקט סכעמע שפּיגלט אָפּ פילע גוגל מערטשאַנט צענטער פעלד נעמען, און עטלעכע גוגל-אָריענטירטע פעלדער (destinations, taxes, adwordsGrouping, adwordsLabels, additionalImageLinks) ווערן אנגענומען ריין פאר קאמפאטיבילעטי אפילו כאטש מייקראסאפט'ס דאקומענטאציע באשטעטיגט אז עס ניצט זיי נישט. איר וועט נאך אלץ וועלן איבערקוקן מייקראסאפט-ספעציפישע פארלאנגטע פעלדער ווי channel און באַדינגטע כּללים ווי דײַטשלאַנדס שיפּינג פאָדערונג.

איז א GTIN פארלאנגט פאר יעדן פראדוקט? נאָר אויב דער פאַבריקאַנט האָט איינס צוגעטיילט. מייקראָסאָפֿטס דאָקומענטאַציע פֿאָדערט gtin, brand, און mpn ווען זיי עקזיסטירן; אויב זיי עקזיסטירן טאקע נישט, שטעלט identifierExists צו false אנשטאט זיי צו לאזן ליידיג.

וואָס פּאַסירט אויב איך הער אויף צו דערהייַנטיקן מיין פיד? לויט מייקראָסאָפֿט'ס דאָקומענטאַציע, יעדע אָפֿער עקספּירירט אויטאָמאַטיש 30 טעג נאָך איר לעצטער דערהייַנטיקונג (סיידן איר האָט באַשטימט אייער אייגענע). expirationDate), און אַן אויסגעלאָפֿענע אָפֿער הערט אויף צו זײַן בארעכטיגט צו סערווירן.

ווי לאַנג נעמט אַן איבערבליק נאָכדעם וואָס איך פאָרלייג אָדער דערהייַנטיקט אַ פּראָדוקט? מייקראָסאָפֿט'ס דאָקומענטאַציע זאָגט אַז נאָך אַ גרונטיקער וואַלידאַציע, גייען אָפפערס דורך נאָך אָפפליין איבערבליקן, אַרייַנגערעכנט רעדאַקציע איבערבליק, וואָס "קען נעמען ביז 36 ​​שעה" איידער די אָפער איז בארעכטיגט צו דינען.

קען איך אריינשיקן מיין פיד דורך FTP אנשטאט אן API? יא — מייקראסאפט מערטשאנט צענטער שטיצט איבערחזרנדיקע פיד טעקע אריינשיקונגען אין צוגאב צו די JSON-באזירטע קאנטענט API, אזוי קענען טימס אן אנטוויקלונג רעסורסן נאך אלץ אויטאמאטיזירן די ליפערונג.