Modificari API pentru partajarea publicului personalizat

Dupa cum am distribuit in iunie, am introdus un nou flux de incarcare si partajare pentru segmente de public personalizate dintr-un fisier client. Atunci cand incarca segmente de public personalizate dintr-un fisier de clienti, agentii de publicitate trebuie sa accepte termenii nostri de audiente personalizate, sa furnizeze informatii despre originea publicului si sa stabileasca relatii de distribuire a publicului prin intermediul Business Manager. Dupa cum sa mentionat, aceste modificari sunt concepute pentru a oferi transparenta sporita, responsabilitate si usurinta in utilizare pentru produsele noastre de directionare.

Cronologia modificarilor

Pe masura ce facem aceste modificari, dorim sa impartasim modul in care se va schimba comportamentul asteptat de API pentru fisierele de clienti Audiente personalizate. Urmati aceasta cronologie pentru aceste modificari:

7 AUGUST 2018

Avand in vedere modificarile din 15 august 2018 care ar putea impiedica crearea, editarea sau duplicarea campaniei folosind fisierul partajat al clientului Audiente personalizate, vom adauga un nou camp backend la Audiente personalizate care poate fi interogat pentru a identifica daca publicul respectiv este afectat sau nu . Acest lucru va va permite sa anuntati agentii de publicitate care s-ar putea sa nu-si dea seama ca trebuie sa ia masuri inainte de 15 august 2018 pentru a continua sa utilizeze fisierul lor comun de clienti Audiente personalizate.

15 AUGUST 2018

Dupa aceasta data, orice fisier de clienti partajat anterior Audienta personalizata care nu are o relatie de manager de afaceri si nu a fost partajat prin noul flux nu va mai fi disponibil pentru utilizare in seturi de anunturi noi. Campaniile infiintate inainte de 15 august vizeaza fisierul clientilor Audiente personalizate distribuite inainte de 2 iulie 2018 (inclusiv segmente de public personalizate gestionate) vor continua sa fie difuzate pana la 1 octombrie 2018, atat timp cat acele campanii nu vor fi intrerupte sau editate dupa 15 august 2018.

1 OCTOMBRIE 2018

Dupa cum s-a anuntat anterior, vom incheia livrarea pentru publicurile personalizate partajate care nu au o relatie de manager de afaceri, facilitata de noul flux de partajare. Livrarea va continua numai pentru campaniile care utilizeaza publicuri care au fost partajate prin parteneriate de Business Manager stabilite, utilizand noul flux de audiente personalizate.

Specificatii tehnice

Pentru a sustine in continuare actualizarile de mai sus, am introdus urmatoarele functionalitati in interfetele noastre:

Vizualizati starea de partajare curenta pentru segmentele de public personalizate ale fisierului partajat pentru clienti

Cu marginea si campurile de mai jos de pe nodul custom_audience_id, destinatarii publicului pot verifica daca exista o relatie stabilita intre compania care detine publicul si compania care detine contul de anunt destinatar. Aplicatia dvs. trebuie sa furnizeze ID-ul contului de anunt destinatar sub parametrul ad_account_id.

Exemplu de apel API, unde valorile posibile ale starii de partajare sunt NO_RELATIONSHIP, PENDING_RELATIONSHIP si ACCEPTED_RELATIONSHIP.

GET <custom_audience_id>? Ad_account_id = <ad_account_id> & fields = [‘sharing_status’] Raspuns: curl \ {„sharing_status”: {„sharing_relationship_id”: <RELATIONSHIP_ID>, „status”: Sharing Status,}}

Pe baza starii de partajare returnate in API, pot exista diverse implicatii pentru utilizarea publicului:

• ACCEPTED_RELATIONSHIP – Indica faptul ca exista deja o relatie de partajare acceptata stabilita intre initiator si destinatar, iar acestia pot continua sa foloseasca publicul partajat fara modificari.

• PENDING_RELATIONSHIP:
  • Indica ca exista o relatie de partajare initiata de proprietarul de afaceri al publicului fata de destinatarul companiei, dar acesta nu a fost inca de acord cu aceasta.
  • Administratorul companiei destinatar trebuie sa accepte aceasta relatie> accesati setarile Audience Manager sau Business Manager pentru a accepta utilizarea acestui public pentru crearea de seturi de anunturi.

• FARA RELATIE:
  • Indica faptul ca publicul a fost distribuit mai devreme fara o relatie de partajare stabilita intre ambele companii.
  • Destinatarul poate continua sa foloseasca publicul pana la 15 august 2018 fara nicio problema. Cu toate acestea, incepand cu 15 august 2018, acestia nu il pot folosi pentru crearea de noi anunturi, cu exceptia cazului in care proprietarul companiei a distribuit un public si destinatarul administratorului companiei accepta relatia. Pentru mai multe informatii, consultati Partajarea segmentelor de public personalizate intre managerii de afaceri.

Vizualizati conturile de anunturi ale destinatarilor si starea de distribuire corespunzatoare pe nodul de public

Urmatoarea caracteristica API permite proprietarilor de public sa verifice lista conturilor de anunturi destinatar pentru un fisier client Audienta personalizata, unde valorile posibile ale starii de partajare sunt NO_RELATIONSHIP, PENDING_RELATIONSHIP si ACCEPTED_RELATIONSHIP.

GET <custom_audience_id> / shared_account_info Raspuns: {“data”: [{“account_id”: <recipient_account_id>, “account_name”: <recipient_account_name>, “business_id”: <recipient_business_id>, “business_name”: <recipient_business_name> : Stare partajare,}, …],}